pSOSystem System Calls - Read

pSOS+ System Calls tm_evwhen
Return Value
Error Codes
Notes
ticks An optional count that begins after the last second of time has
elapsed. This parameter provides a finer resolution of time, if
needed.
events Specifies the events to deliver upon expiration of the timer. The
events are encoded into a long word with bits 31-16 reserved for
system use and bits 15 - 0 available for application use.
tmid Points to the variable where tm_evwhen() stores a timer identifier,
which can be used if the armed timer must be cancelled.
This system call returns 0 on success, or an error code on failure.
Hex Mnemonic Description
0x47 ERR_NOTIME System time and date are not yet set.
0x48 ERR_ILLDATE Date input is out of range.
0x49 ERR_ILLTIME Time of day input is out of range.
0x4A ERR_ILLTICKS Ticks input out of range.
0x4B ERR_NOTIMERS Exceeds maximum number of
configured timers.
0x4E ERR_TOOLATE Too late: input date and time are
already past.
1. A timer is counted down by successive tm_tick() calls. If no clock or timer is
provided, a timer does not expire.
2. A timer established by tm_evwhen() is affected by a tm_set() call if that call
changes the date and time. If a tm_set() advances the time past a scheduled
alarm, it triggers the ev_send() immediately. To detect this situation, the
application can check the time when it awakens and compare it with the
expected time.
3. A task must explicitly call ev_receive() to receive a timer-triggered event
(which is like any event in every other way).
pSOSystem System Calls 1-171
1