CodeWarrior IDE使用Tips之利用Hiwave讀取S12(X)系列MCU片上NVM命令腳本

內容提要

引言

1. Hiwave調試軟件中的command窗口和save命令介紹

1.1 Hiwave調試軟件中的command窗口介紹

1.2 查看Hiwave命令窗口所支持的命令

1.3 瞭解命令用途和具體使用方法

1.4 save命令詳解

2. 通過CALL命令調用cmd腳本實現NVM讀取

2.1 CMD命令腳本和CALL命令詳解

2.2 讀取S12G128的片上NVM數據

2.3 讀取S12XEP100的片上NVM數據

總結

引言

本公衆號之前的文章(點擊標題即可快速跳轉閱讀)：

S12(X)系列MCU的片上存儲器資源與分頁訪問機制詳解(一) ；

S12(X)系列MCU的片上存儲器資源與分頁訪問機制詳解(二)；

詳細介紹了S12(X)的片上NVM(非易失性存儲器--包括EEPROM/D-Flash和P-Flash)以及RAM資源的分頁訪問機制是具體使用和編程方法。

而在實際工作中，如果遇到ECU功能異常，需要做失效分析(FA-Failure Analysis)時，爲了排除NVM中的程序代碼和數據被意外修改(比如程序跑飛，運行Bootloader中的NVM驅動程序，導致NVM擦除或編程爲非預期值)的因素，我們常常需要在重新下載應用程序或者外設測試程序之前，將失效ECU的MCU的NVM內容讀出(所謂dump out)與下載的原始應用工程編譯結果S19文件或者正常ECU中讀出的內容進行對比；或者時在開發bootloader時，完成APP下載之後，檢查APP通過bootloader下載的完整性和正確性，也需要讀出NVM的內容。

本文針對這一需求，介紹如何利用BDM調試器，在CW5.x IDE自帶的Hwave調試軟件中，通過command命令窗口save命令完成S12(X)系列NVM讀出的方法和步驟，希望對大家有所幫助。

1. Hiwave調試軟件中的command窗口和save命令介紹

CW 5.x IDE自帶的調試軟件Hiwave位於其安裝目錄下的Prog子目錄下，雙擊即可打開：

1.1 Hiwave調試軟件中的command窗口介紹

按照《CodeWarrior IDE使用tips之bug定位絕技--hotsync與attach調試》(點擊標題即可快速跳轉閱讀)介紹的方法鏈接和配置連接好目標MCU之後界面如下圖：

其中：

源代碼窗口(Source)：加載應用工程ABS文件和源代碼之後，可以在該窗口中看到應用程序的C語言源代碼；

函數列表窗口(Procedure)：在該窗口中會列出當前斷點所在的函數及其地址信息；

全局變量窗口(Data1)：在該窗口中會自動列出當前應用工程的所有全局變量，在該窗口中，可以查看全局變量的地址和賦值情況；

局部變量窗口(Data2)：在該窗口中會自動列出當前應用工程的所有局部變量，在該窗口中，可以查看局部變量的地址和賦值情況；

彙編代碼窗口(Assembly)：正常調試時，該窗口將自動顯示與源代碼窗口對應的彙編代碼；

CPU內核寄存器窗口(Register)：該窗口可以查看和修改CPU內核寄存器；

存儲器查看窗口(Memory)：通過在窗口可以查看任意合法的MCU存儲器內容；

command命令窗口(Command)：位於調試界面的右下角，可以在其中輸入命令控制調試過程，比如設置斷點，查看變量等，以及打印輸出命令執行結果和調試log信息；

在command命令窗口的命令提示符in>之後輸入想要執行的命令，然後回車即可執行該命令。

Tips：以上窗口其實都是Hiwave的窗口組件(window component)，可以將其單獨最大化、最小化或者關閉。如果不小心關閉了某一窗口，可以通過菜單Component-->Open..-->在Open Window Component對話框中選擇相應的組件重新打開或者另外打開一個新的組件窗口，如下爲打開command命令窗口的過程：

