01.06.2013 Views

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Return Value<br />

Comments<br />

DX=0 (always success) AX: 0<br />

The system maintains a "Task Wakeup Pending " flag for each task. This flag is set when<br />

RTX_WAKEUP_TASK is called for a task which is not currently awaiting wakeup (i.e. when bit 7 in Task<br />

State is zero). In the case where "Task Wakeup Pending " flag had been set, this RTX_SLEEP_REQ<br />

API clears this flag and returns immediately.<br />

Related Topics<br />

Top of list<br />

Index page<br />

<strong>RTOS</strong> Task Control Services<br />

RTX_WAKEUP_TASK Wake up a task<br />

RTX_SLEEP_TIME Timed sleep<br />

Interrupt 0xAD service 0x06: RTX_WAKEUP_TASK, Wake up a task<br />

Parameters<br />

AH<br />

BX<br />

To wake up a task known to be waiting because of a RTX_SLEEP_REQ or RTX_SLEEP_TIME call.<br />

0x06 (= RTX_WAKEUP_TASK)<br />

taskID<br />

Return Value<br />

Comments<br />

DX =0 success<br />

DX!=0 failure AX: contains error code<br />

An immediate task switch will occur if the task being wakened is of higher priority than the current task.<br />

If this API is called for a task which is not currently awaiting wakeup, error code -6 is returned. In this<br />

case a wakeup is left pending such that when the specified task eventually makes a call to<br />

RTX_SLEEP_REQ or RTX_SLEEP_TIME API, it will react (once) to this pending wakeup and return<br />

immediately without a sleep period.<br />

Related Topics<br />

<strong>RTOS</strong> Task Control Services<br />

RTX_SLEEP_REQ Sleep until wake up call<br />

RTX_SLEEP_TIME Timed sleep<br />

Page 189 / 400

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!