系统镜像烧录

板卡运行时需要三个步骤：烧录系统镜像，启动系统和系统登录。 接下来将讲解如何在LubanCat-P1板卡上烧录镜像，并简单介绍下相关镜像。

镜像获取

从网盘获取镜像

镜像命名规则

(处理器型号)-(核心架构)-(更新时间)-(根文件系统)-(存储类型)_update

• 处理器型号

1. sg2000 ：使用sg2000处理器的LubanCat板卡，如LubanCat-P1。

• 核心架构

1. riscv ： 代表riscv核的系统镜像。

2. arm ： 代表arm核的系统镜像。

• 根文件系统

1. ubuntu ： 代表系统使用的根文件系统是ubuntu。

2. buildroot ： 代表系统使用的根文件系统是buildroot。

• 存储类型

1. emmc ：代表存储介质是emmc的系统镜像，需要烧录到emmc启动。

2. sd ：代表存储介质是sd的系统镜像，需要烧录到sd启动。

举例说明

我们以sg2000-riscv-2024-07-27-ubuntu-emmc.zip镜像为例

sg2000-riscv-2024-07-27-ubuntu-emmc.zip

1. 板卡的适用型号：适合LubanCat使用sg2000处理器的板卡

2. 启动核心：riscv

3. 根文件系统：ubuntu

4. 更新日期：2023年7月27日

5. 存储介质：emmc

SD镜像烧录

简要烧录步骤

下面是烧录镜像至SD卡的简要说明：

• 准备Micro SD卡，推荐使用闪迪class 10的SD卡，容量8GB及以上就完全足够。

• 下载Etcher软件，用于烧录镜像至SD卡，下载地址：https://www.balena.io/etcher ，根据自己的电脑系统下载对应版本即可。或者使用野火资料包里提供的(综合资料百度云资料链接->6-开发软件)。

• 下载野火最新的镜像：总资料页中的云盘/3-Linux镜像文件夹

• 给开发板接入烧录好的SD卡，启动跳帽跳到对应核心配置，启动运行。

Etcher工具简介

Etcher是一款简易好用的镜像烧录工具，主要用于刻录镜像到USB设备，包括SD卡和U盘， 支持ios、img、zip、raw、sdcard等多种镜像格式。它的用户界面清爽美观，操作简单， 在软件自动识别到USB设备后，点击几次鼠标就能完成镜像的烧录。

同时Etcher是一个跨平台工具，支持 Mac、Windows 和 Linux ， 国内外开发者常用它将树莓派SD卡启动镜像烧录到SD卡中。

烧录镜像

1、打开安装好的Etcher工具，软件界面如下图所示：

2、选择要烧录的镜像，野火提供的ubuntu/buildroot镜像有两个不同版本，以下以riscv核的ubuntu镜像的为例：

• sg2000-arm-xxx-ubuntu-emmc.zip：arm核ubuntu系统emmc系统镜像。

• sg2000-arm-xxx-ubuntu-sd.img.xz：arm核ubuntu系统sd系统镜像。

• sg2000-riscv-xxx-ubuntu-emmc.zip：riscv核ubuntu系统emmc系统镜像。

• sg2000-riscv-xxx-ubuntu-sd.img.xz：riscv核ubuntu系统sd系统镜像。

3、选择要烧录的SD镜像后，继续选择要烧录的SD卡，然后点击“flash”按钮开始进行烧录。

4、等到软件出现出现如下界面时，表示镜像已经成功烧录完毕。

5、开发板插入烧录好镜像的SD卡，然后拨启动跳帽拨到对应启动核心上。

注意

启动调帽必须要配置正常，不然镜像和启动的核心不对则无法正常启动。

6、sd卡和启动跳帽配置好后，插上5V type-c电源即可启动。

emmc镜像烧录

通过SD刷eMMC

简要烧录步骤

• SD卡格式化为fat32格式

• 将emmc镜像烧录包文件拷贝到SD卡

• 插SD卡到板卡，并正确配置启动调帽上电启动

• 等待烧录完成

• 烧录完成后拔掉SD卡然后重启

