MAX9296-GMSL-HAT 使用教程

产品参数

类型	参数
解串器	MAXIM (ADI) MAX9296A
支持主板	树莓派 5 /Jetson Orin NX/Nano 开发套件
支持串行器型号	MAX9295, MAX96717, MAX96705 等
GMSL 输入	2 路 GMSL2 （兼容 GMSL1) 相机
输入接口	2 × MATE_AX FAKRA Z 连接器
输出接口	22Pin CSI 接口
支持 GMSL 相机型号	ISX031 等
供电	5V

硬件规格

接口

CSI 接口 x2: 2 路 MIPI-4lanes 22pin 排线接口，用于接入 Jetson Orin 或者 Pi 5 主板
CFG 开关： CFG 开关永用于配置上电后的默认串行器 i2c 地址和链路速率等初始配置，该配置可以再上电后重新使用软件配置进行覆盖
fakra Z 扣 x2: 用于接入 GMSL 相机，提供 POC 12V 供电
5V 电源接口：输入 5V 供电，为驱动板和相机供电

尺寸

树莓派主板使用说明

解串板的外形尺寸上是基于树莓派主板设计，配合排线连接，用户可以将其用在树莓派 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
```
根据连接的相机，将对应的设置语句中的注释符号 # 去掉，其中 isx031-gmsl-camera-a 是接入的相机型号 , sensor-type=ISX031C_GMSL2F_1CH 设置的相机通道参数

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

相机型号	相机型号参数	相机通道参数	预览参数
ISX031C-GMSL-Camera-H100	isx031-gmsl-camera-a	ISX031C_GMSL2F_xCH	ISX031-GMSL-Camera-A
ISX031-GMSL-Camera-H60	isx031-gmsl-camera-b	ISX031C_GMSL2F_xCH	ISX031-GMSL-Camera-B
ISX031-GMSL-Camera-H100	isx031-gmsl-camera-b	ISX031C_GMSL2F_xCH	ISX031-GMSL-Camera-B
ISX031-GMSL-Camera-H120	isx031-gmsl-camera-b	ISX031C_GMSL2F_xCH	ISX031-GMSL-Camera-B
ISX031-GMSL-Camera-H190	isx031-gmsl-camera-b	ISX031C_GMSL2F_xCH	ISX031-GMSL-Camera-B
GMSL-2MP-Camera-A	gmsl-2mp-camera-a	GMSL_xCH	GMSL-2MP-Camera-A
GMSL-1MP-Camera-A	gmsl-1mp-camera-a	GMSL_xCH	GMSL-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
```
以下为效果图，仅供参考