maphstra/jm-connect-blueos

JM Connect ROV扩展与摄像头控制镜像

镜像概述与主要用途

本镜像为一款专用扩展组件，主要用于实现遥控潜水器（ROV）与JM Connect系统的识别对接，并提供对JM Focus-camera设备的控制功能。其核心价值在于简化ROV设备与JM Connect平台的集成流程，同时支持摄像头的远程操控，适用于需要ROV远程操作与视觉监控协同的场景。

核心功能与特性

核心功能

• ROV识别与对接：支持ROV设备身份识别，实现与JM Connect系统的稳定对接，确保设备状态与控制指令的可靠传输。
• JM Focus-camera控制：提供对JM Focus-camera的实时控制能力，包括焦距调节、角度调整、拍摄模式切换等操作。

主要特性

• 轻量化设计：镜像体积小巧，资源占用低，适合部署在ROV等嵌入式或资源受限环境。
• 即插即用：简化配置流程，支持快速集成至现有JM Connect生态系统。
• 稳定兼容性：针对JM Connect协议及JM Focus-camera硬件进行优化，确保通信与控制稳定性。

使用场景与适用范围

典型使用场景

• 水下ROV作业：在海洋、湖泊等水下环境中，实现ROV设备与岸基JM Connect系统的远程连接，同步获取ROV状态并控制摄像头监控作业区域。
• ROV设备调试：在实验室或测试环境中，通过本镜像快速搭建ROV与JM Connect的通信链路，验证设备集成效果。
• 远程监控系统：需要联动ROV移动与摄像头视角调整的场景，如水下勘探、管道巡检等。

适用范围

• 搭载JM Focus-camera的ROV设备
• 基于JM Connect协议的远程控制系统
• 需实现ROV与上位机集成的工业或科研项目

使用方法与配置说明

前提条件

• 已安装Docker环境（Docker 18.06+）
• 可访问JM Connect系统服务端
• ROV设备与运行环境网络连通

快速启动（Docker Run）

bash
docker run -d \
  --name jm-rov-extension \
  --network host \  # 根据实际网络配置调整，确保与JM Connect及ROV通信
  -e JM_CONNECT_HOST="your-jm-connect-server" \  # JM Connect服务端地址
  -e JM_CONNECT_PORT=8080 \  # JM Connect服务端端口
  -e ROV_DEVICE_ID="rov-001" \  # ROV设备唯一标识
  -e CAMERA_CONTROL_ENABLE=true \  # 启用摄像头控制功能
  your-registry/jm-rov-extension:latest

环境变量配置说明

配置验证

容器启动后，可通过日志确认服务状态：

bash
docker logs jm-rov-extension

若日志显示"Successfully connected to JM Connect"及"Camera control initialized"，则表示服务正常运行。

停止与卸载

bash
# 停止容器
docker stop jm-rov-extension

# 移除容器
docker rm jm-rov-extension

注意事项

• 确保ROV设备与JM Connect服务端之间的网络延迟低于200ms，以保证控制指令的实时性。
• 摄像头控制功能依赖JM Focus-camera设备的固件版本兼容性，建议使用v2.0及以上版本固件。
• 生产环境中建议通过Docker Compose或Kubernetes进行部署，以提高服务稳定性与可维护性。