通用腳本的寫法以及命令行的寫法

1. 背景

2. 準備工作

2.1 硬件準備

2.2 軟件準備

3. PE工具腳本語法介紹

4. 操作實例

4.1 通用腳本的寫法

4.2 命令行的寫法

4.3 批處理文件的寫法

5. 總結：

6. 免責聲明：

1. 背景

前段時間，內部同事討論到使用Umultilink去批量燒錄的可能性，想起曾經做過類似的嘗試，并被客戶批量生產所采用。想來也是一個經濟實惠的操作，此處總結下，方便有需求的用戶加以應用和擴展。

USB Multilink Universal 是PEmicro的一款簡單易用的調試和編程工具，允許通過USB接口與NXP多種處理器進行通信，包括S08、S12、ColdFire、MPC55xx/56xx、Kinetis以及S32K等多款MCU，同時其也支持ST、Cypress、Microchip、Nordic、Renesas等MCU廠商，甚至還支持國產的芯片公司如GD、Auto chips、MindMotion靈動微、Zhixin等。Multilink的速度和可靠性非常適合產品開發(fā)階段，可以與市場上NXP主流的工具鏈無縫銜接，如CodeWarrior、S32DS、MCUXPresso、IAR、Keil、Cosmic和Mentor Graphics等，價格相對比較便宜(最常用的Multilink FX官網(wǎng)報價199刀)，目前在市場上保有量很高。

而在量產階段，PEmicro也提供了一套工具叫做Cyclone Programmers，提供編程Image的板載存儲、為目標提供電源，而且可以通過 PC 進行控制，也可以脫機燒寫。在配置完成后產線工作人員只需要按一個啟動按鈕即可完成程序的燒錄。當然Cyclone 編程器也支持開發(fā)過程中用作調試器，并受到許多 IDE 的支持，但是鑒于其999刀的價格用來調試程序有點殺雞用牛刀的意思，所以大都是作為量產工具使用。

那么問題來了， 買不起999刀Cyclone Programmers，能否使用199刀Multilink作為量產工具呢？答案當然是可以的，而且還是無需打開GUI界面悄無聲息的那種。本文的目標就是讓大家不用拼夕夕，不用京冬冬，更不用淘寶寶，便可立省600美刀(最高立省800美刀)，省錢的操作就是這么的樸素無華，卻熠熠生輝。

2. 準備工作

2.1 硬件準備

USB Multilink Universal、USB Multilink Universal FX 或者Multilink ACP，相信老Freescale的用戶對前面兩個不會陌生，最后一個倒是有些默認，簡單的來說它是一個cost down版本，只支持ARM Cortex-M 內核產品的燒錄。

2.2 軟件準備

Umultilink 驅動：USB Multilink Resources Install

序列號生成工具(Optional)：Serialize Utility

Flash/EEPROM編程軟件：PROG Flash Programming Software

要指出的是第3個軟件不是完全免費的，如下圖，對于DSC和NEXUS內核是免費的，妥妥立省800刀，而對于S08、S12、PowerPC5xx/8xx、Kinetis、LPC及S32K等ARM內核的MCU都是需要額外收費的，價格是統(tǒng)一的199刀，這也就是前文為何說立省600刀的原因。

Note: Flash/EEPROM編程軟件 LICENSE是和Umultilink的HW序列號綁定的，也就意味著不能一個軟件license不能同時用在多個Umultilink上。如果需要多個License，PE官網(wǎng)按照Quantity是有折扣的，譬如說10個License，價格降到139美刀了；

其實對于PROG-HL-ARM版本還是很劃算，它涵蓋了市場上不同MCU廠家的大部分ARM內核處理器，如NXP、ST、Microchip、Nordic、Renesas等，甚至還有國產的芯片公司如Auto chips、MindMotion靈動微、Zhixin等，可以說是一個License在手，各家MCU編程功能我有，秒變Cyclone，如下截圖是已經支持的廠商列表。回想當初，曾幾何時，PEmicro的工具基本是Freescale芯片專屬，現(xiàn)如今支持的廠商越來越多，可見如今不僅MCU市場卷，工具市場也很卷啊。

除此之外，該版本甚至還支持對外部SPI nor Flash的編程，對于如IMXRT系列這類沒有內部Flash，需要外掛Nor Flash的芯片來說也是支持的，已經支持的比較常用的vendor包括華邦Winbond、Microchip、ISSI、Microchip、旺宏MXIC、Adesto等，以部分ISSI SPI Nor Flash的支持為例如下圖2。