烧录镜像

1、将SD卡格式化为fat32格式，只能是fat32格式，其他exFAT、NTFS格式均不支持。如果烧录过SD系统镜像的SD卡需要使用格式化工具进行格式化，网盘资料/6-开发软件/SDCardFormatterv5

2、将emmc烧录包解压，将镜像文件全部拷贝到SD卡中，以下以riscv核的ubuntu镜像的为例：

3、开发板插入烧录好镜像的SD卡，然后拨启动跳帽拨到对应启动核心上。

4、sd卡和启动跳帽配置好后，插上5V type-c电源即可启动，启动后会进行烧录模式，可以接串口模块到debug口查看烧录信息。

5、系统烧录大概需要两分钟，请耐心等待，烧录完成后进入uboot命令行，如下：

6、烧录完成后拔卡重启即可正常启动系统。

通过USB刷eMMC

简要烧录步骤

• 安装usb驱动

• 通过算能烧录工具烧录

烧录工具有两种CviBurn_v2.0_cli_windows不带界面，cviDownloadTool带界面。

安装驱动

下载资料网盘/6-开发软件的CviUsbDownloadInstallDriver.zip 的USB驱动安装工具包，下载后解压安装即可。

烧录镜像(CviBurn_v2.0_cli_windows)

1、下载资料网盘/6-开发软件的CviBurn_v2.0_cli_windows.zip，下载后解压。

2、下载最新版本的emmc固件，以下以riscv核的ubuntu镜像的为例：

将emmc镜像压缩包解压到CviBurn目录下，如下图：

3、在CviBurn目录搜索框输入cmd然后回车打开命令行窗口：

4、在命令行窗口执行烧录命令，其中sg2000-riscv-2024-07-29-ubuntu-emmc要修改为实际的emmc固件目录名字：

.\usb_dl.exe -s linux -c cv181x -i .\sg2000-riscv-2024-07-29-ubuntu-emmc

执行命令显示等待 USB 连接的信息，如下图：

5、板卡确认启动调帽正确配置

6、用手按住KEY按键，然后用Type-C数据线连接板卡和PC，进入烧录模式后再松开KEY按键。

进入烧录模式后，会下载固件，在命令行终端中显示下载进度，如下图：

烧录完成后，会自动重启板卡。

烧录镜像(cviDownloadTool)

cviDownloadTool工具是一款可视化烧录工具， 通过USB来烧录单板，支持可选择单台设备进行烧写，支持裸片烧写。 也可选择支持最多8台设备同时烧录的USB烧录工具。

配置工具参数

在工具所在目录下存在一个config文件夹， 在文件夹里存在一个Board_config.ini的配置文件， 用户在打开工具之前，必须按照自己的需求修改配置文件的各个配置选项。

参数说明如下：

1、Burn_Type: 烧录模式配置

当前支持三种方式：

• Default: 默认状态，将会默认打开首页选择界面，用户可手动选择进入一拖一模式或者一拖多模式。

• Single：一拖一烧录模式，将会直接打开一拖一烧录界面。

• Multiple：一拖多烧录模式，将会直接打开一拖多烧录界面。

2、Burn_Page_Feature：烧录界面功能

当前支持六种方式：

• Full：含有全功能的一拖一界面将被展示。

• Only_Burn：只含有烧录功能的一拖一界面将被展示。

• Only_Burn_USB：只含有USB烧录功能的一拖一界面将被展示。

• Only_Burn_Emmc：只含有eMMC烧录功能的一拖一界面将被展示。

• Only_Burn_NAND：只含有NAND烧录功能的一拖一界面将被展示。

• Only_TFTP：只含有TFTP文件传输功能的一拖一界面将被展示。

3、chip_type：单板配置

当前支持的单板类型如下：

• cv180x

• cv181x

• cv182x

• cv183x

4、OS_type：系统配置

当前支持的系统类型如下：

• alios

• linux

• dual_os

一拖一烧写工具（Single Cvi Download）操作流程

