重要的#pragma声明

原文出处：龙丘推荐必读基础知识： 重要的#pragma声明
http://www.znczz.com/thread-21542-1-1.html

 

重要的#pragma声明
#pragma声明是基于单片机开发的特点而对标准C语法的一个扩充。它对充分利用单片机内各类有限的资源起到不可或缺的关键作用。下面简单介绍几个最常用的#pragma声明。

1 #pragma DATA_SEG
定义变量所处的数据段。其语法型式为：
#pragma DATA_SEG <属性> 名称
数据段名称可以自己任意命名，但习惯上有些约定的名称，其作用分别为：
 DEFAULT － 缺省的数据段，在08 系列单片机中的地址为0x100 以上。一般的变量定义可以放在这一区域。
 MY_ZEROPAGE － 特指第0页数据段，地址范围0x00-0xff，但实际用户可用的空间不到256 字节，因为前面的一些地址空间已经分配给了片内寄存器。需要频繁或快速存取的变量应该指定放在这一特殊区域，特别是位变量。
数据段名称必须和prm 文件中的数据段配置说明相关连才能真正发挥其定位作用。如果你自己命名的数据段在prm 文件中没有特别说明，那此数据段的性质等同于“DEFAULT”。
数据段的“属性”可以缺省，它主要的目的是告诉编译器此段数据可适用的寻址模式。不同的寻址模式所花的指令数量和运行时间都不同。对于08 系列单片机，关键的是第0页数据段可以用8位地址进行直接快速寻址，故对应此数据段应尽量指明其属性为“__SHORT_SEG”。对于一般数据段没有属性描述，其缺省是

“__FAR_SEG”，将用16位地址间接寻址。

举几个数据段定义的例子加以进一步说明。

#pragma DATA_SEG __SHORT_SEG MY_ZEROPAGE //开始0 页数据定义

volatile struct {

unsigned powerOn : 1;

unsigned alarmOn : 1;

unsigned commActive : 1;

unsigned sysError : 1;

} myFlag;

volatile word msCounter;

byte i,j,k;

#pragma DATA_SEG DEFAULT //开始普通数据段定义（结束0 页数据段）byte
tmpBuff[16];


2 #pragma CONST_SEG

定义一个常数数据段，必须和变量的const修饰关键词配合使用。其语法型式为：

#pragma CONST_SEG 名称

该数据段下定义的所有数据将被放置在程序只读的ROM 区，也就是08 系列单片机内的Flash
程序空间区。常数段名称可以用户自由定义，但一般都用“DEFAULT”，让连接器按可用的ROM区域自由分配变量位置。举例如下：

#pragma CONST_SEG DEFAULT

const byte prjName[]=”This is a demo”;

FSL 系列单片机开发及C语言编程简介

const word version = 0x0301;

#pragma CONST_SEG DEFAULT

word version = 0x0301; //没有const 该变量将被放置在RAM 区！

#pragma DATA_SEG DEFAULT

const word version = 0x0301; //尽管有const 但该变量将被放置在RAM 区！

3.3.3 #pragma INTO_ROM

功能类似于“CONST_SEG”，和变量修饰词“const”配合使用。但它只定义一个常数变量到ROM区，且只作用于紧接着的下一行定义。例如：

#pragma INTO_ROM

const byte prjName[]=”This is a demo”; //变量将被放置在ROM 区

word verData = 0x0301; //变量将被放置在缺省RAM 区


4 #pragma CODE_SEG

用以定义程序段并赋以特定的段名，语法型式如下：

#pragma CODE_SEG <属性> 名称

一般的程序设计是无需对代码段做特殊处理的。因为所有传统的08 系列单片机其程序空间都不超过64KB（16
位寻址最大范围）且在内存地址中呈线性连续分布。对于项目中所有的代码文件或库文件，连接器会在最后按程序模块出现的先后顺序挨个自动安排所有程序函数在内存中所处的实际位置，用户不必太关心某一个函数的具体位置。但最新推出的几款8
位机程序将超过64KB，这样必须在内存空间中以页面型式映射到首64KB地址范围，其对应的程序段属性要特殊声明。某些特殊的设计需要将不同部分的程序分别定位到不同的地址空间，例如实现程序代码下载自动更新。这样的设计需要把负责应用程序下载更新的驱动代码固定放置在一个保留区域内，而把一般的应用程序放置在另外一个区域以便在需要时整体擦除后更新。这时就需要用“CODE_SEG”来分别指明不同的程序段，但还必须配合prm文件对程序空间进行分配和指派。

代码段的属性一般都用缺省的“__FAR_SEG”，表明所有的函数调用都是长调用（对应汇编指令为JSR）。但C08 和S08
系列单片机支持效率更高的函数短调用（对应汇编指令为BSR），如果你的某一个功能模块含有多个相互调用的小函数且函数调用间距不超过+127
或-128 字节，则可以将这部分代码段声明为短调用属性“__NEAR_SEG”。但实际编程时由于C
代码对应的汇编指令长度不是很容易就能估测得到，所以短调用属性很少使用。

下面以几个实例进一步说明：

//定义缺省的代码段，缺省属性为远调用

#pragma CODE_SEG DEFAULT

void main(void)

FSL 08系列单片机开发及C语言编程简介

{

…

}

//定义名字为FUNC_CODE 的代码段，缺省属性为远调用

#pragma CODE_SEG FUNC_CODE

void MyApp(void)

{

}

//定义远调用的程序段，段名为BOOTLOAD

#pragma CODE_SEG __FAR_SEG BOOTLOAD

void BootLoader(void)

{

}

//定义近调用的程序段，段名为KEYBOARD

#pragma CODE_SEG __NEAR_SEG KEYBOARD

void KeyDebounce(void)

{

…

}

byte KeyCheck(void)

{

…

}

void KeyBoard(void)

{

if (keyCheck()) {

KeyDebounce();

…

}

}


5 #pragma TRAP_PROC

用于定义一个函数为中断服务类型。此类型的函数编译器在将C
代码编译成汇编指令时会在代码前后增加必要的现场保护和恢复汇编代码，同时函数的最后返回用汇编指令“RTI”而不是针对普通函数的“RTS”。例如：

#pragma TRAP_PROC

void SCI1_Int(void) { //定义SCI1的中断服务程序

…

}

注意用“TRAP_PROC”定义的中断服务函数其实际中断矢量地址必须通过prm 文件指派。


6 #pragma MESSAGE

这个声明用以控制编译信息的显示。一般情况下这些编译信息都是有用的，特别是告警和错误信息。但有时我们会按单片机的工作特性编写一些代码，但正常程序编写时这些代码会产生一些告警信息，例如

#pragma MESSAGE DISABLE C4002 //忽略“Result-not-used”告警

//==============================================================

// sci1 1 data receive interrupt service routine

// Assigned for full-duplex communication with Main board

//==============================================================

void interrupt 17 sci11_Receive_ISR(void)

FSL 08系列单片机开发及C语言编程简介

{

SCI1S1; //读一次状态寄存器清除中断标志，会产生C4002 告警

sci1RxFifo[sci1FifoPut] = SCI1D;

sci1FifoPut++;

sci1FifoPut &= (SCI1_RXFIFO_SIZE-1);

}

如果你不想每次都看见编译器给出的这一类信息，可以先确认这一信息的编号，然后用“#pragma MESSAGE”加上“DISABLE”
关键词和信息号将它屏蔽。如果你想特别关注某类信息，可以用“ENABLE”让其永远显示出来。