📄 start12.c
字号:
/***************************************************************************
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
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -