烧录调试工具（Linux & MAC）

烧录调试工具CLI

该工具开发与测试在 Ubuntu 20.04.3 LTS, 64-bit 操作系统。在macos X64，aarch系列进行编译测试。

使用2.1.0版本需要升级burning evk 固件版本到V4.5。同时该版本usb模式暂不支持，如需要，需要使用1.8.1以前的版本。

介绍

功能支持, 主要支持evk模式, 部分芯片支持usb模式，如下表。后续详细用例里面有说明。

-	8 Series	B91	B92	TL751x	TL721x	TL321x
read/write flash (rf, wf)	EVK/USB	EVK	EVK/USB	EVK	EVK	EVK
read/write sram (rc, wc)	EVK/USB	EVK	EVK/USB	EVK	EVK	EVK
read/wirte analog (ra, wa)	EVK/USB	EVK	EVK/USB	EVK	EVK	EVK
download in flash	EVK/USB	EVK	EVK/USB	EVK	EVK	EVK
sboot	-	-	EVK	-	-	-
download in core	EVK/USB	EVK	EVK/USB	EVK	EVK	EVK
erase in flash	EVK/USB	EVK	EVK/USB	EVK	EVK	EVK
lock/unlock flash(lf, ulf)	EVK/USB	EVK	EVK	EVK	EVK	EVK
check pc (pc)	EVK/USB	EVK	EVK/USB	EVK	EVK	EVK
check global parameters (var)	EVK/USB	EVK	EVK/USB	EVK	EVK	EVK
reset in flash or sram	EVK/USB	EVK	EVK/USB	EVK	EVK	EVK
sws	EVK	EVK	EVK	EVK	EVK	EVK
run step stop	EVK	-	-	-	-	-
ac	EVK	EVK	EVK	EVK	EVK	EVK
lsusb	-	-	-	-	-	-
up	-	-	-	-	-	-

芯片型号参数

B91 B92 B92_V18 TL751x TL7518 TL721x TL321x  
B80 B85 B87 B89_A1 8232 8266 8267 8269 8366 8368 8367_i 8367_e 8369_i 8369_e

如果使用B92 1.8v环境，该参数选择B92_V18。

命令使用示例

命令选项介绍

-u: 表示使用usb模式,未使用-u默认为evk模式。
-s: 需要操作的字节数量,数量跟在-s后面， eg: -s 16; -s 1k。
-e: 表示擦除操作,常用于flash, core擦除。
-c: 表示core，常用reset命令。
-i: 指定输入文件，后面紧跟文件路径,常用于指定下载文件， eg: -i /home/8258_gpio.bin。
-o: 指定输出文件，后面紧跟文件路径,常用于将读取二进制数据保存到文件， eg: -o /home/readflash.bin。
-p: 表示打印具体过程，常用于flash操作。
-b,-d: usb设备的bus, devid，存在多个usb设备时候需要使用该参数。

支持usb模式的功能, 在命令后面添加-u选项即可。

假如存在多个evk设备，由于evk设备vid、pid都是相同的，可以通过指定evk设备的bus，devid控制指定设备。

假如使用usb模式的调试方式，也需要通过指定bus，devid的方式控制设备。

示例，在命令的后面添加-b:bus -d:devid
./bdt 8258 sws -b 1 -d 1
./bdt 8258 sws -b 1 -d 2

./bdt 8258 sws -b 1 -d 1 -u
./bdt 8258 sws -b 1 -d 2 -u

sws

设置通讯速率，以及检测evk于目标板连接是否正常。

## 设置指定的sws值.
## b0:地址 10:速率参数值.前两个(b0 10)为设置evk swire clk值;后两个(b0 10)是目标开发板swire clk值.
./bdt 8258 sws b0 10 b0 10 

## 如果没有指定值,sws值默认为b0 10 b0 10.
./bdt 8258 sws

写入sws值必须跟在sws命令参数后面。

activate

唤醒设备，程序处于深度睡眠的时候，使用该命令.

./bdt 8258 ac

reset

重新启动, 程序从flash或者sram启动.

## 重启后从flash启动
./bdt 8258 reset

## 重启后从sram启动
./bdt 8258 reset -c

read/write flash

read flash(rf)

读取数量小于1kb, 读取数据将打印; 大于1kb将会保存到默认文件.

