GMSL GUI：CSI Configuration Tool 使用介绍

在调试、配置 GMSL 链路时，面对多如牛毛的寄存器，以及各种 PHY、Port 等互相映射，有些小伙伴可能会无从下手，尤其是对于刚接触 GMSL 相关知识的同学。

庆幸的是，ADI 充分考虑到了用户的这个痛点，推出了超级强大的 GUI 调试工具： GMSL GUI

该工具中的 CSI Configuration Tool 能基于用户的需求，智能导出一份 GMSL Link （包含对 加串器 和 解串器 的配置）配置脚本。用户可直接使用此脚本，或以此脚本为基础移植到其他平台。

接下来，咱们就一步步了解下如何使用该 CSI Configuration Tool。

CSI Configuration Tool 下载、安装：

通过链接 GMSL GUI , 按照上图点击下载

这里提示需要登陆 ADI 的账户，直接登陆自己的账户即可；如果没有账户，可以在线申请注册一个。

下载完成后，直接双击 exe 文件，默认安装完成即可。

CSI Configuration Tool 使用步骤：

双击打开 “GMSL_SerDes_Public_GUI”

我们今天基于 ADI 官方的开发板做演示：MAX96717 EVK 和 MAX96724 EVK

硬件连接如果正确，没有问题的话，我们能在 GUI 的界面上看到 MAX96717 和 MAX96724 两个设备被识别

点击 Tools - CSI Configuration Tool

弹出如下工具框：

MAX96724 可以接四路 GMSL Link，今天我们以 1xMAX96717 + MAX96724 为例子，MAX96717 接至 MAX96724 的 Link A 上。假定数据格式为 RGB888, VC=0

1）加串器 Deserializer： 根据实际硬件进行选择，咱们这里测试用的 MAX96724， 故选择 MAX96724

2）加串器 Deserializer MIPI Port 输出模式：MAX96724 支持 2x4 mode 和 4x2 mode， 这里我们选用默认的 2x4 mode， 即输出两个 MIPI 配置，每个 Port 均配置为 4 lanes

3）加串器的 i2c 地址，这里需要跟目标 deserializer 一致。因为 CSI Configuration Tool 可以脱离 EVK 使用，就是说不用外接 EVK 也可使用 GMSL GUI 的 CSI Configuration Tool 工具。

4）测试中 MAX96717 是接在 MAX96724 的 Link A 上，所以这里需要勾选 GMSL-A Serializer

5）目标 serializer 是 MAX96717, 故选择 MAX96717

6）加串器 MAX96717 MIPI 输入口的模式，这个需要跟摄像头 sensor 的输出保持一致，通常为 1x4 mode

7）加串器 MAX96717 Power-up address: MAX96717 上电时根据 CFGx Pins strapped 的地址，

8）加串器 MAX96717 上电后修改的地址：如果 MAX96724 只接了一个 MAX96717， 这里的地址可以不修改，跟上电的时候保持一样；如果接了多个 MAX96717，为避免 SoC 访问冲突，这里修改修改为不同的地址。比如接了四个 MAX96717，上电时默认地址都是 0x80, 可以修改他们上电后的地址分别为 0x80/0x82/0x84/0x86

9）Tunneling：如果选用 Tunnel mode，需要勾选这里；Pixel mode，不需要勾选这里

10）上述操作正确配置后，点击 Configure， 弹出如下对话框：

可以给大家看下，如果是 4xMAX96717 + MAX96724 的 Configure 是什么样子：

ok， 接着看 1xMAX96717 + MAX96724 的 case：

点击 1. CSI， 打开对话框：

Add input VC: 根据实际选择，这里我们默认选择 0

and DT： datatype， 根据实际选择，比如 RGB888， 在摄像头应用中 YUV422 比较常见

on Port： 对于 MAX96717, 只能选择 Port B

配置完成后，选择 Add to Port。相关配置参数就添加到 Serializer Input 列表中。然后关闭这个对话框即可

点击 2. DPHY， 打开对话框：

这里可以修改 MIPI 输入 data lane 个数，以及极性是否需要翻转等

默认为 1x4 lane 的输入配置，跟我们的测试应用符合，这里我们不做修改

点击 3.CSI， 打开对话框：

Route Input DT： 下拉选择对应的数据格式，这里我们只接了一个 MAX96717, 下拉只有一条可选

to Deserializer Port： MAX96724 我们配置的为 2x4 mode，所有会有 Port A 和 Port B 两个接口，这里我们选择将数据从 Port A 发出

with VC： 选择 0

and DT： 数据格式选择 RGB888

点击 Add to Port， 即可将配置参数添加到 Deserializer Output 列表中。

然后关闭对话框。注意，这里有一个指示灯，绿色表示配置正确

点击 4.C/D-PHY，打开对话框

这里是对 MAX96724 的 MIPI 输出进行配置：比如 datarate， data lanes，极性是否翻转等等。

我们测试中，仅用到 PortA，4xlanes，速率按照默认配置为 4x1500Mbps, 不需要极性翻转等：

只需要配置 Port A， Port B 就无需操作了

配置完成后，关闭对话框即可

好了，到这一步，所有的参数都已经配置完成。

点击 5.Generate Script 弹出如下对话框：

点击 Export Script，选择保存路径和文件名称。默认文件格式为 *.cpp

比如导出的文件我们命名为 test.cpp

CSI Configuration Tool 导出的脚本格式解析：

打开导出的 test.cpp 文件， 文件格式如下：

第一列：GUI 导出的标识字段，没有实际意义

第二列：需要配置的设备 i2c 地址，比如这里为 0x80, 是 MAX96717 的 i2c 地址

第三列：寄存器地址，这里需要将两个 byte 结合起来。比如 0x03, 0x83, 对应的为寄存器地址 0x0383

第四列：需要写入寄存器的值

CSI Configuration Tool 导出的脚本如何使用？

导出的 test.cpp 文件有两种调用方式：

第一种：可以直接通过 GMSL GUI 导入，对设备进行配置

点击 File - Load (.cpp) File - 选择对应的 cpp 文件

第二种：从生成的 cpp 配置文件中，解析出 device i2c address & 寄存器地址 & 要写入的寄存器值

通过 SoC I2C master 对加串器 MAX96717 和 解串器 MAX96724 进行配置。