/***************************************************************************
                        start12.c - 標準的啟動代碼
                 對于某些特殊的用戶請求,這個啟動代碼也許是最優的 


               ----------------------------------------------------
                       版權 (c) Metrowerks, Basel, 瑞士
                                 版權保留

                注意：在啟動代碼中ROM庫沒有執行
                注意：在HIWARE文件格式中，C++全局變量的析構還沒有被支持。
                 為了使用這個特性，請使用ELF文件格式建立你的應用程序。
***************************************************************************/
//lint -esym(750, __NO_FLAGS_OFFSET, __NO_MAIN_OFFSET, 
//           __NO_STACKOFFSET_OFFSET) 
//這個宏移除那些沒有在啟動描述符中使用的域
#define __NO_FLAGS_OFFSET       // 在啟動數據域中我們不需要使用標志域
#define __NO_MAIN_OFFSET        // 在啟動數據域中我們不需要使用主域
#define __NO_STACKOFFSET_OFFSET // 在啟動數據域中我們不需要使用堆棧偏移域

//#define __BANKED_COPY_DOWN : 允許在Flash區域中分配 .copy
#if defined(__BANKED_COPY_DOWN) && (!defined(__HCS12X__) || \
           !defined(__ELF_OBJECT_FILE_FORMAT__))
#error 
//the __BANKED_COPY_DOWN僅被使用ELF文件格式的HCS12X所支持 
//不被HC12，或者使用HIWARE文件格式的HCS12所支持
#endif

#include "hidef.h"
#include "start12.h"

//************************************************************************** 
//下面的宏來控制啟動代碼如何來操作COP:
// #define _DO_FEED_COP_  : 喂 COP
// #define _DO_ENABLE_COP_:啟用 COP
// #define _DO_DISABLE_COP_: 不啟用 COP
//如果沒有上面的宏定義,則該啟動文件沒有對COP進行任何操作
//**************************************************************************
// __ONLY_INIT_SP 定義:
//這個定義為啟動代碼選擇一個更小的版本
//它僅加載堆棧指針,然后直接調用主函數。這個版本不初始化全局變量
//因此這個版本不是ANSI的。
//**************************************************************************
// __FAR_DATA 定義:
//默認情況下，啟動代碼僅初始化默認的內存模式。如果在小的內存模式或者擴展的內
//存模式下，一些內存被分配過遠，當__FAR_DATA被定義時，啟動代碼會初始化這些內
//存塊。當__FAR_DATA沒有被定義時,連接器將要發出一個消息，例如：
//"L1128: Cutting value _Range beg data member from 0xF01000 to 0x1000"
//這個啟動代碼寫入到被剪切的地址中。
//**************************************************************************
//__BANKED_COPY_DOWN 定義:
//默認情況下，啟動代碼使啟動數據結構_startupData，超過區域的零和那些.copy
//選擇區域全部被分配在NON_BANKED內存區域中。
//特別地，如果有許多或者更大的內存區域要初始化的話，.copy選擇區可以被分配
//對HCS12X來說，它能通過.copy區域復制XGATE內存代碼，啟動代碼把.copy分配到
//一個擴展的Flash中。當增加或者移出這個宏時.copy在prm文件中的布局將會改變。
//注意：這個宏僅被使用ELF格式的HCS12X支持。
//**************************************************************************

#ifdef __cplusplus
#define __EXTERN_C  extern "C"
#else
#define __EXTERN_C
#endif

__EXTERN_C void main(void); //主函數原型

#ifndef __ONLY_INIT_SP
#pragma DATA_SEG __NEAR_SEG STARTUP_DATA //_startupData能使用16位尋址
//這個需要因為它包含了堆棧頭，并且沒有堆棧，但遠數據不能被訪問
//lint -e1065
struct _tagStartup _startupData;//只讀:
                                //_startupData被分配在ROM 并且被連接器初始化
//lint +e1065
#pragma DATA_SEG DEFAULT
#endif // __ONLY_INIT_SP

#if defined(FAR_DATA) && (!defined(__HCS12X__) \
            || defined(__BANKED_COPY_DOWN))
#include "non_bank.sgm"
//如果使用了擴展的變量，那么初始函數必須放在非擴展的內存區域中
//因為_SET_PAGE被調用，它可能會改變頁寄存器

//內聯的匯編程序需要一個原型
//這是一個使用特殊調用方法的實時程序，不要在C代碼中使用它
__EXTERN_C void _SET_PAGE(void);  

#else
#include "default.sgm"
#endif // defined(FAR_DATA) && (!defined(__HCS12X__)
       //         || defined(__BANKED_COPY_DOWN))


//為Windef寄存器定義值和位
#ifdef HC812A4
#define WINDEF (*(volatile unsigned char*) 0x37)
#if defined( __BANKED__) || defined(__LARGE__) || defined(__PPAGE__)
#define __ENABLE_PPAGE__ 0x40
#else
#define __ENABLE_PPAGE__ 0x0
#endif
#if defined(__DPAGE__)
#define __ENABLE_DPAGE__ 0x80
#else
#define __ENABLE_DPAGE__ 0x0
#endif
#if defined(__EPAGE__)
#define __ENABLE_EPAGE__ 0x20
#else
#define __ENABLE_EPAGE__ 0x0
#endif
#endif  //HC812A4

