APPENDIX B
Common PEN*KEY 6000 Series Information
PEN*KEY
R
6200/6300 Hand-Held Computer Programmer’s Reference Guide B-17
Command Line Interface
A command line interface to a WAN Power API executable is provided for those
applications that do not conform to the WAN Power API. This executable may
be invoked prior to application execution to set the appropriate power strategy.
Default Settings
In the absence of any power settings, the WAN Power API provides default setĆ
tings. These defaults strike a balance between maximizing power savings and
minimizing the impact on applications. The defaults maintained by the API can
be overridden by the application.
Basic Functions
In addition to default and command line settings, the following functions are
available to DOS or Windows programs (that is, under programmatic control):
Function
Description
Radio type
Return the type of radio (e.g., PIA) and its characteristics
PCMCIA power status
On or off
Set PCMCIA power on
Turn the power to the radio on
Set PCMCIA power off Turn the power to the radio off
Suspend radio
Place the radio in a minimumĆpower state
Idle radio
Place the radio in an idle state. This state may not differ from the default state
but is included because APM can send an idle" message.
Initiate radio
Set/reset radio parameters
Program Requirements
WAN power management requires three levels of software:
"
API
"
WAN Power Manager
"
Monitor and test applications
The API itself supports both general applications and the WAN Power Manager.
The WAN Power Manager software manages power parameters, provides default
power settings, responds to APM messages, and monitors power states and takes
appropriate action.
WAN Power Management Implementation
In DOS, one TSR is the WAN Power Manager; the other supplies API callouts
through INT 15. To prevent loading order problems, the Power Manager spawns
the API.
General Requirements
Ensure the radio's use of power never causes system deterioration and that any
external events the radio needs to respond to are serviced.
The mechanism for accomplishing these tasks is generically called WANPOWER
management. WANPOWER is implemented in DOS by a TSR.
This program provides default power management for radios that can be
configured via command line switches in DOS and by an INI file in Windows.
B. Common PEN*KEY
6000 Series Info.
