APEX AD10 GMSL相机基础使用#

配置方式#

相机工作模式选择#

工作模式

模式说明

用法差异

注意

相机自触发

相机上电后,即以默认支持的频率进行拍照。

可以使用Linux默认方式,以及sdk来获取图像。

所有相机需使用相同的工作模式。

功能作用:​#

当用户只是希望获取相机视频流的时候,没有特殊要求的时候,使用该工作模式,是最便捷的。

在该工作模式下,无需复杂配置,即可快速连接GMSL摄像头并获取实时图像流。​ 当相机正确连接并上电后,它会自动以出厂默认支持的频率开始工作。

关键优势:​#

  • ​极简部署,快速上手:​无需编写底层驱动或复杂脚本。通过直观的可视化界面​(系统设置 > GMSL设置)选择对应通道的相机型号和编号,点击保存即可完成基本配置。

  • ​操作直观,状态明确:​可视化界面清晰展示每个通道的配置状态。

应用场景:​#

  • ​设备安装与初步调试:​ 工程师在现场快速安装摄像头并确认其物理连接和基本功能是否正常。

  • ​原型开发与验证:​ 算法工程师、学生在开发视觉算法初期,快速获取图像数据进行原型验证。

  • ​对严格同步性要求不高的常规应用:​ 当应用场景不需要多个摄像头进行微秒级同步曝光时,此默认模式即可满足需求。

GMSL可视化设置#

  • 点击左侧菜单栏“系统设置-GMSL设置”即可进入页面

  • 选择每个通道的对应相机型号,相机编号,和丝印编号对应

  • 点击保存

  • 等待一会儿,系统会提示GMSL设置成功,即可使用GMSL摄像头

GMSL相机参数确认#

  • 选中一款相机

  • 把鼠标移动到相机图标处

  • 界面会弹出窗口,来指示相机的特性。

使用说明#

视频输出#

可以使用下列命令,快速打开相机来确认效果。

方法一:无需输入参数快速点亮相机#

点亮相机#

sudo chmod +x /opt/miivii/features/gmsl_camera/bin/cameras_sdk_demo 
cd /opt/miivii/features/gmsl_camera/bin/
# 点亮相机(自动点亮所有相机,如需单独点亮相机需指定路数)
./cameras_sdk_demo 

#

性能问题解决方案#

cameras_egl_demo:EGL Demo 直接使用v4l和opencv来获取摄像头图像。

/opt/miivii/features/gmsl_camera/bin/cameras_egl_demo -s 1280x720 -d /dev/video0

兼顾性能和易用性的方案#

cameras_opencv_demo:OpenCV Demo,使用egl来作为显示部分实现,显示部分效率高。

/opt/miivii/features/gmsl_camera/bin/cameras_opencv_demo -s 1280x720 -d /dev/video0

方法二:输入相机参数点亮相机#

显示单路720P的相机#

gst-launch-1.0 -v v4l2src device="/dev/video1" ! video/x-raw,width=1280,height=720,format=UYVY ! xvimagesink

显示单路1080P的相机#

gst-launch-1.0 -v v4l2src device="/dev/video0" ! video/x-raw,width=1920,height=1080,format=UYVY ! xvimagesink

问题排查#

现象:相机帧率与手册标注不一致#

  • 联系米文售前进行定制支持。可选的外触发帧率,是经过实际验证的帧率。

现象:选择了外触发模式,但实际帧率没有跟随外触发变化#

  • ​确认选择了正确的相机型号配置。

  • 询问相机厂商是否支持外触发模式。

​现象:相机无法点亮或黑屏#

  • ​硬件适配检查:确认相机型号在设备支持的兼容列表中(需联系厂商获取最新清单)。

  • 检查相机接口是否插紧,线缆无损坏或氧化。

  • ​配置节点一致性:在设备网页设置中,确保所选相机节点编号与实际物理接口一致(例如接口2对应配置中的“相机2”)。

  • ​热插拔处理:若重新插拔相机,需在网页设置中重新保存配置或重启服务生效。

​现象:图像显示为绿色#

  • ​更换线材,大部分图像的绿屏和线材有关。

  • 和其他相机进行位置调换测试,有相当部分绿屏问题,和相机本身固件也有关系。

  • 联系相机厂商确认固件输出图像格式,和相机支持格式是否相同。

  • 如不同:联系相机厂商更新固件。或寻找米文销售进行支持。

​使用上述手段无效的情况#

#使用下列命令获取日志,并将获得的日志发给技术支持人员
curl -sSL https://doc.miivii.com/scripts/run_miivii_diagnostic.sh | sudo bash -s gmsl