Difference between revisions of "GX camera firmware update manual/zh"
(→固件升级原理) |
|||
| (10 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 这个链接]下载对应型号的固件文件。 |
| − | * 文件命名格式通常为: | + | *文件命名格式通常为: |
| − | + | 设备型号-控制版本逻辑版本-upgrade.bin | |
| − | 示例:<code> | + | 示例:<code>GX-MIPI-IMX662_C112L106_upgrade.bin</code> |
注:请勿修改固件文件名,否则可能导致升级失败。 | 注:请勿修改固件文件名,否则可能导致升级失败。 | ||
| − | ==== 安装升级工具 ==== | + | ====安装升级工具==== |
根据您的硬件平台,下载对应的工具包: | 根据您的硬件平台,下载对应的工具包: | ||
{| 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 | + | |[https://github.com/veyeimaging/raspberrypi_v4l2/blob/main/gx_i2c_tools GitHub链接] |
|- | |- | ||
|NVIDIA Jetson 系列 | |NVIDIA Jetson 系列 | ||
| − | |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 | + | |[https://github.com/veyeimaging/raspberrypi_v4l2/blob/main/gx_i2c_tools GitHub链接] |
|} | |} | ||
| − | + | 下载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>$ | + | ====步骤 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> | + | <code> 0 1 2 3 4 5 6 7 8 9 a b c d e f</code> |
| − | + | <code>00: -- -- -- -- -- -- -- -- -- -- -- -- --</code> | |
| − | |||
| − | + | <code>10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --</code> | |
| − | + | <code>20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --</code> | |
| − | |||
| − | + | <code>30: -- -- -- -- -- -- -- -- -- -- -- UU -- -- -- --</code> | |
| − | + | <code>40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --</code> | |
| − | |||
| − | <code> | + | <code>50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --</code> |
| − | + | <code>60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --</code> | |
| − | + | <code>70: -- -- -- -- -- -- -- --</code> | |
| − | ==== 步骤 | + | ====步骤 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>upgrade one package success!!!</code> | |
| − | + | <code>begin upgrade process3</code> | |
| − | + | <code>====================================================================================================>> [100%]</code> | |
| − | |||
| − | + | <code>upgrade one package success!!!</code> | |
| − | |||
| − | |||
| − | + | <code>Camera version: 0x01120106</code> | |
| − | |||
| − | + | <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. | + | <code>Read version is C 01.12 and L 01.06</code> |
| − | ==== 步骤 | + | ====步骤 5:恢复出厂设置==== |
为避免旧配置与新固件不兼容,强烈建议执行出厂参数重置: | 为避免旧配置与新固件不兼容,强烈建议执行出厂参数重置: | ||
<code>$ ./gx_mipi_i2c.sh -w -f factoryparam -b [总线号]</code> | <code>$ ./gx_mipi_i2c.sh -w -f factoryparam -b [总线号]</code> | ||
| − | === 常见问题 === | + | ===常见问题=== |
| − | ==== 升级后相机无图像输出 ==== | + | ====升级后相机无图像输出==== |
请检查是否恢复了出厂设置;部分新固件默认关闭自动曝光,可尝试手动配置或重置。 | 请检查是否恢复了出厂设置;部分新固件默认关闭自动曝光,可尝试手动配置或重置。 | ||
| − | ==== i2c设备未找到 ==== | + | ====i2c设备未找到==== |
确认: | 确认: | ||
| − | * 相机已正确连接并供电; | + | *相机已正确连接并供电; |
| − | + | *使用正确的总线号。 | |
| − | * 使用正确的总线号。 | ||
| − | |||
| − | |||
| − | |||
| − | === 技术支持 === | + | ===技术支持=== |
如遇无法解决的问题,请提供以下信息联系官方支持: | 如遇无法解决的问题,请提供以下信息联系官方支持: | ||
| − | * 相机完整型号 | + | *相机完整型号 |
| − | * 当前与目标固件版本 | + | *当前与目标固件版本 |
| − | * 使用的平台(如 Jetson Orin NX) | + | *使用的平台(如 Jetson Orin NX) |
| − | * 完整的终端输出日志 | + | *完整的终端输出日志 |
| − | + | <br /> | |
Latest revision as of 10:06, 27 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:确认 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 总线的程序或脚本(如图像采集、寄存器读写等),以免造成通信冲突或升级失败。
- 若升级失败
- 断开相机电源
- 重新上电
- 重试升级命令
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)
- 完整的终端输出日志