//--------------------------------------------------------------------------
//  Tips.txt
//--------------------------------------------------------------------------

//--------------------------------------------------------------------------
//  修改派生類
//--------------------------------------------------------------------------
   對于已經存在的派生類進行修改,你需要注意以下幾點:

   1.你需要對CodeWarrior工程的設置進行修改:在"Assembler for HC12"和
"Compiler for HC12"控制面板中確定新的CPU將被使用在"Command Line Arguments":
    - HC12:   -CpuHC12
  	- HCS12:  -CpuHCS12
    - HCS12X: -CpuHCS12X

   2.派生類的頭文件和源文件被放置在如下的目錄中:
	- {CodeWarrior}lib\hc12c\include (derivative header files)
  	- {CodeWarrior}lib\hc12c\src (derivative source files)
   同時將新的派生類頭文件和源文件從目錄中加載到類庫中。
   提示: 在文件所在處打開"Windows Explorer":
         找到"Libraries"工程中的派生類頭文件和源文件,通過右擊鼠標并選中
         "Open in Windows Explorer"。

   3.通過工程文件的合適的向導,你也可以對派生類的頭文件和源文件進行移去。從
類庫中移去派生類的頭文件和源文件的方法如下:
         找到"Libraries"工程中的派生類頭文件和源文件,通過右擊鼠標并選中
    "Remove"。
   
   4.你需要對主函數的源文件進行修改。該文件可以在"Sources"文件組中找到。打開
該文件,并對其包含的頭文件進行重命名。如果你所編輯的是一個C/C++文件時,你還需
要在編譯指令"LINK_INFO DERIVATIVE"中更改一個新的派生類。這樣,編譯指令就會告
訴模擬器對哪個派生類進行模擬。當然你也可以刪除該編譯指令,在HI-WAVE調試器中重
新建立一個新的派生類。(請看下一點)
   
   5.同時還需要對PRM文件進行修改。PRM文件在目錄的如下位置:
     - {CodeWarrior}lib\hc12c\prm
     你需要打開新的PRM文件,并且將其中的內容拷貝到你現在所使用的PRM文件中去。
如果你沒有一個堆棧的內存模式,你只能修改PRM文件中的內容。 你可能要看一下已有
的PRM文件的內容。

   6.當編輯和連接成功后,你就能開始使用HI-WAVE調試器。
     你需要為一個新的派生類啟動調試器。
     -對整個芯片的模擬/模擬器連接:
         在菜單選項中選擇"Set Derivative..."對話框,然后在打開的對話框中你可
     以通過路徑"Simulator"->"Set Derivative..."進行操作。同樣的,在打開的對話
     框中你可以選擇新的派生類,文件名可以被使用為編譯指令的"LINK_INFO 
     DERIVATIVE"。
   
     -基于P&E Multilink/Cyclone Pro上的連接:
          在菜單選項中打開"Set Derivative..."對話框,并選擇路徑為"Multilink-
     CyclonePro"->"Set Derivative..."。在打開的對話框中選擇新的派生類。

     -基于SofTec HCS12上的連接:
          在菜單選項中打開"MCU Configuration"對話框,并選擇路徑為"inDART-
     HCS12"->"MCU Configuration"在打開的對話框中選擇新的派生類。
     
     -基于HCS12系列的目標監視器:
          派生類會自動的連接到硬件上。但是,調試器可能仍然顯示一部分,那里對于
     來自同一類型的芯片的選擇很少能被采取。

   7.現在你可以在你的工程中添加一個新的派生類。

//--------------------------------------------------------------------------
//  打開專Processor Expert
//--------------------------------------------------------------------------         
   在工程創建時如果你還沒有決定使用Processor Expert,你也稍后去使用。
但是你必須考慮如下幾點:
   1.Processor Expert支持C和C++工程,但它不支持完全的匯編工程或者是
嵌套的匯編工程。

   2.Processor Expert并不支持所有的派生類。

   3.為了打開Processor Expert使用菜單項"Processor Expert->Enable Processor 
     Expert for 文件名"。
 
   4.有一個對話框來詢問你是否想要打開工程的Processor Expert:點擊"Yes"

   5.然后你要為你的工程選擇一塊合適的CPU。選擇的CPU的方法為:在菜單Processor 
Expert->View->Bean Selector,然后在CPU樹中雙擊你想要的CPU,那這塊CPU將加入到
你的工程中。
 
   6.在Processor Expert產生自己的main函數或者源文件的時候，你必須移除由向導
產生的這些文件。移除Sources文件夾下的主文件的方法是:在工程文件夾"Sources"
中選擇主文件右擊鼠標選擇"Remove"。

   7.同樣的應用也用在派生類頭文件中。由于Processor Expert維持自己的版本,你
需要在CodeWarrior工程中移去這些頭文件:在"Libs"工程文件夾中找到.h和.c文件,
選中.h和.c文件,單擊鼠標右鍵,選擇"Delete"將文件刪除。

   8.Processor Expert維持自己的連接器文件.prm。你需要在工程中移去由向導所
建立的連接器文件Prm",單擊鼠標右鍵選擇"Remove"將這些文件刪除。
 
   9.現在你可以按通常的方式建立或編譯你的工程(菜單Project->Make)。

