版本管理

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

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

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

   hinicadm3 updatefw -i hinic0 -f Hinic3_flash.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”可强制更新。打印信息如下所示，表示更新成功。

       hot update NPU_CS major version does not match.(run version: 17.6.3.4 cur version: 17.6.3.3)
       please confirm to continue(y/n)? y
       Version check succeed.
       The running version can be hot upgraded to the target version.
       Please do not remove driver or network device.
       Loading...
       Firmware update start: 2025-04-27 16:15:29
       [>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>] [100%][\]
       Firmware update finish: 2025-04-27 16:16:08
       Firmware update time used: 39s
       Loading firmware image succeed.
       Do not operate the device during the hot upgrade.
       Single NPU firmware is activing. Please waiting ...
       Set update hot active successful!

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

       hot update NPU_CS major version does not match.(run version: 1.0.0.1 cur version: 1.0.0.0),
       please confirm to continue(y/n)? n
       NPU cann't be hot upgraded.
       updatefw command error(-6): The running version and the target version match failed.

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

     hot update NPU_CS major version does not match.(run version: 0.0.0.* cur version: 1.0.0.*),
     please confirm to continue(y/n)? y
     Version check succeed.
     The running version can be hot upgraded to the target version.
     Please do not remove driver or network device.
     Loading...
     Firmware update start: 2025-04-24 14:25:01
     [>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>] [100%][\]
     Firmware update finish: 2025-04-24 14:25:44
     Firmware update time used: 43s
     Loading firmware image succeed.
     Do not operate the device during the hot upgrade.
     Single NPU firmware is activing, Please waiting...
     Set update hot active successful!

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

     hot update NPU_CS major version does not match.(run version: 1.0.0.* cur version: 0.0.0.*),
     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.2.0            2025-04-24_18:54:06
   mpu     : 17.12.2.0            2025-04-24_18:58:48
   smu_L0  : 17.12.2.0            2025-04-24_18:53:26
   smu_L1  : 17.12.2.0            2025-04-24_18:53:26
   npu     : 17.12.2.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.2.0   2025-04-24 21:28:28
   hisdk3     driver:  17.12.2.0   2025-03-28_16:03:29
   hiovs3     driver:  17.12.2.0   2025-03-28_16:04:15
   hivbs3     driver:  17.12.2.0   2025-03-28_16:04:18