WINCE的电源管理


nbsp;  在windows ce中,显示的控制是通过ext­escape函数。这是一个显示和打印机驱动的后门。windows ce显示驱动支持许多设备转义代码(escape codes),这些被公布在platform builder中。对于我们的目的来说,只有两个转义代码被用到:setpowermanagement来设置显示的电源状态和queryescsupport来查询是否setpowermanagement被驱动支持。下面的例子打开或关闭系统显示通过显示驱动,并且支持完全的转义代码:
//

// defines and structures taken from pwingdi.h in the platform builder 

// 

#define queryescsupport             8 

#define setpowermanagement          6147 

#define getpowermanagement          6148 

typedef enum _video_power_state { 

    videopoweron = 1, 

    videopowerstandby, 

    videopowersuspend, 

    videopoweroff 

} video_power_state, *pvideo_power_state; 

typedef struct _video_power_management { 

    ulong length; 

    ulong dpmsversion; 

    ulong powerstate; 

} video_power_management, *pvideo_power_management; 

//---------------------------------------------------------------------- 

// setvideopower - turns on or off the display 

// 

int setvideopower (bool fon) { 

    video_power_management vpm; 

    int rc, fqueryesc; 

    hdc hdc; 

    // get the display dc. 

    hdc = getdc (null); 

    // see if supported. 

    fqueryesc = setpowermanagement; 

    rc = extescape (hdc, queryescsupport, sizeof (fqueryesc),  

                    (lpstr)&fqueryesc, 0, 0);    

    if (rc == 0) { 

        // no support, fail. 

        releasedc (null, hdc); 

        return -1; 

    } 

    // fill in the power management structure. 

    vpm.length = sizeof (vpm); 

    vpm.dpmsversion = 1; 

    if (fon)  

        vpm.powerstate = videopoweron; 

    else 

        vpm.powerstate = videopoweroff; 

    // tell the driver to turn on or off the display. 

    rc = extescape (hdc, setpowermanagement, sizeof (vpm),  

                    (lpstr)&vpm, 0, 0);    

    // always release what you get. 

    releasedc (null, hdc); 

    return 0; 

} 

    前面的代码通过调用extescape和queryescsupport命令来查询是否支持转移代码。被查询的命令首先交给输入缓冲,如果setpowermanagement命令被支持,程序就填充video_power_management结构并再次调用extescape设置电源状态。

    虽然这些转义代码允许应用程序打开或关闭显示,windows ce没有一个统一的方式来控制背光的亮度。每个系统都有它自己的oem特有方式来控制背光亮度。如果将来有一种标准的背光亮度控制方式,它将很可能放在extescape函数中。

打开系统电源

    当系统被挂起,应用程序将不再运行,因此当系统唤醒时,应用程序看起来没有被控制。然而,有一些方式来唤醒一个挂起的设备。首先,一个应用程序通过给定一个时间,并使用11章提到的消息api(notification api)做系统被唤醒的计划。在一般情况下,oem厂商会分配一些中断条件,以便管理系统电源打开,或唤醒。这种方式的一个例子是一个系统当防止了一个同步架(synchronization cradle)时被唤醒。

防止系统关闭电源

    相反的情况,防止系统挂起也是一个问题。windows ce系统通常被设置为当一段时间没有用户输入就自动挂起。要防止自动挂起,一个应用程序可以周期性地调用一下函数:

void winapi systemidletimerreset (void);

这个函数重设windows ce用来监视用户输入的定时器。如果定时器到达预先的没有用户输入的间隔,系统会自动挂起。因为挂起超时值可以被改变,一个应用程序需要知道超时值,这样就要多一点调用systemidletimerreset。系统维护三个超时值,这些都能够使用systemparametersinfo来查询。传递给systemparametersinfo的常量的不同表现,显示如下:

spi_getbatteryidletimeout

当系统运行在电池电源状态下,离用户最后输入的时间

spi_getexternalidletimeout

当系统运行在ac电源状态下,离用户最后输入的时间

spi_getwakeupidletimeout