#ifdef _HCS12_SERIALMON
//為了支持EB386，需要監視在內存和EEPROM中的基本軟件，
//這是通過編輯內存和EEPROM區域來實現的。
#define ___INITRM      (*(volatile unsigned char *) 0x0010)
#define ___INITRG      (*(volatile unsigned char *) 0x0011)
#define ___INITEE      (*(volatile unsigned char *) 0x0012)
#endif

#if defined(_DO_FEED_COP_)
#define __FEED_COP_IN_HLI()  \
} __asm movb #0x55, _COP_RST_ADR; __asm movb #0xAA, _COP_RST_ADR; __asm {

#else
#define __FEED_COP_IN_HLI() //不做任何操作
#endif

#ifndef __ONLY_INIT_SP
#if (!defined(FAR_DATA) || defined(__HCS12X__)) && (defined( __BANKED__) \
     || defined(__LARGE__) || defined(__BANKED_COPY_DOWN))
static void __far Init(void)
#else
static void Init(void)
#endif
 {
//目的：   1) 數據被分配在zero out RAM-areas
 //        2) 從ROM中復制初始化數據到RAM中
//         3) 在C++中調用全局構造函數
//調用者：_Startup, LibInits
   
   __asm {
ZeroOut:
#if defined(__HIWARE_OBJECT_FILE_FORMAT__) && defined(__LARGE__)
             LDX   _startupData.pZeroOut:1 //在HIWARE文件格式的大內存模式下,
                                           //pZeroOut是24位指針
#else
             LDX   _startupData.pZeroOut   //*pZeroOut
#endif
             LDY   _startupData.nofZeroOuts //nofZeroOuts
             BEQ   CopyDown                 //如果沒有0，則退出

NextZeroOut: PSHY                           //保存nofZeroOuts
#if defined(FAR_DATA)
             LDAB  1,X+                     //裝載目的地址頁
             LDY   2,X+                     //裝載目的地址偏移地址
#if defined(__HCS12X__)
             STAB  __GPAGE_ADR__
#else //defined(__HCS12X__)
             __PIC_JSR(_SET_PAGE)           //在正確的頁面寄存器中設置頁值
#endif //defined(__HCS12X__)
#else   //FAR_DATA
             LDY   2,X+                     //開始地址 (X = X+4)
#endif  //FAR_DATA

#if defined(__HCS12X__) && defined(FAR_DATA)
             PSHX
             LDX   0,X                      //字節計數
#if defined(__OPTIMIZE_FOR_SIZE__)
             CLRA
NextWord:    GSTAA 1,Y+                     //清內存字節
             __FEED_COP_IN_HLI()            //如果有必要就喂COP
             DBNE  X, NextWord              //字節計數自減
#else
             LDD #0
             LSRX
             BEQ   LoopClrW1                //我們復制了多于一個字節嗎？
NextWord:    GSTD 2,Y+                      //清內存字節
             __FEED_COP_IN_HLI()            //如果有必要就喂COP
             DBNE  X, NextWord              //字節計數自減
LoopClrW1:
             BCC   LastClr                  //處理最后一個字節
             GSTAA 1,Y+											//處理最后一個字節
LastClr:
#endif
             PULX
             LEAX  2,X
#elif defined(__OPTIMIZE_FOR_SIZE__)        //-os, 默認
             LDD   2,X+                     //字節計數
NextWord:    CLR   1,Y+                     //清內存字節
             __FEED_COP_IN_HLI()            //如果有必要就喂COP
             DBNE  D, NextWord              //字節計數自減
#else //__OPTIMIZE_FOR_TIME__
             LDD   2,X+                     //字節計數
             LSRD                           //除以2并且保存位0到標志Carry中
             BEQ   LoopClrW1                //我們復制了多于一個字節嗎？
             PSHX
             LDX   #0
LoopClrW:    STX   2,Y+                     //字清零
             __FEED_COP_IN_HLI()            //如果有必要就喂COP
             DBNE  D, LoopClrW
             PULX
LoopClrW1:
             BCC   LastClr                  //處理最后一個字節
             CLR   1,Y+
LastClr:
#endif //__OPTIMIZE_FOR_SIZE__/__OPTIMIZE_FOR_TIME__
             PULY                           //恢復 nofZeroOuts
             DEY                            //nofZeroOuts自減
             BNE  NextZeroOut
CopyDown:
#if defined(__BANKED_COPY_DOWN)
             LDAA  _startupData.toCopyDownBeg:0 //取得.copy區域的頁地址
             STAA	 __PPAGE_ADR__          // 設置頁地址
             LDX   _startupData.toCopyDownBeg:1 //裝載復制目的地址
#elif defined(__ELF_OBJECT_FILE_FORMAT__)
             LDX   _startupData.toCopyDownBeg //裝載復制目的地址
#else
             LDX   _startupData.toCopyDownBeg:2 //裝載復制目的地址
#endif
NextBlock:
             LDD   2,X+                     //初始數據的大小-> D
             BEQ   funcInits                //目的地址結束
#ifdef FAR_DATA
             PSHD                           //保存計數器
             LDAB  1,X+                     //裝載目的頁
             LDY   2,X+                     //目的地址
#if defined(__HCS12X__)
             STAB  __GPAGE_ADR__
#else  //__HCS12X__
             __PIC_JSR(_SET_PAGE)           //設置目的頁寄存器
#endif //__HCS12X__
             PULD                           //恢復計數器
#else  //FAR_DATA