wup_tsk

iwup_tsk

概要

タスクの起床

C言語形式

 ER      wup_tsk ( ID tskid );
 
 ER      iwup_tsk ( ID tskid );
 

アセンブリ言語形式

 MOV     A, #tskid
 CALL    !!_wup_tsk
 
 MOV     A, #tskid
 CALL    !!_iwup_tsk
 

パラメータ

I/O

パラメータ

説明

I

 ID      tskid;
タスクのID

TSK_SELF: 自タスク

数値: タスクのID

 

機能

tskidで指定されたタスクのWAITING状態(起床待ち状態)を解除します。

これにより,対象タスクは,起床待ち状態からREADY状態へ,またはWAITING-SUSPENDED状態からSUSPENDED状態へと遷移します。

ただし,本サービス・コールを発行した際,対象タスクが起床待ち状態以外であった場合には,状態操作処理は実行されず,起床要求カウンタの加算処理(起床要求カウンタに0x1を加算)が実行されます。

備考1 本サービス・コールを発行した際,対象タスクがREADY状態へと遷移する場合は,該当タスクの優先度に対応したレディ・キューの最後尾にキューイングし直す処理もあわせて実行されます。

備考2 RI78V4が管理している起床要求カウンタは,7ビット幅で構成されています。このため,本サービス・コールの発行により,起床要求数が最大カウント値127を越える場合には,カウンタ操作処理は実行されず,戻り値として“E_QOVR”が返されます。

戻り値

マクロ

数値

意味

E_OK

0

正常終了

E_OBJ

-41

対象タスクがDORMANT状態である

E_QOVR

-43

起床要求数が127を越えた