lab2
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
lab2 [2010/02/24 18:07] – natalia | lab2 [2010/03/19 12:50] (current) – natalia | ||
---|---|---|---|
Line 39: | Line 39: | ||
You MUST invoke OSIntEnter() and OSIntExit() in pairs. In other words, for every call to OSIntEnter() at the beginning of the ISR you MUST have a call to OSIntExit() at the end of the ISR. | You MUST invoke OSIntEnter() and OSIntExit() in pairs. In other words, for every call to OSIntEnter() at the beginning of the ISR you MUST have a call to OSIntExit() at the end of the ISR. | ||
- | Please note that rescheduling is prevented when the scheduler is locked (see [[syntax# | + | Please note that rescheduling is prevented when the scheduler is locked (see OSSchedLock) |
== OSTaskCreate == | == OSTaskCreate == | ||
Line 46: | Line 46: | ||
Signature: | Signature: | ||
< | < | ||
+ | |||
+ | Arguments: | ||
+ | * Task argument is a pointer to the task's code | ||
+ | * P_arg argument is a pointer to an optional data area which can be used to pass parameters to the task when the task first executes. Where the task is concerned it thinks it was invoked and passed the argument ' | ||
+ | < | ||
+ | { | ||
+ | for (;;) | ||
+ | { | ||
+ | Task code; | ||
+ | } | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | * Ptos argument is a pointer to the task's top of stack. If the configuration constant OS_STK_GROWTH is set to 1, the stack is assumed to grow downward (i.e. from high memory to low memory). ' | ||
+ | * Prio argument is the task's priority. A unique priority MUST be assigned to each task and the lower the number, the higher the priority. | ||
+ | |||
+ | Returns: | ||
+ | * OS_ERR_NONE: | ||
+ | * OS_PRIO_EXIT: | ||
+ | * OS_ERR_PRIO_INVALID: | ||
+ | * OS_ERR_TASK_CREATE_ISR: | ||
+ | |||
+ | == OSTaskDel == | ||
+ | OSTaskDel function allows you to delete a task. The calling task can delete itself by its own priority number. The deleted task is returned to the dormant state and can be re-activated by creating the deleted task again. | ||
+ | |||
+ | Signature: | ||
+ | < | ||
+ | Arguments: | ||
+ | * prio argument is the priority of the task to delete. Note that you can explicitely delete the current task without knowing its priority level by setting ' | ||
+ | |||
+ | Returns: | ||
+ | * OS_ERR_NONE: | ||
+ | * OS_ERR_TASK_DEL_IDLE: | ||
+ | * OS_ERR_PRIO_INVALID: | ||
+ | * OS_ERR_TASK_DEL: | ||
+ | * OS_ERR_TASK_NOT_EXIST: | ||
+ | * OS_ERR_TASK_DEL_ISR : if you tried to delete a task from an ISR. | ||
+ | |||
+ | Please note: | ||
+ | * To reduce interrupt latency, OSTaskDel() ' | ||
+ | * by making it not ready | ||
+ | * by removing it from any wait lists | ||
+ | * by preventing OSTimeTick() from making the task ready to run. The task can then be ' | ||
+ | * The function OS_Dummy() is called after OS_EXIT_CRITICAL() because, on most processors, the next instruction following the enable interrupt instruction is ignored. | ||
+ | * An ISR cannot delete a task. | ||
+ | * The lock nesting counter is incremented because, for a brief instant, if the current task is being deleted, the current task would not be able to be rescheduled because it is removed from the ready list. Incrementing the nesting counter prevents another task from being scheduled. This means that an ISR would return to the current task which is being deleted. The rest of the deletion would thus be able to be completed. | ||
+ | |||
+ | == OSTaskDelReq == | ||
+ | OSTaskDelReq function is used to notify a task to delete itself and to see if a task requested that the current task delete itself. This function is a little tricky to understand. Basically, you have a task that needs to be deleted however, this task has resources that it has allocated (memory buffers, semaphores, mailboxes, queues etc.). The task cannot be deleted otherwise these resources would not be freed. The requesting task calls OSTaskDelReq() to indicate that the task needs to be deleted. Deleting of the task is however, deferred to the task to be deleted. For example, suppose that task #10 needs to be deleted. The requesting task example, task #5, would call OSTaskDelReq(10). When task #10 gets to execute, it calls this function by specifying OS_PRIO_SELF and monitors the returned value. If the return value is OS_ERR_TASK_DEL_REQ, | ||
+ | < | ||
+ | void Task(void *p_arg) | ||
+ | { | ||
+ | . | ||
+ | . | ||
+ | . | ||
+ | while (1) | ||
+ | { | ||
+ | OSTimeDly(1); | ||
+ | if (OSTaskDelReq(OS_PRIO_SELF) == OS_ERR_TASK_DEL_REQ) | ||
+ | { | ||
+ | | ||
+ | | ||
+ | | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | Arguments: | ||
+ | * Prio argument is the priority of the task to request the delete from | ||
+ | |||
+ | Returns : | ||
+ | * OS_ERR_NONE: | ||
+ | * OS_ERR_TASK_NOT_EXIST: | ||
+ | * OS_ERR_TASK_DEL: | ||
+ | * OS_ERR_TASK_DEL_IDLE: | ||
+ | * OS_ERR_PRIO_INVALID: | ||
+ | * OS_ERR_TASK_DEL_REQ: | ||
+ | |||
+ | == OSTaskSuspend == | ||
+ | OSTaskSuspend function is called to suspend a task. The task can be the calling task if the priority passed to OSTaskSuspend() is the priority of the calling task or OS_PRIO_SELF. You should use this function with great care. If you suspend a task that is waiting for an event (i.e. a message, a semaphore, a queue ...) you will prevent this task from running when the event arrives. | ||
+ | |||
+ | Arguments: | ||
+ | * Prio arguments is the priority of the task to suspend. If you specify OS_PRIO_SELF, | ||
+ | |||
+ | Returns: | ||
+ | * OS_ERR_NONE: | ||
+ | * OS_ERR_TASK_SUSPEND_IDLE: | ||
+ | * OS_ERR_PRIO_INVALID: | ||
+ | * OS_ERR_TASK_SUSPEND_PRIO: | ||
+ | * OS_ERR_TASK_NOT_EXITS: | ||
+ | |||
+ | == OSTaskResume == | ||
+ | OSTaskResume function is called to resume a previously suspended task. This is the only call that will remove an explicit task suspension. | ||
+ | |||
+ | Returns: | ||
+ | * OS_ERR_NONE: | ||
+ | * OS_ERR_PRIO_INVALID: | ||
+ | * OS_ERR_TASK_RESUME_PRIO: | ||
+ | * OS_ERR_TASK_NOT_EXIST: | ||
+ | * OS_ERR_TASK_NOT_SUSPENDED: | ||
+ | |||
+ | == OSTaskChangePrio == | ||
+ | OSTaskChangePrio function allows you to change the priority of a task dynamically. Note that the new priority MUST be available. | ||
+ | |||
+ | Returns: | ||
+ | * OS_ERR_NONE: | ||
+ | * OS_ERR_PRIO_INVALID: | ||
+ | * OS_ERR_PRIO_EXIST: | ||
+ | * OS_ERR_PRIO: | ||
+ | * OS_ERR_TASK_NOT_EXIST: | ||
+ | |||
+ | == OSSchedLock == | ||
+ | OSSchedLock function is used to prevent rescheduling to take place. This allows your application to prevent context switches until you are ready to permit context switching. You MUST invoke OSSchedLock() and OSSchedUnlock() in pair. In other words, for every call to OSSchedLock() you MUST have a call to OSSchedUnlock(). | ||
+ | |||
+ | == OSSchedUnlock == | ||
+ | OSSchedUnlock function is used to re-allow rescheduling. You MUST invoke OSSchedLock() and OSSchedUnlock() in pair. In other words, for every call to OSSchedLock() you MUST have a call to OSSchedUnlock(). | ||
+ | |||
+ | == OSTimeDly == | ||
+ | OSTimeDly function is called to delay execution of the currently running task until the specified number of system ticks expires. This, of course, directly equates to delaying the current task for some time to expire. No delay will result If the specified delay is 0. If the specified delay is greater than 0 then, a context switch will result. | ||
+ | |||
+ | Arguments: | ||
+ | * " | ||
+ | |||
+ | == OSTimeDlyHMSM == | ||
+ | OSTimeDlyHMSM function is called to delay execution of the currently running task until some time expires. This call allows you to specify the delay time in HOURS, MINUTES, SECONDS and | ||
+ | MILLISECONDS instead of ticks. | ||
+ | |||
+ | == OS_ENTER_CRITICAL == | ||
+ | OS_ENTER_CRITICAL() is a macro inserts the machine instruction into your code to block all interrupts. | ||
+ | |||
+ | == OS_EXIT_CRITICAL == | ||
+ | OS_EXIT_CRITICAL() is a macro inserts the machine instruction to enable interrupts. | ||
+ | |||
+ | == OSSemCreate == | ||
+ | OSSemCreate function creates a semaphore. | ||
+ | |||
+ | Arguments: | ||
+ | * " | ||
+ | |||
+ | Returns: | ||
+ | * (void *)0 if no event control blocks were available. Otherwise return is a pointer to the event control block (OS_EVENT) associated with the created semaphore. | ||
+ | |||
+ | == OSSemPost == | ||
+ | OSSemPost function signals a semaphore Argument pevent is a pointer to the event control block associated with the desired semaphore. | ||
+ | |||
+ | Returns: | ||
+ | * OS_ERR_NONE: | ||
+ | * OS_ERR_SEM_OVF: | ||
+ | * OS_ERR_EVENT_TYPE: | ||
+ | * OS_ERR_PEVENT_NULL: | ||
+ | |||
+ | == OSSemPendAbort == | ||
+ | OSSemPendAbort function aborts & readies any tasks currently waiting on a semaphore. This function should be used to fault-abort the wait on the semaphore, rather than to normally signal the semaphore via OSSemPost(). | ||
+ | ==== Prelab studies ==== | ||
+ | Please make sure to read and understand the license agreements listed below: | ||
+ | * {{: | ||
+ | * {{: | ||
+ | * {{: | ||
+ | * {{: | ||
+ | Also read the following study guides and application notes: | ||
+ | * {{: | ||
+ | * {{: | ||
+ | * {{: | ||
+ | * {{: | ||
+ | * {{: | ||
+ | * {{: | ||
+ | * {{: | ||
+ | * {{: | ||
+ | |||
+ | |||
+ | ==== Evaluation ==== | ||
+ | μC/OS-II source code is divided into platform dependent and platform independent files. Platform independent files can be found in Micrium/ | ||
+ | |||
+ | By study the source structure and Micrium/ | ||
+ | - Write a pseudo code using μC/OS-II to create two tasks and protect their critical sections that is accessing a common variable called XYZ. | ||
+ | - In your own words, explain how multitasking is achieved in the μC/OS-II (pay special attention to os_cpu_a.s)? | ||
+ | |||
+ | ==== Resources ===== | ||
+ | * {{: |
lab2.1267034832.txt.gz · Last modified: 2010/02/24 18:07 by natalia