IAR MSP430標頭檔中的一些解釋

今天在閱讀RF_Example_Code_v1.0中標頭檔cc430x613x.h時發現了幾部分的疑問。

首先來看一下cc430x613x.h
中的3個#define的例子：

#define DEFC(name, address) __no_init volatile unsigned char name @ address;

#define DEFW(name, address) __no_init volatile unsigned short name @ address;

#define DEFCW(name, address) __no_init union

{

struct

{

volatile unsigned char name##_L;

volatile unsigned char name##_H;

};

volatile unsigned short name;

} @ address;

前面的兩個#define的用法是一樣的。首先我可以發現，在宏定義裡面都有一個關鍵字__no_init。查看了《MSP430 IAR C/EC++ Compiler Reference Guide》內的IAR Language
Extension Overview 可以發現，__no_init是IAR擴充文法裡面的一個擴充關鍵字。作用是聲明一個non-volatile類型的記憶體位址（Support non-valotile memory）。

於是解決了__no_init的問題。

再者對@這個字元存在一定的疑問，於是上網查了查資料。雖然對於@這個字元的用法還是不是很明確，但是可以明確的是：

#define DEFC(name, address) __no_init volatile unsigned char name @ address;

#define DEFC(name, address) sfrb name = address;

這兩種定義是等價的，但是後者是基於彙編嵌入式編程的情況下才成立。也就是說“=”是MSP430彙編中資料分配偽指令中的一種。我們來看一下MSP430彙編的資料分配偽指令有哪些：

這類指令有以下一些：

SET (VAR, ASSIGN) 賦予一個臨時值；

EQU (=) 在當前模組中賦予一個永久的值；

DEFINE 定義一個整個檔案中都有效值；

sfrb 寄存器類型的位元組；

sfrw 寄存器類型的字。

使用文法如下：

label SET expr

label EQU expr

label = expr

label DEFINE expr

[const] sfrb register = value

[const] sfrw register = value

其中，

label 定義一個標誌符、

expr 標誌符的值、

register 特殊功能寄存器、

value 特殊功能寄存器的值。

在下面的例子中使用了局部變數與全域變數，在模組add1
中定義了符號value ，同樣在

模組add2 中也定義了符號value，但它們表示兩個不同的量，都只在各自的模組內部有效，

這是局部變數。而在模組add1
中定義的locn 則為全域變數，在兩個模組中表示同一個值。

NAME add1

locn DEFINE 100H

value EQU 77

MOV locn,R4

ADD #value,R4

ENDMOD

NAME add2

value EQU 88

MOV locn,R5

ADD #value,R5

END

很明顯，“=”也就是EQU，作用是：在當前模組中賦予一個永久的值。

至此，

#define DEFCW(name, address) __no_init union

{

struct

{

volatile unsigned char name##_L;

volatile unsigned char name##_H;

};

volatile unsigned short name;

} @ address;

這種定義也變得相對好理解。以上的這種定義只是多了一個union的定義，將一個16位的地址儲存空間分成2個8bits或者1個16位。可以實現字訪問，也可以實現位元組訪問。以上定義是將一個無名的union與address聯絡起來，使得訪問address對應的記憶體時，就像訪問union一樣。

那麼對於下面的一些看起來貌似比較複雜的定義就相對比較好理解了：

#define RF1AIFCTL1_ (0x0F02u)

DEFCW( RF1AIFCTL1 , RF1AIFCTL1_)

#define RF1AIFIFG RF1AIFCTL1_L

#define RF1AIFIE RF1AIFCTL1_H

可以發現，第一個宏定義，“RF1AIFCTL1_”在字串的最後帶一個底線，其實代表這隻是一個地址。而通過宏擴充DEFCW(
RF1AIFCTL1 , RF1AIFCTL1_)，將會被擴充為：

__no_init union

{

struct

{

volatile unsigned char RF1AIFCTL1_L;

volatile unsigned char RF1AIFCTL1_H;

};

volatile unsigned short RF1AIFCTL1;

} @ (0x0F02u);

關於@的用法，今天查閱了《MSP430 IAR C/EC++ Compiler Reference Guide》，找到了結果：

A variable that has been explicitly placed at an address, for example by using the compiler @ syntax, will be placed in either the DATA16_AC or the DATA16_AN segment.

從中可以看出，@是一種文法。那麼它的作用很明顯就是將變數放置到對應的地址中。使用@，一個變數可以明確的制定一個儲存地址。

因此之前的宏定義就變得好理解了。

#define DEFC(name, address) __no_init volatile unsigned char name @ address;

就是將name變數存放在address地址中，那麼如此一來就可以為每個寄存器進行命名了，也就是說可以實現每個寄存器對應一個或者多個變數。

至此標頭檔中另外一個問題也迎刃而解：

#define RF1AIFCTL1_ (0x0F02u)

DEFCW( RF1AIFCTL1 , RF1AIFCTL1_)

#define RF1AIFIFG RF1AIFCTL1_L

#define RF1AIFIE RF1AIFCTL1_H

我們將DEFCW( RF1AIFCTL1 , RF1AIFCTL1_)展開：

__no_init union

{

struct

{

volatile unsigned char RF1AIFCTL1_L;

volatile unsigned char RF1AIFCTL1_H;

};

volatile unsigned short RF1AIFCTL1;

} @ (0x0F02u);

那麼可以知道，RF1AIFCTL1，RF1AIFCTL1_L，RF1AIFCTL1_H已經聲明成為一個變數，存放的地址分別是0x0F02u，0x0F02u+1，0x0F02u。因此接下來後面兩條宏定義就自然的解開了。

#define RF1AIFIFG RF1AIFCTL1_L

#define RF1AIFIE RF1AIFCTL1_H

功能只是為變數RF1AIFCTL1_L，RF1AIFCTL1_H定義了另外的一種名字作為替換。