Maxim Integrated High-Speed Microcontroller Users Guide: Network Microcontroller Supplement - Manual (Page 208)

High-Speed Microcontroller User’s
Guide: Network Microcontroller
Supplement
208
task_signal
Description: int task_signal(
int id, /* id of task to send signal */
int eventmask); /* eventmask containing event(s) to signal */
The task_signal function signals a task. This function sends event(s) in eventmask to a task. If the task is waiting for no other
events, it wakes up and is electable to be run by the task switcher. ID 0 means current task. This function returns a
success/failure code in the accumulator (ACC). It wakes up tasks that have been suspended by task_suspend().
TASK SCHEDULER USER HOOKS
To allow the user to expand upon implemented task scheduler, i.e., to save and restore additional properties of a task, the task sched-
uler calls hook functions. The user must make sure to preserve all of the parameters passed across the hook function call.
task_create
The task_create function is called when the very first task block is created by task_genesis. The DS80C400 silicon software imple-
mentation of this function does nothing. The parameters automatically passed to task_create by task_genesis are defined as follows.
task_duplicate
The task_duplicate function is called by the task_fork function. The DS80C400 silicon software implementation of this function does
nothing. The parameters automatically passed to task_duplicate by task_fork are defined as follows.
task_destroy
The task_destroy function is called when a task is destroyed by task_kill. The DS80C400 silicon software implementation of this func-
tion does nothing. The parameters automatically passed to task_destroy by task_kill are defined as follows.
rom_task_switch_in
The rom_task_switch_in function is called by the scheduler before a task is switched in. The DS80C400 silicon software implemen-
tation of this function restores the state buffer (stack and SFRs). This function is exported by the DS80C400 silicon software and also
serves as the default taskswitchin in the function redirect table.
Note: This function does not return. However, it returns to the caller of rom_task_switch_out with ACC = 0. The parameters passed
to
rom_task_switch_in are defined as follows.
INPUT DESCRIPTION OUTPUT DESCRIPTION
DPTR0 TCB of task to be switched in User-defined
INPUT DESCRIPTION OUTPUT DESCRIPTION
DPTR0 TCB of task to be removed User-defined
INPUT DESCRIPTION OUTPUT DESCRIPTION
R1: R0
R7
DPTR0
savesize
priority
Newly allocated TCB
User-defined
INPUT DESCRIPTION OUTPUT DESCRIPTION
R1: R0
DPTR0
savesize
Newly allocated TCB
User-defined
INPUT DESCRIPTION OUTPUT DESCRIPTION
ACC
B
id
eventmask
ACC Success (= 00h) or failure code
Example:
MOV A, … ;regular sleep for 10 seconds = 10000ms
MOV B, #TASK_USER0 ;user defined event
ROMCALL task_signal
Maxim Integrated