默认文件名称实例: save1020-11294102.bin

## 读取flash地址0x00 16字节数据
./bdt 8258 rf 0x00 -s 16
./bdt 8258 rf 0x00 -s 1k

## 将读取数据输出到制定文件readflash.bin
./bdt 8258 rf 0x00 -s 16 -o readflash.bin

write flash(wf)

flash 在写入之前需要先进行擦除, 擦除的默认单位是4k.

## 写入4字节数据到flash 0x00.
./bdt 8258 wf 0x00 01 02 03 04 -s 4

## 先擦除,再写入数据.
./bdt 8258 wf 0x00 01 02 03 04 -s 4 -e

## 写入一个文件到flash,下载功能.
## 写入文件不用选项-e -s.
./bdt 8258 wf 0x00 -i bin/USB_Demo.bin

lock flash(lf)

./bdt B92 lf addr size(k)
./bdt B92 lf 0 512k

unlock flash(ulf)

flash在程序运行过程中可能会被锁定，在调试的时候需要重新打开。

./bdt B92 ulf

read/write core

read core(rc)

读取数量小于1kb, 读取数据将打印; 大于1kb将会保存到默认文件.

默认文件名称实例: save1020-11294102.bin

## 读取sram地址0x40000 16字节数据.
./bdt 8258 rc 0x40000 -s 16
./bdt 8258 rc 0x40000 -s 1k

## 将读取数据输出到制定文件readsram.bin.
./bdt 8258 rc 0x40000 -s 16 -o readsram.bin

write core(wc)

## 写入4字节数据到sram 0x40000
./bdt 8258 wc 0x40000 01 02 03 44 -s 4

## 写入一个文件到sram,下载功能
## 写入文件不用选项-e -s
./bdt 8258 wc 0x40000 -i bin/USB_Demo.bin

read/wirte analog

read analog(ra)

## 读取analog数据, 起始地址0x00 16字节.
./bdt 8258 ra 0x00 -s 16

write analog(wa)

## 写入4字节数据到analog 0x00.
./bdt 8258 wa 0x00 01 02 03 44 -s 4

sboot

目前该功能(security boot)暂时只支持b92，详细用法、示例也可使用bdt help sboot查看。

--mode 0/1
0: 普通模式。
1：security boot模式（验签），需要配合--pkh参数使用。

--crypto 0/1
0：flash固件不加密读写模式。
1：flash固件加密读写模式，需要配合--rk参数使用。

--pkh /path/to/public_key_file
下载public key hash到efuse，该文件可以由security boot post工具生成。

--rk (16 bytes key)
root key用于flash读写功能。

--run-code addr-/path/to/bin_file
下载固件到指定flash地址，该固件为mcu实际运行的bin文件。

--run-code-des addr-/path/to/des_bin_file
下载描述符信息到指定flash地址，该des_bin_file文件由security boot post工具生成；需要配合--run-des-addr使用；

--run-des-addr(3 bytes addr)
配置地址到efuse，该参数addr根据flash容量大小变化。
1M: f8000
2M: 1f8000
4M: 4f8000
16M:ff8000

示例

可以依次配置参数，也可以一次性配置所有的参数。

1. mode(0) + crypto(1) + rk(16 bytes) + run-code((flash addr)-path(BIN))
  bdt B92 sboot --mode 0 
  bdt B92 sboot --crypto 1
  bdt B92 sboot --rk 000102030405060708090a0b0c0d0e0f
  bdt B92 sboot --run-code 0-/path/to/flash_bin

  You can input more than one parameter. (During this process, if one parameter configuration fails, subsequent parameter configurations will be terminated).\n "
  f.g 
    bdt B92 sboot --mode 0 --crypto 1 --rk 000102030405060708090a0b0c0d0e0f --run-code 0-/path/to/flash_bin

2. mode(1) + crypto(1) + pkh(public key path) + rk(16 bytes) + run-des-addr(addr) + run-code((flash addr)-path(BIN)) + run-code-des(addr-path(des_bin))
  f.g 
    bdt B92 sboot --mode 1 --crypto 1 --pkh /path/to/public_key_file --rk 000102030405060708090a0b0c0d0e0f --run-des-addr f8000 --run-code 0-/path/to/flash_bin --run-code-des f8000-/path/to/flash_bin

