PEmicro CPROG16Z 閃存編程軟件用戶指南

內容隱藏

1 PEmicro CPROG16Z 快閃記憶體程式設計軟體

2 產品資訊

PEmicro CPROG16Z 快閃記憶體程式設計軟體

產品資訊

CPROG16Z 是一款命令列程式設計器，旨在將您的 PC 連接到目標 MCU 進行程式設計。它配有調試帶狀電纜，用於連接 PC 和目標 MCU 之間的硬體介面。可以透過從 Windows 命令提示字元執行程式設計軟體或使用正確的命令列參數呼叫 CPROG16Z 可執行檔來啟動程式設計軟體。允許的命令列參數包括：[?/!]、[filename], [/PARAMn=s], [v], [reset_delay n], [bdm_speed n], [hideapp], [freq n], [Interface=x], [port=y], [showports], and [/紀錄file 紀錄file姓名]。這些參數可以透過替換特殊參數來修改執行腳本 tags，替換腳本的任何部分，包括編程命令， file名稱和參數，並提供顯示程式設計結果的方法。 INTERFACE=x 參數可讓您選擇以下介面之一：USB MULTILINK、PARALLEL、乙太網路 IP 位址、NAME 和 UNIQUEID。 PORT=y 參數可讓您根據所選介面類型選擇連接埠號碼或名稱。

產品使用說明

透過調試帶狀電纜連接 PC 和目標 MCU 之間的硬體介面。
透過從 Windows 命令提示字元執行程式設計軟體或使用正確的命令列參數呼叫 CPROG16Z 可執行檔來啟動程式設計軟體。

使用允許的命令列參數修改執行腳本並選擇適當的介面和連接埠號碼或名稱。
如果需要，使用[?/!]參數在PROG16Z視窗中顯示程式設計結果。

請參閱第 7 節 – Examp文件編程腳本 File 對於前任amp一個 file 包含程式命令和註解。
請參閱第 8 節 – 在腳本中使用命令列參數以了解更多信息amp有關如何使用 [/PARAMn=s] 命令列參數修改執行腳本的檔案。

如果多個裝置連接到同一台 PC，請使用 [showports] 參數根據連接埠號碼或名稱選擇適當的裝置。

介紹

CPROG16Z 是 PROG16Z 軟體的 Windows 命令列版本，可透過 PEmicro 硬體介面對支援的 NXP 68HC16 處理器的快閃記憶體、EEPROM、EPROM 等進行程式設計。硬體介面可從 PEmicro 取得。一旦您的 PC 和目標裝置之間的介面硬體正確連接，您就可以從命令列啟動 CPROG16Z 執行檔。除了可執行檔之外，還必須傳遞多個命令列參數，以便配置 CPROG16Z 應嘗試連接的 PEmicro 硬體接口，以及配置該硬體接口如何連接到目標設備。這些參數包括組態名稱 (.CFG) file，以及啟動命令，例如硬體介面的名稱或介面所連接的連接埠。 .CFG file 指定如何根據需要對目標進行編程，它包括標準編程命令和可選的配置命令。後續章節將對這些命令和參數進行詳細解釋。

啟動

透過調試帶狀電纜連接 PC 和目標 MCU 之間的硬體介面。
透過從 Windows 命令提示字元執行程式設計軟體或使用正確的命令列參數呼叫 CPROG16Z 可執行檔來啟動程式設計軟體。允許的命令列參數有：

CPROG16Z [?/!] [file名稱] [/PARAMn=s] [v] [reset_delay n] [bdm_speed n] [hideapp] [freq n] [Interface=x] [port=y] [showports] [/logfile 紀錄file姓名] 在哪裡：

