Managing Versions
If no custom firmware version is set, the programming framework sets the user firmware version to 0.0.0.0 by default. A custom firmware version should be within the range from 0.0.0.0 to 255.255.255.255. The validation rules for user firmware version updates are defined as follows:
- If the user firmware is not updated in the current environment, run the following command to update the firmware to any version.
hinicadm3 updatefw -i hinic0 -f Hinic3_flash_cold.bin -a cold -n
If information similar to the following is displayed, the update is successful. The new firmware takes effect after a system reboot.
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.
- If the user firmware has been updated in the environment and the custom firmware version is X.Y.Z.N:
- If the first three segments of the version are identical and the value of N is greater than or equal to that of the current version, the firmware can be updated.
- If the value of N is less than that of the current version, an interactive message will be displayed on the terminal during the update.
- Entering y or yes forces the update. If information similar to the following is displayed, the update is successful:
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.
- Entering n or other characters causes an update failure. If information similar to the following is displayed, the update fails:
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.
- Entering y or yes forces the update. If information similar to the following is displayed, the update is successful:
- If any of the first three segments (X, Y, or Z) is inconsistent with the current version, an interactive message will be displayed on the terminal during the update.
- Entering y or yes forces the update. If information similar to the following is displayed, the update is successful:
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.
- Entering n or other characters causes an update failure. If information similar to the following is displayed, the update fails:
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.
- Entering y or yes forces the update. If information similar to the following is displayed, the update is successful:
- After the update is successful, query the version number.
hinicadm3 version -i hinic0
The following shows an example command output. The custom firmware versions can be queried.
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
Parent topic: OVS Deployment