WinCE6.0 DEVICEEMULATOR BSP在GEC2410开发板上的移植(3)-PwrButton驱动移植及分析

PwrButton驱动实现了按键关机(PowerOff)和重启(Reset)的功能.我们这里定义开发板上的K1为PowerOff,K3为Reset,对应与CPU的EINT0和EINT2中断.
DEVICEEMULATOR BSP中已经基本实现了该驱动,在GEC2410.bat中使能PwrButton,即设置BSP_NOPWRBTN不为1:
set BSP_NOPWRBTN=
编译后通过KITL可以看到pwrbtn2410.dll已经被加载了,但是按任何按钮都没有反应.这是由于PwrButton驱动中的IO设置与我们实际板子上还不完全匹配.
在GEC2410开发板上,按键的原理图是:

在PwrButton驱动中,使用EINT0和EINT2来检测按键的输入,没有按键输入时,EINT0,EINT2被上拉为1,当K1按下时要使EINT0产生下降沿中断,KSCAN0必须为输出0,为了使K2,K9,K10按下时不产生中断,KSCAN1-3需要输出1.这样只有当K1按下时才产生EINT0的下降沿中断.
同理对K3.
我们需要的工作就是配置相应的GPIO,使KSCAN0输出0,KSCAN1-3输出1,EINT0和EINT2设置为外部中断,下降沿触发.然后在驱动中设置该中断,当中断发生时读取EINT0或EINT2对应引脚的值就可以判断K1或者K3是否按下了.
如果要读取所有键盘的值,只需要通过KSCAN0-KSCAN3分别置0扫描并读取相应的EINT管脚就能确定是哪个按键按下了.
接下来我们来看看该驱动详细的代码以及需要添加或修改的地方.
1.流驱动接口
PwrButton驱动也是个标准的流接口驱动,但是只实现了PBT_Init一个函数,其他的如PBT_Open,PBT_Read,PBT_Write都没有实现,仅仅返回0.
PBT_Init 主要工作是:
(1)从coredll.dll获得系统函数SetSystemPowerState,
(2)调用InitializeAddresses获取寄存器地址
(3)调用SetScanOutput()来设置KSCAN0-3的输出值.
(4)创建检测PowerButton(K1)和ResetButton(K3)的线程:PowerButtonIntrThread和ResetButtonIntrThread.
其中SetScanOutput()是我添加的函数,用来初始化KSCAN0-3的输出(KSCAN0为0,其余为1)
代码如下：
DWORD PBT_Init(DWORD dwContext) { DWORD IDPowerButtonThread; DWORD IDResetButtonThread; HMODULE hmCore; // // Obtain a pointer to the power manager function "SetSystemPowerState" // from the core library so we can call into it. pfnSetSystemPowerState = NULL; hmCore = (HMODULE) LoadLibrary(_T("coredll.dll")); if(hmCore != NULL) { pfnSetSystemPowerState = (PFN_SetSystemPowerState) GetProcAddress(hmCore, _T("SetSystemPowerState")); if(pfnSetSystemPowerState == NULL) { FreeLibrary(hmCore); } } // Initialize addresses now as opposed to when interrupts are handled so there are no race conditions InitializeAddresses(); SetScanOutput(); // Create a thread to handle the power button event, and one to handle the reset button event. ResetButtonIntrThreadHandle = CreateThread(0, 0, (LPTHREAD_START_ROUTINE) ResetButtonIntrThread, 0, 0, &IDResetButtonThread); if (ResetButtonIntrThreadHandle == 0) { RETAILMSG(1, (TEXT("PBT: CreateThread() Fail/r/n"))); } PowerButtonIntrThreadHandle = CreateThread(0, 0, (LPTHREAD_START_ROUTINE) PowerButtonIntrThread, 0, 0, &IDPowerButtonThread); if (PowerButtonIntrThreadHandle == 0) { RETAILMSG(1, (TEXT("PBT: CreateThread() Fail/r/n"))); } return (dwContext); }
InitializeAddresses:
InitializeAddresses通过调用VirtualAlloc和VirtualCopy获得了GPIO寄存器和中断寄存器的虚拟地址，并转换为S3C2410X_IOPORT_REG和S3C2410X_INTR_REG结构的指针。
 static BOOL InitializeAddresses(VOID) { BOOL RetValue = FALSE; // IO Register Allocation v_pIOPregs = (volatile S3C2410X_IOPORT_REG *)VirtualAlloc(0, sizeof *v_pIOPregs, MEM_RESERVE, PAGE_NOACCESS); if (v_pIOPregs == NULL) { ERRORMSG(1,(TEXT("PBT: VirtualAlloc failed!/r/n"))); } else { if (!VirtualCopy((PVOID)v_pIOPregs, (PVOID)(S3C2410X_BASE_REG_PA_IOPORT >> 8), sizeof *v_pIOPregs, PAGE_PHYSICAL | PAGE_READWRITE | PAGE_NOCACHE)) { ERRORMSG(1,(TEXT("PBT: VirtualCopy failed!/r/n"))); VirtualFree((PVOID)v_pIOPregs, 0, MEM_RELEASE); v_pIOPregs = NULL; } } s2410INT = (volatile S3C2410X_INTR_REG *)VirtualAlloc(0, sizeof *s2410INT, MEM_RESERVE, PAGE_NOACCESS); if (s2410INT == NULL) { ERRORMSG(1,(TEXT("PBT: VirtualAlloc failed!/r/n"))); } else { if (!VirtualCopy((PVOID)s2410INT, (PVOID)(S3C2410X_BASE_REG_PA_INTR >> 8), sizeof *s2410INT, PAGE_PHYSICAL | PAGE_READWRITE | PAGE_NOCACHE)) { ERRORMSG(1,(TEXT("PBT: VirtualCopy failed!/r/n"))); VirtualFree((PVOID)s2410INT, 0, MEM_RELEASE); s2410INT = NULL; } } if(v_pIOPregs && s2410INT) { RetValue = TRUE; } return (RetValue); }
SetScanOutput:
设置KSCAN0为0,KSCAN1-3为1
static VOID SetScanOutput(VOID) { //only enable K1 and K3 key input detect v_pIOPregs->GPGDAT |= (1<<6)|(1<<2); //GPG6,2((KSCAN1,KSCAN3) output 1 v_pIOPregs->GPEDAT |= (1<<13); //GEE13(KSCAN2) output 1 v_pIOPregs->GPEDAT &= ~(1<<11); //GPE11(KSCAN0) output 0 }
2.PowerButtonIntrThread和ResetButtonIntrThread
PowerButtonIntrThread:
(1).调用EnablePowerButtonInterrupt()来初始化IO和使能中断EINT0.
(2).创建中断事件PwrButtonIntrEvent,调用KernelIoControl向系统申请IRQ_EINT0对应的逻辑中断号PwrButtonSysIntr.
(3).调用InterruptInitialize将PwrButtonSysIntr关联PwrButtonIntrEvent事件并初始化中断.
(4).等待中断事件发生
(5).中断发生后,调用PowerButtonIsPushed来检测按钮是否按下,延时200ms并再次判断是否按键释放,如果释放了确定按键有效.
(6).pfnSetSystemPowerState存在时,调用其来设置系统状态为POWER_STATE_SUSPEND
pfnSetSystemPowerState(NULL, POWER_STATE_SUSPEND, POWER_FORCE);
否则调用PowerOffSystem()关闭系统.
(7).最后InterruptDone(PwrButtonSysIntr);来通知系统中断完成.
以下是PowerButtonIntrThread代码:
static DWORD PowerButtonIntrThread(PVOID pArg) { RETAILMSG(1, (TEXT("PowerButtonIntrThread./r/n"))); EnablePowerButtonInterrupt(); PwrButtonIntrEvent = CreateEvent(NULL, FALSE, FALSE, NULL); // // Request a SYSINTR value from the OAL. // if (!KernelIoControl(IOCTL_HAL_REQUEST_SYSINTR, &PwrButtonIrq, sizeof PwrButtonIrq, &PwrButtonSysIntr, sizeof PwrButtonSysIntr, NULL)) { RETAILMSG(1, (TEXT("PBT: Error! Failed to request sysintr value for power button interrupt./r/n"))); return(0); } if (!(InterruptInitialize(PwrButtonSysIntr, PwrButtonIntrEvent, 0, 0))) { RETAILMSG(1, (TEXT("ERROR: PwrButton: Interrupt initialize failed./r/n"))); } // Handle power button presses. for (;;) { WaitForSingleObject(PwrButtonIntrEvent, INFINITE); if (PowerButtonIsPushed()) // Guard against noise triggering an interrupt. { Sleep(200); // Check again in 200 Ms. to fend off a continuous press. if (!PowerButtonIsPushed()) // Must be held+released in less than .2 seconds. { // // Soft reset and standard suspend-resume both start with suspend for now. // Call whichever shutdown API is available. // if(pfnSetSystemPowerState != NULL) { RETAILMSG(1,(TEXT("PBT: Signalling power manager to suspend.../r/n"))); pfnSetSystemPowerState(NULL, POWER_STATE_SUSPEND, POWER_FORCE); } else { RETAILMSG(1,(TEXT("PBT: Suspending by calling PowerOffSystem.../r/n"))); PowerOffSystem(); } // // Acquiesce to other threads since our work is complete as of // the call to PowerOffSystem, or the signalling of the power // manager. // Sleep(0); } else RETAILMSG(1,(TEXT("PBT: Button held too long (ignored)/r/n"))); } else RETAILMSG(1,(TEXT("PBT: Feeble button press or noise triggered it (ignored)/r/n"))); InterruptDone(PwrButtonSysIntr); } }
ResetButtonIntrThread:
(1).调用EnableResetButtonInterrupt()来初始化IO和使能中断EINT2.
(2).创建中断事件ResetButtonIntrEvent,调用KernelIoControl向系统申请IRQ_EINT2对应的逻辑中断号ResetButtonSysIntr.
(3).调用InterruptInitialize将ResetButtonSysIntr关联ResetButtonIntrEvent事件并初始化中断.
(4).等待中断事件发生
(5).中断发生后,首先屏蔽EINT11中断(原来的EINT11是连接存储设备的,而我们的板子连接的是键盘,这句代码可以不用)
(6)调用PowerButtonIsPushed来检测按钮是否按下,延时200ms并再次判断是否按键释放,如果释放了确定按键有效.
(7).pfnSetSystemPowerState存在时,调用其来设置系统状态为POWER_STATE_RESET
pfnSetSystemPowerState(NULL, POWER_STATE_RESET, POWER_FORCE);
否则调用KernelIoControl(IOCTL_HAL_REBOOT,NULL,0,NULL,0,NULL)来重启系统.
(8).最后InterruptDone(ResetButtonSysIntr);来通知系统中断完成.
以下是ResetButtonIntrThread代码:
static DWORD ResetButtonIntrThread(PVOID pArg) { RETAILMSG(1, (TEXT("ResetButtonIntrThread./r/n"))); EnableResetButtonInterrupt(); ResetButtonIntrEvent = CreateEvent(NULL, FALSE, FALSE, NULL); // // Request a SYSINTR value from the OAL. // if (!KernelIoControl(IOCTL_HAL_REQUEST_SYSINTR, &ResetButtonIrq, sizeof ResetButtonIrq, &ResetButtonSysIntr, sizeof ResetButtonSysIntr, NULL)) { RETAILMSG(1, (TEXT("PBT: Error! Failed to request sysintr value for reset button interrupt./r/n"))); return(0); } if (!(InterruptInitialize(ResetButtonSysIntr, ResetButtonIntrEvent, 0, 0))) { RETAILMSG(1, (TEXT("ERROR: ResetButton: Interrupt initialize failed./r/n"))); } // Handle power button presses. for (;;) { WaitForSingleObject(ResetButtonIntrEvent, INFINITE); //Mask the storage device interrupt EINT11 so we don't service it before reboot is finished s2410INT->INTMSK = (s2410INT->INTMSK | (0x1 << 0x5)); if (ResetButtonIsPushed()) // Guard against noise triggering an interrupt. { // // Soft reset and standard suspend-resume both start with suspend for now. // Call whichever shutdown API is available. // if(pfnSetSystemPowerState != NULL) { RETAILMSG(1,(TEXT("PBT: Signalling power manager to reset.../r/n"))); pfnSetSystemPowerState(NULL, POWER_STATE_RESET, POWER_FORCE); } else { RETAILMSG(1,(TEXT("PBT: Resetting by calling KernelIoControl(IOCTL_HAL_REBOOT).../r/n"))); KernelIoControl(IOCTL_HAL_REBOOT,NULL,0,NULL,0,NULL); } // // Acquiesce to other threads since our work is complete as of // the call to PowerOffSystem, or the signalling of the power // manager. // Sleep(0); } else RETAILMSG(1,(TEXT("PBT: Feeble button press or noise triggered it (ignored)/r/n"))); InterruptDone(ResetButtonSysIntr); } }
3.EnablePowerButtonInterrupt,EnableResetButtonInterrupt,PowerButtonIsPushed,ResetButtonIsPushed
EnablePowerButtonInterrupt和EnableResetButtonInterrupt初始化EINT0和EINT2的功能管脚和中断设置(下降沿触发)
static VOID EnablePowerButtonInterrupt(VOID) { v_pIOPregs->GPFCON &= ~(0x3 << 0); // Set EINT0(GPF0) as EINT0 v_pIOPregs->GPFCON |= (0x2 << 0); v_pIOPregs->EXTINT0 &= ~(0x7 << 0); // Configure EINT0 as Falling Edge Mode v_pIOPregs->EXTINT0 |= (0x2 << 0); } static VOID EnableResetButtonInterrupt(VOID) { v_pIOPregs->GPFCON &= ~(0x3 << 4); // Set EINT2(GPF2) as EINT2 v_pIOPregs->GPFCON |= (0x2 << 4); v_pIOPregs->EXTINT0 &= ~(0x7 << 8); // Configure EINT2 as Falling Edge Mode v_pIOPregs->EXTINT0 |= (0x2 << 8); }
PowerButtonIsPushed和ResetButtonIsPushed读取GPF0和GPF2的状态来确定按钮是否按下.
static BOOL PowerButtonIsPushed(VOID) { // // Switches are pulled up when open, and driven low when closed. // Return true if switch 1 (EINT0) is closed. // RETAILMSG(1, (TEXT("PowerButtonIsPushed./r/n"))); return ((v_pIOPregs->GPFDAT & (1 << 0)) ? FALSE : TRUE); } static BOOL ResetButtonIsPushed(VOID) { // // Switches are pulled up when open, and driven low when closed. // Return true if switch 1 (EINT2) is closed. // RETAILMSG(1, (TEXT("ResetButtonIsPushed./r/n"))); return ((v_pIOPregs->GPFDAT & (1 << 2)) ? FALSE : TRUE); }
4.增加OAL中的GPIO初始化
KSCAN0-3的GPIO寄存器配置在OAL中的OEMInit()函数中完成,调用以下的InitGPIO来进行初始化:
具体的引脚及其功能见如下代码及注释:
void InitGPIO() { S3C2410X_IOPORT_REG *pOalPortRegs; RETAILMSG(1, (L"+GPIO_Init.../r/n")); pOalPortRegs = OALPAtoVA(S3C2410X_BASE_REG_PA_IOPORT, FALSE); //KEY Board GPIO settings pOalPortRegs->GPGCON = pOalPortRegs->GPGCON & (~((3<<12)|(3<<4))) | ((1<<12)|(1<<4)) ; //GPG6(KSCAN1) GPG2(KSCAN3), set output //pOalPortRegs->GPGDAT &= (~((1<<6)|(1<<2))); //GPG6,2((KSCAN1,KSCAN3) output 0 pOalPortRegs->GPECON = pOalPortRegs->GPECON & (~((3<<26)|(3<<22))) | ((1<<26)|(1<<22)); //GPE13(KSCAN2),GPE11(KSCAN0) set output //pOalPortRegs->GPGDAT &= (~((1<<13)|(1<<11))); //GPE13(KSCAN2) GPE11(KSCAN0) output 0 pOalPortRegs->GPGCON = pOalPortRegs->GPGCON & (~((3<<22)|(3<<6))) | ((2<<22)|(2<<6)) ; //GPG11(EINT19),GPG3(EINT11) set EINT pOalPortRegs->GPFCON = pOalPortRegs->GPFCON & (~((3<<4)|(3<<0))) | ((2<<4)|(2<<0)) ; //GPF2(EINT2) GPF0(EINT0), set EINT //pOalPortRegs->GPFUP = 0xf0; // GPF4-7:disabled pull up; GPF0-4: enable pull up }