[？使用 '？或' '！ '字元選項可讓命令列程式設計器等待並在 PROG16Z 視窗中顯示程式設計結果。 '？將始終顯示結果，'！ '僅當發生錯誤時才會顯示結果。如果使用者不使用批次處理 file 為了測試錯誤級別，這提供了一種顯示程式設計結果的方法。該選項應該是第一個命令列選項。

[file姓名]： A file 包含編程命令和註釋，默認 = prog.cfg。參見第 7 節 – Examp文件編程腳本 File 對於前任amp勒。
[/PARAMn=s]： 命令列參數，可以透過取代特殊參數來修改執行腳本 tags (/PARAMn)。這可以用來替換腳本的任何部分，包括編程命令， file名稱和參數。 n 的有效值為 0..9。 s 是一個字串，將替換腳本中出現的任何 /PARAMn file。第 8 節 – 在腳本中使用命令列參數有一個 examp樂供使用。

[介面=x]： 其中 x 是以下之一：（參見前ampUSB MULTILINK（此設定也支援 OSBDM） PARALLEL（並行連接埠或 BDM Lightning [Legacy]）
[連接埠=y]： 其中 y 的值是以下之一（請參閱 show ports 命令列參數以取得已連接硬體的清單；請務必指定「介面」類型）：

USBx： 其中 x = 1,2,3、4、1 或 1。如果僅連接一個硬件，它將始終枚舉為 USBXNUMX。前任amp選擇找到的第一個 Multilink 的文件是：INTERFACE=USBMULTILINK PORT=USB1
#.#.#.#: 乙太網路 IP 位址#.#.#.#。每個 # 符號代表 0 到 255 之間的十進位數。透過乙太網路連接。介面=旋風端口=10.0.1.223

姓名： 某些產品（例如 Cyclone 和 Trace link）支援為裝置指派名稱，例如「Joe's Max」。旋風分離器可以透過其指定的名稱來引用。如果名稱中有任何空格，則整個參數應括在雙引號中（這是 Windows 要求，而不是 PEmicro 要求）。
- Examp萊斯： 介面=CYCLONE 埠=MyCyclone99 介面=CYCLONE“埠=喬的旋風”

獨特的： ID USB Multilink 產品均指派唯一的序號，例如 PE5650030。 Multilink可以被稱為這個數字。這在多個裝置連接到同一台 PC 的情況下非常有用。
- Examp萊斯： 接口=USBMULTILINK 端口=PE5650030

串口： 其中 x = 1,2,3、4、1 或 1。對 Cyclone 介面有效。要連接到 COMXNUMX 上的 Cyclone： INTERFACE=CYCLONE PORT=COMXNUMX
x: 其中 x = 1,2,3、4、1 或 1。

PCIx： 其中 x = 1,2,3、4、1 或 1。（注意：這是舊產品）要在 BDM Lightning #XNUMX 上選擇並行電纜：INTERFACE=PARALLEL PORT=PCIXNUMX
[表演節目]： 命令行程序員將所有可用端口輸出到文本 file 然後終止（無論其他命令列參數如何）。此資訊輸出到文字中 file 包括聯繫所附程式硬體所需的參數以及硬體介面的描述。預設輸出 file名稱為 ports.txt，並在與 CPROG 相同的資料夾中建立。輸出也可以定向到不同的 file.
- Examp樂： SHOWPORTS=C:\MYPORTS.TXT 此清單不會顯示也可用的平行連接埠或 COM 連接埠選項。下面是前任amp連接到 PC 的各種硬體介面的輸出檔案（請注意，對同一單元進行尋址有不同的方法；每個介面的資料後面可能跟著一個 [DUPLICATE] 行，該行顯示同一介面的不同標籤）。

Showports 輸出 Examp樂：
接口=USBMULTILINK 端口=PE5650030

USB1： 多鏈路通用 FX 修訂版 A (PE5650030)[連接埠號碼=21] 介面=USBMULTILINK 連接埠=USB1
USB1： 多鏈路通用 FX 修訂版 A (PE5650030)[PortNum=21][重複]

[v]： 導致編程器在編程或驗證之前不檢查S記錄位址的範圍。這加快了編程過程。應謹慎使用該選項，因為所有超出範圍的 s 記錄都將被忽略。
[重置延遲 n]：指定程式設計師重設目標後的延遲，我們檢查該目標是否已正確進入後台偵錯模式。如果目標具有重設驅動器，則該驅動器會在編程器釋放重設線後使 MCU 保持重設狀態，則這非常有用。 n 值是以毫秒為單位的延遲。
[bdm_速度 n]： 此選項可讓使用者設定 PEmicro 偵錯介面的 BDM 移位時脈速度。此整數值可用於根據以下等式確定通訊速度：
- USB-ML-16/32： (1000000/(N+1)) Hz – 舊產品
- USB 多鏈路通用 FX： (25000000/(N+1)) Hz BDM Lightning : (33000000/(2*N+5)) Hz – 舊產品 n 值應在 0 到 31 之間。，以便這些命令可以增加目標頻率並允許更快的移位時脈。此時脈通常不能超過處理器匯流排頻率的 4 格。
[隱藏應用程式]： 這將導致命令行程序員在運行時不顯示視覺存在，但出現在任務欄上除外。僅限 32 位應用程序！
[頻率n]： 預設情況下，PROG16Z 軟體會嘗試透過在處理器中載入延遲例程並計時執行所需的時間來自動確定目標的運行速度。在某些機器上，這可能會產生不一致的結果，這可能會影響 MCU 內部快閃記憶體進行程式設計的演算法。 PEmicro 提供了一個命令列機制，讓使用者告知 PROG16Z 軟體目標處理器的運作速度到底有多快。這樣，演算法中的計時就會很精確。在命令列上，您可以在「FREQ」識別碼後面指定內部時脈頻率（以赫茲為單位）。請注意，一般來說，如果您使用 MCU 外部的快閃記憶體設備，則不需要此時序參數，因為快閃記憶體會自行處理時序。
[/日誌file 紀錄file姓名]： 此選項打開一個日誌 file 名稱“日誌file name”，這將導致寫入狀態視窗的任何資訊也寫入此 file. “日誌 filename」應該是完整路徑名，例如 c:\mydir\mysubdir\mylog.log.

命令行執行器amp萊斯：
CPROG16Z C:\ENGINE.CFG 介面=USBMULTILINK 連接埠=PE5650030

使用下列選項開啟 CPROG16Z：

運行C：\ENGINE.CFG 腳本
此介面是第一個 USB Multilink Universal FX，序號為 PE5650030
自動偵測通訊頻率（io_delay_cnt 未設定） CPROG16Z C:\ENGINE.CFG Interface=USBMULTILINK Port=USB1

使用下列選項開啟 CPROG16Z：

運行C：\ENGINE.CFG 腳本
此介面是 USB Multilink Universal FX，是偵測到的第一個介面。

編程命令
編程指令均以兩個字元序列開頭，後面跟著空格（空格或製表符）。以非命令字元開頭的行被列為 REMarks。期限 filename 表示一個完整的 DOS 路徑 file。命令使用與互動式編程器 PROG16Z 中使用的相同的兩個字母代碼。同.16P filePROG16Z 使用的 s 用於設定要編程的特定設備。如果為特定裝置指定了使用者功能，則其兩個字元指令和意義或 user_par 在 .16P 中指定 file.

筆記： 指令參數starting_addr、ending_addr、base_addr、byte、word 和user_par 使用預設的十六進位格式。
BM： 空白支票模組。

BR 起始位址結束位址： 空白檢查範圍。
更改 n.nn： （僅限旋風分離器）更改體積tage 提供給目標，其中 n.nn 表示 0.00 到 5.00 之間的值（含 XNUMX 和 XNUMX）。當命令執行時，Cyclone 將立即變更為該磁碟區tage. 如果在調用此命令之前 Cyclone 繼電器關閉，則繼電器將打開並設置新的音量tag執行該指令時的e值。請注意，卷太低tag該值可能會使設備進入低功耗模式，從而完全失去調試通訊。確保 Cyclone 的跳線設定正確，以將電源供應器傳送到正確的連接埠。
EB 起始位址結束位址： 擦除位元組範圍。

EW 起始位址結束位址： 刪除單字範圍。
EM – 擦除模組。
PB 起始位址位元組 … 位元組 – 程式位元組。

PW 起始位址字 … 字 – 程序的話。
下午 – 程式模組。
CM file名稱base_addr – 選擇模組.16P file. 注意：某些模塊可能需要指定基址。

虛擬機器 – 驗證模組。
VR 起始位址結束位址 – 驗證範圍。
UM file姓名 - 上傳模組。

UR 起始地址結束地址 file姓名 - 上傳範圍。
SS file姓名 - 指定S記錄。 SMstarting_addrending_addr – 顯示模組。
繼電器關閉 – （僅限 Multilink FX 和 Cyclone）關閉為目標提供電源的繼電器，包括斷電延遲（如果指定）。對於想要在運行測試之前重新啟動主機板、允許引導程式運行或在編程後運行應用程式程式碼的用戶特別有用。

繼電器 – （僅限 Multilink FX 和 Cyclone）開啟繼電器向目標供電，包括加電延遲（如果指定）。卷tag提供的內容將基於最後一卷tage 指定的設置。對於 Cyclone 用戶，CHANGEV 命令可以改變 voltage 值。對於想要在運行測試之前重新啟動主機板、允許引導程式運行或在編程後運行應用程式程式碼的用戶特別有用。
他 - 幫助（查看 cprog.doc file).
曲 – 辭職。

