IAR PowerPac RTOS User Guide
IAR PowerPac RTOS User Guide IAR PowerPac RTOS User Guide
OS_Q_GetPtrTimed()DescriptionRetrieves a message from a queue within a specified time if a message is available.Prototypeint OS_Q_GetPtrTimed (OS_Q* pQ,void** ppData,OS_TIME Timeout);ParameterDescriptionpQppDataTimeoutReturn value0: No message available in queue.>0: Size of message that was retrieved from queue.Additional InformationIf the queue is empty, no message is retrieved, the task is suspended for the given timeout. The task continues execution,according to the rules of the scheduler, as soon as a message is available within the given timeout, or after the timeoutvalue has expired.Examplestatic void MemoryTask(void) {char MemoryEvent;int Len;char* pData;while (1) {Len = OS_Q_GetPtrTimed(&_MemoryQ, &pData, 10); /* Check message */if (Len > 0) {Memory_WritePacket(*(U32*)pData, pData+4, Len); /* Process message */OS_Q_Purge(&_MemoryQ); /* Delete message */} else { /* Timeout */DoSomethingElse();}}}OS_Q_Purge()DescriptionDeletes the last retrieved message in a queue.Prototypevoid OS_Q_Purge (OS_Q* pQ);ParameterDescriptionAdditional InformationPointer to the queue.Table 77: OS_Q_GetPtrCond() parameter listpQTable 78: OS_Q_Purge() parameter listAddress of pointer to the message to be retrieved from queue.Maximum time in timer ticks until the requested message has to be available. The data typeOS_TIME defaults to an integer, therefore valid values are1
QueuesExamplestatic void MemoryTask(void) {char MemoryEvent;int Len;char* pData;}while (1) {Len = OS_Q_GetPtr(&_MemoryQ, &pData); /* Get message */Memory_WritePacket(*(U32*)pData, pData+4, Len); /* Process message */OS_Q_Purge(&_MemoryQ); /* Delete message */}OS_Q_Clear()DescriptionDeletes all message in a queue.Prototypevoid OS_Q_Clear (OS_Q* pQ);ParameterDescriptionpQPointer to the queue.Table 79: OS_Q_Clear() parameter listOS_Q_GetMessageCnt()DescriptionReturns the number of messages currently in a queue.Prototypeint OS_Q_GetMessageCnt (OS_Q* pQ);ParameterDescriptionpQReturn valuePointer to the queue.Table 80: OS_Q_GetMessageCnt() parameter listThe number of messages in the queue.PPRTOS-275
- Page 23 and 24: Basic conceptsLIST OF LIBRARIESIn y
- Page 25 and 26: Task routinesIntroductionA task tha
- Page 27 and 28: Task routinesOS_CREATETASK() can be
- Page 29 and 30: Task routinesExampleThe following e
- Page 31 and 32: Task routinesExampleint sec,min;voi
- Page 33 and 34: Task routinesAdditional Information
- Page 35 and 36: Task routinesReturn valueOS_TASKID:
- Page 37 and 38: Software timersSoftware timerA soft
- Page 39 and 40: Software timers#define OS_CREATETIM
- Page 41 and 42: Software timersOS_SetTimerPeriod()D
- Page 43 and 44: Software timersAdditional Informati
- Page 45 and 46: Software timersAdditional Informati
- Page 47 and 48: Software timersExampleOS_TIMER TIME
- Page 49 and 50: Resource semaphoresIntroductionReso
- Page 51 and 52: Resource semaphoresResource semapho
- Page 53 and 54: Resource semaphoresOS_Request()Desc
- Page 55 and 56: Counting SemaphoresIntroductionCoun
- Page 57 and 58: Counting SemaphoresPrototypevoid OS
- Page 59 and 60: Counting SemaphoresReturn value0: I
- Page 61 and 62: MailboxesWhy mailboxes?In the prece
- Page 63 and 64: MailboxesMailboxes API function ove
- Page 65 and 66: MailboxesExampleSingle-byte mailbox
- Page 67 and 68: MailboxesPrototypevoid OS_GetMail (
- Page 69 and 70: MailboxesOS_WaitMail()DescriptionWa
- Page 71 and 72: QueuesWhy queues?In the preceding c
- Page 73: QueuesReturn valueThe size of the r
- Page 77 and 78: Task eventsIntroductionTask events
- Page 79 and 80: Task eventsExampleOS_WaitEventTimed
- Page 81 and 82: Task eventsPrototypechar OS_ClearEv
- Page 83 and 84: Event objectsIntroductionEvent obje
- Page 85 and 86: Event objectsExampleif (OS_EVENT_Wa
- Page 87 and 88: Event objectsExampleOS_EVENT_Reset(
- Page 89 and 90: Heap type memory managementANSI C o
- Page 91 and 92: Fixed block size memory poolsIntrod
- Page 93 and 94: Fixed block size memory poolsProtot
- Page 95 and 96: Fixed block size memory poolsProtot
- Page 97 and 98: StacksIntroductionThe stack is the
- Page 99 and 100: InterruptsIntroductionIn this chapt
- Page 101 and 102: InterruptsRules for interrupt handl
- Page 103 and 104: InterruptsOS_LeaveInterruptNoSwitch
- Page 105 and 106: InterruptsNesting interrupt routine
- Page 107 and 108: Critical RegionsIntroductionCritica
- Page 109 and 110: System variablesIntroductionThe sys
- Page 111 and 112: Configuration for your targetsystem
- Page 113 and 114: Time measurementIntroductionIAR Pow
- Page 115 and 116: Time measurementPrototypeU32 OS_Get
- Page 117 and 118: Time measurementPrototypeOS_U32 OS_
- Page 119 and 120: RTOS-aware debuggingThis chapter de
- Page 121 and 122: RTOS-aware debuggingTimersA softwar
- Page 123 and 124: DebuggingRuntime errorsSome error c
QueuesExamplestatic void MemoryTask(void) {char MemoryEvent;int Len;char* pData;}while (1) {Len = OS_Q_GetPtr(&_MemoryQ, &pData); /* Get message */Memory_WritePacket(*(U32*)pData, pData+4, Len); /* Process message */OS_Q_Purge(&_MemoryQ); /* Delete message */}OS_Q_Clear()DescriptionDeletes all message in a queue.Prototypevoid OS_Q_Clear (OS_Q* pQ);ParameterDescriptionpQPointer to the queue.Table 79: OS_Q_Clear() parameter listOS_Q_GetMessageCnt()DescriptionReturns the number of messages currently in a queue.Prototypeint OS_Q_GetMessageCnt (OS_Q* pQ);ParameterDescriptionpQReturn valuePointer to the queue.Table 80: OS_Q_GetMessageCnt() parameter listThe number of messages in the queue.PP<strong>RTOS</strong>-275