當然，鑒于不同Norflash廠家的Feature，譬如是否支持SFDP，是否支持8線，是否支持DDR，是否需要Byte Swap，QE位位置的差異等，其算法完全無縫支持市場上所有的Nor Flash型號也不現(xiàn)實(筆者在里面吃過不少苦頭，心累)，所以PEmicro也承諾可以幫用戶去做定制，而且是免費的，甚至可以提供源代碼讓客戶自己修改。

3. PE工具腳本語法介紹

在安裝完以上軟件后，下一步就可以開始去編寫自動化燒錄的控制腳本程序了，在此之前還是需要了解下P&E工具腳本語法，本章節(jié)期望對關鍵信息點能夠簡明扼要的進行介紹，需要進一步擴展應用的可以參考PROGXXX_User_Manual。

P&E常用的調試工具包括Umultilink、Cyclone等, 但其腳本語法總體類似，如下以DSC內核的MWCT1003為例做一介紹，其語法格式如下：

CPROGDSC[?][filename][/PARAMn=s][v][reset_delayn][bdm_speedn][hideapp][Interface=x][port=y][showports][-usebyteaddr][/logfilelogfilename]示例:
CPROGDSC:ENGINE.CFGINTERFACE=USBMULTILINKPORT=PE5650030//燒錄DSC內核器件
CPROGARM:ENGINE.CFGINTERFACE=USBMULTILINKPORT=PE5650030//燒錄ARM內核器件

可以看到其包含很多參數(shù)，對應每個參數(shù)的含義如下：

[filename]-- 包含編程命令的配置腳本；default = prog.cfg，一個簡單的配置腳本的寫法如下。該腳本對于以前使用過999美刀的Cyclone或者Cyclone FX的用戶或許不會陌生，其和Cyclone GUI配置界面的操作步驟完全一樣。

[/PARAMn=s]-- 指定命令行參數(shù)，用于替代可執(zhí)行腳本.CFG中的特殊標號，譬如說芯片的型號，S19文件的位置，以及.CFG腳本中需要執(zhí)行的BM(Blank Check)/EM(Erase Flash)/VM(Verify)等步驟；

[v]-- 指示編程器在programming 或者verify之前不需要檢查S19文件的地址范圍，這個選項可以加快用戶編程速度，該選項不建議打開；

[reset_delay n]-- 指定在Reset MCU后多長時間去查看芯片是否進入background debug，單位是ms。這個參數(shù)主要是用在外部有類似UM803/UM805等的延時復位芯片的場合，編程器需要等待這些延時復位芯片完全釋放才能嘗試去編程，否則會出錯；

[bdm_speed n]-- 指定BDM shift clock speed速度, 計算公式: USB Multilink (includes Universal): (1000000/(N+1)) Hz

[INTERFACE=x]-- X 可以是USBMULTILINK/CYCLONE/PARALLEL 三個參數(shù)中的一個，其中PARALLEL 并口下載很陳舊，很少再用到，對于本文來說UMULTILINK 就選擇USBMULTILINK;

[PORT=y]-- y代表USBx，此處的x =1，2，3... 主要用于同時連接Cyclone, Tracelink, 或者 Multilink的場景，如果只連接其中一種硬件，就只有USB1。舉例來說，如果PC端只連接一種debug硬件，配置可以是: INTERFACE=USBMULTILINK PORT=USB1

[showports]-- 用于顯示PC端已連接的Debug端口，會保存在ports.txt并存儲在CPROG文件目錄中;

[?]-- 用于暫停命令行執(zhí)行，并顯示編程結果，使用時需要把該選項作為第一個參數(shù);

[hideapp]-- 指定是否顯示命令行窗口，通常在調試階段建議打開，方便查看錯誤信息，量產時無需打開；

[-usebyteaddr]-- 指定S19文件時字節(jié)對齊還是word對齊，通常默認word對齊方式 ;

[/logfile logfilename]-- 打開log輸出，使能該選項后可以把調試過程中執(zhí)行的命令以及錯誤信息全部打印到名稱為logfilename的文件中，方便分析改進；

4. 操作實例