關於 - 復位晶片。
去 - 開始設備運作。如果您希望設備運行進行測試，可以用作最終命令。前面應緊接一個“RE”指令。
DE 時間（單位：ms） – 延遲“timeinms”毫秒

xx 使用者_par – 僅適用於 .16P 中指定的使用者功能 file.

啟動配置命令

配置命令全部在程序員嘗試聯繫目標之前處理。整體配置 file 在嘗試通信之前針對這些命令進行解析。本節給出一個結束view 使用這些配置命令進行不同類型的配置。
筆記： 配置命令參數的預設基數是十進制。一個結束view 配置命令如下：
自訂修剪參考 nnnnnnnn.nn
“PT; 所需的內部參考時脈頻率”編程修剪”命令。此頻率覆蓋預設的內部參考時脈頻率。「n」的有效值取決於正在編程的特定裝置。請參閱設備的電氣規格，以了解有效的內部參考頻率時脈範圍。
在哪裡： nnnnnnnn.nn：以赫茲為單位的頻率，保留兩位小數

提供動力
確定接口是否應為目標供電。注意：並非所有硬件接口都支持此命令。 n 的有效值為：

0 : 接口不向目標提供電源。 (預設)
1 : 啟用介面為目標提供電源。
- （筆記： 與舊選項相同：USEPRORELAYS n)