//--------------------------------------------------------------------------
//  改變存儲器模式
//--------------------------------------------------------------------------
   如果你想對已經存在的存儲器模式進行改變,你可以考慮以下幾點:
   1.存儲器模式只是用來控制默認值。在任何存儲器模式下編寫各種應用程序是
可以的,但是存儲器模式的選擇錯誤肯定會造成更多的代碼的修改。
   
   2.大的存儲器模式會比擴展的存儲器模式和小的存儲器模式產生相對多的和使運行
速度下降的代碼。但是如果你在別的模式下不能別寫出你所要的功能,你可以首選這種
模式。
   擴展的存儲器模式和小的存儲器模式的區別不是很有意義。
  
   3.你需要修改CodeWarrior工程的設置:在"Assembler for HC12"和"Compiler for 
HC12"面板上要確保新的存儲器模式能在"Command Line Arguments"上使用:
   - Small memory model:  -ms
   - Banked memory model: -mb
   - Large memory model:  -ml

   4.你需要對標準庫文件進行修改。庫文件所在位置為:
   - {CodeWarrior}lib\hc12c\lib (HC12)
   - {CodeWarrior}lib\xgatec\lib (optional for a XGATE project)

   5.你需要將新的庫文件從目錄中拖到"Libraries"工程文件夾中,至于命名規則請查
找readme.txt文件:
   - {CodeWarrior}lib\hc12c\readme.txt (HC12)
  - {CodeWarrior}lib\xgatec\readme.txt (可以選擇作為一個XGATE工程)

   6.你現在可以從工程中移除由向導產生的舊的庫文件。從"Libraries"中刪除舊的
庫文件的方法如下:在"Libraries"工程文件夾中選擇庫文件右擊鼠標并選擇"Remove"。
  
   7.在prm文件中也要修改其存儲器模式。
     在每個存儲模式中都包含有如何對DEFAULT_ROM, DEFAULT_RAM, NON_PAGED和其他
的默認值進行分配的方法。
     - DEFAULT_ROM:在小的存儲模式中,必須放在未分頁的區域,在擴展的存儲模式和
大的存儲模式可以放到任何一頁。
     - DEFAULT_RAM:在小的存儲模式和擴展的存儲模式中,必須未分頁的RAM區域。
     - STARTUP,STRINGS,ROM_VAR,COPY。在小的存儲模式和擴展的存儲模式中,它們大
多數放在未擴展的Flahs區域中。COPY必須放在最后面。
     - 查看所有剩余的部分是如何使用的,如果不能確定的話,分配為未擴展的。

   8. 現在你可以在新的存儲器模式下建立工程了。

//--------------------------------------------------------------------------
//  添加一個新的連接
//--------------------------------------------------------------------------
   如果你在創建一個工程時忘了添加一個指定的連接方式,你可以在稍后添加。
你可以考慮以下幾點:
   
   1.在你的工程中選擇"Target"標記,并在菜單中選擇"Project"->"Create 
Target..."。在對話框中添加新的連接名稱,并且選擇"Clone existing target",你可
以選擇任何存在的target。

   2.選擇一個新創建的target。我們需要準備好調試器。在菜單中選擇"Project"->
"Set Default Target"來選擇一個已經創建的target。

   3. 如果你要為自己特殊的連接建立一個不同的存儲映射(例如:"Serial Monitor"),
你需要將修改過的prm文件添加到工程中去。同時確保新的.prm文件在所選的target中。
確保新的prm文件在工程窗口中的target欄中已經被指向。最后確保以前存在的prm文件
沒有被指向。

   4.調試器的配置文件(.ini)被定位在"{Project}"目錄下。你需要拷貝一個已存在的
的".ini"文件到相同的路徑。這個配置文件的命名為該連接的名稱。現在你就可以將
.ini文件拖到"Debugger Project File"中去了。

   5.你還需要在"CodeWarrior"的"Arguments"選項中選擇"Build Extras"。將".ini"
文件名字用新文件名字去替換。
    可選項:在選擇項中將"-instance=x"替換成為"-instance=y",此時y就是新的連接。
該實例選擇的目的是為了確認調試器只對這個已確定的連接進行調試。

   6.我們現在可以啟動調試器。你可以按照如下的方法開始啟動。
    在調試器對話框中通過"Component"->"Set Connection..."選擇所需的連接方式。
    
    -對于整個芯片的模擬/模擬器連接:
     選擇處理器為HC12和連接方式為整芯片模擬

    -對于P&E Multilink/Cyclone Pro連接:
     選擇處理器為HC12和連接方式為P&E Multilink/Cyclone Pro

    -對于SofTec HCS12連接:
     選擇處理器為HC12和連接方式為SofTec HCS12

    -對于HCS12連續監控連接:
     選擇處理器為HC12和連接方式為HCS12連續監控

   7.可選項:如果你需要"Command Files",你可以在"{Project}cmd"目錄下創建一個空
文件。在調試器中,你可以通過連接菜單中的"Command Files..."對話框來修改調試器。

   8.你現在已經在工程中建立了一個新的連接。

//--------------------------------------------------------------------------
//  聯系Metrowerks公司
//--------------------------------------------------------------------------
   如果有漏洞的報告，技術問題和建議，請填寫已經安裝在Release_Notes文件夾下
面的表格，并發送到郵箱：cw_support@freescale.com