憑借低價(jià)就能橫掃市場？極致性價(jià)比是基礎(chǔ)，好用易開發(fā)才是關(guān)鍵——合宙LuatOS超值MCU系列產(chǎn)品驚喜不斷，贏得廣大工程師朋友喜愛。

有工程師朋友問：“如果不使用合宙自主研發(fā)的多功能下載調(diào)試工具LuaTools，可以用命令行刷機(jī)嗎？”當(dāng)然可以！根據(jù)項(xiàng)目實(shí)際需求靈活選用LuatOS系列MCU即可。

命令行刷機(jī)參數(shù)及注意事項(xiàng)

.soc文件為合宙LuatOS-SOC系統(tǒng)使用的固件格式，我們可以使用7z等解壓縮軟件對(duì)其進(jìn)行解壓，固件構(gòu)成如下：

.bin文件：固件二進(jìn)制文件

.exe文件：刷機(jī)程序
Air101/Air103為air101_flash.exe
Air105/ESP32-C3為soc_download.exe

info.json：刷機(jī)參數(shù)信息

Air101/Air103命令行刷機(jī)參數(shù)

01. -ds 下載時(shí)設(shè)置串口速度
默認(rèn)值為115200，可使用15200 | 460800 | 921600 | 1000000 | 2000000 | 1M | 2M。

02. -c 串口號(hào)
例如：COM0

03. -ws 工作串口速度
默認(rèn)值為115200 可使用1200 - 2000000|1M | 2M。

04. -rs 復(fù)位動(dòng)作
設(shè)置設(shè)備復(fù)位方法，默認(rèn)為手動(dòng)控制，可選none | at | rts。

05. -dl 下載固件文件
默認(rèn)下載壓縮映像

更多參數(shù)使用，運(yùn)行air101_flash.exe -h查看。

舉個(gè)例子：

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

各參數(shù)可在info.json中查看。

Air105命令行刷機(jī)參數(shù)

01. 類型
字符串，air105須填寫air105_download

02. 串口號(hào)
10進(jìn)制，1~255

03. 通用bl下載時(shí)的波特率
10進(jìn)制

04. 下載bin文件路徑
帶引號(hào)的字符串

05. 下載bootloader的文件名稱
帶引號(hào)的字符串

06. bootloader寫入地址
16進(jìn)制，不帶0x

07. 下載APP的文件名稱
帶引號(hào)的字符串

08. APP寫入地址
進(jìn)制，不帶0x

09. 下載腳本的文件名稱
帶引號(hào)的字符串

10. 腳本寫入地址
16進(jìn)制，不帶0x

11. RTS復(fù)位的電平
10進(jìn)制，0或者1

12. 只下載腳本的標(biāo)志
10進(jìn)制，0或者1，1表示只下載腳本

13. 文件系統(tǒng)地址

14. 文件系統(tǒng)需要擦除的長度
如果不擦，寫0

舉個(gè)例子：

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

各參數(shù)可在info.json中查看。

ESP32-C3命令行刷機(jī)參數(shù)

01. 類型
字符串，esp32-c3須填寫esp32_download

02. 串口號(hào)
10進(jìn)制，1~255

03. 通用bl下載時(shí)的波特率
10進(jìn)制

04. 下載bin文件路徑
帶引號(hào)的字符串

05. 下載bootloader的文件名稱
帶引號(hào)的字符串

06. bootloader寫入地址
16進(jìn)制，不帶0x

07. 下載APP的文件名稱
帶引號(hào)的字符串

08. APP寫入地址
16進(jìn)制，不帶0x

09. 下載腳本的文件名稱
帶引號(hào)的字符串

10. 腳本寫入地址
16進(jìn)制，不帶0x

11. 分區(qū)表的文件名稱
帶引號(hào)的字符串

12. 分區(qū)表寫入地址
16進(jìn)制，不帶0x

13. 芯片下載參數(shù)
目前是0x00ff0200，byte3是芯片類型，目前只有0，byte2是spi flash info（寫0xff就是大小從ID中獲取），byte1 是spi mode（寫0xff就是不修改固件，目前是0x02），byte0沒用是0。

14. 只下載腳本的標(biāo)志
10進(jìn)制，0或者1，1表示只下載腳本

15. 文件系統(tǒng)地址

16. 文件系統(tǒng)需要擦除的長度
如果不擦，寫0

舉個(gè)例子：

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個(gè)bin合并成1個(gè)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

各參數(shù)可在info.json中查看。

相關(guān)注意事項(xiàng)

控制臺(tái)中打印的信息，需要關(guān)注以下相關(guān)字段：

download error:xxx下載出錯(cuò)及原因：

download stage xxx:yyy 下載XXX（bl，app.bin, script.bin）的 yyy階段，注意yyy是數(shù)字，bl階段根據(jù)不同芯片有不同的解釋，app.bin和script.bin有通用的解釋，如下：

Air105的bl：

0：嘗試通過RTS復(fù)位芯片，及同步芯片串口

1：同步串口成功，開始連接串口

2：連接串口成功，發(fā)送bootloader信息

3：開始擦除相關(guān)flash

4：開始寫入bl數(shù)據(jù)

5：完成

通用bl下載協(xié)議：

0：開始同步

1：發(fā)送bin信息

2：發(fā)送bin數(shù)據(jù)

3：等待驗(yàn)證固件信息

ESP32的ramrun：

0：嘗試通過RTS復(fù)位芯片，及同步芯片串口

1：同步串口成功，開始連接串口

2：連接串口成功，發(fā)送bootloader信息

3：開始擦除相關(guān)flash

download percent:xxx當(dāng)前下載的進(jìn)度：

全部下載完成后提示download OK