Intermec ck1 Reference Guide

Page of 390
Chapter 2 — Configuring the CK1 System 
90 
CK1 SDK Programmer’s Reference Manual 
Getting the Alarm Value 
 
Purpose:  Get the alarm time set in the system. This function lets the application 
change the alarm time.  
 
Syntax: 
int devRTCalarmValueGet( int *a_hour, int *a_min, int 
*a_sec )
 
 On-CK1 Parameters:  a_hour 
Returns the alarm value for the hour that is set in the system 
a_min 
Returns the alarm value for the minute that is set in the 
system 
a_sec 
Returns the alarm value for the second that is set in the 
system 
 
On-CK1 Return: -1 
 Function 
failed 
0 Function 
succeeded 
 On-Host Parameters:  a_hour Unknown 
a_min Unknown 
a_sec Unknown 
 
On-Host Return:  Always return 0 
Waiting for the Alarm Arrival 
 
Purpose:  The application has no way to know if the alarm signal was generated, so if 
you want to make sure that your application responds, call this function. 
The application holds and waits for the alarm to happen (the application 
stops until the alarm signal is generated). The application holds forever if 
no alarm happens. 
If you use the alarm function to wake up the system in Suspend mode, you 
do not need to call this function in you application. Call 
devRTCalarmEnable(). The system deals with this alarm function in 
Suspend mode by itself. 
 
Syntax: 
int devRTCalarmWait( void )
 
 On-CK1 Parameters: None 
 
On-CK1 Return: -1 
 Function 
failed 
0 Function 
succeeded 
 On-Host Parameters: None 
 
On-Host Return:  Always return 0