在系统再次挂起时离系统被自动唤醒的时间

要防止电源被自动挂起,你需要查询这三个值,并在最短时间内返回之前调用systemidletimerreset。如果超时值被设置为0,表示超时值被禁止。

电源管理程序

    一个新的,独立的电源管理组件在windows ce .net 4.0中被引入了。这个电源管理程序替代了许多gwes以前完成的函数。电源管理程序定义了一系列的电源状态,如d0,d1,d2,和d3。这些看起来神秘的名字被对应于一些友好的系统级别名称。

    对嵌入式系统来说,oem厂商定义了系统的电源状态。例如,电源状态可能是打开(on),空闲(idle)和挂起(suspend)。其他电源状态也被定义了,像screenoff, incradle, 和 onbattery。

    从应用程序的观点看,新的电源管理程序提供了通知电源状态改变的能力以及通过一系列的函数统一改变电源状态的能力。

    系统的电源状态被定义在注册表中,sdk定义了pwrmgr_reg_key,以致你不得不知道注册表的字符串,但是当常量没定义的时间,电源管理程序注册数据被保留在hkey_local_machinesystemcurrentcontrolsetcontrolpower。电源状态被定义作为子键,位于key state

电源通知

    电源管理程序一个十分受欢迎的特点是,可以在系统电源状态改变时通知应用程序。这可以让应用程序从手动检测电源状态中解脱出来。一个应用程序可以通过调用requestpowernotifications请求电源管理程序当电源状态改变的时候发送一个通知给应用程序。电源管理程序会通过一个由应用程序前面建立的消息队列发送通知。

    requestpowernotifications原型如下。

 
 
 

    handle requestpowernotifications (handle hmsgq, dword flags);

 
 
 

第一个参数是一个应用程序在之前建立的消息队列的句柄。第二个参数是一系列参数,表示应用程序想接收的通知。

 
 
 

pbt_transition

接受系统电源状态改变的通知。例如,当系统从on到suspend。

pbt_resume

当系统resume的时候接收通知。

pbt_powerstatuschange

当系统在ac和电池之间切换的时候接收通知。

pbt_powerinfochange

当系统电池级数变化时接收通知。

power_notify_all

接收所有的通知。

 
 
 

requestpowernotifications函数返回一个电源通知的句柄,失败返回null。消息队列建立的时候必须使应用程序有读权限,因为应用程序将从消息队列中读取电源通知。

要接收通知,应用程序必须使用waitforsingleob-ject来阻塞消息句柄。像第10章所讨论的,当通知被放在队列中时,句柄将被signaled。实际的通知将由结构power_broadcast表中被接收到。

typedef struct _power_broadcast {

    dword message;

    dword flags;

    dword length;

    wchar systempowerstate[1];

} power_broadcast, *ppower_broadcast;

 
 
 

第一个要注意的是,这个结构长度是可变的。最后一个字段,systempowerstate,是被定义为wchars类型,但是可以填上非字符串数据。第一个字段是通知自己的标识,这个字段可以填前面pbt_标志列表之一。flags区可以包括以下标志,依赖于被接收的通知:

power_state_on

系统处于on状态。

power_state_off

系统处于off状态。

power_state_critical

系统进入了一个临界off状态。

power_state_boot

系统正在启动。

power_state_idle

系统进入idle状态。

power_state_suspend

系统被挂起。

power_state_reset

系统被复位。

最后两个字段是相互关联的。length字段是systempowerstate字段数据的长度。systempowerstate中包含的数据依赖于被发送的通知。对于pbt_transition通知来说,systempowerstate字段包含一个新电源状态的标识字符串。这个字符串是以非0结尾的。为了结束字符串,使用length字段来指出字符串的长度。注意,length字段是以字节为单位的,当字符是双字节的uncode字符时,需要获得字符串字符的长度,就需要用length字段去除tchar的size。

对于pbt_powerinfochange通知来说,systempowerstate字段包含一个ppower_broadcast_power_info结构:

