IAR PowerPac RTOS User Guide

More documents

Recommendations

Info

Event objects................................................................................................................................................... 83Introduction........................................................................................................................................83Event object API function overview ................................................................................................83OS_EVENT_Create() ............................................................................................................................83OS_EVENT_Wait() ...............................................................................................................................84OS_EVENT_WaitTimed().....................................................................................................................84OS_EVENT_Set()..................................................................................................................................85OS_EVENT_Reset() ..............................................................................................................................86OS_EVENT_Pulse() ..............................................................................................................................87OS_EVENT_Get() .................................................................................................................................87OS_EVENT_Delete() ............................................................................................................................87Heap type memory management............................................................................................................... 89Heap type memory manager API reference ..................................................................................89Fixed block size memory pools.................................................................................................................. 91Introduction........................................................................................................................................91Memory pools API reference overview...........................................................................................91OS_MEMF_Create()..............................................................................................................................91OS_MEMF_Delete()..............................................................................................................................92OS_MEMF_Alloc() ...............................................................................................................................92OS_MEMF_AllocTimed().....................................................................................................................92OS_MEMF_Request() ...........................................................................................................................93OS_MEMF_Release()............................................................................................................................93OS_MEMF_FreeBlock()........................................................................................................................94OS_MEMF_GetNumBlocks() ...............................................................................................................94OS_MEMF_GetBlockSize() ..................................................................................................................94OS_MEMF_GetNumFreeBlocks() ........................................................................................................94OS_MEMF_GetMaxUsed()...................................................................................................................95OS_MEMF_IsInPool()...........................................................................................................................95Stacks................................................................................................................................................................ 97Introduction........................................................................................................................................97System stack.......................................................................................................................................97Task stack ...........................................................................................................................................97Interrupt stack ...................................................................................................................................97Stacks API function overview...........................................................................................................98OS_GetStackSpace()..............................................................................................................................98Interrupts......................................................................................................................................................... 99Introduction........................................................................................................................................99Interrupt latency................................................................................................................................99Causes of interrupt latencies ..................................................................................................................99Additional causes for interrupt latencies................................................................................................99Zero interrupt latency.....................................................................................................................100High / low priority interrupts .........................................................................................................100Rules for interrupt handlers............................................................................................................101General rules ........................................................................................................................................101Additional rules for preemptive multitasking ......................................................................................101Calling IAR PowerPac RTOS routines from within an ISR .........................................................101Interrupts API function overview.........................................................................................................102OS_EnterInterrupt() .............................................................................................................................1028IAR PowerPac RTOSfor ARM CoresPPRTOS-2
ContentsOS_LeaveInterrupt() ............................................................................................................................102OS_LeaveInterruptNoSwitch() ............................................................................................................103Example using OS_EnterInterrupt()/OS_LeaveInterrupt()..................................................................103Enabling / disabling interrupts from C........................................................................................... 103OS_IncDI() / OS_DecRI() ...................................................................................................................103OS_DI() / OS_EI() / OS_RestoreI() ....................................................................................................104Definitions of interrupt control macros (in RTOS.h) ..................................................................104Nesting interrupt routines..............................................................................................................105OS_EnterNestableInterrupt() ...............................................................................................................105OS_LeaveNestableInterrupt() ..............................................................................................................106OS_LeaveNestableInterruptNoSwitch() ..............................................................................................106Non-maskable interrupts (NMIs)................................................................................................... 106Critical Regions............................................................................................................................................ 107Introduction .....................................................................................................................................107Critical regions API function overview .........................................................................................107OS_EnterRegion()................................................................................................................................107OS_LeaveRegion() ..............................................................................................................................107System variables........................................................................................................................................... 109Introduction .....................................................................................................................................109Time variables.................................................................................................................................. 109OS_Time ..............................................................................................................................................109OS_TimeDex .......................................................................................................................................109OS internal variables and data-structures .................................................................................... 109Configuration for your target system..................................................................................................... 111Introduction .....................................................................................................................................111Hardware-specific routines.............................................................................................................111Configuration defines ...................................................................................................................... 111How to change settings...................................................................................................................111Setting the system frequency OS_FSYS..............................................................................................111Using a different timer to generate the tick-interrupts for IAR PowerPac RTOS ...............................112Changing the tick frequency ................................................................................................................112OS_CONFIG() ................................................................................................................................. 112STOP / HALT / IDLE modes ..........................................................................................................112Time measurement ..................................................................................................................................... 113Introduction .....................................................................................................................................113Low-resolution measurement........................................................................................................113Low-resolution measurement API function overview................................................................. 114OS_GetTime()......................................................................................................................................114OS_GetTime32()..................................................................................................................................114High-resolution measurement .......................................................................................................115High-resolution measurement API function overview................................................................ 116OS_TimingStart() ................................................................................................................................116OS_TimingEnd()..................................................................................................................................116OS_Timing_Getus().............................................................................................................................116OS_Timing_GetCycles() .....................................................................................................................116PPRTOS-29
Page 1 and 2: IAR PowerPac RTOSUser GuidePPRTOS-2
Page 3 and 4: PrefaceWelcome to the IAR PowerPac
Page 5 and 6: ContentsPreface ...................
Page 7: ContentsOS_WaitCSema() ............
Page 11 and 12: Introduction to IAR PowerPacRTOSWha
Page 13 and 14: Basic conceptsTasksIn this context,
Page 15 and 16: Basic conceptsPREEMPTIVES MULTITASK
Page 17 and 18: Basic conceptsMAILBOXES AND QUEUESA
Page 19 and 20: Basic conceptsThe active task may b
Page 21 and 22: Basic conceptsThe flowchart below i
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 and 74:
QueuesReturn valueThe size of the r
Page 75 and 76:
QueuesExamplestatic void MemoryTask
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
Page 125 and 126:
DebuggingValue Define Description17
Page 127 and 128:
Performance and resource usageThis
Page 129 and 130:
Performance and resource usageThe c
Page 131 and 132:
Performance and resource usage*/sta
Page 133 and 134:
ReentranceAll routines that can be
Page 135 and 136:
LimitationsThe following limitation
Page 137 and 138:
Source code of kernel and libraryIn
Page 139 and 140:
Additional modulesKeyboard manager:
Page 141 and 142:
FAQ (frequently asked questions)Q:
Page 143 and 144:
GlossaryActive TaskCooperativemulti
Page 145 and 146:
IndexIndexAAdditional modules . . .
Page 147:
IndexOS_WaitSingleEventTimed(). . .
show all

IAR PowerPac RTOS User Guide

Create successful ePaper yourself

Delete template?

Save as template?