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

Revision as of 13:20, 10 December 2025

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

1 适用产品型号

GX 系列

示例型号：GX-MIPI-IMX662

2 固件升级原理

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

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

3 准备工作

3.1 下载固件升级包

从官方提供的链接下载对应型号的固件文件。

文件命名格式通常为：

驱动命名_控制版本逻辑版本_升级.bin

示例：gxcam_C110L106_upgrade.bin

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

3.2 安装升级工具

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

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

解压后，确保 veye_gx_upgrade 可执行，并位于工作目录中。

4 升级步骤详解

4.1 步骤 1：放置固件文件

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

$ ls会看到类似目录

gxcam_C110L106_upgrade.bin veye_gx_upgrade

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

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

对于旧款的树莓派机型，您需要执行 ./camera_i2c_config 来手动开启相机。

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 gxcam_C110L106_upgrade.binn -b 10

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

全程请勿断电或中断命令！
若升级失败

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

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

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

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

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

Read version is C 01.08 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）；
使用正确的总线号。

5.3 是否跨型号刷固件

不同传感器/硬件的固件不兼容，强行刷写可能导致硬件“变砖”。

6 技术支持

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

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

注：固件升级属于高风险操作，请在稳定电源环境下进行，并确保网络/存储介质可靠。

@@ Line 20: / Line 20: @@
 * 文件命名格式通常为：
-驱动命名_控制版本.逻辑版本_升级.bin
+驱动命名_控制版本逻辑版本_升级.bin
 示例：<code>gxcam_C110L106_upgrade.bin</code>
@@ Line 55: / Line 55: @@
 ==== 步骤 2：确保相机已通电并识别 ====
-运行 <code>i2cdetect -y [总线号]</code>，应能看到相机的 I²C 地址（如 0x3b 或 0x10）。
+在使用 V4L2 驱动程序时，相机会在 Linux 启动过程中自动开启并进行探测——只需接通板子电源即可。
-<br />
+对于旧款的树莓派机型，您需要执行 <code>./camera_i2c_config</code> 来手动开启相机。
+==== 步骤 3：确认 I²C 总线编号 ====
+请参考这篇文章来确定该相机连接的是哪个 I2C 总线。
+[https://wiki.veye.cc/index.php/I2c_bus_number_and_video_node i2c bus number on different boards]
+==== 步骤 4：读取当前固件版本 ====
+对于GX系列，请执行此命令以读取当前版本：
+<code>./gx_mipi_i2c.sh -r -f version -b [总线号]</code>
+示例输出：
+Read version is C 01.07 and L 01.05
+==== 步骤 5：执行固件升级 ====
+运行升级命令
+<code>$ sudo ./veye_gx_upgrade [固件文件名] -b [总线号]</code>
+示例：<code>$ sudo ./veye_gx_upgrade gxcam_C110L106_upgrade.binn -b 10</code>
+* 升级过程中将显示进度条（如 <code>[=====>      ] 45%</code>）。
+* 全程请勿断电或中断命令！
+* 若升级失败
+# 断开相机电源
+# 重新上电
+# 重试升级命令
+==== 步骤 6：验证新固件版本 ====
+升级完成后，相机会自动重启（约需 2~5 秒）。
+再次运行步骤 4 的命令，确认版本已更新：
+<code>$ ./gx_mipi_i2c.sh -r -f version -b [总线号]</code>
+Read version is C 01.08 and L 01.06
+==== 步骤 7：恢复出厂设置 ====
+为避免旧配置与新固件不兼容，强烈建议执行出厂参数重置：
+<code>$ ./gx_mipi_i2c.sh -w -f factoryparam -b [总线号]</code>
+=== 常见问题 ===
+==== 升级后相机无图像输出 ====
+请检查是否恢复了出厂设置；部分新固件默认关闭自动曝光，可尝试手动配置或重置。
+==== i2c设备未找到 ====
+确认：
+* 相机已正确连接并供电；
+* I²C 接口已在系统中启用（如树莓派需在 <code>raspi-config</code> 中开启 I2C）；
+* 使用正确的总线号。
+==== 是否跨型号刷固件 ====
+不同传感器/硬件的固件不兼容，强行刷写可能导致硬件“变砖”。
+=== 技术支持 ===
+如遇无法解决的问题，请提供以下信息联系官方支持：
+* 相机完整型号
+* 当前与目标固件版本
+* 使用的平台（如 Jetson Orin NX）
+* 完整的终端输出日志
+注：固件升级属于高风险操作，请在稳定电源环境下进行，并确保网络/存储介质可靠。