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

From wiki_veye
Jump to navigation Jump to search
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
[[GX camera firmware update manual|English]]
 +
 
'''Gx系列MIPI相机固件升级指南'''
 
'''Gx系列MIPI相机固件升级指南'''
  
=== 适用产品型号 ===
+
===适用产品型号===
  
* GX 系列
+
*GX 系列
  
 
示例型号:GX-MIPI-IMX662
 
示例型号:GX-MIPI-IMX662
  
=== 固件升级原理 ===
+
===固件升级原理===
 
所有上述 MIPI 相机模块均配备 I²C 控制接口,可通过标准 I²C 总线进行固件烧录与参数配置。升级过程由专用工具 <code>veye_gx_upgrade</code> 完成,该工具支持多种嵌入式平台。
 
所有上述 MIPI 相机模块均配备 I²C 控制接口,可通过标准 I²C 总线进行固件烧录与参数配置。升级过程由专用工具 <code>veye_gx_upgrade</code> 完成,该工具支持多种嵌入式平台。
  
=== 准备工作 ===
+
===准备工作===
  
==== 下载固件升级包 ====
+
====下载固件升级包====
  
* 从官方提供的链接下载对应型号的固件文件。
+
*从[https://www.mediafire.com/folder/4tov5s500gaif/camera_firmware_upgrade_images 这个链接]下载对应型号的固件文件。
  
* 文件命名格式通常为:
+
*文件命名格式通常为:
  
设备型号_控制版本逻辑版本_升级.bin
+
设备型号-控制版本逻辑版本-upgrade.bin
  
 
示例:<code>GX-MIPI-IMX662_C112L106_upgrade.bin</code>
 
示例:<code>GX-MIPI-IMX662_C112L106_upgrade.bin</code>
Line 24: Line 26:
 
注:请勿修改固件文件名,否则可能导致升级失败。
 
注:请勿修改固件文件名,否则可能导致升级失败。
  
==== 安装升级工具 ====
+
====安装升级工具====
 
根据您的硬件平台,下载对应的工具包:
 
根据您的硬件平台,下载对应的工具包:
 
{| class="wikitable"
 
{| class="wikitable"
Line 33: Line 35:
 
|树莓派 (Raspberry Pi)
 
|树莓派 (Raspberry Pi)
 
| rowspan="3" |veye_gx_upgrade
 
| 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 系列
 
|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 系列
 
|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链接]
 
|}
 
|}
解压后,确保 <code>veye_gx_upgrade</code> 可执行,并位于工作目录中。
+
下载veye_gx_upgrade到嵌入式主板上,执行<code>chmod +x veye_gx_upgrade</code>
  
=== 升级步骤详解 ===
+
===升级步骤详解===
  
==== 步骤 1:放置固件文件 ====
+
====步骤 1:放置固件文件====
 
将下载的 <code>.bin</code> 固件文件复制到 <code>veye_gx_upgrade</code> 所在的同一目录下。
 
将下载的 <code>.bin</code> 固件文件复制到 <code>veye_gx_upgrade</code> 所在的同一目录下。
  
<code>$ ls</code>会看到类似目录
+
====步骤 2:确认 I²C 总线编号====
 +
请参考这篇文章来确定该相机连接的是哪个 I2C 总线。
 +
 
 +