1、下载资料网盘/6-开发软件的cviDownloadTool.zip，下载后解压。点击cvi_combine.exe启动cviDownloadTool， 进入可视化选择界面， 可以选择一拖一烧写工具(Single Cvi Burn)

2、选好一拖一烧写工具（Single Cvi Burn）烧写工具类型后点击OK按钮，即可跳转到对应的页面，点击Brdwse按钮，找到需要被烧写的文件系统配置xml文件，以下以riscv核的ubuntu镜像为例：

3、选好文件后，点击确认，格中会列出需要被烧录进去的文件以及他们的属性， 用户可以手动选择哪些文件可以被烧录，默认烧录全部。

4、确认 正确配置启动跳帽，跳到对应的启动核心位置。

5、 按住KEY按键，连接type-c线，直到开始烧录再 松开KEY按键。

6、点击Download按钮，这时状态栏会出现等待下载的log消息，如果识别到设备则进行烧录，状态栏会显示下载进度和打印logo消息。

7、烧录完成后软件会弹出下载完成弹窗，设备会自动重启，正常启动系统后心跳灯闪烁。

一拖一烧写工具（Multiple Cvi Download）操作流程

1、下载资料网盘/6-开发软件的cviDownloadTool.zip，下载后解压。点击cvi_combine.exe启动cviDownloadTool， 进入可视化选择界面， 可以选择一拖一烧写工具(Multiple Cvi Burn)

2、选好一拖一烧写工具（Multiple Cvi Burn）烧写工具类型后点击OK按钮，即可跳转到对应的页面，点击Browser按钮选择固件镜像，镜像的文件名没有要求，但必须是zip文件，以下以riscv核的ubuntu镜像为例：

3、点击Start按钮启动镜像解压， 软件会先检测同级目录下是否存在CviBurnImage文件夹，若存在将不会解压镜像，避免重复解压所选择的相同镜像（若想解压该镜像，请返回到步骤2.2重新选择镜像），否则将创建CviBurnImage文件夹，并将镜像文件解压到该文件夹中。

同时，软件会初始化烧录程序并启动，程序进入就绪状态， Start按钮变为不可点击状态， 上方的Restart按钮亮起变为可点击状态 （Restart按钮功能会在后面做详细解释）。

4、确认 正确配置启动跳帽，跳到对应的启动核心位置。

5、 按住KEY按键，连接type-c线，直到开始烧录再松开KEY按键。

6、type-c连接板卡后会自动进开始烧录，Log中打印的是当前插入的USB设备，并且会在上方的方框标题显示插入板子对应的USB Port，烧录开始了之后进度条会展示当前设备的烧录进度。

USB Port的对应：

• 将USB接口插入电脑之后，软件会自动识别插入的USB设备并为其编号，无需用户设置。

• 在电脑与单板建立连接之后，会在对应的Board窗口展示其Port号。

• 根据插入的顺序，依从左往右、从上至下的顺序排列在软件界面上。

• USB Port由两部分组成，例如USB Port：2,1中，2表示当前HUB的编号，1表示该HUB上的USB编号。

• 建议用户在插入USB之后为其做好标记，以免造成混淆。

这样在量产时便可以通过软件显示的USB Port与实际单板一一对应，方便查看每个单板的状态。

注意

为了使USB Port能够依次正确读取，请先将USB HUB插入电脑后再依次插入单板。请勿先将单板插入USB HUB之后再一次性将HUB插入电脑，此操作可能造成无法正确读取USB Port

7、当板子烧录完毕时，进度条为100%，Log会打印“Board x download complete”。

若烧录过程中因各种原因导致烧录失败的话，对应烧录失败的Board框内图标会显示“⊗”，log会提示“Board x download failed！ Please restart.”，此时可点击“Restart”按钮对单个板子重新启动烧录程序。

每个板子对应的框内都含有Restart按钮，点击Restart按钮可将对应的烧录程序重置， 重新进入就绪状态，此时将未烧录成功的板子需要将USB拔掉、关机、再重新插入、开机， 烧录程序会重新启动对板子进行烧录。

参考资料： cviDownloadTool 工具