跳到主要内容

树莓派主板使用说明

解串板的外形尺寸上是基于树莓派主板设计，配合排线连接，用户可以将其用在树莓派 5 主板上

硬件连接​

连接 树莓派 5 主板

  • 将解串板的 CSI0 接口用配送的排线连接到树莓派 5 的 CAM1 或 CAM0 接口。
  • 将解串板插入树莓派5的40PIN排针上。
  • 将 GMSL 相机使用同轴线接入解码板的相机接口。
  • 将 CFG 开关，拨到 0100 状态（默认为 ISX031 相机配置）

软件配置​

  • 使用树莓派 2025-05-13-raspios-bookworm-arm64.img.xz 官方镜像。

  • 烧录镜像文件并启动树莓派

    • 将下载的镜像包解压出 .img 镜像文件
    • 使用 树莓派 Imager 烧录器 或者 balenEtcher 软件 将镜像文件烧录到 TF 卡上。
    • 将烧录好镜像的 TF 卡插入树莓派主板，连接好硬件后上电启动

  • 打开树莓派 Terminal 终端，使用指令下载并解压驱动包

    wget https://files.waveshare.com/wiki/MAX9296-GMSL-Deser-Module/ws-rpi5-gmsl.zip
    unzip ws-rpi5-gmsl.zip

  • 安装驱动

    • 使用功能 cd 指令进入驱动包目录

      cd ws-rpi5-gmsl/

      进入驱动目录

    • 为安装脚本添加可执行权限并执行：

      sudo chmod a+x rpi5_gmsl_driver_install.sh
      sudo ./rpi5_gmsl_driver_install.sh

  • 配置 config.txt 文件

    • 编辑文件，并按照下图添加 dtoverlay 设置

      sudo nano /boot/firmware/config.txt

      编辑 config 文件

    • 根据连接的相机，将对应的设置语句中的注释符号 # 去掉，其中 isx031-gmsl-camera-a 是接入的相机型号 , sensor-type=ISX031C_GMSL2F_1CH 设置的相机通道参数

    • 相机和对应的配置说明表格

      相机型号相机型号参数相机通道参数预览参数
      ISX031C-GMSL-Camera-H100isx031-gmsl-camera-aISX031C_GMSL2F_xCHISX031-GMSL-Camera-A
      ISX031-GMSL-Camera-H60isx031-gmsl-camera-bISX031C_GMSL2F_xCHISX031-GMSL-Camera-B
      ISX031-GMSL-Camera-H100isx031-gmsl-camera-bISX031C_GMSL2F_xCHISX031-GMSL-Camera-B
      ISX031-GMSL-Camera-H120isx031-gmsl-camera-bISX031C_GMSL2F_xCHISX031-GMSL-Camera-B
      ISX031-GMSL-Camera-H190isx031-gmsl-camera-bISX031C_GMSL2F_xCHISX031-GMSL-Camera-B
      GMSL-2MP-Camera-Agmsl-2mp-camera-aGMSL_xCHGMSL-2MP-Camera-A
      GMSL-1MP-Camera-Agmsl-1mp-camera-aGMSL_xCHGMSL-1MP-Camera-A

      *_xCH 根据接入的相机，可配置为1CH或者2CH

  • 如果是接入一路 IS031 （链路 A 或者链路 B 均可，程序会自动检测）

    dtoverlay=isx031-gmsl-camera-a,sensor-type=ISX031C_GMSL2F_1CH

  • 如果是接入两路 IS031

    dtoverlay=isx031-gmsl-camera-a,sensor-type=ISX031C_GMSL2F_2CH

  • 如果接入的是 CAM0 接口，在后面添加 cam0 参数

    dtoverlay=gmsl-isx031,sensor-type=ISX031C_GMSL2F_1CH,cam0
    dtoverlay=gmsl-isx031,sensor-type=ISX031C_GMSL2F_2CH,cam0

  • 默认的解串器 i2c 地址是 0x48(0x90 >> 1). 如果需要修改默认地址，可以再后面添加 dser-addr 参数

    dtoverlay=isx031-gmsl-camera-a,sensor-type=ISX031C_GMSL2F_1CH,dser-addr=0x4a
    dtoverlay=isx031-gmsl-camera-a,sensor-type=ISX031C_GMSL2F_2CH,dser-addr=0x4a

  • 设置好后保存文件并重启系统 sudo reboot

快速测试

  • 安装 gstreamer1.0 工具

    sudo apt install gstreamer1.0-tools -y

  • 驱动板中提供了预览用的测试指令，重启系统后可以直接用下方指令对摄像头做预览测试

    • 连接到树莓派 CAM1， 2 路 ISX031C:

      ws_camera_preview.sh ISX031-GMSL-Camera-A csi1 2ch

    • 连接到树莓派 CAM1， 1 路 ISX031C:

      ws_camera_preview.sh ISX031-GMSL-Camera-A csi1 1ch

    • 连接到树莓派 CAM0， 2 路 ISX031C:

      ws_camera_preview.sh ISX031-GMSL-Camera-A csi0 2ch

    • 连接到树莓派 CAM0， 1 路 ISX031C:

      ws_camera_preview.sh ISX031-GMSL-Camera-A csi0 1ch

  • 以下为效果图，仅供参考

    相机预览效果图