[https://wiki.veye.cc/index.php/I2c_bus_number_and_video_node i2c bus number on different boards]
 +
 
 +
如果是客户自己的板卡,i2c总线编号就使用客户自己定义的,
 +
 
 +
确认好i2c总线编号后,使用<code>i2cdetect -y -r [i2c_bus]</code>查看i2c是否通信正常
 +
 
 +
<code>$ i2cdetect -y -r 9</code>
  
<code>gxcam_C110L106_upgrade.bin  veye_gx_upgrade</code>
+
<code>   0 1 2 3 4 5 6 7 8 9 a b  c d e f</code>
  
==== 步骤 2:确保相机已通电并识别 ====
+
<code>00:          -- -- -- -- -- -- -- -- -- -- -- -- --</code>
在使用 V4L2 驱动程序时,相机会在 Linux 启动过程中自动开启并进行探测——只需接通板子电源即可。
 
  
对于旧款的树莓派机型,您需要执行 <code>./camera_i2c_config</code> 来手动开启相机。
+
<code>10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --</code>
  
==== 步骤 3:确认 I²C 总线编号 ====
+
<code>20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --</code>
请参考这篇文章来确定该相机连接的是哪个 I2C 总线。
 
  
[https://wiki.veye.cc/index.php/I2c_bus_number_and_video_node i2c bus number on different boards]
+
<code>30: -- -- -- -- -- -- -- -- -- -- -- UU -- -- -- --</code>
  
==== 步骤 4:读取当前固件版本 ====
+
<code>40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --</code>
对于GX系列,请执行此命令以读取当前版本:
 
  
<code>./gx_mipi_i2c.sh -r -f version -b [总线号]</code>
+
<code>50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --</code>
  
示例输出:
+
<code>60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --</code>
  
Read version is C 01.07 and L 01.05
+
<code>70: -- -- -- -- -- -- -- --</code>
  
==== 步骤 5:执行固件升级 ====
+
====步骤 3:执行固件升级====
 
运行升级命令
 
运行升级命令
  
<code>$ sudo ./veye_gx_upgrade [固件文件名] -b [总线号]</code>
+
<code>$ sudo ./veye_gx_upgrade [固件文件名] -b [总线号] -d [i2c地址] -m [升级模式]</code>
 +
 
 +
-b : 步骤2查到的总线号
 +
 
 +
-d : i2c地址,出厂默认0x3b,后期客户更改后使用更改后的地址
 +
 
 +
<nowiki>-m : 升级模式[0/1],默认使用[0]短包传输,速度略低于[1]长包传输,但对于多个厂商板卡的兼容性较高。</nowiki>
 +
 
 +
示例:
 +
 
 +
<code>$ ./veye_gx_upgrade GX-MIPI-IMX662_C112L106_upgrade.bin  -b 9 -d 0x3b -m 0</code>
 +
 
 +
<code>Camera version: 0x01090106</code>
 +
 
 +
<code>nanny version: 1.0</code>
 +
 
 +
<code>Upgrade file package:3</code>
 +
 
 +
<code>begin upgrade process1</code>
 +
 
 +
<code>====================================================================================================>>  [100%]</code>
 +
 
 +
<code>upgrade one package success!!!</code>
 +
 
 +
<code>begin upgrade process2</code>
 +
 
 +
<code>====================================================================================================>>  [100%]</code>
  
示例:<code>$ sudo ./veye_gx_upgrade gxcam_C110L106_upgrade.binn -b 10</code>
+
<code>upgrade one package success!!!</code>
  
* 升级过程中将显示进度条(如 <code>[=====>      ] 45%</code>)。
+
<code>begin upgrade process3</code>
  
* 全程请勿断电或中断命令!
+
<code>====================================================================================================>>  [100%]</code>
* 若升级失败
 
  
# 断开相机电源
+
<code>upgrade one package success!!!</code>
# 重新上电
 
# 重试升级命令
 
  
==== 步骤 6:验证新固件版本 ====
+
<code>Camera version: 0x01120106</code>
升级完成后,相机会自动重启(约需 2~5 秒)。
 
  
再次运行步骤 4 的命令,确认版本已更新:
+
<code>upgrade success!!</code>
 +
 
 +
<code>upgrade finish!</code>
 +
 
 +
*升级开始会读取当前版本,升级结束后会读取最新的版本号
 +
 
 +
*升级过程中将显示进度条(如 <code>[=====>      ] 45%</code>)。
 +
 
 +
*全程请勿断电或中断命令!
 +
*在升级过程中,请确保 I²C 总线仅用于固件升级。不要运行其他可能访问该 I²C 总线的程序或脚本(如图像采集、寄存器读写等),以免造成通信冲突或升级失败。
 +
*若升级失败
 +
 
 +
#断开相机电源
 +
#重新上电
 +
#重试升级命令
 +
 
 +
====步骤 4:验证新固件版本====
 +
升级完成后,相机会自动重启(约需 3~5 秒)。
 +
 
 +
再次运行以下命令,确认版本已更新:
  
 
<code>$ ./gx_mipi_i2c.sh -r -f version -b [总线号]</code>
 
<code>$ ./gx_mipi_i2c.sh -r -f version -b [总线号]</code>
  
Read version is C 01.08 and L 01.06
+
<code>Read version is C 01.12 and L 01.06</code>
  
==== 步骤 7:恢复出厂设置 ====
+
====步骤 5:恢复出厂设置====
 
为避免旧配置与新固件不兼容,强烈建议执行出厂参数重置:
 
为避免旧配置与新固件不兼容,强烈建议执行出厂参数重置:
  
 
<code>$ ./gx_mipi_i2c.sh -w -f factoryparam -b [总线号]</code>
 
<code>$ ./gx_mipi_i2c.sh -w -f factoryparam -b [总线号]</code>
  
=== 常见问题 ===
+
===常见问题===
  
==== 升级后相机无图像输出 ====
+
====升级后相机无图像输出====
 
请检查是否恢复了出厂设置;部分新固件默认关闭自动曝光,可尝试手动配置或重置。
 
请检查是否恢复了出厂设置;部分新固件默认关闭自动曝光,可尝试手动配置或重置。
  
==== i2c设备未找到 ====
+
====i2c设备未找到====
 
确认:
 
确认:
  
* 相机已正确连接并供电;
+
*相机已正确连接并供电;
* I²C 接口已在系统中启用(如树莓派需在 <code>raspi-config</code> 中开启 I2C);
+
*使用正确的总线号。
* 使用正确的总线号。
 
 
 
==== 是否跨型号刷固件 ====
 
不同传感器/硬件的固件不兼容,强行刷写可能导致硬件“变砖”。
 
  
=== 技术支持 ===
+
===技术支持===
 
如遇无法解决的问题,请提供以下信息联系官方支持:
 
如遇无法解决的问题,请提供以下信息联系官方支持:
  
* 相机完整型号
+
*相机完整型号
* 当前与目标固件版本
+
*当前与目标固件版本
* 使用的平台(如 Jetson Orin NX)
+
*使用的平台(如 Jetson Orin NX)
* 完整的终端输出日志
+
*完整的终端输出日志
  
注:在升级过程中,请确保 I²C 总线仅用于固件升级——不要运行其他可能访问该 I²C 总线的程序或脚本(如图像采集、寄存器读写等),以免造成通信冲突或升级失败。
+
<br />

Latest revision as of 10:06, 27 December 2025

English

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:确认 I²C 总线编号

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

i2c bus number on different boards

如果是客户自己的板卡,i2c总线编号就使用客户自己定义的,

确认好i2c总线编号后,使用i2cdetect -y -r [i2c_bus]查看i2c是否通信正常

$ i2cdetect -y -r 9

  0 1 2 3 4 5 6 7 8 9 a b  c d e f

00: -- -- -- -- -- -- -- -- -- -- -- -- --

10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --

20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --

30: -- -- -- -- -- -- -- -- -- -- -- UU -- -- -- --

40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --

50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --

60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --

70: -- -- -- -- -- -- -- --

4.3 步骤 3:执行固件升级

运行升级命令

$ sudo ./veye_gx_upgrade [固件文件名] -b [总线号] -d [i2c地址] -m [升级模式]

-b : 步骤2查到的总线号

-d : i2c地址,出厂默认0x3b,后期客户更改后使用更改后的地址

-m : 升级模式[0/1],默认使用[0]短包传输,速度略低于[1]长包传输,但对于多个厂商板卡的兼容性较高。

示例:

$ ./veye_gx_upgrade GX-MIPI-IMX662_C112L106_upgrade.bin  -b 9 -d 0x3b -m 0

Camera version: 0x01090106

nanny version: 1.0

Upgrade file package:3

begin upgrade process1

====================================================================================================>>  [100%]

upgrade one package success!!!

begin upgrade process2

====================================================================================================>>  [100%]

upgrade one package success!!!

begin upgrade process3

====================================================================================================>>  [100%]

upgrade one package success!!!

Camera version: 0x01120106

upgrade success!!

upgrade finish!

  • 升级开始会读取当前版本,升级结束后会读取最新的版本号
  • 升级过程中将显示进度条(如 [=====> ] 45%)。
  • 全程请勿断电或中断命令!
  • 在升级过程中,请确保 I²C 总线仅用于固件升级。不要运行其他可能访问该 I²C 总线的程序或脚本(如图像采集、寄存器读写等),以免造成通信冲突或升级失败。
  • 若升级失败
  1. 断开相机电源
  2. 重新上电
  3. 重试升级命令

4.4 步骤 4:验证新固件版本

升级完成后,相机会自动重启(约需 3~5 秒)。

再次运行以下命令,确认版本已更新:

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

Read version is C 01.12 and L 01.06

4.5 步骤 5:恢复出厂设置

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

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

5 常见问题

5.1 升级后相机无图像输出

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

5.2 i2c设备未找到

确认:

  • 相机已正确连接并供电;
  • 使用正确的总线号。

6 技术支持

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

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