WINCE6.0 简单LED驱动程序的编写

把它写成了实验报告的样子！ 在此BLOG中的有些函数是针对特定的BSP， 比如：地址的映射函数， 在每一个BSP中它的地址映射函数都不同， 但是都是地址映射（废话当然是地址映射了）。其实里面有很多的东西都还可以添加：比如添加读取LED信息状态， 优化地址映射（不必把全部的GPIO都映射， 可以自定义一个小的结构体来实现）。
一． 实验目的
a) 掌握流驱动的结构
b) 掌握一般流驱动的编写方法

二． 实验设备
a) S3C6410 开发板一台
b) PC 机一台， VS2005, CE6.0 环境

三． 实验内容
a) 进行简单 LED 驱动的编写。

四． 实验原理
a) 硬件原理图
i.
ii.
iii. 从原理图可以知道如果我们要点亮 LEDx ， 只需要 GPMx 输出高电平， 如果要熄灭 LEDx ， 只需要 GPMx 输出低电平即可。

b) 软件原理设计
i. 由于在 WINCE 中使用都是虚拟的地址， 所以需要将实际的物理地址转换为虚拟地址来使用。 在系统提供的 BSP 中提供了一个函数来实现从物理地址到虚拟地址的映射。
1. void *DrvLib_MapIoSpace (UINT32 PhysicalAddress , UINT32 NumberOfBytes , BOOL CacheEnable )
2. 把物理地址转换为虚拟地址。（其实它就是在地址映射表中查找相应的物理地址，然后返回对应的虚拟地址加上它的偏移。）
3. UINT32 PhysicalAddress ：要实现映射的物理地址的起始地址。
4. UINT32 NumberOfBytes ： 要映射物理地址的长度。
5. BOOL CacheEnable ：该物理地址是否使用了CACHE.( 具体参照地址映射表) 。
ii. LED 上下文结构体的定义
1. 定义了一个 LED 驱动的上下文， 用来保存 LED 驱动的信息。 但是只是简单的 LED 驱动， 没有包含多的数据。
typedef struct
{
volatile S3C6410_GPIO_REG *pGPIOReg ;
}LED_PUBLIC_CONTEXT , *PLED_PUBLIC_CONTEXT ;
2 ． S3C6410_GPIO_REG 是BSP 预先定义的一个GPIO 使用的数据结构。
iii. GPIO 寄存器的使用。 GPIO 寄存器的地址都映射到了虚拟的地址上。 BSP 提供了一个结构体方便 GPIO 寄存器的使用。
1. typedef struct
{ ……………..
UINT32 GPMCON; // 820
UINT32 GPMDAT; // 824
UINT32 GPMPUD; // 828
………………..
} S3C6410_GPIO_REG, *PS3C6410_GPIO_REG;
2. 在使用这个结构全的时候把 GPIO 的虚拟地址的基地址映射到此结构的开始即可以操作此结构体的数据来操作实际的寄存器。
3. 进行GPIO 物理地址到虚拟地址的映射: pLedContext ->pGPIOReg = (volatile S3C6410_GPIO_REG *)DrvLib_MapIoSpace (S3C6410_BASE_REG_PA_GPIO , sizeof (S3C6410_GPIO_REG ), FALSE ) ；
iv. 实现 LED 灯状态的操作。
1. 获得了 GPIO 的虚拟地址就可以像实际的物理地址那样实现寄存器的操作。
2.
a) // 使能上拉
b) pLedContext ->pGPIOReg ->GPMPUD |= 0x0ff;
c) // 设置为输出
d) pLedContext ->pGPIOReg ->GPMCON = 0x111111;
e) // 关闭所有的LED
f) LED_ALL_OFF (pLedContext ->pGPIOReg ->GPMDAT );
3. 为了方便进行操作，定义了一组宏。
// 打开或关闭LED0
#define LED0_ON (x ) (x |= 0x00000001)
#define LED0_OFF (x ) (x = 0xfffffffe)
// 打开或关闭LED1
#define LED1_ON (x ) (x |= 0x00000002)
#define LED1_OFF (x ) (x = 0xfffffffd)
// 打开或关闭LED2
#define LED2_ON (x ) (x |= 0x00000004)
#define LED2_OFF (x ) (x = 0xfffffffb)
// 打开或关闭LED3
#define LED3_ON (x ) (x |= 0x00000008)
#define LED3_OFF (x ) (x = 0xfffffff7)
// 打开或关闭所有的LED
#define LED_ALL_ON (x ) (x |= 0x0000000f)
#define LED_ALL_OFF (x ) (x = 0xfffffff0)
五． 实验步骤
a) Xxx_Init 函数的原型：
i. DWORD XXX_Init( LPCTSTR pContext , DWORD dwBusContext );
ii. pContext: Pointer to a string containing the registry path to the active key for the stream interface driver.
iii. lpvBusContext: Potentially process-mapped pointer passed as the fourth parameter to ActivateDeviceEx . If this driver was loaded through legacy mechanisms, then dwBusContext is zero. This pointer, if used, has only been mapped again as it passes through the protected server library (PSL). The XXX _Init function is responsible for performing all protection checking
iv. 返回值 ： Returns a handle to the device context created if successful. Returns zero if not successful. This handle is passed to the XXX_Open (Device Manager) , XXX_PowerDown (Device Manager) , XXX_PowerUp (Device Manager) , and XXX_Deinit (Device Manager) functions
v. 注意：当调用 设备管理程序当调用 ActivateDeviceEx 函数的时候会间接调用到此函数， ActivateDeviceEx 的作用就是加载设备
vi. LED_Init 函数的编写。 LED_Init 最主要的功能就是进行硬件的初使化。
vii. LED_Init 函数的实现：
DWORD Led_Init (LPCTSTR pContext )
{
volatile PLED_PUBLIC_CONTEXT pLedContext ;

RETAILMSG (DEBUG_LED ,(TEXT (Led_Init Function!/n )));

// 申请LED 的CONTEXT
pLedContext = (PLED_PUBLIC_CONTEXT )LocalAlloc (LPTR , sizeof (pContext ));
if (!pLedContext )
{
RETAILMSG (DEBUG_LED , (TEXT (Can't alloc memory for led context!/n )));
return NULL ;
}

// 得到GPIO 寄存器的地址
pLedContext ->pGPIOReg = (volatile S3C6410_GPIO_REG *)DrvLib_MapIoSpace (S3C6410_BASE_REG_PA_GPIO , sizeof (S3C6410_GPIO_REG ), FALSE );
if (pLedContext ->pGPIOReg == NULL )
{
RETAILMSG (DEBUG_LED , (TEXT (LED for pGPIORges: DrvLib_MapIoSpace failed!/n )));
LocalFree (pLedContext );
return NULL ;
}

// 使能上拉
pLedContext ->pGPIOReg ->GPMPUD |= 0x0ff;
// 设置为输出
pLedContext ->pGPIOReg ->GPMCON = 0x111111;
// 关闭所有的LED
LED_ALL_OFF (pLedContext ->pGPIOReg ->GPMDAT );
RETAILMSG (DEBUG_LED , (TEXT (Led0 on! %d!/n ), (pLedContext ->pGPIOReg ->GPMDAT )));

return pLedContext ;
` }
a) Xxx_Write 函数原型：
DWORD XXX_Write(DWORD
hOpenContext
, LPCVOID
pBuffer
, DWORD
Count
);