APPENDIX B
Common PEN*KEY 6000 Series Information
B-18 PEN*KEY
R
6200/6300 Hand-Held Computer Programmer’s Reference Guide
These switches and this file respond to NORAPM INT 2F broadcasts and
manage power consumption by the radio. Since each radio has different
characteristics, the parameters and their defaults depend on the radio. Where
possible, the program senses the radio in use and change its defaults accordingly.
Purpose
The purpose of these programs is to prevent the radio from causing a switch from
the main battery to the backup battery, respond to NORAPM INT 2F broadcasts,
and provide an environment in which application software does work.
If radios are allowed to run on the backup battery, all power could be drained beĆ
fore shutĆdown could be effected. This condition would destroy all data in the
DRAM and the PEN*KEY HHC would need reprogramming. Since this is unacĆ
ceptable, the battery power must be monitored and thresholds established for
each radio for powering them down.
The powerĆdown threshold may be set by the application either through WANĆ
POWER APM, command line switches, or INI file entries, or by default. Once
the threshold is reached, the radio power is shut down
regardless of any current
activity
(that is, transmission or reception). To monitor battery status, the
following System Interface Functions are used:
Function
Description
ReadMBVoltage
10Ćsecond average main battery voltage
GetFuel
(Function not currently implemented)
ReadBTemp
Main battery temperature
ReadMBA2D
Main battery voltage at 0.125Ćsecond increments
MainVoltage
Main battery voltage
BackupBatteryVoltage
Backup battery voltage
WANPOWER must respond to NORAPM broadcasts. The events and their reĆ
sponse are listed below. The response indicated assumes the current mode as set
by default parameters or by the user who permits the operation. For example, if
the user tells WANPOWER to never shut down, APMSUSPEND, APMCRITIĆ
CALSUSPEND, APMUSERSUPEND etc., are not honored.
Event
Response
APMSTANDBY
Not implemented by NORAPM
APMSUSPEND
Honored if received, not conflicting with default, userĆsupplied parameters.
If radio operates, request failed.
APMRESUME
PIAĆtoggle DTR (depending on mode). Other radios to be determined (TBD).
APMCRITICALRESUME
Radio powered up, PIAĆtoggle DTR, other radios TBD.
APMBATLOW
This message should never be received.
APMPWRCHANGE
Ignored. Battery status is constantly monitored.
APMTIMEUPDATE
Ignored. WANPOWER runs via constant clock.
APMCRITICALSUSPEND Radio powered off.
APMUSERSTANDBY
Not supported.
APMUSERSUSPEND
PIAĆturns itself off. (OthersĆTBD)
OEM_XKBD
No action.
OEM_CHARGE
No action.
OEM_POD1
No action.
B. Common PEN*KEY
6000 Series Info.
