vrd-tool工具介绍

命令功能

vrd-tool工具用于升级vrd器件，包括vrd信息查询，vrd固件升级和生效。

vrd器件控制芯片电源，升级过程中请勿将设备断电，断电可能会导致产品无法启动。

命令格式

vrd-tool -h用于显示查询命令帮助信息。

vrd-tool --help用于显示查询命令帮助信息。

vrd-tool -v用于显示vrd-tool工具版本信息。

vrd-tool info用于查询vrd固件相关信息。

vrd-tool upgrade -h用于显示查询vrd升级命令帮助信息。

vrd-tool upgrade -f file用于升级vrd固件文件。

vrd-tool upgrade -a用于生效已升级的vrd固件文件。

vrd-tool upgrade -a此命令会导致设备重启，请谨慎操作。

参数说明

类型	描述
-h/--help	帮助信息
-v	vrd-tool工具版本信息
info	vrd固件信息
upgrade -h	升级命令帮助信息
upgrade -f file	升级vrd固件文件
upgrade -a	生效vrd固件文件

注意事项

vrd-tool工具不支持在非root用户和容器下运行。

vrd-tool工具需要在主区使用，具体切换操作请参见boot_tool工具介绍。

使用示例

此处以Atlas 200I DK A2 开发者套件为例。

登录Atlas 200I DK A2 开发者套件系统环境。
使用WinSCP工具或其他工具，将下载软件包获取的工具包“vrdtool.tar.gz”上传至root用户属组目录下，例如“/opt”。详细操作请参见使用WinSCP传输文件。
执行如下命令，进入源码包所在目录“/opt”。
cd /opt
执行如下命令，解压源码包“vrdtool.tar.gz”。
tar -xzvf vrdtool.tar.gz
执行如下命令，进入工具包目录。
cd vrdtool
执行如下命令，增加操作权限。
chmod +x vrd-tool
执行如下命令，查看设备的vrd器件类型。
./vrd-tool info

显示如下回显，vrd器件类型为MPS。
```
        supplier                  : MPS 
```
执行如下命令，升级MPS类型的单个vrd固件文件。
./vrd-tool upgrade -f /opt/vrdtool/msp_firmware/V01_IT22MMDA_MPS_MPS_U12_0X60_AI-DVFS_0V9_0V8-CORE_0V825.txt

出现如下回显，表示升级成功。
```
vrd firmware starts to upgrade
The vrd firmware has been upgraded,need to active vrd
```
出现如下回显，表示升级文件被篡改，请重新获取工具包“vrdtool.tar.gz”。
```
vrd firmware signature verification failed. Error:-9014
```
vrd固件文件有两个，只能对一个vrd固件文件升级和生效后再进行另一个vrd固件文件升级和生效。不能同时升级两个vrd固件文件。
执行如下命令，生效vrd文件。
./vrd-tool upgrade -a

出现如下回显，表示生效成功。
```
The vrd firmware is taking effect
```
生效vrd文件会导致产品重启，请谨慎使用。
待Atlas 200I DK A2 开发者套件启动完成后，执行如下命令，进入工具包目录。
cd /opt/vrdtool
执行如下命令，升级MPS类型的另一个vrd固件文件。
./vrd-tool upgrade -f /opt/vrdtool/mps_firmware/V01_IT22MMDA_MPS_MPS_U15_0X6C_CPU-DVFS_0V9.txt

出现如下回显，表示升级成功。
```
vrd firmware starts to upgrade
The vrd firmware has been upgraded,need to active vrd
```
vrd固件文件有两个，只能对一个vrd固件文件升级和生效后再进行另一个vrd固件文件升级和生效。不能同时升级两个vrd固件文件。
执行如下命令，生效vrd文件。
./vrd-tool upgrade -a

出现如下回显，表示生效成功。
```
The vrd firmware is taking effect
```
生效vrd文件会导致产品重启，请谨慎使用。

待Atlas 200I DK A2 开发者套件启动完成后，执行如下命令，查看升级后的版本号。

./vrd-tool info

MPS回显示例如下：

        supplier                  : MPS
        ai_vrd_version            : 1
        ai_vrd_avail_times        : 255
        cpu_vrd_version           : 1
        cpu_vrd_avail_times       : 255

MPS中的“ai_vrd_avail_times”和“cpu_vrd_avail_times”数值无实际意义，MPS升级次数不做限制。

IFX回显示例如下：

        supplier                  : IFX
        ai_vrd_version            : 1
        ai_vrd_avail_times        : 16
        cpu_vrd_version           : 1
        cpu_vrd_avail_times       : 22

IFX中的“ai_vrd_avail_times”和“cpu_vrd_avail_times”数值表示剩余的可升级次数。

父主题： 其他工具介绍