3. mode(1) + crypto(0) +pkh(public key path) + run-des-addr(addr) + run-code((flash addr)-path(BIN)) + run-code-des(addr-path(des_bin))
  f.g 
    bdt B92 sboot --mode 1 --crypto 0 --pkh /path/to/public_key_file --run-des-addr f8000 --run-code 0-/path/to/flash_bin --run-code-des f8000-/path/to/flash_bin

secure-debug enable

## 如果已经设置root key，则不用设置
./bdt b92 sboot --rk 000102030405060708090a0b0c0d0e0f
./bdt b92 sboot --debug-text 000102030405060708090a0b0c0d0e0f
./bdt b92 sboot --secure-debug 1

运行 --secure-debug 命令后，sw相关调试命令会立即失效。root-key 与 debug-text在后续re-enable命令需要继续使用，请保存2个字符串。

secure-debug re-enable

## --re-enable-debug rook_key-debug_text
./bdt b92 sboot --re-enable-debug 000102030405060708090a0b0c0d0e0f-000102030405060708090a0b0c0d0e0f

成功运行该命令后，开发板没有重启前，调试功能继续生效；重启后，调试功能将再次失效。

read sboot info

可以运行如下命令读取当前关于sboot的设置信息。

./bdt b92 sboot --read-info

check pc/parameter

查看pc指针值, 全局参数表(var)。

需要查看pc指针值, 参数具体含义，需要配置.lst文件。

## 打印当前pc指针值.
./bdt 8258 pc

## 打印当前pc指针值,详细说明.
./bdt 8258 pc -i USB_PRINT_LOG.lst

## 打印当前程序参数列表(地址,长度,值).
/bdt 8258 var -i USB_PRINT_LOG.lst

run stop

运行，停止程序执行。

## 开始运行.
./bdt 8258 run

## 停止运行.
./bdt 8258 stop

step

单步运行程序.

./bdt 8258 step

up

更新evk固件, usb连接evk设备。

-i: 指定需要更新的固件文件夹

-v: 查询当前evk版本号

## evk芯片为8266
./bdt 8266 up -i fw/Firmware_v3.4.bin
./bdt 8266 up -i fw/Firmware_v3.4.bin -ev
./bdt 8266 up -ev

lsusb

查看已经电脑usb设备列表，-v选项可以查看usb描述符字符串。

./bdt lsusb 
./bdt lsusb -v

FAQ

TBD

烧录调试工具GUI

该工具基于gtk, libusb开发，使用前请安装gtk+-3.0, libusb-1.0环境(仅linux，mac需要安装，安装方法可以查看软件压缩包里的readme.md文档)。

(1) 参数配置区

主要配置芯片的具体型号（B92, B91，8258，8266...）
访问设备的模式（evk，usb）
访问存储类型（flash，ram，analog）
访问的起始地址
访问的字节数量
下载文件的路径配置

(2) 在1号区域配置完对应的参数后

点击read，write按键，进行存储空间的读写操作
点击download按键，下载bin文件到flash、ram
点击erase按键，进行flash区域擦除，起始地址
点击reset按键，可选择从flash或者ram复位
点击active按键，可对开发板进行唤醒操作

(3) 调试区

run：运行程序
pause：暂停运行程序
step ：单步运行程序
pc：查看当前的程序运行指针值
var：查看当前程序的全局变量值
start：开始运行程序
stall：终止程序的运行

功能使用

设备选择

点击菜单栏Device，将显示已经连接的evk设备，该列表识别的evk设备（vid：0x248a, pid：0x8266），如上图-1区域所示。如需添加的设备vid、pid值不一样，请点击add device。

add device列表显示系统扫描的所有usb设备，根据自身需求添加设备，如上图2区域所示。请注意，请正确添加需要连接的设备，否则添加到其他设备，该设备可能会出现故障，需要重新插拔连接，才能恢复正常使用。

sws

设置单线同步速度，确保EVK设备与开发板正常连接，当开发板程序处于low power模式，该功能不能正常使用需要，需要先唤醒开发板。

(1) 选择芯片对应的型号

(2) 配置sws寄存器地址、时钟值（默认不改动）

(3) sws成功的结果

reset

复位开发板，选择启动程序从flash或者sram开始运行。

