-
twai_sem
-
Acquire semaphore resource (with timeout).
ER twai_sem (ID semid, TMO tmout);
|
|
|
|
ID semid;
|
ID number of the semaphore from which resource is acquired.
|
|
TMO tmout;
|
Specified timeout (unit:millisecond).
TMO_FEVR: Waiting forever.
Value: Specified timeout.
|
This service call acquires a resource from the semaphore specified by parameter
semid (subtracts 0x1 from the semaphore counter).
If no resources are acquired from the target semaphore when service call is issued this (no available resources exist), this service call does not acquire resources but queues the invoking task to the target semaphore wait queue and moves it from the RUNNING state to the WAITING state with timeout (resource acquisition wait state).
The WAITING state for a semaphore resource is cancelled in the following cases, and then moved to the READY state.
WAITING State for a Semaphore Resource Cancel Operation
|
|
The resource was returned to the target semaphore as a result of issuing sig_sem.
|
|
The resource was returned to the target semaphore as a result of issuing isig_sem.
|
|
Forced release from waiting (accept rel_wai while waiting).
|
|
Forced release from waiting (accept irel_wai while waiting).
|
|
Polling failure or timeout.
|
|
Note 1 Invoking tasks are queued to the target semaphore wait queue in the order defined during configuration (FIFO order or priority order).
Note 2 TMO_FEVR is specified for wait time
tmout, processing equivalent to
wai_sem will be executed. When TMO_POL is specified, processing equivalent to
pol_sem /
ipol_sem will be executed.
|
|
|
|
|
|
|
|
|
|
|
- semid > Maximum ID number
|
|
|
- This service call was issued from a non-task.
- This service call was issued in the CPU locked state.
- This service call was issued in the dispatching disabled state.
|
|
|
- Specified semaphore is not registered.
|
|
|
Forced release from the WAITING state.
|
|
|
- Polling failure or timeout.
|