凭借低价就能横扫市场？合宙超值MCU的实用【刷机】命令行

凭借低价就能横扫市场？极致性价比是基础，好用易开发才是关键——合宙LuatOS超值MCU系列产品惊喜不断，赢得广大工程师朋友喜爱。

有工程师朋友问：“如果不使用合宙自主研发的多功能下载调试工具LuaTools，可以用命令行刷机吗？”当然可以！根据项目实际需求灵活选用LuatOS系列MCU即可。

命令行刷机参数及注意事项

---

.soc文件为合宙LuatOS-SOC系统使用的固件格式，我们可以使用7z等解压缩软件对其进行解压，固件构成如下：

.bin文件：固件二进制文件

.exe文件：刷机程序
Air101/Air103为air101_flash.exe
Air105/ESP32-C3为soc_download.exe

info.json：刷机参数信息

Air101/Air103命令行刷机参数

01. -ds 下载时设置串口速度
默认值为115200，可使用15200 | 460800 | 921600 | 1000000 | 2000000 | 1M | 2M。

02. -c 串口号
例如：COM0

03. -ws 工作串口速度
默认值为115200 可使用1200 - 2000000|1M | 2M。

04. -rs 复位动作
设置设备复位方法，默认为手动控制，可选none | at | rts。

05. -dl 下载固件文件
默认下载压缩映像

更多参数使用，运行air101_flash.exe -h查看。

举个例子：

air101_flash.exe -ds 2M -c COM0 -ws 115200 -rs rts -dl air10x.fls

各参数可在info.json中查看。

Air105命令行刷机参数

---

01. 类型
字符串，air105须填写air105_download

02. 串口号
10进制，1~255

03. 通用bl下载时的波特率
10进制

04. 下载bin文件路径
带引号的字符串

05. 下载bootloader的文件名称
带引号的字符串

06. bootloader写入地址
16进制，不带0x

07. 下载APP的文件名称
带引号的字符串

08. APP写入地址
进制，不带0x

09. 下载脚本的文件名称
带引号的字符串

10. 脚本写入地址
16进制，不带0x

11. RTS复位的电平
10进制，0或者1

12. 只下载脚本的标志
10进制，0或者1，1表示只下载脚本

13. 文件系统地址

14. 文件系统需要擦除的长度
如果不擦，写0

举个例子：

soc_download.exe air105_download 83 3000000 "E:\air105\core\hex\air105\debug" bootloader.bin 01001000 app.bin 01010000 script.bin 01300000 0 0 01380000 0

各参数可在info.json中查看。

ESP32-C3命令行刷机参数

---

01. 类型
字符串，esp32-c3须填写esp32_download

02. 串口号
10进制，1~255

03. 通用bl下载时的波特率
10进制

04. 下载bin文件路径
带引号的字符串

05. 下载bootloader的文件名称
带引号的字符串

06. bootloader写入地址
16进制，不带0x

07. 下载APP的文件名称
带引号的字符串

08. APP写入地址
16进制，不带0x

09. 下载脚本的文件名称
带引号的字符串

10. 脚本写入地址
16进制，不带0x

11. 分区表的文件名称
带引号的字符串

12. 分区表写入地址
16进制，不带0x

13. 芯片下载参数
目前是0x00ff0200，byte3是芯片类型，目前只有0，byte2是spi flash info（写0xff就是大小从ID中获取），byte1 是spi mode（写0xff就是不修改固件，目前是0x02），byte0没用是0。

14. 只下载脚本的标志
10进制，0或者1，1表示只下载脚本

15. 文件系统地址

16. 文件系统需要擦除的长度
如果不擦，写0

举个例子：

soc_download.exe esp32_download 66 1152000 "_temp\soc\download\esp32" "bootloader.bin" 00000000 "luatos.bin" 00010000 "script.bin" 01300000 "partition-table.bin" 00008000 00ff0200 0 00380000 0000

如果3个bin合并成1个bin，可以如下：

soc_download.exe esp32_download 66 1152000 "_temp\soc\download\esp32" "bootloader.bin" ffffffff "luatos_esp32.bin" 00000000 "script.bin" 01300000 "partition-table.bin" ffffffff 00ff0200 0 00380000 0000

各参数可在info.json中查看。

相关注意事项

---

控制台中打印的信息，需要关注以下相关字段：

download error:xxx下载出错及原因：

download stage xxx:yyy 下载XXX（bl，app.bin, script.bin）的 yyy阶段，注意yyy是数字，bl阶段根据不同芯片有不同的解释，app.bin和script.bin有通用的解释，如下：

Air105的bl：

0：尝试通过RTS复位芯片，及同步芯片串口

1：同步串口成功，开始连接串口

2：连接串口成功，发送bootloader信息

3：开始擦除相关flash

4：开始写入bl数据

5：完成

通用bl下载协议：

0：开始同步

1：发送bin信息

2：发送bin数据

3：等待验证固件信息

ESP32的ramrun：

0：尝试通过RTS复位芯片，及同步芯片串口

1：同步串口成功，开始连接串口

2：连接串口成功，发送bootloader信息

3：开始擦除相关flash

download percent:xxx当前下载的进度：

全部下载完成后提示download OK