Difference between revisions of "GX camera firmware update manual/zh"

Revision as of 09:46, 11 December 2025

Gx系列MIPI相机固件升级指南

1 适用产品型号

GX 系列

示例型号：GX-MIPI-IMX662

2 固件升级原理

所有上述 MIPI 相机模块均配备 I²C 控制接口，可通过标准 I²C 总线进行固件烧录与参数配置。升级过程由专用工具 veye_gx_upgrade 完成，该工具支持多种嵌入式平台。

3 准备工作

3.1 下载固件升级包

从这个链接下载对应型号的固件文件。

文件命名格式通常为：

设备型号-控制版本逻辑版本-upgrade.bin

示例：GX-MIPI-IMX662_C112L106_upgrade.bin

注：请勿修改固件文件名，否则可能导致升级失败。

3.2 安装升级工具

根据您的硬件平台，下载对应的工具包：

平台	工具包名称	获取方式
树莓派 (Raspberry Pi)	veye_gx_upgrade	GitHub链接
NVIDIA Jetson 系列		GitHub链接
Rockchip RK35xx 系列		GitHub链接

下载veye_gx_upgrade到嵌入式主板上，执行chmod +x veye_gx_upgrade。

4 升级步骤详解

4.1 步骤 1：放置固件文件

将下载的 .bin 固件文件复制到 veye_gx_upgrade 所在的同一目录下。

4.2 步骤 2：确保相机已通电并识别

在使用 V4L2 驱动程序时，相机会在 Linux 启动过程中自动开启并进行探测——只需接通板子电源即可。

4.3 步骤 3：确认 I²C 总线编号

请参考这篇文章来确定该相机连接的是哪个 I2C 总线。

i2c bus number on different boards

4.4 步骤 4：读取当前固件版本

对于GX系列，请执行此命令以读取当前版本：

./gx_mipi_i2c.sh -r -f version -b [总线号]

示例输出：

Read version is C 01.07 and L 01.05

4.5 步骤 5：执行固件升级

运行升级命令

$ sudo ./veye_gx_upgrade [固件文件名] -b [总线号]

示例：$ sudo ./veye_gx_upgrade GX-MIPI-IMX662_C112L106_upgrade.bin -b 10

升级过程中将显示进度条（如 [=====> ] 45%）。

全程请勿断电或中断命令！
在升级过程中，请确保 I²C 总线仅用于固件升级。不要运行其他可能访问该 I²C 总线的程序或脚本（如图像采集、寄存器读写等），以免造成通信冲突或升级失败。
若升级失败

断开相机电源
重新上电
重试升级命令

4.6 步骤 6：验证新固件版本

升级完成后，相机会自动重启（约需 3~5 秒）。

再次运行步骤 4 的命令，确认版本已更新：

$ ./gx_mipi_i2c.sh -r -f version -b [总线号]

Read version is C 01.12 and L 01.06

4.7 步骤 7：恢复出厂设置

为避免旧配置与新固件不兼容，强烈建议执行出厂参数重置：

$ ./gx_mipi_i2c.sh -w -f factoryparam -b [总线号]

5 常见问题

5.1 升级后相机无图像输出

请检查是否恢复了出厂设置；部分新固件默认关闭自动曝光，可尝试手动配置或重置。

5.2 i2c设备未找到

确认：

相机已正确连接并供电；
I²C 接口已在系统中启用（如树莓派需在 raspi-config 中开启 I2C）；
使用正确的总线号。

6 技术支持

如遇无法解决的问题，请提供以下信息联系官方支持：

相机完整型号
当前与目标固件版本
使用的平台（如 Jetson Orin NX）
完整的终端输出日志

@@ Line 33: / Line 33: @@
 |树莓派 (Raspberry Pi)
 | rowspan="3" |veye_gx_upgrade
-|[https://github.com/veyeimaging/raspberrypi_v4l2/blob/main/gx_i2c_tools/veye_gx_upgrade GitHub链接]
+|[https://github.com/veyeimaging/raspberrypi_v4l2/blob/main/gx_i2c_tools GitHub链接]
 |-
 |NVIDIA Jetson 系列
-|[https://github.com/veyeimaging/nvidia_jetson_veye_bsp/blob/master/gx_i2c_tools/veye_gx_upgrade GitHub链接]
+|[https://github.com/veyeimaging/nvidia_jetson_veye_bsp/blob/master/gx_i2c_tools GitHub链接]
 |-
 |Rockchip RK35xx 系列
-|[https://github.com/veyeimaging/raspberrypi_v4l2/blob/main/gx_i2c_tools/veye_gx_upgrade GitHub链接]
+|[https://github.com/veyeimaging/raspberrypi_v4l2/blob/main/gx_i2c_tools GitHub链接]
 |}
 下载veye_gx_upgrade到嵌入式主板上，执行<code>chmod +x veye_gx_upgrade</code>。
@@ Line 70: / Line 70: @@
 <code>$ sudo ./veye_gx_upgrade [固件文件名] -b [总线号]</code>
-示例：<code>$ sudo ./veye_gx_upgrade gxcam_C110L106_upgrade.binn -b 10</code>
+示例：<code>$ sudo ./veye_gx_upgrade GX-MIPI-IMX662_C112L106_upgrade.bin -b 10</code>
 * 升级过程中将显示进度条（如 <code>[=====>      ] 45%</code>）。
 * 全程请勿断电或中断命令！
+*在升级过程中，请确保 I²C 总线仅用于固件升级。不要运行其他可能访问该 I²C 总线的程序或脚本（如图像采集、寄存器读写等），以免造成通信冲突或升级失败。
 * 若升级失败
@@ Line 82: / Line 83: @@
 ==== 步骤 6：验证新固件版本 ====
-升级完成后，相机会自动重启（约需 2~5 秒）。
+升级完成后，相机会自动重启（约需 3~5 秒）。
 再次运行步骤 4 的命令，确认版本已更新：
@@ Line 88: / Line 89: @@
 <code>$ ./gx_mipi_i2c.sh -r -f version -b [总线号]</code>
-Read version is C 01.08 and L 01.06
+Read version is C 01.12 and L 01.06
 ==== 步骤 7：恢复出厂设置 ====
@@ Line 115: / Line 116: @@
 * 完整的终端输出日志
-注：在升级过程中，请确保 I²C 总线仅用于固件升级——不要运行其他可能访问该 I²C 总线的程序或脚本（如图像采集、寄存器读写等），以免造成通信冲突或升级失败。
+<br />