通過腳本命令控制Umultilink作為量產工具在實現(xiàn)上有兩種思路：一種是把所有對芯片的Selection、Reset、Flash algorithm selection、erase、blank check、待燒錄S19文件的選擇都手動添加到.CFG腳本中，另外一種是使用一套通用的帶默認參數(shù)的.CFG腳本，然后在執(zhí)行命令時傳入?yún)?shù)。

顯然第二種方式更加靈活，用戶可以直接在命令行中靈活替換通用腳本中的參數(shù)，從而支持更多的芯片型號，選擇燒寫算法以及指定燒錄文件位置，避免重復造輪子的工作。除此之外，第一種方式還一個缺點是CFG腳本中只支持絕對路徑，不支持相對路徑，更換電腦或者目錄都可能導致原有的配置無法工作，所以第二種方法是比較建議的，下文就以第二種方法進行講解。

4.1 通用腳本的寫法

:DEVICE /PARAM1;Select target device to program
RE ;Reset the MCU
CM /PARAM2;Choose Flash Module
EM ;Erase the module
BM ;Blank Check the module
SS /PARAM3 ;Specify the S19 to use
PM ;Program the module with the S19
/PARAM4 ;Verify the module again

4.2 命令行的寫法

一個完整的示例如下，具體每個參數(shù)的含義可以參考上面的表述，只能說”很顯然“()

C:PEMICROCPROGDSC INTERFACE=CYCLONE PORT=USB1 BDM_SPEED 1 C:PROJECTGENERIC.CFG /PARAM1=MWCT1013A /PARAM2=C:PEMICROfreescale_mwct1013a_1x16x144k_all.dsp “/PARAM3=C:PEMICROEXAMPLE FILESTEST.S19” /PARAM4=VM

Note：1. 以上整個command是連續(xù)的，每個參數(shù)之間只有空格，不能有行break; 2. 如果其中參數(shù)有空格，需要引號引起來，例如 “/PARAM3=C:PEMICROEXAMPLE FILESTEST.S19"

4.3 批處理文件的寫法

對于產線來說，如果每次敲入命令行是比較繁瑣的，所以可以保存成.bat批處理文件，這樣就可以被產線自動化測試的FCT站直接調用，悄無聲息的完成燒錄和驗證的流程。

如下批處理文件的寫法，其中errorlevel是USBMULTILINK的返回值，用于判斷命令行是否正確執(zhí)行；

C:PEMicroPROGDSCcprogdsc.exe INTERFACE=USBMULTILINK PORT=USB1 D:YU_CustomerXXXGENERIC.CFG /PARAM1=MWCT1013A /PARAM2=C:PEMicroPROGDSCAlgorithmsfreescale_mwct1013a_1x16x144k_all.dsp /PARAM3=D:YU_CustomerXXXTEST.elf.S /PARAM4=VMif errorlevel 1 goto bad
goto good
:bad
ECHO BAD BAD BAD BAD BAD BAD BAD BAD
ECHO %errorlevel%
:good
ECHO done
pause

完成以上步驟后，在電腦端可以直接執(zhí)行雙擊第三步的.bat文件即可實現(xiàn)對目標板的燒錄，整個過程都是在后臺自動執(zhí)行的(前提是在命令行中配置了hideapp選項)，可以很方便的集成到自動化生產線的FCT站中。當然，考慮到程序燒錄的健壯性，建議額外加入一些錯誤處理機制，如4.3章節(jié)中的批處理文件，就會對errorlevel返回值進行判斷。如下是上面腳本出錯時的執(zhí)行結果(沒有使能hideapp選項)，可以看到會有出錯的提示信息。

5. 總結：

上文講解了Multilink作為量產工具所需要做的準備工作，支持的器件，P&E工具腳本語法，并結合一個具體實例介紹了通用腳本的寫法、命令行的寫法以及批處理文件的寫法，方便有需要的用戶以Multilink作為量產工具，實現(xiàn)低成本的量產工具。除去離線燒錄和加密存儲之外，Cyclone能實現(xiàn)的基本功能U-Multilink大都能夠實現(xiàn)，真正的實現(xiàn)低成本。當然，如果不差錢，Cyclone還是優(yōu)先推薦，畢竟其支持加密文件存儲這點還是很強大的，可以把binary文件生成加密的SAP格式，防止知識產權被非法竊取。

原文標題：如何巧用U-Multilink作為量產工具最高立省800刀

文章出處：【微信公眾號：痞子衡嵌入式】歡迎添加關注！文章轉載請注明出處。