:掉電延遲 n
為使目標電源降至 0.1v 以下而關閉目標電源時延遲的時間量。 n 是以毫秒為單位的時間。
:POWERUPDELAY n
從目標電源打開或目標重置到軟件嘗試與目標對話之前的延遲時間。該時間可以是加電時間和復位時間的組合（尤其是在使用複位驅動器的情況下）。 n 是以毫秒為單位的時間。
:POWEROFFONE 退出 n
確定當 CPROG16Z 應用程式終止時是否應關閉提供給目標的電源。注意：並非所有硬體介面都支援此命令。 n 的有效值為：

0 : 退出時關閉電源（預設）
1 : 退出時保持電源開啟

驗證結束view

有多種命令可用於在編程後驗證裝置上閃存的內容。最廣泛使用的指令是「VC ;驗證物件的CRC File 到模組」。「VC」指令將指示 CPROG16Z 首先從所選物件計算 16 位元 CRC 值 file。然後，CPROG16Z 將程式碼載入到裝置的 RAM 中，並指示器件根據裝置 FLASH 中的內容計算 16 位元 CRC 值。僅物件中的有效位址範圍 file 在設備上計算。一旦來自對象的 16 位 CRC 值 file 並且該裝置可用，CPROG16Z 對其進行比較。如果兩個值不匹配，則會引發錯誤。或者，「VM ;Verify Module」指令可用於在所選物件之間執行逐位元組驗證 file 和設備。通常，VM 指令比 VC 指令需要更長的時間來執行，因為 CPROG16Z 必須逐位元組讀取裝置快閃記憶體的內容。還有另外兩個命令可用於驗證。「SC ;Show Module CRC」指示 CPROG16Z 將程式碼載入到裝置的 RAM 中，並指示器件從裝置的整個 FLASH（包括空白區域）的內容計算 16 位元 CRC 值。一旦計算出 16 位元 CRC 值，CPROG16Z 將在狀態視窗中顯示該值。 “VV；驗證模組 CRC 到值”指令與“SC”指令類似。不同之處在於，CPROG16Z 不會顯示計算出的 16 位元 CRC 值，而是將計算出的值與使用者給出的 16 位元 CRC 值進行比較。

