树莓派主板使用说明
虽然解串板的外形尺寸上是基于 Jetson Orin/NX 开发套件设计，配合排线连接，用户仍然可以将其用在树莓派 5 主板上
硬件连接
 |  |
 |
- 将解串板的 CSI0 接口用配送的排线连接到树莓派 5 的 CAM1 或 CAM0 接口。
- 将电源线分别接入到解串板的电源接口和树莓派 40PIN 中的 5V、GND 排针上。
- 将 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
-
根据连接的相机，将对应的设置语句中的注释符号
#去掉，其中isx031-gmsl-camera-a是接入的相机型号 ,sensor-type=ISX031C_GMSL2F_1CH对应的是串行器的型号和通道数 -
如果是接入一路 IS031C （链路 A 或者链路 B 均可，程序会自动检测）
dtoverlay=isx031-gmsl-camera-a,sensor-type=ISX031C_GMSL2F_1CH -
如果是接入两路 IS031C
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
-
-
以下为实测效果图，仅供参考
