应用程序中读写TCC7901的寄存器
//=====================================================================
//TITLE:
// 应用程序中读写TCC7901的寄存器
//AUTHOR:
// norains
//DATE:
// Monday 12-July-2010
//Environment:
// Windows CE 5.0
//=====================================================================
熟悉于WinCE驱动编写的兄弟姐妹，估计对于嵌入式CPU的寄存器读写不会陌生，甚至可以说就像是左手摸右手那般熟悉。
不过熟悉归熟悉，实际工作中，如果死板地按照微软的驱动编写流程，估计会被烦死；即使没有被烦死，也会效率大打折扣。比方说，你需要写一个GPIO驱动，该驱动会根据某些特定情况开断指示灯。当你酣畅淋漓地将驱动写完，兴致勃勃部署到设备上，启动，哑火。这时候，我估计很多朋友都会选择通过在代码中遍布打印消息，以此推断结症所在。如果这时候能将相应的操作放置于应用程序，能通过IDE的断点来调试，是不是一切就会简单很多呢？
如果你使用的是Telechips的TCC7901，在应用程序中操作其寄存器，将会是一件非常简单的事--简单到连通用做法都不必采用。
我们以一个最为简单的例子，设置GPIOD[8]功能。
先查看一下TCC7901的Datasheet：
通过图片中用红色圈起来的部分，我们知道，如果要将SDI0这个PIN作为GPIO功能，那我们需要对PORTCFG4这个寄存器的24~27位写入1，并且该寄存器的地址为0xF005A010。
我们先把文档放一边，先来查看一下TCC7901的BSP代码。找到TCC79x_Physical.h这个文件，输入PORTCFG4，我们可以看到在该头文件中对于该寄存器是如此定义的：
#define HwPORTCFG4 *(volatile unsigned long *)0xF005A010
#define HwPORTCFG4_SCLK0(X) ((X)*Hw28)
#define HwPORTCFG4_SDI0(X) ((X)*Hw24)
#define HwPORTCFG4_SDO0(X) ((X)*Hw20)
#define HwPORTCFG4_GPIOA2(X) ((X)*Hw16)
#define HwPORTCFG4_GPIOA3(X) ((X)*Hw12)
#define HwPORTCFG4_GPIOA4(X) ((X)*Hw8)
#define HwPORTCFG4_GPIOA5(X) ((X)*Hw4)
#define HwPORTCFG4_CSN_CS0(X) ((X)*Hw0)
仔细点观察，我们会发现，如果将这些定义的前缀Hw去掉，那么剩下的名字就和Datasheet上的完全一一对应。没错，确实如此。Telechips为了方便，已经将所有寄存器的地址定义在一个头文件中，Datasheet中提到的寄存器名，只要加上Hw前缀，就能在头文件中找到其相应的位置。
不仅如此，Telechips还在该文件定义了寄存器的相应操作：
#ifndef BITSET
#define BITSET( X, MASK) ( (X) |= (unsigned int)(MASK) )
#endif
#ifndef BITSCLR
#define BITSCLR(X, SMASK, CMASK) ( (X) = ((((unsigned int)(X)) | ((unsigned int)(SMASK))) & ~((unsigned int)(CMASK))) )
#endif
#ifndef BITCSET
#define BITCSET(X, CMASK, SMASK) ( (X) = ((((unsigned int)(X)) & ~((unsigned int)(CMASK))) | ((unsigned int)(SMASK))) )
#endif
#ifndef BITCLR
#define BITCLR( X, MASK) ( (X) &= ~((unsigned int)(MASK)) )
#endif
#ifndef BITXOR
#define BITXOR( X, MASK) ( (X) ^= (unsigned int)(MASK) )
#endif
#ifndef ISZERO
#define ISZERO(X, MASK) ( ! (((unsigned int)(X)) & ((unsigned int)(MASK))) )
#endif
#ifndef ISSET
#define ISSET(X, MASK) ( (unsigned int)(X) & ((unsigned int)(MASK)) )
#endif
#ifndef IS
#define IS(X, MASK) ( (unsigned int)(X) & ((unsigned int)(MASK)) )
#endif
#ifndef ISONE
#define ISONE(X, MASK) ( (unsigned int)(X) & ((unsigned int)(MASK)) )
#endif
以文章开头的例子，如果我们想对PORTCFG4进行设置，那么代码会非常简单：
BITCSET(HwPORTCFG4, HwPORTCFG4_SDI0(0xFUL), HwPORTCFG4(1))
那么，这代码能不能正常运行呢？很遗憾，结论是：不行。因为这个是硬件的地址，如果你应用程序强制往该地址写数据，你得到的将是一个错误。
似乎遇到了一个难题，但解决方法却是非常简单。我们不包含TCC79x_Physical.h文件，而改为TCC79x_Virtual.h。这两个文件宏定义的名称完全相同，没有任何差别，唯一的差异是，TCC79x_Virtual.h中定义的地址是虚拟内存地址--而这个地址完全可以直接在应用程序中使用。
所以，对于文中提出的问题，以代码的形式，则是简单如此：
#include "stdafx.h"
#include "TCC79x_Virtual.h"
int main(int argc, char** argv)
{
BITCSET(HwPORTCFG4, HwPORTCFG4_SDI0(0xFUL), HwPORTCFG4(1));
return 0;
}
其实，借助于TCC79x_Virtual.h文件，我们能做的事情还很多。比如，该文件还对每一位进行了定义：
#define Hw37 (1LL << 37)
#define Hw36 (1LL << 36)
#define Hw35 (1LL << 35)
#define Hw34 (1LL << 34)
#define Hw33 (1LL << 33)
#define Hw32 (1LL << 32)
#define Hw31 0x80000000
#define Hw30 0x40000000
#define Hw29 0x20000000
#define Hw28 0x10000000
#define Hw27 0x08000000
#define Hw26 0x04000000
#define Hw25 0x02000000
#define Hw24 0x01000000
#define Hw23 0x00800000
#define Hw22 0x00400000
#define Hw21 0x00200000
#define Hw20 0x00100000
#define Hw19 0x00080000
#define Hw18 0x00040000
#define Hw17 0x00020000
#define Hw16 0x00010000
#define Hw15 0x00008000
#define Hw14 0x00004000
#define Hw13 0x00002000
#define Hw12 0x00001000
#define Hw11 0x00000800
#define Hw10 0x00000400
#define Hw9 0x00000200
#define Hw8 0x00000100
#define Hw7 0x00000080
#define Hw6 0x00000040
#define Hw5 0x00000020
#define Hw4 0x00000010
#define Hw3 0x00000008
#define Hw2 0x00000004
#define Hw1 0x00000002
#define Hw0 0x00000001
#define HwZERO 0x00000000
如果我们的程序的流程依赖于PORTCFG4的第2位的话，那么我们的代码流程也可以简单地书写如下：
if(HwPORTCFG4 & Hw1)
{
...
}
总而言之，对于TCC7901寄存器的读写，完全可以在应用程序中进行，这对于产品调试的便利性，不言而喻。