Everything

act_tsk

iact_tsk

Outline
Activate task (queues an activation request).
C format
 ER      act_tsk ( ID tskid );
 
 ER      iact_tsk ( ID tskid );

Assembly format
 MOV     A, #tskid
 CALL    !!_act_tsk
 
 MOV     A, #tskid
 CALL    !!_iact_tsk

Parameter(s)
I/O
Parameter
Description
I
 ID      tskid;
ID number of the task to be activated.
TSK_SELF: Invoking task.
Value: ID number of the task to be activated.

Explanation
These service calls move a task specified by parameter tskid from the DORMANT state to the READY state.
As a result, the target task is queued at the end on the ready queue corresponding to the initial priority and becomes subject to scheduling by the RI78V4.
If the target task has been moved to a state other than the DORMANT state when this service call is issued, this service call does not move the state but increments the activation request counter (by added 0x1 to the wakeup request counter).
Note 1 The activation request counter managed by the RI78V4 is configured in 7-bit widths. If the number of activation requests exceeds the maximum count value 127 as a result of issuing this service call, the counter manipulation processing is therefore not performed but "E_QOVR" is returned.
Note 2 An extended infomration "Extended information: exinf" is passed to the task activated by issuing this service call.
Return value
Macro
Value
Description
E_OK
0
Normal completion.
E_QOVR
-43
Queue overflow (overflow of activation request count "127").