Tips：通過打開對個窗口組件，比如打開3個memory窗口，可以同時查看本地址地址、邏輯地址和全局地址或者不同存儲器--EEPROM、RAM和P-Flash中的數據變化，從而全面掌握調試信息，功能十分強大，使用也十分方便快捷。但是每一個BDM連接，只能打開一個command窗口；

1.2 查看Hiwave命令窗口所支持的命令

在command窗口中輸入命令help即可查看到所有可在該窗口中執行的命令及其功能介紹：

Tips：command窗口中輸入的命令不區分大小寫，比如命令help，輸入help或者HELP都可以被Hiwave識別：

1.3 瞭解命令用途和具體使用方法

通過Hiwave的菜單Help-->Help Topics-->打開HC(S)S12(X) Debugger 幫助，在其中搜索欄輸入命令作爲關鍵詞，即可查到該命令的使用說明，比如搜索本文要使用的save命令，其結果如下：

1.4 save命令詳解

save命令用於將指定地址範圍的存儲器數據保存(讀出)到指定的S19文件中，其用法如下：

SAVE range fileName [offset][;A]

range：指定要讀出的存儲器地址範圍：在起始地址和結束地址之間用英文輸入法輸入的兩個小數點".."進行區分：<起始地址>..<結束地址>；

fileName ：指定用於保存數據的文件名，可以包含具體路徑或者直接文件名，前者將自動在指定的目錄下創建該文件用於保存存儲器數據，後者由於爲指定保存路徑，所以其默認會在當前工程的project.int所在目錄下創建S19文件：

[offset]：可選選項，用於指定保存到S19文件時是否進行地址偏移，默認爲偏移爲0，即保存時使用的地址與save命令range中指定的地址一致；

[;A]：可選選項，用戶將當前目錄輸出的數據疊加(append)到已有S19文件，比如要將多次save命令導出的不連續地址數據放在同一個S19文件中時，就可以使用這個選項了。

典型應用例子如下：

①：in>SAVE 0x400..0x13FF S12G_EEPROM.s19

作用：將S12G系列MCU位於地址0x400到0x13FF之間的4KB EEPROM數據讀出保存到當前工程目錄下的S12G_EEPROM.s19中；

②：in>save 0x88000..0x8BFFF D:\S12G128_NVM.s19 ;A

作用：將位於地址0x88000到0x8BFFF 之間的16KB S12G128的0x8 的P-Flash分頁數據讀出疊加保存到D:\S12G128_NVM.s19中；

2. 通過CALL命令調用cmd腳本實現NVM讀取

2.1 CMD命令腳本和CALL命令詳解

Hiwave調試軟件支持調用命令腳本文件方式實現多條命令的一次性調用和執行；其目錄腳本文件類似於Window的命令行批處理文件，用戶可以通過新建文本文件(*.txt)然後將其後綴手動修改爲.cmd的方式創建其腳本文件。

使用任意文本編輯器即可打開和編輯器中內容，所有可以在Hiwave調試軟件command窗口中正常執行的命令都可以添加帶.cmd腳本文件中。

通過以下命令CALL即可調用已經創建好的cmd腳本文件。

CALL FileName [;C][;NL]

其中，FileName 爲所要執行得cmd腳本文件，其可以指定具體的cmd保存路徑以執行其他非當然工程目錄下的cmd腳本文件；

CALL 命令的典型用法如下：

CALL D:\S12G128_NVM_Read.cmd

作用：調用並執行保存在D盤根目錄下的S12G128_NVM_Read.cmd腳本文件。

2.2 讀取S12G128的片上NVM數據

S12G128的片上NVM資源如下：

器件(part)	存儲器資源類型	大小	分頁寄存器	分頁窗口地址	分頁號	頁數
S12G128	EEPROM	4KB	-	無	-	-
S12G128	P-Flash	128KB	PPAGE	0x8000~0xBFFF	0x08~0x0F	8