憑借低價就能橫掃市場？極致性價比是基礎，好用易開發才是關鍵——合宙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