(1) 复位，从flash启动，如下图所示：

(2) 复位，从sram，如下图所示

activate

开发板运行程序处于low power模式，唤醒操作。

内存、flash读写

(1) 读flash

从0x0000地址读取16字节的数据，如下图所示。

从0x0000地址读取1k字节的数据，读取数量大于等于1k的数据将不会直接打印，保存在文件，如下图所示。

(2) 读取sram

读取sram的操作与上述读取flash操作相似。从0x40000（8258芯片sram起始地址）读取16字节数据，如下图所示。

(3) 写入flash

在0x0000写入4个字节数据，配置写入起始地址（如下图-2区域）、写入数量（如下图-3区域）、写入内容（如下图-4区域，字节之间以空格间隔）。

成功结果如下图-6区域所示。
失败结果如下图-7区域所示，写入之前先进行擦除，详情参照flash 擦除。

(4) 写入sram

在0x40001写入2字节数据，如下图所示。下图-4区域输入数据后，不用按回车，否则当做命令执行。

解锁Flash

下载

(1) 下载bin文件到flash，配置bin文件路径（如下图-2区域），配置起始地址。如果下载过程中长时间未响应，请检查设备是否处于低功耗模式。

(2) 下载bin文件到flash，配置bin文件路径（如下图-2区域），配置起始地址。

flash 擦除

擦除起始地址0x0000, 擦除字节8kb（如下图-3区域，擦除大小自定义输入），擦除最小单位为4kb。

调试功能

(1) pc 查看程序运行指针

查看pc值的详细信息，则需要打开运行程序的.lst文件（如下图-1区域），勾选使用.lst文件（如下图-2区域）。

(2) var 查看程序全局变量

该功能需要打开、使用.lst文件，如上节所示。

(3) run

继续程序运行，一般在使用pause后使用。

(4) pause

暂停程序运行。

(5) step

程序单步运行

(6) start

程序重新开始运行。操作地址0x602、操作值0x88一般不做改动。

(7) stall

程序终止运行。操作地址0x602、操作值0x06一般不做改动。

程序终止功能

cancel按键，在长时间操作无响应，可以直接退出当前运行命令。

命令行功能

命令行模式，如下图所示，输入命令，按回车执行命令。命令使用格式，请参考命令行用户手册。

设备自定义标签

在插入多个设备的情况，防止设备混乱。用户对连接的设备自定义名称。如下图所示，单击可修改标签文本，回车结束。

多下载模式

Tool -> mutilple downloads。该功能，适用于设备下载多个bin文件，多个设备同时下载文件。

(1) add：添加下载项，以序号（NO)1、2、3排列

(2) remove：删除制定下载项，鼠标点击下载项后，再点击remove

(3) file：指定下载bin文件路径

(4) download：执行下载命令

(5) clear：删除全部下载项目

(6) cancel：取消全部正在下载中的进程

使用步骤

(1) 单击start address栏，输入起始地址，回车结束。

(2) 单击file，选择bin文件路径，将自动解析文件大小，计算结束地址。地址区间存在冲突将会标红提示。

(3) 配置设备，如上图-标号1所示，点击进入配置界面，输入芯片信号，回车结束。

如上图，标号1选择下载设备。标号2, 配置burning evk连接的芯片型号。点击save configure案件。

(1) 单击download开始下载，等待执行结果，如下图所示。(下载前请保证所有的设备连接正常)

Burning EVK固件更新

查看、更新Burning EVK固件。注意事项，在更新过程中请勿插拔设备。更新完成后，需要重新插拔设备。

使用步骤

(1) 如上图-1区域选择需要更新固件的设备。

(2) 如上图-2区域点击可以查询当前固件的版本。

(3) 如上图-3区域点击选择固件文件路径。

(4) 如上图-4区域点击更新指定的固件到设备。

配置可选芯片型号与flash固件路径

点击打开config.ini文件。

(1) 可在bdt_cmd区域添加芯片型号和对应的flash固件路径，每项之间通过空格间隔。（如果正在使用的芯片型号没有配置的时候）。该位置配置的芯片型号，将会出现在图形界面的芯片型号可选框。

(2) bdt_gui区域用于配置ram起始地址、sws寄存器设置值。

(3) bdt_version区域不做修改。