5. cviDownloadTool 工具¶
5.1. cviDownloadTool工具介绍¶
cviDownloadTool工具是一款可视化烧录工具， 通过USB来烧录单板，支持可选择单台设备进行烧写，支持裸片烧写。 也可选择支持最多8台设备同时烧录的USB烧录工具。
注解
通过USB来烧录单板需要满足以下条件:
PC机USB接口与单板的USB2.0口对接
单板必须满足一次系统复位，可以上电复位或者系统软复位
以上条件必须同时满足时，单板才能进入USB烧录流程
5.2. 配置工具参数¶
在工具所在目录下存在一个config文件夹， 在文件夹里存在一个Board_config.ini的配置文件， 用户在打开工具之前，必须按照自己的需求修改配置文件的各个配置选项。
Burn_Type: 烧录模式配置
Burn_Type: 烧录类型
当前支持三种方式：
Default: 默认状态，将会默认打开首页选择界面，用户可手动选择进入一拖一模式或者一拖多模式
Single：一拖一烧录模式，将会直接打开一拖一烧录界面
Multiple：一拖多烧录模式，将会直接打开一拖多烧录界面
Burn_Page_Feature：烧录界面功能
当前支持六种方式：
Full：含有全功能的一拖一界面将被展示
Only_Burn：只含有烧录功能的一拖一界面将被展示
Only_Burn_USB：只含有USB烧录功能的一拖一界面将被展示
Only_Burn_Emmc：只含有eMMC烧录功能的一拖一界面将被展示
Only_Burn_NAND：只含有NAND烧录功能的一拖一界面将被展示
Only_TFTP：只含有TFTP文件传输功能的一拖一界面将被展示
Processor:单板配置
processor_type:单板类型
当前支持的单板类型如下：
cv180x
cv181x
cv182x
cv183x
OS: 系统配置
OS_type: 系统类型
当前支持的系统类型如下：
alios
linux
dual_os
注解
如果Burn_Type没有键入正确的模式名称，则会默认打开首页选择界面。
如果Burn_Page_Feature没有键入正确的功能界面名称，则会默认打开全功能界面。
5.3. cviDownloadTool 使用方法¶
启动cviDownloadTool， 进入可视化选择界面， 可以选择一拖一烧写工具(Single Cvi Burn) 或者一拖多烧写工具（Multiple Cvi Burn）
图 5.1 选择界面¶
5.3.1. 一拖一烧写工具（Single Cvi Download）操作流程¶
步骤1.1
选好一拖一烧写工具（Single Cvi Burn）烧写工具类型后点击OK按钮，即可跳转到对应的页面
图 5.2 Single Cvi Burn 烧录工具界面¶
步骤1.2
点击Brdwse按钮，找到需要被烧写的文件系统配置xml文件
Figure 9 点击Brdwse 按钮
步骤1.3
选好文件后，点击确认，便会出现如 图 5.3 ， 表格中会列出需要被烧录进去的文件以及他们的属性， 用户可以手动选择哪些文件可以被烧录。
图 5.3 选择需要下载的文件¶
步骤1.4
点击Download按钮，这时状态栏会出现等待下载的log消息，用户需要通过上电复位系统或者系统软复位。
图 5.4 点击Download 后，系统等待复位¶
步骤1.5
系统复位以后，烧写进程便会自动运行，直到烧写完成。
进度条会记录烧写进度，状态栏会打印烧写log情况。
烧写完成后会有一个“Download completed!”提示框。
图 5.5 烧写完成¶
步骤1.6
如果在烧写过程中需要终止烧写， 那么可以点击Terminate按钮，烧录进程会被直接终止， 并且会出现“Process Terminate!!!”提示框。
烧写的log会被保留在状态栏里，以供用户阅读检查。
图 5.6 进程中断¶
5.3.2. 一拖多烧写工具（Multiple Cvi Download）操作流程¶
步骤2.1
选好一拖多烧写工具（Multiple Cvi Burn）烧写工具类型后点击OK按钮， 即可跳转到对应的页面，如 图 5.7 。
图 5.7 Multiple Cvi Download 界面¶
步骤2.2
点击Browser按钮选择固件镜像，镜像的文件名没有要求，但必须是zip文件。
图 5.8 选择zip镜像¶
注解
选择完镜像之后会检测同级目录下是否存在CviBurnImage文件夹，若存在会将其删除，以删除旧的镜像文件！
该文件用于保存从镜像中解压出来的所有文件，同时也是烧录的固件所在路径。
请在放置烧录固件文件的时候尽量避免所在路径存在同名文件夹。
如要重新选择镜像文件，请确保Start按钮是亮起的可点击的，或者请确保点击过Stop按钮之后再进行文件的重新选择。
镜像文件要求：
镜像文件的内容请确保根路径即为所有镜像文件，而非一个文件夹，如 图 5.9 。
图 5.9 zip文件目录样式¶
步骤2.3
点击Start按钮启动镜像解压， 软件会先检测同级目录下是否存在CviBurnImage文件夹，若存在将不会解压镜像，避免重复解压所选择的相同镜像（若想解压该镜像，请返回到步骤2.2重新选择镜像），否则将创建CviBurnImage文件夹，并将镜像文件解压到该文件夹中
同时，软件会初始化烧录程序并启动，程序进入就绪状态， Start按钮变为不可点击状态， 上方的Restart按钮亮起变为可点击状态 （Restart按钮功能会在后面做详细解释）。
如 图 5.10
图 5.10 启动烧录程序加入就绪状态¶
步骤2.4
进入就绪状态之后，可以将设备插入到USB HUB中并开机，烧录程序会自动启动。
Log中打印的是当前插入的USB设备，并且会在上方的方框标题显示插入板子对应的USB Port。
烧录开始了之后进度条会展示当前设备的烧录进度。
图 5.11 插入USB设备开始烧录¶
附：USB Port的对应：
将USB接口插入电脑之后，软件会自动识别插入的USB设备并为其编号，无需用户设置。
在电脑与单板建立连接之后，会在对应的Board窗口展示其Port号。
根据插入的顺序，依从左往右、从上至下的顺序排列在软件界面上。
USB Port由两部分组成，例如USB Port：2,1中，
2表示当前HUB的编号，
1表示该HUB上的USB编号
（实物HUB上标记的编号和电脑识别的可能不一致，这里以电脑标记的HUB号为主）。
建议用户在插入USB之后为其做好标记，以免造成混淆。
这样在量产时便可以通过软件显示的USB Port与实际单板一一对应，方便查看每个单板的状态。
注解
为了使USB Port能够依次正确读取，请先将USB HUB插入电脑后再依次插入单板。
请勿先将单板插入USB HUB之后再一次性将HUB插入电脑，此操作可能造成无法正确读取USB Port
步骤2.5
当板子烧录完毕时，进度条为100%，Log会打印“Board x download complete”。
图 5.12 烧录完成¶
烧录失败：
若烧录过程中因各种原因导致烧录失败的话，对应烧录失败的Board框内图标会显示“⊗”，log会提示“Board x download failed！ Please restart.”，
如 图 5.13。此时可点击“Restart”按钮对单个板子重新启动烧录程序。
图 5.13 烧录失败¶
Restart:
每个板子对应的框内都含有Restart按钮，点击Restart按钮可将对应的烧录程序重置， 重新进入就绪状态，此时将未烧录成功的板子需要将USB拔掉、关机、再重新插入、开机， 烧录程序会重新启动对板子进行烧录。
图 5.14 Restart 按钮¶