DOS 錯誤返回
提供 DOS 錯誤返回，因此可以在 .BAT 中測試它們 files。錯誤代碼
使用的是：

0 – 程序完成且沒有錯誤。

1 – 被用戶取消。
2 – 讀取 S 記錄時出錯 file.
3 – 驗證錯誤。

4 – 確認被用戶取消。
5 – S 記錄 file 未選擇。
6 – 起始位址不在模組中

7 – 結束地址不在模塊中或小於起始地址。
8 – 無法打開 file 用於上傳。
9 – File 上傳時寫入錯誤。

10 – 上傳被用戶取消。
11 – 開啟 .16P 時發生錯誤 file.
12 – 讀取 .16P 時發生錯誤 file.

13 – 設備未初始化。
14 – 載入 .16P 時發生錯誤 file.
15 – 錯誤啟用剛剛選擇的模塊。

16 – 指定的 S 記錄 file 未找到。
17 – .16P 指定的緩衝區空間不足以容納 file S-記錄。
18 – 編程時出錯。

19 – 起始地址未指向模塊。
20 – 最後一個字節編程時出錯。
21 – 模塊中不再有編程地址。

22 – 起始地址不在對齊的字邊界上。
23 – 最後一個字編程時出錯。
24 – 無法擦除模塊。

25 – 模塊字未擦除。
26 – 精選 .16P file 不執行字節檢查。
27 – 模塊字節未擦除。

28 – 字擦除起始地址必須是偶數。
29 – 字擦除結束地址必須是偶數。
30 – 用戶參數不在範圍內。

31 – .16P 指定功能期間發生錯誤。
32 – 指定的端口不可用或打開端口時出錯。
33 – 命令對此 .16P 無效 file.

34 – 無法進入後台模式。檢查連接。
35 – 無法訪問處理器。嘗試軟件重置。
36 – 無效 .16P file.

37 – 無法訪問處理器 RAM。嘗試軟件重置。
38 – 初始化被用戶取消。
39 – 轉換十六進制命令編號時出錯。

40 – 設置 file 未指定和 file prog.cfg 不存在。
41 – .16P file 不存在。
42 – 命令列上的 io_delay 編號錯誤。

43 – 無效的命令行參數。
44 – 指定以毫秒為單位的十進制延遲時出錯。
47 – 腳本錯誤 file.

49 – 未檢測到電纜
50 – S-唱片 file 不包含有效數據。
51 – 校驗和驗證失敗 – S 記錄數據與 MCU 內存不匹配。

52 – 必須啟用排序以驗證閃存校驗和。
53 – S-Records 不在模塊範圍內。（見“v”命令行參數）
54 – 在端口/接口的命令行設置中檢測到錯誤

60 – 計算設備 CRC 值時出錯
61 – 錯誤 – 設備 CRC 與給定的值不匹配
70 – 錯誤 – CPROG 已經在運行

71 – 錯誤 – 必須在命令行上同時指定接口和端口
72 – 當前硬件接口不支持選定的目標處理器。

Examp文件編程腳本 File

