SECTION 2
Supporting DOS Applications
2-8 PEN*KEY
R
6200/6300 Hand-Held Computer Programmer’s Reference Guide
000A User System Suspend Request Notification
(
APM_USER_SUSPEND
)
A Get Power Status call determines if the terminal is on charge. If the terminal is on charge then the
event is simply ignored. The user suspend event is broadcast via Int. 2Fh. The value returned in BH
from the broadcast call determines if the suspend request is rejected. If zero is returned in BH, then a Set
Power State command is issued to the APM BIOS to suspend all power managed devices. Otherwise, a
beep is issued via the APM OEM BIOS extension (Int 15h, AX=5380h, BH=11h).
000B User System Suspend Request Notification
(
APM_USER_SUSPEND
)
A Get Power Status call determines if the terminal is on charge.
OEM Extended APM Event Processing
Any APM event in the range of 200h to 2FFh is defined to be an OEM extension
by the APM standard. Below are the OEM extended APM events for which
NPOWER will perform specific actions. APM events not listed are broadcast:
0203
Pod 1 Ring Detect
(APM_OEM_POD1)
If the terminal was previously suspended, then all of the processing normally performed for a Normal ReĆ
sume System Notification is performed. Unless the /SS:1 switch has been specified, the Pod 1 Ring Detect
is also broadcast.
0204
Pod 2 Ring Detect
(APM_OEM_POD2)
If the terminal was previously suspended, then all of the processing normally performed for a Normal ReĆ
sume System Notification is performed. Unless the /SS:1 switch has been specified, the Pod 2 Ring Detect
is also broadcast.
0205
COM1 Ring Detect
(APM_OEM_EXTRING)
If the terminal was previously suspended, then all of the processing normally performed for a normal reĆ
sume system notification resume notification is performed. Unless the /SS:1 switch was specified, the
COM1 Ring Detect is also broadcast.
0206
PCMCIA Ring Detect
(APM_OEM_PCMCIA)
If the terminal was previously suspended, then all of the processing normally performed for a Normal ReĆ
sume System Notification is performed. Unless the /SS:1 switch has been specified, the PCMCIA Ring
Detect is also broadcast.
0207
RealĆTime Clock (RTC) Alarm
(APM_OEM_ALARM)
If the terminal was previously suspended, then all of the processing normally performed for a Normal ReĆ
sume System Notification is performed. Unless the /SS:1 switch has been specified, the RTC Alarm Detect
is also broadcast.
020B
Backup Battery Low
Backup battery low warnings are handled significantly different from main battery warnings. First of all,
there is no way for NPOWER to query the state of the backup battery. That means that once a warning is
received, there is no way to query the system to determine when warnings are no longer required. The
only way to determine if warnings are still required is the absence of additional warnings being received
from the APM BIOS. Thus, low backup battery warnings are broadcast:
"
Each time a warning is received from the APM BIOS.
"
Each time a timer expires after having broadcast the first" warning.
"
At regular intervals (based upon the warning timer) so long as another warning is received
from the APM BIOS while the timer is still counting
0214
Backlight On Pressed
(APM_OEM_EL)
If backlight management is enable (via the /BL switch), a backlight change event from the APM BIOS
causes NPOWER to perform a Get Power State to get the current state, and then rearms the countdown
timers (including the global backlight counter). This event is not broadcast.
2. DOS
Applications
