版本管理

用户若未设置自定义固件版本，编程框架默认设置用户版本为0.0.0.0。用户若设置自定义固件版本，允许设置版本号范围为0.0.0.0~255.255.255.255。

用户固件版本号更新校验规则如下所示。

1. 若当前环境未更新用户固件，用户可执行以下命令更新任意版本的固件。

   hinicadm3 updatefw -i hinic0 -f Hinic3_flash_cold.bin -a cold -n

   打印信息如下所示，表示成功，重启后环境固件生效。

   Run gray_npu_ver is empty.
   Please do not remove driver or network device.
   Loading...
   Firmware update start: 2025-11-14 11:25:03
   [>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>] [100%][\]
   Firmware update finish: 2025-11-14 11:25:44
   Firmware update time used: 41s
   Loading firmware image succeed.
   Set update active cfg succeed!
   Please reboot OS to take Firmware effect.

2. 若环境中已更新用户固件，用户自定义固件版本为X.Y.Z.N。
   • 版本号前三位一致，N值大于等于当前运行版本值时，可正常更新固件。
   • N值小于当前运行版本值时，更新固件时终端显示交互信息。
     • 输入“y”或“yes”可强制更新。打印信息如下所示，表示更新成功。

       cold update NPU_CS major version does not match.(run version: 17.6.3.3 cur version: 17.6.3.2),
       please confirm to continue(y/n)?  y
       Please do not remove driver or network device.
       Loading...
       Firmware update start: 2025-11-14 11:57:31
       [>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>] [100%][\]
       Firmware update finish: 2025-11-14 11:58:22
       Firmware update time used: 51s
       Loading firmware image succeed.
       Set update active cfg succeed!
       Please reboot OS to take Firmware effect.

     • 输入“n”或其他字符，更新失败，打印信息如下所示，表示更新失败。

       cold update NPU_CS major version does not match.(run version: 17.6.3.3 cur version: 17.6.3.2),
       please confirm to continue(y/n)?  n 
       NPU cann't be hot upgraded.
       updatefw command error(-6): Update firmware failed.

3. 版本号前三位X、Y、Z若存在任意一个值不一致，更新固件时终端显示交互信息。
   • 输入“y”或“yes”可强制更新，更新成功，打印信息如下，表示更新成功。

     cold update NPU_CS major version does not match.(run version: 17.6.3.* cur version: 1.1.1.*),
     please confirm to continue(y/n)?  y
     Please do not remove driver or network device.
     Loading...
     Firmware update start: 2025-11-14 11:51:12
     [>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>] [100%][\]
     Firmware update finish: 2025-11-14 11:52:04
     Firmware update time used: 52s
     Loading firmware image succeed.
     Set update active cfg succeed!
     Please reboot OS to take Firmware effect.

   • 输入“n”或其他字符，更新失败，打印信息如下所示，表示更新失败。

     cold update NPU_CS major version does not match.(run version: 17.6.3.* cur version: 1.1.1.*),
     please confirm to continue(y/n)?  n
     NPU cann't be hot upgraded.
     updatefw command error(-6): Update firmware failed.

4. 更新成功后，执行以下命令查询版本号。

   hinicadm3 version -i hinic0

   打印信息如下所示，可查询到自定义用户固件版本。

   boot    : 17.12.5.0            2025-04-24_18:54:06
   mpu     : 17.12.5.0            2025-04-24_18:58:48
   smu_L0  : 17.12.5.0            2025-04-24_18:53:26
   smu_L1  : 17.12.5.0            2025-04-24_18:53:26
   npu     : 17.12.5.0            2025-04-24_17:14:44
   npu-cs  : 1.0.0.1             2025-04-24_17:14:44
   cfg     : 0.0.0.23            2025-04-24_17:15:30
   hinicadm3    tool:  17.12.5.0   2025-04-24 21:28:28
   hisdk3     driver:  17.12.5.0   2025-03-28_16:03:29
   hiovs3     driver:  17.12.5.0   2025-03-28_16:04:15
   hivbs3     driver:  17.12.5.0   2025-03-28_16:04:18