typedef struct _power_broadcast_power_info {

    dword       dwnumlevels;

    dword       dwbatterylifetime;

    dword       dwbatteryfulllifetime;

    dword       dwbackupbatterylifetime;

    dword       dwbackupbatteryfulllifetime;

    byte        baclinestatus;

    byte        bbatteryflag;

    byte        bbatterylifepercent;

    byte        bbackupbatteryflag;

    byte        bbackupbatterylifepercent;

} power_broadcast_power_info, *ppower_broadcast_power_info;

 
 
 

注意,这里有一些字段的名字和函数十分相似于前面讨论的system_power_status_ex2结构。

 
 
 

设置电源状态

    电源管理程序提供的函数也允许应用程序来控制电源状态。有两个方式来控制电源。第一个方式是应用程序给定一个电源设定。第二个方式是应用程序请求电源状态不要低于给定的级别。

    一个应用程序通过调用函数setsystempowerstate可以请求特定的电源状态。这个函数原型如下。

 
 
 
         dword setsystempowerstate (lpcwstr psstate, dword stateflags,

                                    dword options);

 
 
 

电源状态可以被请求通过指定前两个参数。如果第一个参数是非零值,它指向一个字符串标识被请求的状态。这个字符串必须和注册表中列出的电源状态之一相匹配。

如果psstate 为 null,第二个参数stateflags,定义了请求的电源状态。这个参数是从power_state_on直到power_state_reset状态其中之一,这些在前面提到的power_broadcast结构有描述。

比较特别的是power_state_reset标志。这个标志请求系统重起,使用setsystempowerstate的方法重起比通过直接使用ioctl_hal_reboot命令来调用kerneliocontrol的方法更好。调用 setsystempowerstate 会让系统在重起设备之前任何还在缓冲中的数据保存到文件系统。

调用setsystempowerstate是一个直接改变电源状态的方法。更巧妙的方法是通过调用setpowerrequirement来请求系统维持应用程序所需最低限度的电源状态。setsystempowerstate是假定应用程序知道所需状态,而调用setpowerrequirement是允许系统对电源设定做优化以满足应用程序的需要。一个使用setpowerrequirement会比较方便的例子是,一个使用串口的应用程序需要串口在进行通信时保持住电源状态。setpowerrequirement被定义如下。

 
 
 

handle setpowerrequirement (pvoid pvdevice,

                            cedevice_power_state devicestate,

                            ulong deviceflags, pvoid pvsystemstate,

                        ulong stateflags);

 
 
 

第一个参数指定了应用程序需要维护电源状态的设备。devicestate参数定义了设备的电源状态。cedevice_power_state指定了状态范围是从d0(意味着设备是处于最大功耗状态)到d4(表示设备被关闭)(译者注:其实d0到d4的状态的具体表现,完全是由oem厂商可自定义的,对应用程序开发者来说,比如是在d1关lcd背光还是在d2,都是不确定的,微软只给出标准定义,而不是实际定义)。deviceflags参数由两个标志合并而成:power_name,表示设备名有效;power_force,表示设备应当维持当前状态甚至当系统挂起时。如果pvsystemstate不为null,它表示只有对于在pvsystemstate中已命名的电源请求才是有效的。设备可能无法更改请求的状态。

应用程序应当注销通过调用releasepowerrequirement来注销请求,原型如下。

 
 
 

dword releasepowerrequirement (handle hpowerreq);

 
 
 

这里唯一的参数是从setpowerrequirement里返回的句柄。

在下一章,我将就windows ce流设备驱动和服务,继续探讨有关系统的问题。尽管大多数应用程序开发者可能不需要写一些设备驱动或服务,但是知道它们是如何和程序一起工作对我们也是有启发的。让我们一起来看一看吧。

COPYRIGHT(C) 2011 厦门永宏亚得机电科技有限公司版权所有(闽ICP备05025945号) ALL RIGHTS RESERVED?

电话: 0592-5190891 传真: 0592-5190720 E-Mail: E-mail:yade8895@163.com
地址: 厦门市海沧区兴港六里17号2607室 邮编:361009 联系人:翟先生