編程腳本 file 應該是純 ASCII file 每行一個命令。這是CFG file 在前任amp萊斯。
前任amp是：

CM C：\PEMICRO\9X1__32K.16P 0 ;選擇快閃記憶體模組
EM； 擦除模組
骨髓； 空白檢查模組

SSC：\PEMICRO\TEST.S19 ;指定要使用的S19
下午; 使用 S19 對模組進行編程
虛擬機； 再次驗證模組

筆記： 的路徑名稱 file也可以使用與 CPROG 可執行文件相關的文件。

在腳本中使用命令行參數

/PARAMn=s 形式的命令列參數可用來將文字插入腳本中 file 代替特殊 tags。這可以用來替換腳本的任何部分，包括編程命令， file名稱和參數。 n 的有效值為 0..9。 s 是一個字串，它將替換腳本中出現的任何 /PARAMn file. 作為前任ample，以下通用腳本可用於與 ex 具有完全相同功能的編程amp第 7 節中的 le 腳本 – Example
編程腳本 File:

CM/參數1；選擇快閃記憶體模組
EM；擦除模組
骨髓；空白檢查模組

SS/參數2； 指定要使用的 S19
下午;使用 S19 對模組進行編程
/參數3； 再次驗證模組

以下參數將添加到 CPROG 命令行：
“/PARAM1=C:\PEMICRO\9X1__32K.16P 0″
/PARAM2=C:\PEMICRO\TEST.S19
/PARAM3=虛擬機
筆記： 由於 /PARAM1 參數的值中有空格，因此整個參數需要用雙引號引起來。這向 Windows 表明它是單一參數。在本例中，腳本中的 Choose Module 行中包含基址 0x0，因此必須在命令列上指定 /PARAM1，如下所示：
“/PARAM1=C:\PEMICRO\9X1__32K.16P 0″
所以完整的前任amp命令行將是（注意這是連續的；沒有換行符）：
C:\PEMICRO\CPROG16Z 介面=CYCLONE 連接埠=USB1 BDM_SPEED 1
C:\PROJECT\GENERIC.CFG “/PARAM1=C:\PEMICRO\9X1__32K.16P 0″ /PARAM2=C:\PEMICRO\TEST.S19 /PARAM3=VM

Samp批次 File

這是一個前任amp調用命令行編程器並測試其錯誤代碼的文件以簡單的批處理方式返回 file。 Samp樂批次 files 適用於 Windows 95/98/XP 和 Windows 2000/NT/XP/Vista/7/8/10。
Windows NT/2000/Vista/7/8/10：

C:\PROJECT\CPROG16Z C:\PROJECT\ENGINE.CFG INTERFACE=USBMULTILINK PORT=USB1 若錯誤等級 1 轉為壞轉為好

壞的： ECHO 壞壞壞壞壞壞壞壞壞
好的： 迴聲完成
視窗 95/98/ME/XP: START /WC:\PROJECT\CPROG16Z C:\PROJECT\ENGINE.CFG INTERFACE=USBMULTILINK PORT=USB1 若錯誤等級 1 轉為壞轉為好

壞的： ECHO 壞壞壞壞壞壞壞壞壞
好的： 迴聲完成

筆記： 的路徑名稱 file也可以使用與 CPROG 可執行文件相關的文件。

資訊

有關 CPROG16Z 和 PROG16Z 的更多信息，請聯絡我們：

P&E 微型電腦系統公司 嗓音： 617-923-0053
98 蓋倫街傳真： 617-923-0808
馬薩諸塞州沃特敦 02472-4502 WEB: http://www.pemicro.com.
美國：

到 view 我們整個 .16P 模組庫，請造訪 PEmicro 的支援頁面 web站點位於 www.pemicro.com/support.

文件/資源

PEmicro CPROG16Z 快閃記憶體程式設計軟體 [pdf] 使用者指南
CPROG16Z 快閃記憶體程式設計軟體, CPROG16Z, 快閃記憶體程式設計軟體, 程式設計軟體, 軟體

參考

使用者手冊