History.txt 150 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057
  1. Documentation and download available at https://www.FreeRTOS.org/
  2. Changes between FreeRTOS V10.5.0 and FreeRTOS V10.5.1 released November 16 2022
  3. + Updating the version in the manifest.yml file to be accurate.
  4. Changes between FreeRTOS V10.4.6 and FreeRTOS V10.5.0 released September 16 2022
  5. + ARMv7-M and ARMv8-M MPU ports: It was possible for a third party that
  6. already independently gained the ability to execute injected code to
  7. read from or write to arbitrary addresses by passing a negative argument
  8. as the xIndex parameter to pvTaskGetThreadLocalStoragePointer() or
  9. vTaskSetThreadLocalStoragePointer respectively. A check has been added to
  10. ensure that passing a negative argument as the xIndex parameter does not
  11. cause arbitrary read or write.
  12. We thank Certibit Consulting, LLC for reporting this issue.
  13. + ARMv7-M and ARMv8-M MPU ports: It was possible for an unprivileged task
  14. to invoke any function with privilege by passing it as a parameter to
  15. MPU_xTaskCreate, MPU_xTaskCreateStatic, MPU_xTimerCreate,
  16. MPU_xTimerCreateStatic, or MPU_xTimerPendFunctionCall. MPU_xTaskCreate
  17. and MPU_xTaskCreateStatic have been updated to only allow creation of
  18. unprivileged tasks. MPU_xTimerCreate, MPU_xTimerCreateStatic and
  19. MPU_xTimerPendFunctionCall APIs have been removed.
  20. We thank Huazhong University of Science and Technology for reporting
  21. this issue.
  22. + ARMv7-M and ARMv8-M MPU ports: It was possible for a third party that
  23. already independently gained the ability to execute injected code to
  24. achieve further privilege escalation by branching directly inside a
  25. FreeRTOS MPU API wrapper function with a manually crafted stack frame.
  26. The local stack variable `xRunningPrivileged` has been removed so that
  27. a manually crafted stack frame cannot be used for privilege escalation
  28. by branching directly inside a FreeRTOS MPU API wrapper.
  29. We thank Certibit Consulting, LLC, Huazhong University of Science and
  30. Technology and the SecLab team at Northeastern University for reporting
  31. this issue.
  32. + ARMv7-M MPU ports: It was possible to configure overlapping memory
  33. protection unit (MPU) regions such that an unprivileged task could access
  34. privileged data. The kernel now uses highest numbered MPU regions for
  35. kernel protections to prevent such MPU configurations.
  36. We thank the SecLab team at Northeastern University for reporting this
  37. issue.
  38. + Add support for ARM Cortex-M55.
  39. + Add support for ARM Cortex-M85. Contributed by @gbrtth.
  40. + Add vectored mode interrupt support to the RISC-V port.
  41. + Add support for RV32E extension (Embedded Profile) in RISC-V GCC port.
  42. Contributed by @Limoto.
  43. + Heap improvements:
  44. - Add a check to heap_2 to track if a memory block is allocated to
  45. the application or not. The MSB of the size field is used for this
  46. purpose. The same check already exists in heap_4 and heap_5. This
  47. check prevents double free errors.
  48. - Add a new flag configHEAP_CLEAR_MEMORY_ON_FREE to heap_2, heap_4
  49. and heap_5. If the flag is set in FreeRTOSConfig.h then memory freed using
  50. vPortFree() is automatically cleared to zero.
  51. - Add a new API pvPortCalloc to heap_2, heap_4 and heap_5 which has the same
  52. signature as the standard library calloc function.
  53. - Update the pointer types to portPOINTER_SIZE_TYPE. Contributed by
  54. @Octaviarius.
  55. + Add the ability to override send and receive completed callbacks for each
  56. instance of a stream buffer or message buffer. Earlier there could be
  57. one send and one receive callback for all instances of stream and message
  58. buffers. Having separate callbacks per instance allows different message
  59. and stream buffers to be used differently - for example, some for inter core
  60. communication and others for same core communication.
  61. The feature can be controlled by setting the configuration option
  62. configUSE_SB_COMPLETED_CALLBACK in FreeRTOSConfig.h. When the option is set to 1,
  63. APIs xStreamBufferCreateWithCallback() or xStreamBufferCreateStaticWithCallback()
  64. (and likewise APIs for message buffer) can be used to create a stream buffer
  65. or message buffer instance with application provided callback overrides. When
  66. the option is set to 0, then the default callbacks as defined by
  67. sbSEND_COMPLETED() and sbRECEIVE_COMPLETED() macros are invoked. To maintain
  68. backwards compatibility, configUSE_SB_COMPLETED_CALLBACK defaults to 0. The
  69. functionality is currently not supported for MPU enabled ports.
  70. + Generalize the FreeRTOS's Thread Local Storage (TLS) support so that it
  71. is not tied to newlib and can be used with other c-runtime libraries also.
  72. The default behavior for newlib support is kept same for backward
  73. compatibility.
  74. + Add support to build and link FreeRTOS using CMake build system. Contributed
  75. by @yhsb2k.
  76. + Add support to generate Software Bill of Materials (SBOM) for every release.
  77. + Add support for 16 MPU regions to the GCC Cortex-M33 ports.
  78. + Add ARM Cortex-M7 r0p0/r0p1 Errata 837070 workaround to ARM CM4 MPU ports.
  79. The application writer needs to define configENABLE_ERRATA_837070_WORKAROUND
  80. when using CM4 MPU ports on a Cortex-M7 r0p0/r0p1 core.
  81. + Add configSYSTICK_CLOCK_HZ to Cortex-M0 ports. This is needed to support
  82. the case when the SysTick timer is not clocked from the same source as the CPU.
  83. + Add hardware stack protection support to MicroBlazeV9 port. This ensures that
  84. the CPU immediately raises Stack Protection Violation exception as soon as any
  85. task violates its stack limits. Contributed by @uecasm.
  86. + Introduce the configUSE_MINI_LIST_ITEM configuration option. When this
  87. option is set to 1, ListItem_t and MiniLitItem_t remain separate types.
  88. However, when configUSE_MINI_LIST_ITEM == 0, MiniLitItem_t and ListItem_t
  89. are both typedefs of the same struct xLIST_ITEM. This addresses some issues
  90. observed when strict-aliasing and link time optimization are enabled.
  91. To maintain backwards compatibility, configUSE_MINI_LIST_ITEM defaults to 1.
  92. + Simplify prvInitialiseNewTask to memset newly allocated TCB structures
  93. to zero, and remove code that set individual structure members to zero.
  94. + Add prototype for prvPortYieldFromISR to the POSIX port so that it builds
  95. without any warning with -Wmissing-prototypes compiler option.
  96. + Add top of stack and end of stack to the task info report obtained using
  97. vTaskGetInfo(). Contributed by @shreyasbharath.
  98. + Add a cap to the cRxLock and cTxLock members of the queue data structure.
  99. These locks count the number items received and sent to the queue while
  100. the queue was locked. These are later used to unblock tasks waiting on
  101. the queue when the queue is unlocked. This PR caps the values of the
  102. cRxLock and cTxLock to the number of tasks in the system because we cannot
  103. unblock more tasks than there are in the system. Note that the same assert
  104. could still be triggered is the application creates more than 127 tasks.
  105. + Changed uxAutoReload parameter in timer functions to xAutoReload. The
  106. type is now BaseType_t. This matches the type of pdTRUE and pdFALSE.
  107. The new function xTimerGetAutoReload() provides the auto-reload state as
  108. a BaseType_t. The legacy function uxTimerGetAutoReload is retained with the
  109. original UBaseType_t return value.
  110. + Fix support for user implementations of tickless idle that call
  111. vTaskStepTick() with xExpectedIdleTime ticks to step. The new code
  112. ensures xTickCount reaches xNextTaskUnblockTime inside xTaskIncrementTick()
  113. instead of inside vTaskStepTick(). This fixes the typical case where a task
  114. wakes up one tick late and a rare case assertion failure when xTickCount\
  115. rolls over. Contributed by @jefftenney.
  116. + Fix deadlock in event groups when pvPortMalloc and vPortFree functions
  117. are protected with a mutex. Contributed by @clemenskresser.
  118. + Fix a warning in tasks.c when compiled with -Wduplicated-branches
  119. GCC option. Contributed by @pierrenoel-bouteville-act.
  120. + Fix compilation error in tasks.c when configSUPPORT_DYNAMIC_ALLOCATION
  121. is set to zero. Contributed by @rdpoor.
  122. + Fix prvWriteMessageToBuffer() function in stream_buffer.c so that it correctly
  123. copies length on big endian platforms too.
  124. + Remove the need for INCLUDE_vTaskSuspend to be set to 1
  125. when configUSE_TICKLESS_IDLE is enabled. Contributed by @pramithkv.
  126. + Update the RL78 IAR port to the latest version of IAR which uses the
  127. industry standard ELF format as opposed to earlier UBROF object format.
  128. Contributed by @felipe-iar.
  129. + Add tick type is atomic flag when tick count is 16-bit to PIC24 port. This
  130. allows the PIC24 family of 16 bit processors to read the tick count without
  131. a critical section when the tick count is also 16 bits.
  132. + Fix offset-out-of-range errors for GCC CM3/CM4 mpu ports when
  133. Link Time Optimization is enabled. Contributed by @niniemann.
  134. + Remove #error when RISC-V port is compiled on a 64-bit RISC-V platform.
  135. Contributed by @cmdrf.
  136. + Fix ullPortInterruptNesting alignment in Cortex-A53 port so that it is
  137. 8-byte aligned. This fixes the unaligned access exception. Contributed
  138. by @Atomar25.
  139. + Fix Interrupt Handler Register Function and Exception Process in NiosII
  140. Port. Contributed by @ghost.
  141. + Change FreeRTOS IRQ Handler for Cortex-A53 SRE port to store and restore
  142. interrupt acknowledge register. This ensures that the SRE port behavior
  143. matches the Memory Mapped IO port. Contributed by @sviaunxp.
  144. + Update the uncrustify config file to match the version of the uncrustify
  145. used in the CI Action. Also, pin the version of uncrustify in CI. Contributed
  146. by @swaldhoer.
  147. Changes between FreeRTOS V10.4.5 and FreeRTOS V10.4.6 released November 12 2021
  148. + ARMv7-M and ARMv8-M MPU ports – prevent non-kernel code from calling the
  149. internal functions xPortRaisePrivilege and vPortResetPrivilege by changing
  150. them to macros.
  151. + Introduce a new config configALLOW_UNPRIVILEGED_CRITICAL_SECTIONS which
  152. enables developers to prevent critical sections from unprivileged tasks.
  153. It defaults to 1 for backward compatibility. Application should set it to
  154. 0 to disable critical sections from unprivileged tasks.
  155. Changes between FreeRTOS V10.4.4 and FreeRTOS V10.4.5 released September 10 2021
  156. See https://www.FreeRTOS.org/FreeRTOS-V10.4.5.html
  157. + Introduce configRUN_TIME_COUNTER_TYPE which enables developers to define
  158. the type used to hold run time statistic counters. Defaults to uint32_t
  159. for backward compatibility. #define configRUN_TIME_COUNTER_TYPE to a type
  160. (for example, uint64_t) in FreeRTOSConfig.h to override the default.
  161. + Introduce ulTaskGetIdleRunTimePercent() to complement the pre-existing
  162. ulTaskGetIdleRunTimeCounter(). Whereas the pre-existing function returns
  163. the raw run time counter value, the new function returns the percentage of
  164. the entire run time consumed by the idle task. Note the amount of idle
  165. time is only a good measure of the slack time in a system if there are no
  166. other tasks executing at the idle priority, tickless idle is not used, and
  167. configIDLE_SHOULD_YIELD is set to 0.
  168. + ARMv8-M secure-side port: Tasks that call secure functions from the
  169. non-secure side of an ARMv8-M MCU (ARM Cortex-M23 and Cortex-M33) have two
  170. contexts - one on the non-secure side and one on the secure-side. Previous
  171. versions of the FreeRTOS ARMv8-M secure-side ports allocated the structures
  172. that reference secure-side contexts at run time. Now the structures are
  173. allocated statically at compile time. The change necessitates the
  174. introduction of the secureconfigMAX_SECURE_CONTEXTS configuration constant,
  175. which sets the number of statically allocated secure contexts.
  176. secureconfigMAX_SECURE_CONTEXTS defaults to 8 if left undefined.
  177. Applications that only use FreeRTOS code on the non-secure side, such as
  178. those running third-party code on the secure side, are not affected by
  179. this change.
  180. Changes between FreeRTOS V10.4.3 and FreeRTOS V10.4.4 released May 28 2021
  181. + Minor performance improvements to xTaskIncrementTick() achieved by providing
  182. macro versions of uxListRemove() and vListInsertEnd().
  183. + Minor refactor of timers.c that obsoletes the need for the
  184. tmrCOMMAND_START_DONT_TRACE macro and removes the need for timers.c to
  185. post to its own event queue. A consequence of this change is that auto-
  186. reload timers that miss their intended next execution time will execute
  187. again immediately rather than executing again the next time the command
  188. queue is processed. (thanks Jeff Tenney).
  189. + Fix a race condition in the message buffer implementation. The
  190. underlying cause was that length and data bytes are written and read as
  191. two distinct operations, which both modify the size of the buffer. If a
  192. context switch occurs after adding or removing the length bytes, but
  193. before adding or removing the data bytes, then another task may observe
  194. the message buffer in an invalid state.
  195. + The xTaskCreate() and xTaskCreateStatic() functions accept a task priority
  196. as an input parameter. The priority has always been silently capped to
  197. (configMAX_PRIORITIES - 1) should it be set to a value above that priority.
  198. Now values above that priority will also trigger a configASSERT() failure.
  199. + Replace configASSERT( pcQueueName ) in vQueueAddToRegistry with a NULL
  200. pointer check.
  201. + Introduce the configSTACK_ALLOCATION_FROM_SEPARATE_HEAP configuration
  202. constant that enables the stack allocated to tasks to come from a heap other
  203. than the heap used by other memory allocations. This enables stacks to be
  204. placed within special regions, such as fast tightly coupled memory.
  205. + If there is an attempt to add the same queue or semaphore handle to the
  206. queue registry more than once then prior versions would create two separate
  207. entries. Now if this is done the first entry is overwritten rather than
  208. duplicated.
  209. + Update the ESP32 port and TF-M (Trusted Firmware M)code to the latest from
  210. their respective repositories.
  211. + Correct a build error in the POSIX port.
  212. + Additional minor formatting updates, including replacing tabs with spaces
  213. in more files.
  214. + Other minor updates include adding additional configASSERT() checks and
  215. correcting and improving code comments.
  216. + Go look at the smp branch to see the progress towards the Symetric
  217. Multiprocessing Kernel. https://github.com/FreeRTOS/FreeRTOS-Kernel/tree/smp
  218. Changes between FreeRTOS V10.4.2 and FreeRTOS V10.4.3 released December 14 2020
  219. V10.4.3 is included in the 202012.00 LTS release. Learn more at https:/freertos.org/lts-libraries.html
  220. See https://www.FreeRTOS.org/FreeRTOS-V10.4.x.html
  221. + Changes to improve robustness and consistency for buffer allocation in
  222. the heap, queue and stream buffer.
  223. + The following functions can no longer be called from unprivileged code.
  224. - xTaskCreateRestricted
  225. - xTaskCreateRestrictedStatic
  226. - vTaskAllocateMPURegions
  227. Changes between FreeRTOS V10.4.1 and FreeRTOS V10.4.2 released November 10 2020
  228. See https://www.FreeRTOS.org/FreeRTOS-V10.4.x.html
  229. + Fix an issue in the ARMv8-M ports that caused BASEPRI to be masked
  230. between the first task starting to execute and that task making
  231. a FreeRTOS API call.
  232. + Introduced xTaskDelayUntil(), which is functionally equivalent to
  233. vTaskDelayUntil(), with the addition of returning a value to
  234. indicating whether or not the function placed the calling task into
  235. the Blocked state or not.
  236. + Update WolfSSL to 4.5.0 and add the FIPS ready demo.
  237. + Add support for ESP IDF 4.2 to ThirdParty Xtensa port.
  238. + Re-introduce uxTopUsedPriority to support OpenOCD debugging.
  239. + Convert most dependent libraries in FreeRTOS/FreeRTOS to submodules.
  240. + Various general maintenance and improvements to MISRA compliance.
  241. Changes between FreeRTOS V10.4.0 and FreeRTOS V10.4.1 released September 17 2020
  242. See https://www.FreeRTOS.org/FreeRTOS-V10.4.x.html
  243. + Fixed an incorrectly named parameter that prevented the
  244. ulTaskNotifyTakeIndexed macro compiling, and the name space clash in the
  245. test code that prevented this error causing test failures.
  246. Changes between FreeRTOS V10.3.1 and FreeRTOS V10.4.0 released September 10 2020
  247. See https://www.FreeRTOS.org/FreeRTOS-V10.4.x.html
  248. Major enhancements:
  249. + Task notifications: Prior to FreeRTOS V10.4.0 each created task had a
  250. single direct to task notification. From FreeRTOS V10.4.0 each task has
  251. an array of notifications. The direct to task notification API has been
  252. extended with API functions postfixed with "Indexed" to enable the API to
  253. operate on a task notification at any array index. See
  254. https://www.freertos.org/RTOS-task-notifications.html for more information.
  255. + Kernel ports that support memory protection units (MPUs): The ARMv7-M and
  256. ARMv8-M MPU ports now support a privilege access only heap. The ARMv7-M
  257. MPU ports now support devices that have 16 MPU regions, have the ability
  258. to override default memory attributes for privileged code and data
  259. regions, and have the ability to place the FreeRTOS kernel code outside of
  260. the Flash memory. The ARMv8-M MPU ports now support tickless idle mode.
  261. See https://www.freertos.org/FreeRTOS-MPU-memory-protection-unit.html
  262. for more information.
  263. Additional noteworthy updates:
  264. + Code formatting is now automated to facilitate the increase in
  265. collaborative development in Git. The auto-formated code is not identical
  266. to the original formatting conventions. Most notably spaces are now used
  267. in place of tabs.
  268. + The prototypes for callback functions (those that start with "Application",
  269. such as vApplicationStackOverflowHook()) are now in the FreeRTOS header
  270. files, removing the need for application writers to add prototypes into
  271. the C files in which they define the functions.
  272. + New Renesas RXv3 port layer.
  273. + Updates to the Synopsys ARC code, including support for EM and HS cores,
  274. and updated BSP.
  275. + Added new POSIX port layer that allows FreeRTOS to run on Linux hosts in
  276. the same way the Windows port layer enables FreeRTOS to run on Windows
  277. hosts.
  278. + Many other minor optimisations and enhancements. For full details
  279. see https://github.com/FreeRTOS/FreeRTOS-Kernel/commits/main
  280. Changes between FreeRTOS V10.3.0 and FreeRTOS V10.3.1 released February 18 2020
  281. See https://www.FreeRTOS.org/FreeRTOS-V10.3.x.html
  282. + ./FreeRTOS-Labs directory was removed from this file. The libraries it
  283. contained are now available as a separate download.
  284. Changes between FreeRTOS V10.2.1 and FreeRTOS V10.3.0 released February 7 2020
  285. See https://www.FreeRTOS.org/FreeRTOS-V10.3.x.html
  286. New and updated kernel ports:
  287. + Added RISC-V port for the IAR compiler.
  288. + Update the Windows simulator port to use a synchronous object to prevent
  289. a user reported error whereby a task continues to run for a short time
  290. after being moved to the Blocked state. Note we were not able to
  291. replicate the reported issue and it likely depends on your CPU model.
  292. + Correct alignment of stack top in RISC-V port when
  293. configISR_STACK_SIZE_WORDS is defined to a non zero value, which causes
  294. the interrupt stack to be statically allocated.
  295. + The RISC-V machine timer compare register can now be for any HART, whereas
  296. previously it was always assumed FreeRTOS was running on HART 0.
  297. + Update the sequence used to update the 64-bit machine timer
  298. compare register on 32-bit cores to match that suggested in RISC-V
  299. documentation.
  300. + Added tickless low power modes into the ARM, IAR and GCC Cortex-M0 compiler
  301. ports.
  302. + Updated the behaviour of the ARMv7-M MPU (Memory Protection Unit) ports to
  303. match that of the ARMv8-M ports whereby privilege escalations can only
  304. originate from within the kernel's own memory segment. Added
  305. configENFORCE_SYSTEM_CALLS_FROM_KERNEL_ONLY configuration constant.
  306. + Update existing MPU ports to correctly disable the MPU before it is
  307. updated.
  308. + Added contributed port and demo application for a T-Head (formally C-SKY)
  309. microcontroller.
  310. New API functions:
  311. + Added the vPortGetHeapStats() API function which returns information on
  312. the heap_4 and heap_5 state.
  313. + Added xTaskCatchUpTicks(), which corrects the tick count value after the
  314. application code has held interrupts disabled for an extended period.
  315. + Added xTaskNotifyValueClear() API function.
  316. + Added uxTimerGetReloadMode() API function.
  317. Other miscellaneous changes:
  318. + Change type of uxPendedTicks from UBaseType_t to TickType_t to ensure it
  319. has the same type as variables with which it is compared to, and therefore
  320. also renamed the variable xPendingTicks.
  321. + Update Keil projects that use the MPU so memory regions come from linker
  322. script (scatter file) variables instead of being hard coded.
  323. + Added LPC51U68 Cortex-M0+ demos for GCC (MCUXpresso), Keil and IAR
  324. compilers.
  325. + Added CORTEX_MPU_STM32L4_Discovery_Keil_STM32Cube demo.
  326. + Added LPC54018 MPU demo.
  327. + Rename xTaskGetIdleRunTimeCounter() to ulTaskGetIdleRunTimeCounter().
  328. Changes between FreeRTOS V10.2.1 and FreeRTOS V10.2.0 released May 13 2019:
  329. + Added ARM Cortex-M23 port layer to complement the pre-existing ARM
  330. Cortex-M33 port layer.
  331. + The RISC-V port now automatically switches between 32-bit and 64-bit
  332. cores.
  333. + Introduced the portMEMORY_BARRIER macro to prevent instruction re-ordering
  334. when GCC link time optimisation is used.
  335. + Introduced the portDONT_DISCARD macro to the ARMv8-M ports to try and
  336. prevent the secure side builds from removing symbols required by the
  337. non secure side build.
  338. + Introduced the portARCH_NAME to provide additional data to select semi-
  339. automated build environments.
  340. + Cortex-M33 and Cortex-M23 ports now correctly disable the MPU before
  341. updating the MPU registers.
  342. + Added Nuvoton NuMaker-PFM-M2351 ARM Cortex-M23 demo.
  343. + Added LPC55S69 ARM Cortex-M33 demo.
  344. + Added an STM32 dual core AMP stress test demo.
  345. Changes between FreeRTOS V10.1.1 and FreeRTOS V10.2.0 released February 25 2019:
  346. + Added GCC RISC-V MCU port with three separate demo applications.
  347. + Included pre-existing ARM Cortex-M33 (ARMv8-M) GCC/ARMclang and IAR ports
  348. with Keil simulator demo.
  349. + Update the method used to detect if a timer is active. Previously the
  350. timer was deemed to be inactive if it was not referenced from a list.
  351. However, when a timer is updated it is temporarily removed from, then
  352. re-added to a list, so now the timer's active status is stored separately.
  353. + Add vTimerSetReloadMode(), xTaskGetIdleRunTimeCounter(), and
  354. xTaskGetApplicationTaskTagFromISR() API functions.
  355. + Updated third party Xtensa port so it is MIT licensed.
  356. + Added configINCLUDE_PLATFORM_H_INSTEAD_OF_IODEFINE_H to the Renesas
  357. compiler RX600v2 port to enable switching between platform.h and
  358. iodefine.h includes within that port's port.c file.
  359. + Removed the 'FromISR' functions from the MPU ports as ISRs run privileged
  360. anyway.
  361. + Added uxTaskGetStackHighWaterMark2() function to enable the return type to
  362. be changed without breaking backward compatibility.
  363. uxTaskGetStackHighWaterMark() returns a UBaseType_t as always,
  364. uxTaskGetStackHighWaterMark2() returns configSTACK_DEPTH_TYPE to allow the
  365. user to determine the return type.
  366. + Fixed issues in memory protected ports related to different combinations
  367. of static memory only and dynamic memory only builds. As a result the
  368. definition of tskSTATIC_AND_DYNAMIC_ALLOCATION_POSSIBLE became more
  369. complex and was moved to FreeRTOS.h with a table explaining its definition.
  370. + Added a 'get task tag from ISR' function.
  371. + Change the method used to determine if a timer is active or not from just
  372. seeing if it is referenced from the active timer list to storing its
  373. active state explicitly. The change prevents the timer reporting that it
  374. is inactive while it is being moved from one list to another.
  375. + The pcName parameter passed into the task create functions can be NULL,
  376. previously a name had to be provided.
  377. + When using tickless idle, prvResetNextTaskUnblockTime() is now only called
  378. in xTaskRemoveFromEventList() if the scheduler is not suspended.
  379. + Introduced portHAS_STACK_OVERFLOW_CHECKING, which should be set to 1 for
  380. FreeRTOS ports that run on architectures that have stack limit registers.
  381. Changes between FreeRTOS V10.1.0 and FreeRTOS V10.1.1 released 7 September 2018
  382. + Reverted a few structure name changes that broke several kernel aware
  383. debugger plug-ins.
  384. + Updated to the latest trace recorder code.
  385. + Fixed some formatting in the FreeRTOS+TCP TCP/IP stack code.
  386. + Reverted moving some variables from file to function scope as doing so
  387. broke debug scenarios that require the static qualifier to be removed.
  388. Changes between FreeRTOS V10.0.1 and FreeRTOS V10.1.0 released 22 August 2018
  389. FreeRTOS Kernel Changes:
  390. + Update lint checked MISRA compliance to use the latest MISRA standard, was
  391. previously using the original MISRA standard.
  392. + Updated all object handles (TaskHandle_t, QueueHandle_t, etc.) to be
  393. unique types instead of void pointers, improving type safety. (this was
  394. attempted some years back but had to be backed out due to bugs in some
  395. debuggers). Note this required the pvContainer member of a ListItem_t
  396. struct to be renamed - set configENABLE_BACKWARD_COMPATIBILITY to 1 if
  397. this causes an issue.
  398. + Added configUSE_POSIX_ERRNO to enable per task POSIX style errno
  399. functionality in a more user friendly way - previously the generic thread
  400. local storage feature was used for this purpose.
  401. + Added Xtensa port and demo application for the XCC compiler.
  402. + Changed the implementation of vPortEndScheduler() for the Win32 port to
  403. simply call exit( 0 ).
  404. + Bug fix in vPortEnableInterrupt() for the GCC Microblaze port to protect
  405. the read modify write access to an internal Microblaze register.
  406. + Fix minor niggles when the MPU is used with regards to prototype
  407. differences, static struct size differences, etc.
  408. + The usStackHighWaterMark member of the TaskStatus_t structure now has type
  409. configSTACK_DEPTH_TYPE in place of uint16_t - that change should have been
  410. made when the configSTACK_DEPTH_TYPE type (which gets around the previous
  411. 16-bit limit on stack size specifications) was introduced.
  412. + Added the xMessageBufferNextLengthBytes() API function and likewise stream
  413. buffer equivalent.
  414. + Introduce configMESSAGE_BUFFER_LENGTH_TYPE to allow the number of bytes
  415. used to hold the length of a message in the message buffer to be reduced.
  416. configMESSAGE_BUFFER_LENGTH_TYPE default to size_t, but if, for example,
  417. messages can never be more than 255 bytes it could be set to uint8_t,
  418. saving 3 bytes each time a message is written into the message buffer
  419. (assuming sizeof( size_t ) is 4).
  420. + Updated the StaticTimer_t structure to ensure it matches the size of the
  421. Timer_t structure when the size of TaskFunction_t does not equal the size
  422. of void *.
  423. + Update various Xilinx demos to use 2018.1 version of the SDK tools.
  424. + Various updates to demo tasks to maintain test coverage.
  425. + FreeRTOS+UDP was removed in FreeRTOS V10.1.0 as it was replaced by
  426. FreeRTOS+TCP, which was brought into the main download in FreeRTOS
  427. V10.0.0. FreeRTOS+TCP can be configured as a UDP only stack, and
  428. FreeRTOS+UDP does not contain the patches applied to FreeRTOS+TCP.
  429. FreeRTOS+TCP Changes:
  430. + Multiple security improvements and fixes in packet parsing routines, DNS
  431. caching, and TCP sequence number and ID generation.
  432. + Disable NBNS and LLMNR by default.
  433. + Add TCP hang protection by default.
  434. We thank Ori Karliner of Zimperium zLabs Team for reporting these issues.
  435. Changes between FreeRTOS V10.0.0 and FreeRTOS V10.0.1, released December 20 2017
  436. + Fix position of "#if defined( __cplusplus )" in stream_buffer.h.
  437. + Correct declarations of MPU_xQueuePeek() and MPU_xQueueSemaphoreTake() in
  438. mpu_prototypes.h.
  439. + Correct formatting in vTaskList() helper function when it prints the state
  440. of the currently executing task.
  441. + Introduce #error if stream_buffer.c is built without
  442. configUSE_TASK_NOTIFICATIONS set to 1.
  443. + Update FreeRTOS+TCP to V2.0.0
  444. - Improve the formatting of text that displays the available netword
  445. interfaces when FreeRTOS+TCP is used on Windows with WinPCap.
  446. - Introduce ipconfigSOCKET_HAS_USER_WAKE_CALLBACK option to enable a user
  447. definable callback to execute when data arrives on a socket.
  448. Changes between FreeRTOS V9.0.1 and FreeRTOS V10.0.0:
  449. The FreeRTOS kernel is now MIT licensed: https://www.FreeRTOS.org/license
  450. New Features and components:
  451. + Stream Buffers - see https://www.FreeRTOS.org/RTOS-stream-buffer-example.html
  452. + Message Buffers - see https://www.FreeRTOS.org//RTOS-message-buffer-example.html
  453. + Move FreeRTOS+TCP into the main repository, along with the basic Win32
  454. TCP demo FreeRTOS_Plus_TCP_Minimal_Windows_Simulator.
  455. New ports or demos:
  456. + Added demo for TI SimpleLink CC3220 MCU.
  457. + Added MPU and non MPU projects for Microchip CEC and MEC 17xx and 51xx
  458. MCUs.
  459. + Added CORTEX_MPU_Static_Simulator_Keil_GCC demo to test static allocation
  460. in the MPU port.
  461. Fixes or enhancements:
  462. + Cortex-M ports push additional register prior to calling
  463. vTaskSwitchContext to ensure 8-byte alignment is maintained. Only
  464. important if a user defined tick hook function performs an operation that
  465. requires 8-byte alignment.
  466. + Optimisations to the implementation of the standard tickless idle mode on
  467. Cortex-M devices.
  468. + Improvements to the Win32 port including using higher priority threads.
  469. + Ensure interrupt stack alignment on PIC32 ports.
  470. + Updated GCC TriCore port to build with later compiler versions.
  471. + Update mpu_wrappers.c to support static allocation.
  472. + The uxNumberOfItems member of List_t is now volatile - solving an issue
  473. when the IAR compiler was used with maximum optimization.
  474. + Introduced configRECORD_STACK_HIGH_ADDRESS. When set to 1 the stack start
  475. address is saved into each task's TCB (assuming stack grows down).
  476. + Introduced configINCLUDE_FREERTOS_TASK_C_ADDITIONS_H to allow user defined
  477. functionality, and user defined initialisation, to be added to FreeRTOS's
  478. tasks.c source file. When configINCLUDE_FREERTOS_TASK_C_ADDITIONS_H is
  479. set to 1 a user provided header file called freertos_task_c_additions.h
  480. will be included at the bottom of tasks.c. Functions defined in that
  481. header file can call freertos_tasks_c_additions_init(), which in turn
  482. calls a macro called FREERTOS_TASKS_C_ADDITIONS_INIT(), if it is defined.
  483. FREERTOS_TASKS_C_ADDITIONS_INIT() can be defined in FreeRTOSConfig.h.
  484. + Introduced configPRE_SUPPRESS_TICKS_AND_SLEEP_PROCESSING( x ) which can be
  485. defined by a user in FreeRTOSConfig.h. The macro is called before
  486. assessing whether to enter tickless idle mode or not. If the macro sets
  487. x to zero then tickless idle mode will not be entered. This allows users
  488. to abort tickless idle mode entry before the tickless idle function is
  489. even called - previously it was only possible to abort from within the
  490. tickless idle function itself.
  491. + Added configPRINTF(), which can be defined by users to allow all libraries
  492. to use the same print formatter.
  493. + Introduced configMAX() and configMIN() macros which default to standard
  494. max( x, y ) and min( x, y ) macro behaviour, but can be overridden if the
  495. application writer defines the same macros in FreeRTOSConfig.h.
  496. + Corrected the definition of StaticTask_t in the case where
  497. INCLUDE_xTaskAbortDelay is set to 1.
  498. + Introduced configTIMER_SERVICE_TASK_NAME and configIDLE_TASK_NAME, both of
  499. which can be defined to strings in FreeRTOSConfig.h to change the default
  500. names of the timer service and idle tasks respectively.
  501. + Only fill the stack of a newly created task with a known value if stack
  502. checking, or high water mark checking/viewing, is in use - removing the
  503. dependency on memset() in other cases.
  504. + Introduced xTaskCreateRestrictedStatic() so static allocation can be used
  505. with the MPU.
  506. + Ensure suspended tasks cannot be unsuspended by a received task
  507. notification.
  508. + Fix race condition in vTaskSetTimeOutState().
  509. + Updated trace recorder files to the latest version.
  510. Changes since FreeRTOS V9.0.0:
  511. + Priority dis-inheritance behaviour has been enhanced in the case where a
  512. task that attempted to take a mutex that was held by a lower priority task
  513. timed out before it was able to obtain the mutex (causing the task that
  514. holds the mutex to have its priority raised, then lowered again, in
  515. accordance with the priority inheritance protocol).
  516. + Split the overloaded xQueueGenericReceive() function into three separate
  517. dedicated functions.
  518. + Allow the default human readable text names given to the Idle and Timer
  519. tasks to be overridden by defining the configIDLE_TASK_NAME and
  520. configTIMER_SERVICE_TASK_NAME definitions respectively in FreeRTOSConfig.h.
  521. + Introduced configINITIAL_TICK_COUNT to allow the tick count to take a
  522. value of than than 0 when the system boots. This can be useful for
  523. testing purposes - although setting configUSE_16_BIT_TICKS to 1 can also
  524. be used to test frequent tick overflows.
  525. + Ensure the Cortex-M SysTick count is cleared to zero before starting the
  526. first task.
  527. + Add configASSERT() into ARM Cortex-M ports to check the number of priority
  528. bit settings.
  529. + Clear the 'control' register before starting ARM Cortex-M4F ports in case
  530. the FPU is used before the scheduler is started. This just saves a few
  531. bytes on the main stack as it prevents space being left for a later save
  532. of FPU registers.
  533. + Added xSemaphoreGetMutexHolderFromISR().
  534. + Corrected use of portNVIC_PENDSVSET to portNVIC_PENDSVSET_BIT in MPU ports.
  535. + Introduced configSTACK_DEPTH_TYPE to allow users to change the type used
  536. to specify the stack size when using xTaskCreate(). For historic reasons,
  537. when FreeRTOS was only used on small MCUs, the type was set to uint16_t,
  538. but that can be too restrictive when FreeRTOS is used on larger
  539. processors. configSTACK_DEPTH_TYPE defaults to uint16_t.
  540. xTaskCreateStatic(), being a newer function, used a uint32_t.
  541. + Increase the priority of the Windows threads used by the Win32 port. As
  542. all the threads run on the same core, and the threads run with very high
  543. priority, there is a risk that the host will become unresponsive, so also
  544. prevent the Windows port executing on single core hosts.
  545. Changes between FreeRTOS V9.0.0 and FreeRTOS V9.0.0rc2 released May 25 2016:
  546. See https://www.FreeRTOS.org/FreeRTOS-V9.html
  547. RTOS kernel updates:
  548. + The prototype of the new xTaskCreateStatic() API function was modified to
  549. remove a parameter and improve compatibility with other new
  550. "CreateStatic()" API functions. The stack size parameter in
  551. xTaskCreateStatic() is now uint32_t, which changes the prototype of the
  552. callback functions. See the following URL:
  553. https://www.FreeRTOS.org/xTaskCreateStatic.html
  554. + GCC ARM Cortex-A port: Introduced the configUSE_TASK_FPU_SUPPORT
  555. constant. When configUSE_TASK_FPU_SUPPORT is set to 2 every task is
  556. automatically given a floating point (FPU) context.
  557. + GCC ARM Cortex-A port: It is now possible to automatically save and
  558. restore all floating point (FPU) registers on entry to each potentially
  559. nested interrupt by defining vApplicationFPUSafeIRQHandler() instead of
  560. vApplicationIRQHandler().
  561. + All ARM Cortex-M3/4F/7 ports: Clear the least significant bit of the task
  562. entry address placed onto the stack of a task when the task is created for
  563. strict compliance with the ARM Cortex-M3/4/7 architecture documentation
  564. (no noticeable effect unless using the QMEU emulator).
  565. + Added GCC and Keil ARM Cortex-M4F MPU ports - previously the MPU was only
  566. supported on ARM Cortex-M3.
  567. + ARM Cortex-M3/4F MPU ports: Update to fully support the FreeRTOS V9.0.0
  568. API (other than static object creation) and added the
  569. FreeRTOS/Demo/CORTEX_MPU_Simulator_Keil_GCC demo application to
  570. demonstrate how to use the updated MPU port.
  571. + All ARM Cortex-M3/4F/7 ports: Add additional barrier instructions to the
  572. default low power tickless implementation.
  573. + All ARM Cortex-M0 ports: Prevent an item being left on the stack of the
  574. first task that executes.
  575. + Win32 ports: Reduce the amount of stack used and change the way Windows
  576. threads are deleted to increase the maximum execution time.
  577. + Add an ARM Cortex-M4F port for the MikroC compiler. Ensure to read the
  578. documentation page for this port before use.
  579. + MPS430X IAR port: Update to be compatible with the latest EW430 tools
  580. release.
  581. + IAR32 GCC port: Correct vPortExitCritical() when
  582. configMAX_API_CALL_INTERRUPT_PRIORITY == portMAX_PRIORITY.
  583. + For consistency vTaskGetTaskInfo() now has the alias vTaskGetInfo(),
  584. xTaskGetTaskHandle() now has the alias xTaskGetHandle() and
  585. pcQueueGetQueueName() now has an alias pcQueueGetName().
  586. + Fix various errors in comments and compiler warnings.
  587. Demo application updates:
  588. + Update Atmel Studio projects to use Atmel Studio 7.
  589. + Update Xilinx SDK projects to use the 2016.1 version of the SDK.
  590. + Remove dependency on legacy IO libraries from the PIC32 demos.
  591. + Move the Xilinx UltraScale Cortex-R5 demo into the main distribution.
  592. + Update the MSP432 libraries to the latest version.
  593. + Add Microchip CEC1302 (ARM Cortex-M4F) demos for GCC, Keil and MikroC
  594. compilers.
  595. + Move the Atmel SAMA5D2 demo into the main distribution.
  596. Changes between FreeRTOS V9.0.0rc1 and FreeRTOS V9.0.0rc2 (release candidate 2)
  597. released March 30 2016:
  598. NOTE - See https://www.FreeRTOS.org/FreeRTOS-V9.html for details
  599. + The functions that create RTOS objects using static memory allocation have
  600. been simplified and will not revert to using dynamic allocation if a
  601. buffer is passed into a function as NULL.
  602. + Introduced the configSUPPORT_DYNAMIC_ALLOCATION configuration constant to
  603. allow a FreeRTOS application to be built without a heap even being being
  604. defined. The Win32 example located in the
  605. /FreeRTOS/demo/WIN32-MSVC-Static-Allocation-Only directory is provided as
  606. a reference for projects that do not include a FreeRTOS heap.
  607. + Minor run-time optimisations.
  608. + Two new low power tickless implementations that target Silicon Labs EFM32
  609. microcontrollers.
  610. + Addition of the xTimerGetPeriod() and xTimerGetExpireTime() API functions.
  611. Changes between FreeRTOS V8.2.3 and FreeRTOS V9.0.0rc1 (release candidate 1)
  612. released February 19 2016:
  613. RTOS Kernel Updates:
  614. + Major new feature - tasks, semaphores, queues, timers and event groups can
  615. now be created using statically allocated memory, so without any calls to
  616. pvPortMalloc().
  617. + Major new features - Added the xTaskAbortDelay() API function which allows
  618. one task to force another task to immediately leave the Blocked state,
  619. even if the event the blocked task is waiting for has not occurred, or the
  620. blocked task's timeout has not expired.
  621. + Updates necessary to allow FreeRTOS to run on 64-bit architectures.
  622. + Added vApplicationDaemonTaskStartupHook() which executes when the RTOS
  623. daemon task (which used to be called the timer service task) starts
  624. running. This is useful if the application includes initialisation code
  625. that would benefit from executing after the scheduler has been started.
  626. + Added the xTaskGetTaskHandle() API function, which obtains a task handle
  627. from the task's name. xTaskGetTaskHandle() uses multiple string compare
  628. operations, so it is recommended that it is called only once per task.
  629. The handle returned by xTaskGetTaskHandle() can then be stored locally for
  630. later re-use.
  631. + Added the pcQueueGetQueueName() API function, which obtains the name of
  632. a queue from the queue's handle.
  633. + Tickless idling (for low power applications) can now also be used when
  634. configUSE_PREEMPTION is 0.
  635. + If one task deletes another task, then the stack and TCB of the deleted
  636. task is now freed immediately. If a task deletes itself, then the stack
  637. and TCB of the deleted task are freed by the Idle task as before.
  638. + If a task notification is used to unblock a task from an ISR, but the
  639. xHigherPriorityTaskWoken parameter is not used, then pend a context switch
  640. that will then occur during the next tick interrupt.
  641. + Heap_1.c and Heap_2.c now use the configAPPLICATION_ALLOCATED_HEAP
  642. settings, which previously was only used by heap_4.c.
  643. configAPPLICATION_ALLOCATED_HEAP allows the application writer to declare
  644. the array that will be used as the FreeRTOS heap, and in-so-doing, place
  645. the heap at a specific memory location.
  646. + TaskStatus_t structures are used to obtain details of a task.
  647. TaskStatus_t now includes the bae address of the task's stack.
  648. + Added the vTaskGetTaskInfo() API function, which returns a TaskStatus_t
  649. structure that contains information about a single task. Previously this
  650. information could only be obtained for all the tasks at once, as an array
  651. of TaskStatus_t structures.
  652. + Added the uxSemaphoreGetCount() API function.
  653. + Replicate previous Cortex-M4F and Cortex-M7 optimisations in some
  654. Cortex-M3 port layers.
  655. Demo Application Updates:
  656. Further demo applications will be added prior to the final FreeRTOS V9
  657. release.
  658. + Updated SAM4L Atmel Studio project to use Atmel Studio 7.
  659. + Added ARM Cortex-A53 64-bit port.
  660. + Added a port and demo for the ARM Cortex-A53 64-bit cores on the Xilinx
  661. Ultrascale MPSoC.
  662. + Added Cortex-M7 SAME70 GCC demo.
  663. + Added EFM32 Giant and Wonder Gecko demos.
  664. Changes between V8.2.2 and V8.2.3 released October 16, 2015
  665. RTOS kernel updates:
  666. + Fix bug identified in a modification made in V8.2.2 to the software timer
  667. code that allows tickless low power applications to sleep indefinitely
  668. when software timers are used.
  669. + Simplify and improve efficiency of stack overflow checking.
  670. + Add xTaskNotifyStateClear() API function.
  671. + New IAR and GCC Cortex-R ports for microprocessors that do not use an ARM
  672. generic interrupt controller (GIC).
  673. + New PIC32MEC14xx port.
  674. + Add support for PIC32MZ EF parts (with floating point) into the PIC32MZ
  675. port.
  676. + Zynq7000 port layer now declares the functions that setup and clear the
  677. tick interrupt as weak symbols so they can be overridden by the
  678. application, and uses a global XScuGic object so the same object can be
  679. used by the application code.
  680. + Introduced configUSE_TASK_FPU_SUPPORT, although the PIC32MZ EF port is
  681. currently the only port that uses it.
  682. + Updates to RL78 and 78K0 IAR port layers to improve support for
  683. combinations of memory models.
  684. + Minor updates to heap_5.c to remove compiler warnings generated by some
  685. compilers.
  686. + License simplifications. See /FreeRTOS/License/license.txt in the
  687. official distribution.
  688. FreeRTOS+ updates:
  689. + Update directory names to use WolfSSL instead of CyaSSL, inline with
  690. WolfSSL's re-branding.
  691. + Update to latest WolfSSL code.
  692. + Update to latest FreeRTOS+Trace recorder code.
  693. + Add in the FreeRTOS+Trace recorder library required for streaming trace.
  694. Demo application changes:
  695. + Add demo applications for Renesas RZ/T (Cortex-R), PIC32MZ EF (PIC32 with
  696. floating point hardware), PIC32MEC14xx, RX71M, RX113 and RX231.
  697. + General tidy up of spelling and compiler warnings.
  698. Changes between V8.2.1 and V8.2.2 released August 12, 2015
  699. RTOS kernel updates:
  700. + Added Intel IA32/x86 32-bit port.
  701. + General maintenance.
  702. + PRIVILEGED_FUNCTION and PRIVILEGED_DATA macros, which are used in memory
  703. protected systems, have been added to the newer event group and software
  704. timer functions.
  705. + Add the errno definitions used by FreeRTOS+ components into projdefs.h.
  706. + Remove the restriction that prevented tick-less idle implementations
  707. waiting indefinitely when software timers were used in the same
  708. application.
  709. + Introduce xTaskNotifyAndQueryFromISR() as the interrupt safe version of
  710. xTaskNotifyAndQuery().
  711. + Add additional NOPs to the MSP430X port layers to ensure strict compliance
  712. with the hardware documentation.
  713. + Microblaze port: Added option for port optimised task selection.
  714. + Microblaze port: Previously tasks inherited the exception enable state
  715. at the time the task was created. Now all tasks are created with
  716. exceptions enabled if the Microblaze design supports exceptions.
  717. + Windows port: Add additional safe guards to ensure the correct start up
  718. sequence and thread switching timing.
  719. + Windows port: Improve the implementation of the port optimised task
  720. selection assembly code.
  721. + Update heap_4 and heap_5 to allow use on 64-bit processors.
  722. + Simplify the code that creates a queue.
  723. + General improved tick-less idle behaviour.
  724. + Ensure none of the variables in the common kernel files are initialised to
  725. anything other than zero.
  726. + Correct calculation of xHeapStructSize in heap_4 and heap_5.
  727. Demo application updates:
  728. + Added demo project for the new IA32/x86 port that targets the Galileo
  729. hardware.
  730. + Added MSP430FR5969 demos (previously provided as a separate download).
  731. + Added FreeRTOS BSP repository for automatic creation of FreeRTOS
  732. applications in the Xilinx SDK.
  733. + Added Atmel Studio / GCC project for the SAMV71 (ARM Cortex-M7)
  734. + Update Xilinx SDK projects to use version 2015.2 of the SDK.
  735. + Remove Microblaze demos that were using obsolete tools.
  736. + Add MSP43FR5969 IAR and CCS demos.
  737. FreeRTOS+ Updates:
  738. + Updated FreeRTOS+Trace recorder library, which requires an update to the
  739. FreeRTOS+Trace application.
  740. + Added Reliance Edge source code and demo application. Reliance edge is
  741. a fail safe transactional file system ideal for applications that require
  742. file storage, and especially when high reliability is essential.
  743. + Introduce configAPPLICATION_PROVIDES_cOutputBuffer to allow FreeRTOS+CLI
  744. users to place the output buffer at a fixed memory address.
  745. + Improve the NetworkInterface.c file provided for the Windows port of
  746. FreeRTOS+UDP.
  747. Changes between V8.2.0 and V8.2.1 released 24th March 2015.
  748. RTOS kernel updates:
  749. + Added user definable and flexible thread local storage facility.
  750. + Added vTimerSetTimerID() API function to complement the pvTimerGetTimerID()
  751. function to allow the timer's ID to be used as timer local storage.
  752. + Fixed a potential issue related to the use of queue sets from an ISR.
  753. + Some updates to the Xilinx Microblaze GCC port.
  754. + Added ARM Cortex-M4F port for Texas Instruments Code Composer Studio.
  755. + Added ARM Cortex-M7 r0p1 port layer for IAR, GCC and Keil which contains a
  756. minor errata work around. All other ARM Cortex-M7 core revisions should
  757. use the ARM Cortex-M4F port.
  758. + Exclude the whole of croutine.c if configUSE_CO_ROUTINES is set to 0.
  759. + Change some data types from uint32_t to size_t in preparation for 64-bit
  760. Windows port.
  761. + Update the PIC32 port to remove deprecation warnings output by the latest
  762. XC32 compilers.
  763. + Fix bug when xQueueOverwrite() and xQueueOverwrite() from ISR are used to
  764. overwrite items in two queues that are part of the same set.
  765. Demo application updates:
  766. + Added demo application for TI's ARM Cortex-M4F based MSP432
  767. microcontroller using IAR, Keil and CCS compilers.
  768. + Added demo application for STM32F ARM Cortex-M7 based microcontroller
  769. using IAR and Keil.
  770. + Added demo application for Atmel SAMV71 ARM Cortex-M7 based
  771. microcontroller using IAR and Keil.
  772. + Added Microblaze demo that uses the 2014.4 version of the Xilinx SDK and
  773. runs on the KC705 evaluation board (Kintex FPGA).
  774. Changes between V8.1.2 and V8.2.0 released 16th January 2015
  775. Changes between release candidate 1 and the official release are restricted
  776. to maintenance only.
  777. Significant RTOS kernel updates:
  778. + MAJOR NEW FEATURE! Task notifications. Please see the following URL for
  779. details: https://www.FreeRTOS.org/RTOS-task-notifications.html
  780. + NEW HEADER FILE REQUIRED! Obsolete definitions have been separated into
  781. a new header file called FreeRTOS/Source/include/deprecated_definitions.h.
  782. This header file must be present to build. Note some of the obsolete
  783. definitions are still used by very old demo application projects.
  784. Other RTOS kernel updates:
  785. + Made xSemaphoreGiveFromISR() a function rather than a macro that calls
  786. xQueueGenericSendFromISR(). This allows for major performance
  787. enhancements at the expense of some additional code size if both functions
  788. are used in the same application. NOTE: In most uses cases such use of
  789. a semaphore can now be replaced with a task notification which is smaller
  790. and faster still.
  791. + The TCB is now always allocated such that the task's stack grows away from
  792. the TCB (improves debugging of stack overflows as the overflow will not
  793. overwrite the task's name).
  794. + GCC, IAR and Keil Cortex-M4F ports now use more inlining (performance
  795. enhancements at the cost of a little additional code space).
  796. + Queues are now allocated with a single call to pvPortMalloc() which
  797. allocates both the queue structure and the queue storage area.
  798. + Introduced a new critical section macro for reading the tick count that
  799. defines away to nothing in cases where the width of the tick allows the
  800. tick count to be read atomically (performance benefits - especially when
  801. optimisation is on).
  802. + Introduced configAPPLICATION_ALLOCATED_HEAP in heap_4.c to allow the
  803. application writer to provide their own heap array - and in so doing
  804. control the location of the heap.
  805. + Introduced configUSE_LIST_DATA_INTEGRITY_CHECK_BYTES which, when set, will
  806. include known values in both list and list item structures. The values
  807. are intended to assist debugging. If the values get overwritten then it
  808. is likely application code has written over RAM used by the kernel.
  809. + configASSERT()s in all Cortex-M ports used to test the lowest 5 bits of
  810. the interrupt control register to detect taskENTER_CRITICAL() being called
  811. from an interrupt. This has been changed to test all 8 bits.
  812. + Introduced uxTaskPriorityGetFromISR().
  813. + Microblze V8 port now tests XPAR_MICROBLAZE_0_USE_FPU for inequality to 0
  814. rather than equality to 1, and 2 and 3 are also valid values.
  815. + Cortex-A5 GIC-less port no longer passes the address of the interrupting
  816. peripheral into the interrupt handler.
  817. + Fix an issue in FreeRTOS-MPU where an attempt was made to free the stack
  818. belonging to a task when the task was deleted, even when the stack was
  819. allocated statically.
  820. + Utility (helper) functions that format task statistic information into
  821. human readable tables now pad task names with spaces to ensure columns
  822. line up correctly even where task name lengths vary greatly.
  823. + Update FreeRTOS+Trace recorder library to version 2.7.0.
  824. Demo application updates:
  825. + Added two new standard demo task sets: IntSemTest and TaskNotify.
  826. + Added port and demo application for Atmel SAMA5D4 Cortex-A5 MPU.
  827. + Added demo application for Altera Cyclone V Cortex-A9 MPU.
  828. + Updated Zynq demo to use version 2014.4 of Xilinx's SDK and added in
  829. demo tasks for new RTOS features.
  830. + Updated Atmel SAM4E and SAM4S demos to include a lot of additional test
  831. and demo tasks.
  832. + Fixed a corner case issue in Atmel SAM4L low power tickless
  833. implementation, and added button interrupt handling.
  834. + Make the interrupt queue tests more tolerant to heave CPU loads.
  835. + Updated MSVC FreeRTOS simulator demo to include the latest standard test
  836. and demo tasks.
  837. + Updated MingW/Eclipse FreeRTOS simulator demo to match the FreeRTOS MSVC
  838. simulator demo.
  839. + Updated all demos that use FreeRTOS+Trace to work with the latest trace
  840. recorder code.
  841. Changes between V8.1.1 and V8.1.2 released September 2nd 2014
  842. Move the defaulting of configUSE_PORT_OPTIMISED_TASK_SELECTION into the
  843. individual port layers where necessary so it does not affect ports that do
  844. not support the definition.
  845. Changes between V8.1.0 and V8.1.1 released August 29th 2014
  846. By popular requests - a minor patch to V8.1.0 to re-instate the ability to
  847. give a mutex type semaphore (with priority inheritance) from an interrupt
  848. handler.
  849. Changes between V8.0.1 and V8.1.0 released August 26th 2014
  850. FreeRTOS scheduler, kernel, demo and test updates:
  851. + Improved the priority inheritance algorithms to assist integration with
  852. off the shelf middleware that may hold multiple mutexes simultaneously.
  853. + Introduce heap_5.c, which is similar to heap_4.c but allows the heap to
  854. span multiple non-contiguous memory regions.
  855. + Updated all Cortex-A9 ports to help trap a couple of common usage errors -
  856. the first being when a task incorrectly attempts to exit its implementing
  857. function and the second being when a non interrupt safe API function is
  858. called from an interrupt.
  859. + Update all Cortex-A9 ports to remove obsolete mode switches prior to
  860. restoring a task context.
  861. + configUSE_PORT_OPTIMISED_TASK_SELECTION now defaults to 1 instead of 0.
  862. + Update all Cortex-M3/4F ports to trap a non interrupt safe API function
  863. being called from an interrupt handler.
  864. + Simplify the alignment checks in heap_4.c.
  865. + Update the MSVC Windows simulator demo to use heap_5.c in place of
  866. heap_4.c to ensure end users have an example to refer to.
  867. + Updated standard demo test code to test the new priority inheritance
  868. algorithms.
  869. + Updated the standard demo tasks to make use of stdint and the FreeRTOS
  870. specific typedefs that were introduced in FreeRTOS V8.0.0.
  871. + Introduce the pdMS_TO_TICKS() macro as a more user friendly and intuitive
  872. alternative to pdTICKS_PER_MS - both of which can be used to convert a
  873. time specified in milliseconds to a time specified in RTOS ticks.
  874. + Fix a bug in the Tasking compiler's Cortex-M port that resulted in an
  875. incorrect value being written to the basepri register. This only effects
  876. users of the Tasking compiler.
  877. + Update the Zynq demo to use version 2014.2 of the SDK and add in an lwIP
  878. example that demonstrates lwIP being used with both its raw and sockets
  879. interfaces.
  880. + Updated the CCS Cortex-R4 port to enable it to be built with the latest
  881. CCS compiler.
  882. New ports and demo applications:
  883. + Two Renesas RX64M ports (RXv2 core) and demos introduced, one for the GCC
  884. compiler and one for the Renesas compiler. Both demos use e2 studio.
  885. + Generic IAR Cortex-A5 port (without any reliance on a GIC) introduced.
  886. The new port is demonstrated on an Atmel SAMA5D3 XPlained board.
  887. FreeRTOS+ component updates:
  888. + Update CyaSSL to the latest version.
  889. + Updated the FreeRTOS+ components supplied directly by Real Time Engineers
  890. Ltd. to make use of stdint and the FreeRTOS specific typedefs that were
  891. introduced in FreeRTOS V8.0.0.
  892. + Rework and simplify the FreeRTOS+FAT SL RAM disk driver.
  893. Miscellaneous updates and maintenance:
  894. + Update the IAR and DS-5/ARM RZ demos to target the official RZ RSK
  895. hardware in place of the previously targeted Renesas internal (not
  896. publicly available) hardware.
  897. + Various other maintenance tasks.
  898. Changes between V8.0.0 and V8.0.1 released 2nd May 2014
  899. + Minor fixes to the event group functionality that was released in V8.0.0.
  900. The 'clear bits from ISR' functionality is now implemented using a
  901. deferred interrupt callback instead of a function, and the 'wait bits' and
  902. 'task sync' functions now correctly clear internal control bits before
  903. returning a value in every possible path through the respective functions.
  904. + Ensure the updating of internal control data is protected by a critical
  905. section after a task is deleted or suspended.
  906. + Minor fixes to FreeRTOS+FAT SL - namely seeking beyond the end of a file
  907. when the offset was not a multiple of the sector size.
  908. + Ensure Cortex-A9 system registers are only ever accessed as 32-bit values,
  909. even when only the lest significant byte of the register is implemented.
  910. Other updates:
  911. + Updated the XMC4200 IAR project so it links with version 7.x of the IAR
  912. tools.
  913. + Add RL78L1C demo.
  914. + Add pcTimerGetName() API function.
  915. + Call _reclaim_reent() when a task is deleted if configUSE_NEWLIB_REENTRANT
  916. is defined.
  917. Changes between V7.6.0 and V8.0.0 released 19th Feb 2014
  918. https://www.FreeRTOS.org/upgrading-to-FreeRTOS-V8.html
  919. FreeRTOS V8.x.x is a drop-in compatible replacement for FreeRTOS V7.x.x,
  920. although a change to the type used to reference character strings may result
  921. in application code generating a few (easily clearable) compiler warnings
  922. after the upgrade, and an updated typedef naming convention means use of the
  923. old typedef names is now discouraged.
  924. See https://www.FreeRTOS.org/upgrading-to-FreeRTOS-V8.html for full
  925. information.
  926. New features and functionality:
  927. + Event groups - see https://www.FreeRTOS.org/FreeRTOS-Event-Groups.html
  928. + Centralised deferred interrupt processing - see
  929. https://www.FreeRTOS.org/xTimerPendFunctionCallFromISR.html
  930. Other updates:
  931. + Previously, when a task left the Blocked state, a context switch was
  932. performed if the priority of the unblocked task was greater than or equal
  933. to the priority of the Running task. Now a context switch is only
  934. performed if the priority of the unblocked task is greater than the
  935. priority of the Running task.
  936. + New low power tickless demonstration project that targets the ST STM32L
  937. microcontroller - see
  938. https://www.FreeRTOS.org/STM32L-discovery-low-power-tickless-RTOS-demo.html
  939. + Add xPortGetMinimumEverFreeHeapSize() to heap_4.c.
  940. + Small change to the tickless low power implementation on the SAM4L to
  941. ensure the alarm value (compare match value) cannot be set to zero when a
  942. tickless period is exited due to an interrupt originating from a source
  943. other than the RTOS tick.
  944. + Update the GCC/Eclipse Win32 simulator demo to make better use of Eclipse
  945. resource filters and match the functionality of the MSVC equivalent.
  946. + xTaskIsTaskSuspended() is no longer a public function. Use
  947. eTaskGetState() in its place.
  948. + Improved trace macros, including tracing of heap usage.
  949. + Remove one level of indirection when accepting interrupts on the PIC32MZ.
  950. + Add Cortex-A9 GCC port layer.
  951. + Add Xilinx Zynq demo application.
  952. Changes between V7.5.3 and V7.6.0 released 18th November 2013
  953. V7.6.0 changes some behaviour when the co-operative scheduler is used (when
  954. configUSE_PREEMPTION is set to 0). It is important to note that the
  955. behaviour of the pre-emptive scheduler is unchanged - the following
  956. description only applies when configUSE_PREEMPTION is set to 0:
  957. WHEN configUSE_PREEMPTION IS SET TO 0 (which is in a small minority of
  958. cases) a context switch will now only occur when a task places itself into
  959. the Blocked state, or explicitly calls taskYIELD(). This differs from
  960. previous versions, where a context switch would also occur when implicitly
  961. moving a higher priority task out of the Blocked state. For example,
  962. previously, WHEN PREEMPTION WAS TURNED OFF, if task A unblocks task B by
  963. writing to a queue, then the scheduler would switch to the higher priority
  964. task. Now, WHEN PREEMPTION IS TURNED OFF, if task A unblocks task B by
  965. writing to a queue, task B will not start running until task A enters the
  966. Blocked state or task A calls taskYIELD(). [If configUSE_PREEMPTION is not
  967. set to 0, so the normal pre-emptive scheduler is being used, then task B
  968. will start running immediately that it is moved out of the Blocked state].
  969. Other changes:
  970. + Added a port layer and a demo project for the new PIC32MZ architecture.
  971. + Update the PIC32MX port layer to re-introduce some ehb instructions that
  972. were previously removed, add the ability to catch interrupt stack
  973. overflows (previously only task stack overflows were trapped), and also
  974. add the ability to catch an application task incorrectly attempting to
  975. return from its implementing function.
  976. + Make dramatic improvements to the performance of the Win32 simulator port
  977. layer.
  978. + Ensure tasks that are blocked indefinitely report their state as Blocked
  979. instead of Suspended.
  980. + Slight improvement to the Cortex-M4F port layers where previously one
  981. register was inadvertently being saved twice.
  982. + Introduce the xSemaphoreCreateBinary() API function to ensure consistency
  983. in the semantics of how each semaphore type is created. It is no longer
  984. recommended to use vSemaphoreCreateBinary() (the version prefixed with a
  985. 'v'), although it will remain in the code for backward compatibility.
  986. + Update the Cortex-M0 port layers to allow the scheduler to be started
  987. without using the SVC handler.
  988. + Added a build configuration to the PIC32MX MPLAB X demo project that
  989. targets the PIC32 USB II starter kit. Previously all the build
  990. configurations required the Explorer 16 hardware.
  991. + Some of the standard demo tasks have been updated to ensure they execute
  992. correctly with the updated co-operative scheduling behaviour.
  993. + Added comprehensive demo for the Atmel SAM4E, including use of
  994. FreeRTOS+UDP, FreeRTOS+FAT SL and FreeRTOS+CLI.
  995. FreeRTOS+ Changes:
  996. + Minor maintenance on FreeRTOS+UDP.
  997. Changes between V7.5.2 and V7.5.3 released October 14 2013
  998. Kernel changes:
  999. + Prior to V7.5.x yields requested from the tick hook would occur in the
  1000. same tick interrupt - revert to that original behaviour.
  1001. + New API function uxQueueSpacesAvailable().
  1002. + Introduced the prvTaskExitError() function to Cortex-M0, Cortex-M3/4
  1003. and Cortex-M4F ports. prvTaskExitError() is used to trap tasks that
  1004. attempt to return from their implementing functions (tasks should call
  1005. vTaskDelete( NULL ); if they want to exit).
  1006. + The Cortex-M0 version of portSET_INTERRUPT_MASK_FROM_ISR and
  1007. portCLEAR_INTERRUPT_MASK_FROM_ISR are now fully nestable.
  1008. + Improved behaviour and robustness of the default Cortex-M tickless idle
  1009. behaviour.
  1010. + Add workaround for silicon errata PMU_CM001 in Infineon XMC4000 devices to
  1011. all Cortex-M4F ports.
  1012. + Add Cortex-M0 port for Keil.
  1013. + Updated Cortus port.
  1014. + Ensure _impure_ptr is initialised before the scheduler is started.
  1015. Previously it was not set until the first context switch.
  1016. FreeRTOS+ changes:
  1017. + Update FreeRTOS+UDP to V1.0.1 - including direct integration of the
  1018. FreeRTOS+Nabto task, improvements to the DHCP behaviour, and a correction
  1019. to the test that prevents the network event hook being called on the first
  1020. network down event. The FreeRTOS+UDP change history is maintained
  1021. separately.
  1022. + Correct the __NVIC_PRIO_BITS setting in the LPC18xx.h header files
  1023. provided in the NXP CMSIS library, then update the interrupts used by the
  1024. LPC18xx demos accordingly.
  1025. + Replace double quotes (") with single quotes (') in FreeRTOS+CLI help
  1026. strings to ensure the strings can be used with the JSON descriptions used
  1027. in the FreeRTOS+Nabto demos.
  1028. Demo and miscellaneous changes:
  1029. + Added demo for the Atmel SAMD20 Cortex-M0+. The demo includes
  1030. FreeRTOS+CLI
  1031. + Added a demo for the Infineon Cortex-M0 that can be built with the IAR
  1032. Keil and GCC tools.
  1033. + Updated the Infineon XMC4000 demos for IAR, Keil, GCC and Tasking tools,
  1034. with additional build configurations to directly support the XMC4200 and
  1035. XMC4400 devices, in addition to the previously supported XMC4500.
  1036. + Updated the demo application.
  1037. + Added additional trace macros traceMALLOC and traceFREE to track heap
  1038. usage.
  1039. Changes between V7.5.0 and V7.5.2 released July 24 2013
  1040. V7.5.2 makes the new Cortex-M vPortCheckInterruptPriority() function
  1041. compatible with the STM32 standard peripheral driver library, and adds
  1042. an extra critical section to the default low power tickless mode
  1043. implementation. Only users of the STM32 peripheral library or the default
  1044. tickless implementation need update from version 7.5.0.
  1045. Changes between V7.4.2 and V7.5.0 released July 19 2013
  1046. V7.5.0 is a major upgrade that includes multiple scheduling and efficiency
  1047. improvements, and some new API functions.
  1048. Compatibility information for FreeRTOS users:
  1049. FreeRTOS V7.5.0 is backward compatible with FreeRTOS V7.4.0 with one
  1050. exception; the vTaskList() and vTaskGetRunTimeStats() functions are now
  1051. considered legacy, having been replaced by the single uxTaskGetSystemState()
  1052. function. configUSE_STATS_FORMATTING_FUNCTIONS must be set to 1 in
  1053. FreeRTOSConfig.h for vTaskList() and vTaskGetRunTimeStats() to be
  1054. available.
  1055. Compatibility information for FreeRTOS port writers:
  1056. vTaskIncrementTick() is now called xTaskIncrementTick() (because it now
  1057. returns a value).
  1058. Headline changes:
  1059. + Multiple scheduling and efficiency improvements.
  1060. + Core kernel files now pass PC-Lint V8 static checking without outputting
  1061. any warnings (information on the test conditions will follow).
  1062. New API functions:
  1063. + uxTaskGetSystemState() https://www.FreeRTOS.org/uxTaskGetSystemState.html
  1064. + xQueueOverwrite() https://www.FreeRTOS.org/xQueueOverwrite.html
  1065. + xQueueOverwriteFromISR()
  1066. + xQueuePeekFromISR()
  1067. The following ports and demos, which were previously available separately,
  1068. are now incorporated into the main FreeRTOS zip file download:
  1069. + ARM Cortex-A9 IAR
  1070. + ARM Cortex-A9 ARM compiler
  1071. + Renesas RZ
  1072. + Microsemi SmartFusion2
  1073. New FreeRTOSConfig.h settings
  1074. https://freertos.org/a00110.html
  1075. + configUSE_TIME_SLICING
  1076. + configUSE_NEWLIB_REENTRANT
  1077. + configUSE_STATS_FORMATTING_FUNCTIONS
  1078. + configINCLUDE_APPLICATION_DEFINED_PRIVILEGED_FUNCTIONS
  1079. Other changes:
  1080. + (MPU port only) The configINCLUDE_APPLICATION_DEFINED_PRIVILEGED_FUNCTIONS
  1081. options provides a mechanism that allows application writers to execute
  1082. certain functions in privileged mode even when a task is running in user
  1083. mode.
  1084. + Ports that support interrupt nesting now include a configASSERT() that
  1085. will trigger if an interrupt safe FreeRTOS function is called from an
  1086. interrupt that has a priority designated as above the maximum system/API
  1087. call interrupt priority.
  1088. + The included FreeRTOS+Trace recorder code has been updated to the latest
  1089. version, and the demo applications that use the trace recorder code have
  1090. been updated accordingly.
  1091. + The FreeRTOS Windows Simulator (MSVC version only) has been updated to
  1092. include a new basic 'blinky' build option in addition to the original
  1093. comprehensive build option.
  1094. + Improve RAM usage efficiency of heap_4.c and heap_2.c.
  1095. + Prevent heap_4.c from attempting to free memory blocks that were not
  1096. allocated by heap_4.c, or have already been freed.
  1097. + As FreeRTOS now comes with FreeRTOS+FAT SL (donated by HCC) the Chan FATfs
  1098. files have been removed from FreeRTOS/Demo/Common.
  1099. + Fix build error when R4 port is build in co-operative mode.
  1100. + Multiple port and demo application maintenance activities.
  1101. Changes between V7.4.1 and V7.4.2 released May 1 2013
  1102. NOTE: There are no changes in the FreeRTOS kernel between V7.4.1 and V7.4.2
  1103. + Added FreeRTOS+FAT SL source code and demo project. The demo project
  1104. runs in the FreeRTOS Windows simulator for easy and hardware independent
  1105. experimentation and evaluation. See https://www.FreeRTOS.org/fat_sl
  1106. Changes between V7.4.0 and V7.4.1 released April 18 2013
  1107. + To ensure strict conformance with the spec and ensure compatibility with
  1108. future chips data and instruction barrier instructions have been added to
  1109. the yield macros of Cortex-M and Cortex-R port layers. For efficiency
  1110. the Cortex-M port layer "yield" and "yield" from ISR are now implemented
  1111. separately as the barrier instructions are not required in the ISR case.
  1112. + Added FreeRTOS+UDP into main download.
  1113. + Reorganised the FreeRTOS+ directory so it now matches the FreeRTOS
  1114. directory with Source and Demo subdirectories.
  1115. + Implemented the Berkeley sockets select() function in FreeRTOS+UDP.
  1116. + Changed (unsigned) casting in calls to standard library functions with
  1117. (size_t) casting.
  1118. + Added the Atmel SAM4L and Renesas RX100 demos that demonstrates the
  1119. tickless (tick suppression) low power FreeRTOS features.
  1120. + Add a new RL78 IAR demo that targets numerous new RL78 chips and
  1121. evaluation boards.
  1122. + Adjusted stack alignment on RX200 ports to ensure an assert was not
  1123. falsely triggered when configASSERT() is defined.
  1124. + Updated the Cortex_M4F_Infineon_XMC4500_IAR demo to build with the latest
  1125. version of EWARM.
  1126. + Corrected header comments in the het.c and het.h files (RM48/TMS570 demo).
  1127. Changes between V7.3.0 and V7.4.0 released February 20 2013
  1128. + New feature: Queue sets. See:
  1129. https://www.FreeRTOS.org/Pend-on-multiple-rtos-objects.html
  1130. + Overhauled the default tickless idle mode implementation provided with the
  1131. ARM Cortex-M3 port layers.
  1132. + Enhanced tickless support in the core kernel code with the introduction of
  1133. the configEXPECTED_IDLE_TIME_BEFORE_SLEEP macro and the
  1134. eTaskConfirmSleepModeStatus() function.
  1135. + Added the QueueSet.c common demo/test file. Several demo applications
  1136. have been updated to use the new demo/test tasks.
  1137. + Removed reliance on the PLIB libraries from the MPLAB PIC32 port layer and
  1138. demo applications.
  1139. + Added the FreeRTOS+Trace recorder code to the MSVC Win32 demo.
  1140. + Renamed eTaskStateGet() to eTaskGetState() for consistency, and added a
  1141. pre-processor macro for backward compatibility with the previous name.
  1142. + Updated functions implemented in the core queue.c source file to allow
  1143. queue.h to be included from the .c file directly (this prevents compiler
  1144. warnings that were generated by some compilers).
  1145. + Updated the CCS Cortex-R4 port layer to replace the CLZ assembler function
  1146. with the CLZ compiler intrinsic that is provided by the latest versions of
  1147. the CCS ARM compiler.
  1148. + Updated all heap_x.c implementations to replace the structure that was
  1149. used to ensure the start of the heap was aligned with a more portable
  1150. direct C code implementation.
  1151. + Added support for PIC24 devices that include EDS.
  1152. + Minor optimisations to the PIC32 port layer.
  1153. + Minor changes to tasks.c that allow the state viewer plug-ins to display
  1154. additional information.
  1155. + Bug fix: Update prvProcessReceivedCommands() in timers.c to remove an
  1156. issue that could occur if the priority of the timer daemon task was set
  1157. below the priority of tasks that used timer services.
  1158. + Update the FreeRTOS+Trace recorder code to the latest version.
  1159. Changes between V7.2.0 and V7.3.0 released October 31 2012
  1160. + Added ability to override the default scheduler task selection mechanism
  1161. with implementations that make use of architecture specific instructions.
  1162. + Added ability to suppress tick interrupts during idle time, and in so
  1163. doing, provide the ability to make use of architecture specific low power
  1164. functionality.
  1165. + Added the portSUPPRESS_TICKS_AND_SLEEP() macro and vTaskStepTick() helper
  1166. function.
  1167. + Added the configSYSTICK_CLOCK_HZ configuration constant.
  1168. + Reworked the Cortex-M3 and Cortex-M4F port layers for GCC, Keil and IAR to
  1169. directly support basic power saving functionality.
  1170. + Added hooks to allow basic power saving to be augmented in the application
  1171. by making use of chip specific functionality.
  1172. + Minor change to allow mutex type semaphores to be used from interrupts
  1173. (which would not be a normal usage model for a mutex).
  1174. + Change the behaviour of the interrupt safe interrupt mask save and restore
  1175. macros in the Cortex-M ports. The save macro now returns the previous
  1176. mask value. The restore macro now uses the previous mask value. These
  1177. changes are not necessary for the kernel's own implementation, and are
  1178. made purely because the macros were being used by application writers.
  1179. + Added eTaskStateGet() API function.
  1180. + Added port specific optimisations to the PIC32 port layer, and updated the
  1181. PIC32 demo applications to make use of this new feature.
  1182. + Added port specific optimisations to the Win32 simulator port.
  1183. + Added new ports and demo applications for the TI Hercules RM48 and TMS570
  1184. safety microcontrollers.
  1185. + Added SAM3 demos targeting the ATSAM3S-EK2 and ATSAM3X-EK evaluation
  1186. boards.
  1187. + Updated the PIC32 MPLAB X project to manually set the compiler include
  1188. paths instead of using the IDE entry box following reports that the
  1189. include paths were somehow being deleted.
  1190. + Improved character handling in FreeRTOS+CLI.
  1191. Changes between V7.1.1 and V7.2.0 released 14 August 2012
  1192. FreeRTOS V7.2.0 is backward compatible with FreeRTOS V7.1.2.
  1193. + Added a FreeRTOS+ sub-directory. The directory contains some FreeRTOS+
  1194. source code, and example projects that use the FreeRTOS Win32 simulator.
  1195. + Added a new example heap allocation implementation (heap_4.c) that
  1196. includes memory block coalescence.
  1197. + Added a demo that targets the Atmel SAM4S Cortex-M4 based microcontroller.
  1198. The demo is preconfigured to build using the free Atmel Studio 6 IDE and
  1199. GCC compiler.
  1200. + Added xSemaphoreTakeFromISR() implementation.
  1201. + The last parameter in ISR safe FreeRTOS queue and semaphore functions
  1202. (xHigherPriorityTaskWoken) is now optional and can be set to NULL if it
  1203. is not required.
  1204. + Update the IAR and MSP430X ports to clear all lower power mode bits before
  1205. exiting the tick interrupt [bug fix].
  1206. + Allow xQueueReset() to be used, even when the queues event lists are not
  1207. empty.
  1208. + Added a vQueueDelete() handler for the FreeRTOS MPU port (this was
  1209. previously missing).
  1210. + Updated the vPortSVCHandler() functions in the FreeRTOS MPU port layer to
  1211. ensure it compiles with the latest ARM GCC compilers from Linaro.
  1212. + Updated the prvReadGP() function in the NIOS II port to ensure the compiler
  1213. can choose any register for the functions parameter (required at high
  1214. compiler optimisation levels).
  1215. + Add #error macros into the Keil and IAR Cortex-M ports to ensure they
  1216. cannot be built if the user has set configMAX_SYSCALL_INTERRUPT_PRIORITY
  1217. to 0.
  1218. + Added comments in the FreeRTOSConfig.h files associated with Cortex-M3 and
  1219. Cortex-M4 demos stating that the configMAX_SYSCALL_INTERRUPT_PRIORITY
  1220. parameter must not be set to 0.
  1221. + Introduce new INCLUDE_xQueueGetMutexHolder configuration constant
  1222. (defaulted to 0).
  1223. + Added two new list handling macros - for internal use only in upcoming new
  1224. products.
  1225. + Removed all mention of the legacy vTaskStartTrace and ulTaskEndTrace
  1226. macros. FreeRTOS+Trace supersedes the legacy trace.
  1227. + Added a configASSERT() into the vPortFree() function in heap_1.c as it is
  1228. invalid for the function to be called.
  1229. + Made the xRxLock and xTxLock members of the queue structure volatile.
  1230. This is probably not necessary, and is included as a precautionary
  1231. measure.
  1232. + Modify the assert() that checks to see if the priority passed into an
  1233. xTaskCreate() function is within valid bounds to permit the assert to be
  1234. used in the FreeRTOS MPU port.
  1235. + The software timer service (daemon) task is now created in a way that
  1236. to ensure compatibility with FreeRTOS MPU.
  1237. Changes between V7.1.0 and V7.1.1 released May 1 2012
  1238. New ports:
  1239. The following ports are brand new:
  1240. + Cortex-M3 Tasking
  1241. The following ports have been available as separate downloads for a number
  1242. of months, but are now included in the main FreeRTOS download.
  1243. + Cortex-M0 IAR
  1244. + Cortex-M0 GCC
  1245. + Cortex-M4F GCC (with full floating point support)
  1246. New demos:
  1247. The following demos are brand new:
  1248. + Renesas RX63N RDK (Renesas compiler)
  1249. The following demos have been available as separate downloads for a number
  1250. of months, but are now included in the main FreeRTOS download.
  1251. + NXP LPC1114 GCC/LPCXpresso
  1252. + ST STM32F0518 IAR
  1253. + Infineon XMC4500 GCC/Atollic
  1254. + Infineon XMC4500 IAR
  1255. + Infineon XMC4500 Keil
  1256. + Infineon XMC4500 Tasking
  1257. Kernel miscellaneous / maintenance:
  1258. + Introduced the portSETUP_TCB() macro to remove the requirement for the
  1259. Windows simulator to use the traceTASK_CREATE() macro, leaving the trace
  1260. macro available for use by FreeRTOS+Trace (https://www.FreeRTOS.org/trace).
  1261. + Added a new trace macro, traceMOVE_TASK_TO_READY_STATE(), to allow future
  1262. FreeRTOS+Trace versions to provide even more information to users.
  1263. + Updated the FreeRTOS MPU port to be correct for changes that were
  1264. introduced in FreeRTOS V7.1.0.
  1265. + Introduced the xQueueReset() API function.
  1266. + Introduced the xSemaphoreGetMutexHolder() API function.
  1267. + Tidy up various port implementations to add the static key word where
  1268. appropriate, and remove obsolete code.
  1269. + Slight change to the initial stack frame given to the RX600 ports to allow
  1270. them to be used in the Eclipse based E2Studio IDE without confusing GDB.
  1271. + Correct the alignment given to the initial stack of Cortex-M4F tasks.
  1272. + Added a NOP following each DINT instruction on MSP430 devices for strict
  1273. conformance with the instructions on using DINT.
  1274. + Changed the implementation of thread deletes in the Win32 port to prevent
  1275. the port making use of the traceTASK_DELETE() trace macros - leaving this
  1276. macro free for use by FreeRTOS+Trace.
  1277. + Made some benign changes to the RX600 Renesas compiler port layer to
  1278. ensure the code can be built to a library without essential code being
  1279. removed by the linker.
  1280. + Reverted the change in the name of the uxTaskNumber variable made in
  1281. V7.1.0 as it broke the IAR plug-in.
  1282. Demo miscellaneous / maintenance:
  1283. + The command interpreter has now been formally released as FreeRTOS+CLI,
  1284. and been moved out of the main FreeRTOS download, to instead be available
  1285. from the FreeRTOS+ Ecosystem site https://www.FreeRTOS.org/plus.
  1286. + flash_timer.c/h has been added to the list of standard demo tasks. This
  1287. performs the same functionality as the flash.c tasks, but using software
  1288. timers in place of tasks.
  1289. + Upgraded the PIC32 demo as follows: Changes to how the library functions
  1290. are called necessitated by the new compiler version, addition of MPLAB X
  1291. project with PIC32MX360, PIC32MX460 and PIC32MX795 configurations,
  1292. addition of simply blinky demo, updated FreeRTOSConfig.h to include more
  1293. parameters, addition of hook function stubs.
  1294. + The MSP430X IAR and CCS demos have been updated to ensure the power
  1295. settings are correct for the configured CPU frequency.
  1296. + Rowley CrossWorks projects have been updated to correct the "multiple
  1297. definition of ..." warnings introduced when the toolchain was updated.
  1298. + Updated various FreeRTOSConfig.h header files associated with projects
  1299. that build with Eclipse to include a #error statement informing the user
  1300. that the CreateProjectDirectoryStructure.bat batch file needs to be
  1301. executed before the projects can be opened.
  1302. + Renamed directories that included "CCS4" in their name to remove the '4'
  1303. and instead just be "CCS". This is because the demo was updated and
  1304. tested to also work with later Code Composer Studio versions.
  1305. + Updated the TCP/IP periodic timer frequency in numerous uIP demos to be
  1306. 50ms instead of 500ms.
  1307. Changes between V7.0.2 and V7.1.0 released December 13 2011
  1308. New ports:
  1309. + Cortex-M4F IAR port.
  1310. + Cortex-M4F Keil/RVDS port.
  1311. + TriCore GCC port.
  1312. New demos:
  1313. + NXP LPC4350 using the Keil MDK, and demonstrated on a Hitex development
  1314. board.
  1315. + ST STM32F407 using the IAR Embedded Workbench for ARM, and demonstrated on
  1316. the IAR STM32F407ZG-SK starter kit.
  1317. + Infineon TriCore TC1782, using the GCC compiler, demonstrated on the
  1318. TriBoard TC1782 evaluation board.
  1319. + Renesas RX630, using the Renesas compiler and HEW, demonstrated on an
  1320. RX630 RSK (Renesas Starter Kit).
  1321. Miscellaneous / maintenance:
  1322. + Removed all calls to printf() from the K60/IAR Kinetis demo so the project
  1323. can execute stand alone - without being connected to the debugger.
  1324. + Completed the command interpreter framework. Command handlers now receive
  1325. the entire command string, giving them direct access to parameters.
  1326. Utility functions are provided to check the number of parameters, and
  1327. return parameter sub-strings.
  1328. + The previously documented fix for the bug in xTaskResumeFromISR() that
  1329. effected (only) ports supporting interrupt nesting has now been
  1330. incorporated into the main release.
  1331. + The portALIGNMENT_ASSERT_pxCurrentTCB() definition has been added to allow
  1332. specific ports to skip the second stack alignment check when a task is
  1333. created. This is because the second check is not appropriate for some
  1334. ports - including the new TriCore port where the checked pointer does not
  1335. actually point to a stack.
  1336. + The portCLEAN_UP_TCB() macro has been added to allow port specific clean
  1337. up when a task is deleted - again this is required by the TriCore port.
  1338. + Various other minor changes to ensure warning free builds on a growing
  1339. number of microcontroller and toolchain platforms. This includes a
  1340. (benign) correction to the prototype of the
  1341. vApplicationStackOverflowHook() definition found in lots of recent demos.
  1342. Trace system:
  1343. + The legacy trace mechanism has been completely removed - it has been
  1344. obsolete for the years since the trace macros were introduced. The
  1345. configuration constant configUSE_TRACE_FACILITY is now used to optionally
  1346. include additional queue and task information. The additional information
  1347. is intended to make the trace mechanism more generic, and allow the trace
  1348. output to provide more information. When configUSE_TRACE_FACILITY is set
  1349. to 1:
  1350. - the queue structure includes an additional member to hold the queue
  1351. type, which can be base, mutex, counting semaphore, binary semaphore
  1352. or recursive mutex.
  1353. - the queue structure includes an additional member to hold a queue
  1354. number. A trace tool can set and query the queue number for its own
  1355. purposes. The kernel does not use the queue number itself.
  1356. - the TCB structure includes an additional member to hold a task number
  1357. number. A trace tool can set and query the task number for its own
  1358. purposes. The kernel does not use the task number itself.
  1359. + Queues and all types of semaphores are now automatically allocated their
  1360. type as they are created.
  1361. + Added two new trace macros - traceTASK_PRIORITY_INHERIT() and
  1362. traskTASK_PRIORITY_DISINHERIT().
  1363. + Updated the traceQUEUE_CREATE_FAILED() macro to take a parameter that
  1364. indicates the type of queue, mutex, or semaphore that failed to be
  1365. created.
  1366. + The position from which traceCREATE_MUTEX() is called has been moved from
  1367. after the call to xQueueGenericSend() [within the same function] to before
  1368. the call. This ensures the trace events occur in the correct order.
  1369. + The value passed into tracePRIORITY_SET() has been corrected for the case
  1370. where vTaskPrioritySet() is called with a null parameter.
  1371. Changes between V7.0.1 and V7.0.2 released September 20 2011
  1372. New ports:
  1373. + The official FreeRTOS Renesas RX200 port and demo application have been
  1374. incorporated into the main FreeRTOS zip file download.
  1375. + The official FreeRTOS Renesas RL78 port and demo application have been
  1376. incorporated into the main FreeRTOS zip file download.
  1377. + The official FreeRTOS Freescale Kinetis K60 tower demo application has
  1378. been incorporated into the main FreeRTOS zip file download. This includes
  1379. an embedded web server example.
  1380. + A new Microblaze V8 port layer has been created to replace the older, now
  1381. deprecated, port layer. The V8 port supports V8.x of the Microblaze IP,
  1382. including exceptions, caches, and the floating point unit. A new
  1383. Microblaze demo has also been added to demonstrate the new Microblaze V8
  1384. port layer. The demo application was created using V13.1 of the Xilinx
  1385. EDK, and includes a basic embedded web server that uses lwIP V1.4.0.
  1386. + The official FreeRTOS Fujitsu FM3 MB9A310 demo application has been
  1387. incorporated into the main FreeRTOS zip file download. Projects are
  1388. provided for both the IAR and Keil toolchains.
  1389. API additions:
  1390. + xTaskGetIdleTaskHandle() has been added.
  1391. + xTaskGetTimerDaemonTaskHandle() has been added.
  1392. + pcTaskGetTaskName() has been added.
  1393. + vSemaphoreDelete() macro has been added to make it obvious how to delete
  1394. a semaphore. In previous versions vQueueDelete() had to be used.
  1395. + vTaskCleanUpResources() has been removed. It has been obsolete for a
  1396. while.
  1397. + portPOINTER_SIZE_TYPE has been introduced to prevent compiler warnings
  1398. being generated when the size of a pointer does not match the size of
  1399. the stack type. This will (has already) be used in new ports, but will
  1400. not be retrofitted to existing ports until the existing port itself is
  1401. updated.
  1402. Other updates and news:
  1403. + The core files have all been modified to tighten the coding standard even
  1404. further. These are style, not functional changes.
  1405. + All ARM7 port layers have been slightly modified to prevent erroneous
  1406. assert() failures when tasks are created and configASSERT() is defined.
  1407. + All ARM IAR projects have been updated to build with the latest V6.2.x
  1408. versions of the IAR Embedded Workbench for ARM tools (EWARM). This was
  1409. necessary due to a change in the way EWARM uses the CMSIS libraries.
  1410. + The PIC32 port layer has been updated in preparation for V2 of the C32
  1411. compiler.
  1412. + The old Virtex-4 Microblaze demo has been marked as deprecated. Please
  1413. use the brand new Spartan-6 port and demo in its place.
  1414. + The bones of a new generic command interpreter is located in
  1415. FreeRTOS/Demo/Common/Utils/CommandInterpreter.c. This is still a work in
  1416. progress, and not documented. It is however already in use. It will be
  1417. documented in full when the projects that are already using it are
  1418. completed.
  1419. + A couple of new standard demos have been included. First, a version of
  1420. flop.c called sp_flop.c. This is similar to flop.c, but uses single
  1421. precision floats in place of double precision doubles. This allows the
  1422. for testing ports to processors that have only single precision floating
  1423. point units, and revert to using emulated calculations whenever a double
  1424. is used. Second, comtest_strings.c has been included to allow the test
  1425. of UART drivers when an entire string is transmitted at once. The
  1426. previous comtest.c only used single character transmission and reception.
  1427. + lwIP V1.4.0 is now included in the FreeRTOS/Demo/Common directory, and
  1428. used by a couple of new demos.
  1429. Changes between V7.0.0 and V7.0.1 released May 13 2011
  1430. + Added a Fujitsu FM3 demo application for both the IAR and Keil tool
  1431. chains.
  1432. + Added a SmartFusion demo application for all of the IAR, Keil and
  1433. SoftConsole (GCC/Eclipse) tool chains.
  1434. + Updated the RX600 port and demo applications to take into account the
  1435. different semantics required when using the latest (V1.0.2.0) version of
  1436. the Renesas compiler.
  1437. + Modified the RX600 Ethernet driver slightly to make it more robust under
  1438. heavy load, and updated the uIP handling task to make use of the FreeRTOS
  1439. software timers.
  1440. + Slightly changed the PIC32 port layer to move an ehb instruction in line
  1441. with the recommendations of the MIPS core manual, and ensure 8 byte stack
  1442. alignment is truly always obtained.
  1443. + Changed the behaviour when tasks are suspended before the scheduler has
  1444. been started. Before, there needed to be at least one task that was not
  1445. in the suspended state. This is no longer the case.
  1446. Changes between V6.1.1 and V7.0.0 released April 8 2011
  1447. FreeRTOS V7.0.0 is backward compatible with FreeRTOS V6.x.x
  1448. Main changes:
  1449. + Introduced a new software timer implementation.
  1450. + Introduced a new common demo application file to exercise the new timer
  1451. implementation.
  1452. + Updated the Win32/MSVC simulator project to include the new software timer
  1453. demo tasks and software timer tick hook test. Much simpler software timer
  1454. demonstrations are included in the demo projects for both of the new ports
  1455. (MSP430X with CCS4 and STM32 with TrueStudio).
  1456. + Various enhancements to the kernel implementation in tasks.c. These are
  1457. transparent to users and do not effect the pre-existing API.
  1458. + Added calls to configASSERT() within the kernel code. configASSERT() is
  1459. functionally equivalent to the standard C assert() macro, but does not
  1460. rely on the compiler providing assert.h.
  1461. Other changes:
  1462. + Updated the MSP430X IAR port and demo project to include support for the
  1463. medium memory model.
  1464. + Added a demo project for the MSP430X that targets the MSP430X Discovery
  1465. board and uses the Code Composer Studio 4 tools. This demo includes use
  1466. of the new software timer implementation.
  1467. + Added an STM32F100RB demo project that targets the STM32 Discovery Board
  1468. and uses the TrueStudio Eclipse based IDE from Atollic.
  1469. + Removed some compiler warnings from the PSoC demo application.
  1470. + Updated the PIC32 port layer to ensure the
  1471. configMAX_SYSCALL_INTERRUPT_PRIORITY constant works as expected no matter
  1472. what its value is (within the valid range set by the microcontroller
  1473. kernel).
  1474. + Updated the PIC24, dsPIC and PIC32 projects so they work with the latest
  1475. MPLAB compiler versions from Microchip.
  1476. + Various cosmetic changes to prepare for a standards compliance statement
  1477. that will be published after the software release.
  1478. Changes between V6.1.0 and V6.1.1 released January 14 2011
  1479. + Added two new Windows simulator ports. One uses the free Microsoft Visual
  1480. Studio 2010 express edition, and the other the free MingW/Eclipse
  1481. environment. Demo projects are provided for both.
  1482. + Added three demo projects for the PSoC 5 (CYAC5588). These are for the
  1483. GCC, Keil, and RVDS build tools, and all use the PSoC Creator IDE.
  1484. + Added a demo for the low power STM32L152 microcontroller using the IAR
  1485. Embedded Workbench.
  1486. + Added a new port for the MSP430X core using the IAR Embedded Workbench.
  1487. + Updated all the RX62N demo projects that target the Renesas Demonstration
  1488. Kit (RDK) to take into account the revered LED wiring on later hardware
  1489. revisions, and the new J-Link debug interface DLL.
  1490. + Updated all the RX62N demo projects so the IO page served by the example
  1491. embedded web server works with all web browsers.
  1492. + Updated the Red Suite projects to work with the up coming Red Suite
  1493. release, and to use a more recent version of the CMSIS libraries.
  1494. + Added the traceTAKE_MUTEX_RECURSIVE_FAILED() trace macro.
  1495. + Removed the (pointless) parameter from the traceTASK_CREATE_FAILED()
  1496. trace macro.
  1497. + Introduced the portALT_GET_RUN_TIME_COUNTER_VALUE() macro to compliment
  1498. the already existing portGET_RUN_TIME_COUNTER_VALUE(). This allows for
  1499. more flexibility in how the time base for the run time statistics feature
  1500. can be implemented.
  1501. + Added a "cpsie i" instruction before the "svc 0" instruction used to start
  1502. the scheduler in each of the Cortex M3 ports. This is to ensure that
  1503. interrupts are globally enabled prior to the "svc 0" instruction being
  1504. executed in cases where interrupts are left disabled by the C start up
  1505. code.
  1506. + Slight optimisation in the run time stats calculation.
  1507. Changes between V6.0.5 and V6.1.0 released October 6 2010
  1508. + Added xTaskGetTickCountFromISR() function.
  1509. + Modified vTaskSuspend() to allow tasks that have just been created to be
  1510. immediately suspended even when the kernel has not been started. This
  1511. allows them to effectively start in the Suspended state - a feature that
  1512. has been asked for on numerous occasions to assist with initialisation
  1513. procedures.
  1514. + Added ports for the Renesas RX62N using IAR, GCC and Renesas tool suites.
  1515. + Added a STM32F103 demo application that uses the Rowley tools.
  1516. + Under specific conditions xFreeBytesRemaining within heap_2.c could end up
  1517. with an incorrect value. This has been fixed.
  1518. + xTaskCreateGeneric() has a parameter that can be used to pass the handle
  1519. of the task just created out to the calling task. The assignment to this
  1520. parameter has been moved to ensure it is assigned prior to the newly
  1521. created having any possibility of executing. This takes into account the
  1522. case where the assignment is made to a global variable that is accessed by
  1523. the newly created task.
  1524. + Fixed some build time compiler warnings in various FreeTCPIP (based on
  1525. uIP) files.
  1526. + Fixed some build time compiler warnings in Demo/Common/Minimal/IntQueue.c.
  1527. Changes between V6.0.4 and V6.0.5 released May 17 2010
  1528. + Added port and demo application for the Cortus APS3 processor.
  1529. Changes between V6.0.3 and V6.0.4 released March 14 2010
  1530. + All the contributed files that were located in the Demo/Unsupported_Demos
  1531. directory have been removed. These files are instead now available in the
  1532. new Community Contributions section of the FreeRTOS website. See
  1533. https://www.FreeRTOS.org/RTOS-contributed-ports.html
  1534. + The project file located in the Demo/CORTEX_STM32F107_GCC_Rowley directory
  1535. has been upgraded to use V2.x of the Rowley Crossworks STM32 support
  1536. package.
  1537. + An initial Energy Micro EFM32 demo has been included. This will be
  1538. updated over the coming months to make better use of the low power modes
  1539. the EFM32 provides.
  1540. Changes between V6.0.2 and V6.0.3 released February 26 2010
  1541. + SuperH SH7216 (SH2A-FPU) port and demo application added.
  1542. + Slight modification made to the default implementation of
  1543. pvPortMallocAligned() and vPortFreeAligned() macros so by default they
  1544. just call pvPortMalloc() and vPortFree(). The macros are only needed to
  1545. be defined when a memory protection unit (MPU) is being used - and then
  1546. only depending on other configuration settings.
  1547. Changes between V6.0.1 and V6.0.2 released January 9th 2010
  1548. + Changed all GCC ARM 7 ports to use 0 as the SWI instruction parameter.
  1549. Previously the parameter was blank and therefore only an implicit 0 but
  1550. newer GCC releases do not permit this.
  1551. + Updated IAR SAM7S and SAM7X ports to work with IAR V5.40.
  1552. + Changed the stack alignment requirement for PIC32 from 4 bytes to 8 bytes.
  1553. + Updated prvListTaskWithinSingleList() is it works on processors where the
  1554. stack grows up from low memory.
  1555. + Corrected some comments.
  1556. + Updated the startup file for the RVDS LPC21xx demo.
  1557. Changes between V6.0.0 and V6.0.1 released November 15th 2009
  1558. + Altered pxPortInitialiseStack() for all Cortex-M3 ports to ensure the
  1559. stack pointer is where the compiler expects it to be when a task first
  1560. starts executing.
  1561. The following minor changes only effect the Cortex-M3 MPU port:
  1562. + portRESET_PRIVILEGE() assembly macro updated to include a clobber list.
  1563. + Added prototypes for all the privileged function wrappers to ensure no
  1564. compile time warnings are generated no matter what the warning level
  1565. setting.
  1566. + Corrected the name of portSVC_prvRaisePrivilege to
  1567. portSVC_RAISE_PRIVILEGE.
  1568. + Added conditional compilation into xTaskGenericCreate() to prevent some
  1569. compilers issuing warnings when portPRIVILEGE_BIT is defined as zero.
  1570. Changes between V5.4.2 and V6.0.0 released October 16th 2009
  1571. FreeRTOS V6 is backward compatible with FreeRTOS V5.x.
  1572. Main changes:
  1573. + FreeRTOS V6 is the first version to include memory protection unit (MPU)
  1574. support. Two ports now exist for the Cortex M3, the standard FreeRTOS
  1575. which does not include MPU support, and FreeRTOS-MPU which does.
  1576. + xTaskCreateRestricted() and vTaskAllocateMPURegions() API functions added
  1577. in support of FreeRTOS-MPU.
  1578. + Wording for the GPL exception has been (hopefully) clarified. Also the
  1579. license.txt file included in the download has been fixed (the previous
  1580. version contained some corruption).
  1581. Other changes:
  1582. + New API function xPortGetFreeHeapSize() added to heap_1.c and heap_2.c.
  1583. + ARM7 GCC demo interrupt service routines wrappers have been modified to
  1584. call the C portion using an __asm statement. This prevents the function
  1585. call being inlined at higher optimisation levels.
  1586. + ARM7 ports now automatically set the THUMB bit if necessary when
  1587. setting up the initial stack of a task - removing the need for
  1588. THUMB_INTERWORK to be defined. This also allows THUMB mode and ARM mode
  1589. tasks to be mixed more easily.
  1590. + All ARM7/9 ports now have portBYTE_ALIGNMENT set to 8 by default.
  1591. + Various demo application project files have been updated to be up to date
  1592. with the latest IDE versions.
  1593. + The linker scripts used with command line GCC demos have been updated to
  1594. include an eh_frame section to allow their use with the latest Yagarto
  1595. release. Likewise the demo makefiles have been updated to include
  1596. command line options to reduce or eliminate the eh_frame section all
  1597. together.
  1598. + The definition of portBYTE_ALIGNMENT_MASK has been moved out of the
  1599. various memory allocation files and into the common portable.h header
  1600. file.
  1601. + Removed unnecessary use of portLONG, portSHORT and portCHAR.
  1602. + Added LM3Sxxxx demo for Rowley CrossWorks.
  1603. + Posix simulator has been upgraded - see the corresponding WEB page on the
  1604. FreeRTOS.org site.
  1605. Changes between V5.4.1 and V5.4.2 released August 9th 2009
  1606. + Added a new port and demo app for the Altera Nios2 soft core.
  1607. + Added LPC1768 demo for IAR.
  1608. + Added a USB CDC demo to all LPC1768 demos (Code Red, CrossWorks and IAR).
  1609. + Changed clock frequency of LPC1768 demos to 99MHz.
  1610. Changes between V5.4.0 and V5.4.1 released July 25th 2009
  1611. + New hook function added. vApplicationMallocFailedHook() is (optionally)
  1612. called if pvPortMalloc() returns NULL.
  1613. + Additional casting added to xTaskCheckForTimeOut(). This prevents
  1614. problems that can arise should configUSE_16_BIT_TICKS be set to 1 on a
  1615. 32 bit architecture (which would probably be a mistake, anyway).
  1616. + Corrected the parameter passed to NVIC_SetPriority() to set the MAC
  1617. interrupt priority in both LPC1768 demos.
  1618. + Decreased the default setting of configMINIMAL_STACK_SIZE in the PIC32
  1619. demo application to ensure the heap space was not completely consumed
  1620. before the scheduler was started.
  1621. Changes between V5.3.1 and V5.4.0 released July 13th 2009
  1622. + Added Virtex5 / PPC440 port and demos.
  1623. + Replaced the LPC1766 Red Suite demo with an LPC1768 Red Suite demo. The
  1624. original demo was configured to use engineering samples of the CPU. The
  1625. new demo has an improved Ethernet driver.
  1626. + Added LPC1768 Rowley demo with zero copy Ethernet driver.
  1627. + Reworked byte alignment code to ensure 8 byte alignment works correctly.
  1628. + Set configUSE_16_BIT_TICKS to 0 in the PPC405 demo projects.
  1629. + Changed the initial stack setup for the PPC405 to ensure the small data
  1630. area pointers are setup correctly.
  1631. Changes between V5.3.0 and V5.3.1 released June 21st 2009
  1632. + Added ColdFire V1 MCF51CN128 port and WEB server demo.
  1633. + Added STM32 Connectivity Line STM32107 Cortex M3 WEB server demo.
  1634. + Changed the Cortex M3 port.c asm statements to __asm so it can be
  1635. compiled using Rowley CrossWorks V2 in its default configuration.
  1636. + Updated the Posix/Linux simulator contributed port.
  1637. Changes between V5.2.0 and V5.3.0 released June 1st 2009
  1638. Main changes:
  1639. + Added new (optional) feature that gathers statistics on the amount of CPU
  1640. time used by each task.
  1641. + Added a new demo application for the Atmel AT91SAM3U Cortex-M3 based
  1642. microcontroller.
  1643. + Added a new demo application for the NXP LPC1766 Cortex-M3 based
  1644. microcontroller.
  1645. + Added a contributed port/demo that allows FreeRTOS to be 'simulated' in a
  1646. Linux environment.
  1647. Minor changes:
  1648. + Updated the Stellaris uIP WEB server demos to include the new run time
  1649. statistics gathering feature - and include a served WEB page that
  1650. presents the information in a tabular format.
  1651. + Added in the lwIP port layer for the Coldfire MCF52259.
  1652. + Updated the CrossWorks LPC2368 WEB server to include an image in the
  1653. served content.
  1654. + Changed some of the timing in the initialisation of the LPC2368 MAC to
  1655. permit its use on all part revisions.
  1656. + Minor modifications to the core uIP code to remove some compiler warnings.
  1657. + Added xTaskGetApplicationTaskTag() function and updated the OpenWatcom
  1658. demo to make use of the new function.
  1659. + Added contributed demos for AVR32 AP7000, STM32 Primer 2 and STM32 using
  1660. Rowley Crossworks.
  1661. + Heap_1.c and Heap_2.c used to define structures for the purpose of data
  1662. alignment. These have been converted to unions to save a few bytes of
  1663. RAM that would otherwise be wasted.
  1664. + Remove the call to strncpy() used to copy the task name into the TCB when
  1665. the maximum task name is configured to be 1 byte long.
  1666. Changes between V5.1.2 and V5.2.0 released March 14th 2009
  1667. + Optimised the queue send and receive functions (also used by semaphores).
  1668. + Replaced the standard critical sections used to protect BIOS calls in the
  1669. PC port to instead use scheduler locks. This is because the BIOS calls
  1670. always return with interrupts enabled.
  1671. + Corrected unclosed comments in boot.s.
  1672. Changes between V5.1.1 and V5.1.2 released February 9th 2009
  1673. + Added NEC V850ES port and demo.
  1674. + Added NEC 78K0R port and demo.
  1675. + Added MCF52259 port and demo.
  1676. + Added the AT91SAM9XE port and demo.
  1677. + Updated the MCF52233 FEC driver to work around a silicon bug that
  1678. prevents the part auto negotiating some network parameters.
  1679. + Minor modifications to the MCF52233 makefile to permit it to be used
  1680. on Linux hosts.
  1681. + Updated the STM32 primer files to allow them to be built with the latest
  1682. version of the RIDE tools.
  1683. + Updated the threads.js Java script used for kernel aware debugging in
  1684. the Rowley CrossWorks IDE.
  1685. Changes between V5.1.0 and V5.1.1 released November 20, 2008
  1686. + Added Coldfire MCF52233 WEB server demo using GCC and Eclipse.
  1687. + Added IAR MSP430 port and demo.
  1688. + Corrected several compiler time issues that had crept in as tool versions
  1689. change.
  1690. + Included FreeRTOS-uIP - a faster uIP. This is not yet complete.
  1691. Changes between V5.0.4 and V5.1.0 released October 24, 2008
  1692. + Added a new port and demo application for the ColdFire V2 core using the
  1693. CodeWarrior development tools.
  1694. + Replaced the ARM7 demo that used the old (and now no longer supported)
  1695. Keil compiler with a new port that uses the new Keil/RVDS combo.
  1696. + Stack overflow checking now works for stacks that grow up from low
  1697. memory (PIC24 and dsPIC).
  1698. + BUG FIX - set the PIC32 definition of portSTACK_GROWTH to the correct
  1699. value of -1.
  1700. + MSP430 port layers have been updated to permit tasks to place the
  1701. microcontroller into power down modes 1 to 3. The demo applications have
  1702. likewise been updated to demonstrate the new feature.
  1703. + Replaced the two separate MSP430/Rowley port layers with a single and more
  1704. flexible version.
  1705. + Added more contributed ports, including ports for NEC and SAM9
  1706. microcontrollers.
  1707. + Changed the linker script used in the LPC2368 Eclipse demo.
  1708. Changes between V5.0.3 and V5.0.4 released September 22, 2008
  1709. + Completely re-written port for ColdFire GCC.
  1710. + Bug fix: All Cortex M3 ports have a minor change to the code that sets
  1711. the pending interrupt.
  1712. + Some header files require that FreeRTOS.h be included prior to their
  1713. inclusion. #error message have been added to all such header file
  1714. informing users to the cause of the compilation error should the headers
  1715. not be included in the correct order.
  1716. Changes between V5.0.2 and V5.0.3 released July 31, 2008
  1717. Changes relating to the Cortex M3:
  1718. + Added configMAX_SYSCALL_INTERRUPT_PRIORITY usage to all the Cortex M3
  1719. ports and demos. See the port documentation pages on the FreeRTOS.org
  1720. WEB site for full usage information.
  1721. + Improved efficiency of Cortex M3 port even further.
  1722. + Ensure the Cortex M3 port works no matter where the vector table is
  1723. located.
  1724. + Added the IntQTimer demo/test tasks to a demo project for each CM3 port
  1725. (Keil, GCC and IAR) to test the new configMAX_SYSCALL_INTERRUPT_PRIORITY
  1726. functionality.
  1727. + Added the mainINCLUDE_WEB_SERVER definition to the LM3SXXXX IAR and Keil
  1728. projects to allow the WEB server to be conditionally excluded from the
  1729. build and therefore allow use of the KickStart (code size limited)
  1730. compiler version.
  1731. Other changes:
  1732. + Moved the PIC24 and dsPIC versions of vPortYield() from the C file to
  1733. an assembly file to allow use with all MPLAB compiler versions. This also
  1734. allows the omit-frame-pointer optimisation to be turned off.
  1735. Changes between V5.0.0 and V5.0.2 released May 30, 2008
  1736. + Updated the PIC32 port to allow queue API calls to be used from
  1737. interrupts above the kernel interrupt priority, and to allow full
  1738. interrupt nesting. Task stack usages has also been reduced.
  1739. + Added a new PowerPC port that demonstrates how the trace macros can be
  1740. used to allow the use of a floating point co-processor. The
  1741. traceTASK_SWITCHED_OUT() and traceTASK_SWITCHED_INT() macros are used to
  1742. save and restore the floating point context respectively for those tasks
  1743. that actually use floating point operations.
  1744. + BUG FIX: The first PPC405 port contained a bug in that it did not leave
  1745. adequate space above the stack for the backchain to be saved when a task
  1746. started to execute for the first time.
  1747. + Updated queue.c to add in the means to allow interrupt nesting and for
  1748. queue API functions to be called from interrupts that have a priority
  1749. above the kernel priority. This is only supported on PIC32 ports thus
  1750. far.
  1751. + Fixed the compiler warnings that were generated when the latest version
  1752. of WinAVR was used.
  1753. + Remove all inline usage of 'inline' from the core kernel code.
  1754. + Added the queue registry feature. The queue registry is provided as a
  1755. means for kernel aware debuggers to locate queue definitions. It has no
  1756. purpose unless you are using a kernel aware debugger. The queue registry
  1757. will only be used when configQUEUE_REGISTRY_SIZE is greater than zero.
  1758. + Added the ST Cortex-M3 drivers into the Demo/Common/Drivers directory to
  1759. prevent them from having to be included in multiple demos.
  1760. + Added a Keil STM32 demo application.
  1761. + Changed the blocktim.c test files as it is no longer legitimate for all
  1762. ports to call queue API functions from within a critical section.
  1763. + Added the IntQueue.c test file to test the calling of queue API functions
  1764. from different interrupt priority levels, and test interrupt nesting.
  1765. Changes between V5.0.0 and V5.0.1
  1766. + V5.0.1 was a customer specific release.
  1767. Changes between V4.8.0 and V5.0.0 released April 15, 2008
  1768. *** VERY IMPORTANT INFORMATION ON UPGRADING TO FREERTOS.ORG V5.0.0 ***
  1769. The parameters to the functions xQueueSendFromISR(), xQueueSendToFrontFromISR(),
  1770. xQueueSendToBackFromISR() and xSemaphoreGiveFromISR() have changed. You must
  1771. update all calls to these functions to use the new calling convention! Your
  1772. compiler might not issue any type mismatch warnings!
  1773. Other changes:
  1774. + Support added for the new Luminary Micro LM3S3768 and LM3S3748 Cortex-M3
  1775. microcontrollers.
  1776. + New task hook feature added.
  1777. + PowerPC demo updated to use version 10.1 of the Xilinx EDK.
  1778. + Efficiency gains within the PIC32 port layer.
  1779. Changes between V4.7.2 and V4.8.0 released March 26 2008
  1780. + Added a Virtex4 PowerPC 405 port and demo application.
  1781. + Added optional stack overflow checking and new
  1782. uxTaskGetStackHighWaterMark() function.
  1783. + Added new xQueueIsQueueEmptyFromISR(), xQueueIsQueueFullFromISR() and
  1784. uxQueueMessagesWaitingFromISR() API functions.
  1785. + Efficiency improvements to the Cortex-M3 port layer. NOTE: This
  1786. requires that an SVC handler be installed in the application.
  1787. + Efficiency improvements to the queue send and receive functions.
  1788. + Added new trace macros. These are application definable to provide
  1789. a flexible trace facility.
  1790. + Implemented the configKERNEL_INTERRUPT_PRIORITY within the Keil Cortex
  1791. M3 port layer (bringing it up to the same standard as the IAR and GCC
  1792. versions).
  1793. + Ports that used the arm-stellaris-eabi-gcc tools have been converted to
  1794. use the arm-non-eabi-gcc tools.
  1795. Changes between V4.7.1 and V4.7.2 released February 21, 2008
  1796. + Added Fujitsu MB91460 port and demo.
  1797. + Added Fujitsu MB96340 port and demo.
  1798. + Tidied up the capitalisation of include files to facilitate builds on
  1799. Linux hosts.
  1800. + Removed some redundant casting that was generating warnings - but was
  1801. included to remove warnings on other compilers.
  1802. Changes between V4.7.0 and V4.7.1 released February 3, 2008
  1803. + Updated all IAR ARM projects to use V5.11 of the IAR Embedded Workbench
  1804. for ARM.
  1805. + Introduced recursive semaphore feature.
  1806. + Updated LPC2368 demos to take into account silicon bugs in old chip
  1807. revisions.
  1808. + Updated STR9 uIP port to manually set the net mask and gateway addresses.
  1809. + Updating demos to allow more to run with the co-operative scheduler.
  1810. + Fixed co-operative scheduler behaviour upon the occurrence of a tick
  1811. interrupt while the scheduler was suspended.
  1812. + Updated documentation contained within semphr.h.
  1813. + ARM7 GCC ports no longer use the IRQ attribute.
  1814. Changes between V4.6.1 and V4.7.0 released December 6, 2007
  1815. + Introduced the counting semaphore macros and demo source files. The
  1816. Open Watcom PC project has been updated to include the new demo. See
  1817. the online documentation for more information.
  1818. + Introduced the 'alternative' queue handling API and demo source files.
  1819. The Open Watcom PC project has been updated to include the new demo
  1820. source files. See the online documentation for more information.
  1821. + Added AT91SAM7X Eclipse demo project.
  1822. + Added the STM32 primer demo project for the GCC compiler and Ride IDE.
  1823. + Removed the .lock files that were mistakenly included in the V4.6.1
  1824. eclipse workspaces.
  1825. Changes between V4.6.0 and V4.6.1 released November 5 2007
  1826. + Added support for the MIPS M4K based PIC32.
  1827. + Added 'extern "C"' to all the header files to facilitate use with C++.
  1828. Changes between V4.5.0 and V4.6.0 released October 28 2007
  1829. + Changed the method used to force a context switch within an ISR for the
  1830. ARM7/9 GCC ports only. The portENTER_SWITCHING_ISR() and
  1831. portEXIT_SWITCHING_ISR() macros are no longer supported. This is to
  1832. ensure correct behaviour no matter which GCC version is used, with or
  1833. without the -fomit-frame-pointer option, and at all optimisation levels.
  1834. + Corrected the prototype for xQueueGenericSend() within queue.h.
  1835. Changes between V4.4.0 and V4.5.0 released September 17 2007
  1836. + Added the xQueueSendToFront(), xQueueSendToBack() and xQueuePeek()
  1837. functionality. These should now be used in preference to the old
  1838. xQueueSend() function - which is maintained for backward compatibility.
  1839. + Added Mutex functionality. The behaviour of mutexes is subtly different
  1840. to the already existing binary semaphores as mutexes automatically
  1841. include a priority inheritance mechanism.
  1842. + Added the GenQTest.c and QPeek.c to test and demonstrate the behaviour
  1843. of the new functionality.
  1844. + Updated the LM3Sxxxx and PC ports to include the new GenQTest.c and
  1845. QPeek.c files.
  1846. + Updated the GCC port for the Cortex M3 to include the
  1847. configKERNEL_INTERRUPT_PRIORITY functionality. This was previously only
  1848. included in the IAR port.
  1849. + Optimised the GCC and IAR port layer code - specifically the context
  1850. switch code.
  1851. + Consolidated the LM3Sxxxx EK demos for all development tools into a
  1852. single project that automatically detects which version of the EK the
  1853. application is executing on.
  1854. + Added Eclipse support for LM3Sxxxx evaluation kits.
  1855. + Added Eclipse support for the Keil LPC2368 evaluation kit.
  1856. + Added the Demo/Drivers directory to hold code that is common to multiple
  1857. demo application projects.
  1858. + Included some minor bug fixes in the uIP 1.0 code.
  1859. + Added an lwIP demo for the STR9 - thanks ST for assistance.
  1860. + Updated the AVR32 port to ensure correct behaviour with full compiler
  1861. optimisation.
  1862. + Included binaries for OpenOCD FTDI and parallel port interfaces.
  1863. Changes between V4.4.0 and V4.3.1 released July 31, 2007
  1864. + Added AVR32 UC3B demo application.
  1865. + Updated AVR32 UC3A port and demo applications.
  1866. + Added IAR lwIP demo for AVR32 UC3A.
  1867. + Updated listGET_OWNER_OF_NEXT_ENTRY() to assist compiler optimisation
  1868. (thanks Niu Yong for making the suggestion).
  1869. + Added xTaskGetSchedulerState() API function.
  1870. + BUG FIX: Corrected behaviour when tasks that are blocked indefinitely
  1871. have their block time adjusted (within xQueueSend() and xQueueReceive()),
  1872. and are the subject of a call the vTaskResume() when they are not
  1873. actually in the Suspended state (thanks Dan Searles for reporting the
  1874. issues).
  1875. Changes between V4.3.0 and V4.3.1 released June 11, 2007
  1876. + Added STMicroelectronics STM32 Cortex-M3 demo application.
  1877. + Updated ustdlib.c for the GCC LM3S6965 demo.
  1878. Changes between V4.2.1 and V4.3.0 released June 5, 2007
  1879. + Introduced configKERNEL_INTERRUPT_PRIORITY to the IAR Cortex-M3, PIC24
  1880. and dsPIC ports. See the LM3S6965 and PIC24 demo application
  1881. documentation pages for more information.
  1882. + Updated the PIC24 and dsPIC demos to build with V3.0 of the PIC30 GCC
  1883. tools, and changed the demo applications.
  1884. + Added demos for the new Ethernet and CAN enabled Luminary Micro Stellaris
  1885. microcontrollers.
  1886. + Corrected bug in uIP the demos that prevented frames of approximately 1480
  1887. bytes and over from being transmitted.
  1888. + Included the LPC2368/uIP/Rowley demo into the main FreeRTOS.org
  1889. download.
  1890. + Update to WizC PIC18 port to permit its use with version 14 of the
  1891. compiler. Thanks Marcel!
  1892. Changes between V4.2.1 and V4.2.0 released April 2, 2007
  1893. + Added AVR32 AT32UC3A ports for GCC and IAR.
  1894. + Added -fomit-frame-pointer option to lwIP SAM7X demo makefile.
  1895. + Moved location of call to LCD_Init() in STR9 demo to ensure it is only
  1896. called after the scheduler has been started.
  1897. Changes between V4.1.3 and V4.2.0 released February 8, 2007
  1898. + Changes to both task.c and queue.c as a result of testing performed on
  1899. the SafeRTOS code base.
  1900. + Added Cortex-M3 LM3S811 demos for GCC and IAR tools.
  1901. Changes between V4.1.2 and V4.1.3 released November 19, 2006
  1902. + Added STR750 ARM7 port using the Raisonance RIDE/GCC tools.
  1903. + Added -fomit-frame-pointer option to Rowley ARM7 demos as work around
  1904. to GCC bug at some optimisation levels.
  1905. + Altered the way the heap is defined in the LM3S811 Keil demo to prevent
  1906. the RAM usage from counting toward the code size limit calculation.
  1907. + CO-ROUTINE BUG FIX: Removed the call to prvIsQueueEmpty from within
  1908. xQueueCRReceive as it exited with interrupts enabled. Thanks Paul Katz.
  1909. + Tasks that block on events with a timeout of portMAX_DELAY are now
  1910. blocked indefinitely if configINCLUDE_vTaskSuspend is defined.
  1911. Previously portMAX_DELAY was just the longest block time possible. This
  1912. is still the case if configINCLUDE_vTaskSuspend is not defined.
  1913. + Minor changes to some demo application files.
  1914. Changes between V4.1.1 and V4.1.2 released October 21, 2006
  1915. + Added 16bit PIC ports and demos.
  1916. + Added STR750 port and demo.
  1917. Changes between V4.1.0 and V4.1.1 released September 24, 2006
  1918. + Added the Luminary Micro Stellaris LM3S811 demo application.
  1919. Changes between V4.0.5 and V4.1.0 released August 28, 2006
  1920. + Prior to V4.1.0, under certain documented circumstances, it was possible
  1921. for xQueueSend() and xQueueReceive() to return without having completed
  1922. and without their block time expiring. The block time effectively
  1923. stated a maximum block time, and the return value of the function needed
  1924. to be checked to determine the reason for returning. This is no longer
  1925. the case as the functions will only return once the block time has
  1926. expired or they are able to complete their operation. It is therefore no
  1927. longer necessary to wrap calls within loops.
  1928. + Changed the critical section handling in the IAR AVR port to correct the
  1929. behaviour when used with later compiler versions.
  1930. + Added the LPC2138 CrossWorks demo into the zip file. Previously this was
  1931. only available as a separate download.
  1932. + Modified the AVR demo applications to demonstrate the use of co-routines.
  1933. Changes between V4.0.4 and V4.0.5 released August 13, 2006
  1934. + Introduced API function xTaskResumeFromISR(). Same functionality as
  1935. xTaskResume(), but can be called from within an interrupt service routine.
  1936. + Optimised vListInsert() in the case when the wake time is the maximum
  1937. tick count value.
  1938. + Bug fix: The 'value' of the event list item is updated when the priority
  1939. of a task is changed. Previously only the priority of the TCB itself was
  1940. changed.
  1941. + vTaskPrioritySet() and vTaskResume() no longer use the event list item.
  1942. This has not been necessary since V4.0.1 when the xMissedYield handling
  1943. was added.
  1944. + Lowered the PCLK setting on the ARM9 STR9 demo from 96MHz to 48MHz.
  1945. + When ending the scheduler - do not try to attempt a context switch when
  1946. deleting the current task.
  1947. + SAM7X EMAC drivers: Corrected the Rx frame length mask when obtaining
  1948. the length from the rx descriptor.
  1949. Changes between V4.0.3 and V4.0.4 released June 22, 2006
  1950. + Added a port and demo application for the STR9 ARM9 based processors from
  1951. ST.
  1952. + Slight optimisation to the vTaskPrioritySet() function.
  1953. + Included the latest uIP version (1.0) in the demo/common/ethernet
  1954. directory.
  1955. Changes between V4.0.2 and V4.0.3 released June 7, 2006
  1956. + Added a port and demo application for the Cortex-M3 target using the IAR
  1957. development tools.
  1958. + The ARM Cortex-m3 Rowley projects have been updated to use V1.6 of the
  1959. CrossStudio tools.
  1960. + The heap size defined for the lwIP Rowley demo has been reduced so that
  1961. the project will link correctly when using the command line GCC tools
  1962. also. The makefile has also been modified to allow debugging.
  1963. + The lwIP Rowley demo not includes a 'kernel aware' debug window.
  1964. + The uIP Rowley project has been updated to build with V1.6 of CrossWorks.
  1965. + The second set of tasks in the blockQ demo were created the wrong way
  1966. around (inconsistent to the description in the file). This has been
  1967. corrected.
  1968. Changes between V4.0.1 and V4.0.2 released May 28, 2006
  1969. + Port and demo application added for the Tern Ethernet Engine controller.
  1970. + Port and demo application added for MC9S12 using GCC, thanks to
  1971. Jefferson "imajeff" Smith.
  1972. + The function vTaskList() now suspends the scheduler rather than disabling
  1973. interrupts during the creation of the task list.
  1974. + Allow a task to delete itself by passing in its own handle. Previously
  1975. this could only be done by passing in NULL.
  1976. + Corrected the value passed to the WDG_PeriodValueConfig() library
  1977. function in the STR71x demo.
  1978. + The tick hook function is now called only within a tick isr. Previously
  1979. it was also called when the tick function was called during the scheduler
  1980. unlocking process.
  1981. + The EMAC driver in the SAM7X lwIP demo has been made more robust as per
  1982. the thread: https://sourceforge.net/forum/message.php?msg_id=3714405
  1983. + In the PC ports: Add function prvSetTickFrequencyDefault() to set the
  1984. DOS tick back to its proper value when the scheduler exits. Thanks
  1985. Raynald!
  1986. + In the Borland x86 ports there was a mistake in the portFIRST_CONTEXT
  1987. macro where the BP register was not popped from the stack correctly. The
  1988. BP value would never get used so this did not cause a problem, but it has
  1989. been corrected all the same.
  1990. Changes between V4.0.0 and V4.0.1 released April 7 2006
  1991. + Improved the ARM CORTEX M3 ports so they now only have to service
  1992. pendSV interrupts.
  1993. + Added a Luminary Micro port and demo for use with Rowley CrossWorks.
  1994. + Added the xMissedYield handling to tasks.c.
  1995. Changes between V3.2.4 and V4.0.0
  1996. Major changes:
  1997. + Added new RTOS port for Luminary Micros ARM CORTEX M3 microcontrollers.
  1998. + Added new co-routine functionality.
  1999. Other kernel changes:
  2000. + An optional tick hook call is now included in the tick function.
  2001. + Introduced the xMiniListItem structure and removed the list pxHead
  2002. member in order to reduce RAM usage.
  2003. + Added the following definitions to the FreeRTOSConfig.h file included
  2004. with every port:
  2005. configUSE_TICK_HOOK
  2006. configUSE_CO_ROUTINES
  2007. configMAX_CO_ROUTINE_PRIORITIES
  2008. + The volatile qualification has been changed on the list members to allow
  2009. the task.c code to be tidied up a bit.
  2010. + The scheduler can now be started even if no tasks have been created!
  2011. This is to allow co-routines to run when there are no tasks.
  2012. + A task being woken by an event will now preempt the currently running task
  2013. even if its priority is only equal to the currently running task.
  2014. Port and demo application changes:
  2015. + Updated the WinAVR demo to compile with the latest version of WinAVR
  2016. with no warnings generated.
  2017. + Changed the WinAVR makefile to make chars signed - needed for the
  2018. co-routine code if BaseType_t is set to char.
  2019. + Added new demo application file crflash.c. This demonstrates co-routine
  2020. functionality including passing data between co-routines.
  2021. + Added new demo application file crhook.c. This demonstrates co-routine
  2022. and tick hook functionality including passing data between and ISR and
  2023. a co-routine.
  2024. + Some NOP's were missing following stmdb{}^ instructions in various ARM7
  2025. ports. These have been added.
  2026. + Updated the Open Watcom PC demo project to include the crflash and crhook
  2027. demo co-routines as an example of their use.
  2028. + Updated the H8S demo to compile with the latest version of GCC.
  2029. + Updated the SAM7X EMAC drivers to take into account the hardware errata
  2030. regarding lost packets.
  2031. + Changed the default MAC address used by some WEB server demos as the
  2032. original addresses used was not liked by some routers.
  2033. + Modified the SAM7X/IAR startup code slightly to prevent it hanging on
  2034. some systems when the code is executed using a j-link debugger. The
  2035. j-link macro file configures the PLL before the code executes so
  2036. attempting to configure it again in the startup code was causing a
  2037. problem for some user. Now a check is performed first to see if the
  2038. PLL is already set up.
  2039. + GCC port now contain all assembler code in a single asm block rather than
  2040. individual blocks as before.
  2041. + GCC LPC2000 code now explicitly uses R0 rather than letting the assembler
  2042. choose the register to use as a temporary register during the context
  2043. switch.
  2044. + Added portNOP() macro.
  2045. + The compare match load value on LPC2000 ports now has 1 added to correct
  2046. the value used.
  2047. + The minimal stack depth has been increased slightly on the WIZC PIC18
  2048. port.
  2049. Changes between V3.2.3 and V3.2.4
  2050. + Modified the GCC ARM7 port layer to allow use with GCC V4.0.0 and above.
  2051. Many thanks to Glen Biagioni for the provided update.
  2052. + Added a new Microblaze port and demo application.
  2053. + Modified the SAM7X EMAC demo to default to use the MII interface rather
  2054. than the RMII interface.
  2055. + Modified the startup sequence of the SAM7X demo slightly to allow the
  2056. EMAC longer to auto negotiate.
  2057. Changes between V3.2.2 and V3.2.3
  2058. + Added MII interface support to the SAM7X EMAC peripheral driver.
  2059. Previously versions worked with the RMII interface only.
  2060. + Added command line GCC support to the SAM7X lwIP demo. Previously the
  2061. project could only be built using the CrossWorks IDE. Modifications to
  2062. this end include the addition of a standard makefile and linker script to
  2063. the download, and some adjustments to the stacks allocated to each task.
  2064. + Changed the page returned by the lwIP WEB server demo to display the
  2065. task status table rather than the TCP/IP statistics.
  2066. + Corrected the capitalisation of some header file includes and makefile
  2067. dependencies to facilitate use on Linux host computers.
  2068. + The various LPC2000 ports had a mistake in the timer setup where the
  2069. prescale value was written to T0_PC instead of T0_PR. This would have
  2070. no effect unless a prescale value was actually required. This has been
  2071. corrected.
  2072. Changes between V3.2.1 and V3.2.2 - Released 23 September, 2005
  2073. + Added an IAR port for the Philips LPC2129
  2074. + The Atmel ARM7 IAR demo project files are now saved in the IAR Embedded
  2075. Workbench V4.30a format.
  2076. + Updated the J-Link macro file included with the SAM7X uIP demo project
  2077. to allow the demo board to be reset over the J-Link.
  2078. Changes between V3.2.0 and V3.2.1 - Released 1 September, 2005
  2079. + Added lwIP demo for AT91SAM7X using Rowley tools.
  2080. + Added uIP demo for AT91SAM7X using IAR tools.
  2081. + Added function xTaskGetCurrentTaskHandle().
  2082. + Renamed events.h to mevents.h to prevent it conflicting with the events.h
  2083. generated automatically by the HCS12 processor expert utility. events.h
  2084. is only used by the PC demo application.
  2085. + Both PIC18 ports now initialise the TBLPTRU to 0 as this is the value
  2086. expected by the compiler, and the compilers do not write to this
  2087. register.
  2088. + The HCS12 banked model demo now creates the 'suicide' tasks immediately
  2089. prior to starting the scheduler. These tasks should be the last tasks to
  2090. get started in order for the test to function correctly.
  2091. Changes between V3.1.1 and V3.2.0 - Released 29 June, 2005
  2092. V3.2.0 introduces two new MSP430 ports and corrects a minor kernel
  2093. issues. Thanks to Ares.qi for his input.
  2094. + Added two MSP430 ports that use the Rowley CrossWorks development tools.
  2095. One port just mirrors the existing GCC port. The other port was provided
  2096. by Milos Prokic. Thanks!
  2097. + V3.2.0 corrects the behavior when vTaskPrioritySet() or vTaskResume()
  2098. are called while the scheduler is locked (by a call to
  2099. vTaskSuspendAll()). When this is done the subject task now starts to
  2100. execute immediately when the scheduler is unlocked if it has the highest
  2101. priority that is ready to run. Previously there was a possibility that
  2102. the task would not run until the next RTOS tick or call to portYIELD().
  2103. + Another similar small correction ensures that in the case where more than
  2104. one task is blocked on a semaphore or queue, the task with the highest
  2105. priority is guaranteed to be unblocked first.
  2106. + Added a couple of more test tasks to the PC demo which cover the points
  2107. above.
  2108. Changes between V3.1.0 and V3.1.1 - Released 21st June, 2005
  2109. This release updates the HCS12 port. The common kernel code
  2110. remains unchanged.
  2111. + Updated the HCS12 port to support banking and introduced a demo
  2112. application for the MC9S12DP256. The new demo application is
  2113. located in the Demo/HCS12_CodeWarrior_banked directory.
  2114. + The name of the directory containing the MC9S12F32 demo application
  2115. has been changed to Demo/HCS12_CodeWarrior_small (as in 'small'
  2116. memory model).
  2117. + MC9S12F32 demo updated slightly to use the PLL. The CPU speed for the
  2118. demo application is now 24MHz. Previously it was 8MHz.
  2119. + The demo application file Demo/Common/Minimal/death.c has a slight
  2120. alteration to prevent it using floating point variables.
  2121. Changes between V3.0.0 and V3.1.0 - Released 11th June, 2005
  2122. + Added new ports for ST Microsystems STR71x, and Freescale HCS12
  2123. microcontrollers. Currently the HCS12 port is limited to the small
  2124. memory model. Large memory models will be supported in the next
  2125. release.
  2126. + PIC18 wizC port updated. Thanks to Marcel van Lieshout for his
  2127. continuing contribution.
  2128. + The accuracy of the AVR port timer setup has been improved. Thanks to
  2129. Thomas Krutmann for this contribution.
  2130. + Added a new conditional compilation macro configIDLE_SHOULD_YIELD.
  2131. See the WEB documentation for details.
  2132. + Updated the CrossWorks uIP demo to build with V1.4 of CrossWorks.
  2133. + Slight modification to the SAM7 release build configuration to correct
  2134. an include path definition.
  2135. + Updated the MPLAB PIC18 documentation to provide extra details on linker
  2136. file configuration.
  2137. Changes between V3.0.0 and V2.6.1 - Released 23rd April, 2005
  2138. V3.0.0 includes many enhancements, so this history list is broken into
  2139. subsections as follows:
  2140. API changes
  2141. New ports
  2142. Directory name changes
  2143. Kernel and miscellaneous changes changes
  2144. - API changes
  2145. + Each port now defines BaseType_t as the data type that is most
  2146. efficient for that architecture. The type BaseType_t is used
  2147. extensively in API calls necessitating the following changes to the
  2148. FreeRTOS API function prototypes.
  2149. See the "New for V3.0.0" section of the FreeRTOS online
  2150. documentation for full details of API changes.
  2151. - New ports
  2152. + The AT91FR40008 ARM7 port contributed by John Feller is now included
  2153. in the download (thanks John!).
  2154. + The PIC18 port for the wizC/fedC compiler contributed by Marcel van
  2155. Lieshout is now included in the download (thanks Marcel!).
  2156. + The IAR port for the AVR microcontroller has been upgraded to V3.0.0
  2157. and is now a supported port.
  2158. - Directory name changes
  2159. For consistency, and to allow integration of the new ports, the
  2160. following directory names have been changed.
  2161. + The source/portable/GCC/ARM7 directory has been renamed
  2162. source/portable/GCC/ARM7_LPC2000 so it is compatible with the naming
  2163. of other GCC ARM7 ports.
  2164. + The Demo/PIC directory has been renamed Demo/PIC18_MPLAB to
  2165. accommodate the wizC/fedC PIC port.
  2166. + The demo applications for the two AVR ports no longer share the same
  2167. directory. The WinAVR demo is in the Demo/AVR_ATMega323_WinAVR
  2168. directory and the IAR port in the Demo/AVR_ATMega323_IAR directory.
  2169. - Kernel and miscellaneous changes changes
  2170. See the "New for V3.0.0" section of the FreeRTOS online
  2171. documentation for more information.
  2172. + Previously 'portmacro.h' contained some user editable definitions
  2173. relating to the user application, and some fixed definitions relating
  2174. specifically to the port being used. The application specific
  2175. definitions have been removed from 'portmacro.h' and placed inside a
  2176. new header file called 'FreeRTOSConfig.h'. 'portmacro.h' should now
  2177. never be modified by the user. A 'FreeRTOSConfig.h' is now included
  2178. in each of FreeRTOS/Demo subdirectories - as it's settings relate to
  2179. the demo application rather than being specific to the port.
  2180. + Introduced configUSE_IDLE_HOOK in idle task.
  2181. + The idle task will yield when another idle priority task is ready to
  2182. run. Previously the idle task would run to the end of its time slice
  2183. regardless.
  2184. + The idle task is now created when the scheduler is started. This
  2185. requires less stack than the previous scheme where it was created upon
  2186. creation of the first application task.
  2187. + The function usPortCheckFreeStackSpace() has been renamed
  2188. usTaskCheckFreeStackSpace() and moved from the portable layer to
  2189. tasks.c.
  2190. + Corrected spelling of portMINMAL_STACK_SIZE to portMINIMAL_STACK_SIZE.
  2191. + The portheap.c file included with the AVR port has been deleted. The
  2192. AVR demo now uses the standard heap1 sample memory allocator.
  2193. + The GCC AVR port is now build using the standard make utility. The
  2194. batch files used previously have been deleted. This means a recent
  2195. version of WinAVR is required in order to create a binary suitable for
  2196. source level debugging.
  2197. + vTaskStartScheduler() no longer takes the configUSE_PREEMPTION
  2198. constant as a parameter. Instead the constant is used directly within
  2199. tasks.c and no parameter is required.
  2200. + The header file 'FreeRTOS.h' has been created and is used to include
  2201. 'projdefs.h', 'FreeRTOSConfig.h' and 'portable.h' in the necessary
  2202. order. FreeRTOS.h can now be included in place of these other
  2203. headers.
  2204. + The header file 'errors.h' has been deleted. The definitions it
  2205. contained are now located within 'projdefs.h'.
  2206. + pvPortMalloc() now takes a size_t parameter as per the ANSI malloc().
  2207. Previously an unsigned short was used.
  2208. + When resuming the scheduler a yield is performed if either a tick has
  2209. been missed, or a task is moved from the pending ready list into a
  2210. ready list. Previously a yield was not performed on this second
  2211. condition.
  2212. + In heap1.c an overflow check has been added to ensure the next free
  2213. byte variable does not wrap around.
  2214. + Introduced the portTASK_FUNCTION() and portTASK_FUNCTION_PROTO()
  2215. macros.
  2216. + The MPLAB PIC port now saved the TABLAT register in interrupt service
  2217. routines.
  2218. Changes between V2.6.0 and V2.6.1 - Released Feb 22, 2005
  2219. This version adds support for the H8 processor.
  2220. Other changes:
  2221. + tskMAX_TASK_NAME_LEN removed from the task.h header and added to each
  2222. individual portmacro.h file as portMAX_TASK_NAME_LEN. This allows RAM
  2223. limited ports to allocate fewer characters to the task name.
  2224. + AVR port - Replaced the inb() and outb() functions with direct memory
  2225. access. This allows the port to be built with the 20050414 build of
  2226. WinAVR.
  2227. + GCC LPC2106 port - removed the 'static' from the definition of
  2228. vNonPreemptiveTick() to allow the demo to link when using the cooperative
  2229. scheduler.
  2230. + GCC LPC2106 port - Corrected the optimisation options in the batch files
  2231. ROM_THUMB.bat, RAM_THUMB.bat, ROM_ARM.bat and RAM_ARM.bat. The lower case
  2232. -o is replaced by an uppercase -O.
  2233. + Tasks.c - The strcpy call has been removed when copying across the task
  2234. name into the TCB.
  2235. + Updated the trace visualisation to always be 4 byte aligned so it can be
  2236. used on ARM architectures.
  2237. + There are now two tracecon executables (that convert the trace file binary
  2238. into an ASCII file). One for big endian targets and one for little endian
  2239. targets.
  2240. + Added ucTasksDeleted variable to prevent vTaskSuspendAll() being called
  2241. too often in the idle task.
  2242. + SAM7 USB driver - Replaced the duplicated RX_DATA_BK0 in the interrupt
  2243. mask with the RX_DATA_BK1.
  2244. Changes between V2.5.5 and V2.6.0 - Released January 16, 2005
  2245. + Added the API function vTaskDelayUntil(). The demo app file
  2246. Demo/Common/Minimal/flash.c has been updated to demonstrate its use.
  2247. + Added INCLUDE_vTaskDelay conditional compilation.
  2248. + Changed the name of the Demo/ARM7_AtmelSAM7S64_IAR directory to
  2249. Demo/ARM7_AT91SAM7S64_IAR for consistency.
  2250. + Modified the AT91SAM7S USB driver to allow descriptors that have
  2251. a length that is an exact multiple of the FIFO to be transmitted.
  2252. Changes between V2.5.4 and V2.5.5 - Released January 3, 2005
  2253. This version adds support for the Atmel SAM7 ARM7 microcontrollers
  2254. along with the IAR development tools.
  2255. Other changes:
  2256. + Renamed the Demo/ARM7 directory to Demo/ARM7_LPC2106_GCC.
  2257. + Renamed the Demo/ARM7_Keil directory to Demo/ARM7_LPC2129_Keil.
  2258. + Modified the Philips ARM7 serial interrupt service routines to only
  2259. process one interrupt per call. This seems to enable the ISR to
  2260. operate more quickly.
  2261. + Removed the 'far' keyword from the Open Watcom portable layer source
  2262. files. This allows their use with V1.3 of Open Watcom.
  2263. + Minor modifications to the SDCC build files to allow their use under
  2264. Linux. Thanks to Frieder Ferlemann for this contribution.
  2265. + Small change to sTaskCreate() to allow a context switch even when
  2266. pxCreatedTask is NULL. Thanks to Kamil for this contribution.
  2267. + inline keyword removed from vTaskSwitchContext() and VTaskIncrementTick()
  2268. definitions.
  2269. Changes between V2.5.3 and V2.5.4 - Released Dec 1, 2004
  2270. This is an important maintenance release.
  2271. The function cTaskResumeAll() has been modified so it can be used safely
  2272. prior to the kernel being initialised. This was an issue as
  2273. cTaskResumeAll() is called from pvPortMalloc(). Thanks to Daniel Braun
  2274. for highlighting this issue.
  2275. Changes between V2.5.2 and V2.5.3 - Released Nov 2, 2004
  2276. The critical section handling functions have been changed for the GCC ARM7
  2277. port. Some optimisation levels use the stack differently to others. This
  2278. means the interrupt flags cannot always be stored on the stack and are
  2279. instead now stored in a variable, which is then saved as part of the
  2280. tasks context. This allows the GCC ARM7 port to be used at all
  2281. optimisation levels - including -Os.
  2282. Other minor changes:
  2283. + MSP430 definition of usCriticalNesting now uses the volatile qualifier.
  2284. This is probably not required but added just in case.
  2285. Changes between V2.5.1 and V2.5.2 - Released Oct 26, 2004
  2286. + Added the Keil ARM7 port.
  2287. + Slight modification to comtest.c to make the delay periods more random.
  2288. This creates a better test condition.
  2289. Changes between V2.5.0 and V2.5.1 - Released Oct 9, 2004
  2290. + Added the MSP430 port.
  2291. + Extra comments added to the GCC ARM7 port.c and portISR.c files.
  2292. + The memory pool allocated within heap_1.c has been placed within a
  2293. structure to ensure correct memory alignment on 32bit systems.
  2294. + Within the GCC ARM7 serial drivers an extra check is made to ensure
  2295. the post to the queue was successful if then attempting immediately
  2296. retrieve the posted character.
  2297. + Changed the name of the constant portTICKS_PER_MS to portTICK_PERIOD_MS
  2298. as the old name was misleading.
  2299. Changes between V2.4.2 and V2.5.0 - Released Aug 12, 2004
  2300. The RTOS source code download now includes three separate memory allocation
  2301. schemes - so you can choose the most appropriate for your application.
  2302. These are found in the Source/Portable/MemMang directory. The demo
  2303. application projects have also been updated to demonstrate the new schemes.
  2304. See the "Memory Management" page of the API documentation for more details.
  2305. + Added heap_1.c, heap_2.c and heap_3.c in the Source/Portable/MemMang
  2306. directory.
  2307. + Replaced the portheap.c files for each demo application with one of the
  2308. new memory allocation files.
  2309. + Updated the portmacro.h file for each demo application to include the
  2310. constants required for the new memory allocators: portTOTAL_HEAP_SIZE and
  2311. portBYTE_ALIGNMENT.
  2312. + Added a new test to the ARM7 demo application that tests the operation
  2313. of the heap_2 memory allocator.
  2314. Changes between V2.4.1 and V2.4.2 - Released July 14, 2004
  2315. + The ARM7 port now supports THUMB mode.
  2316. + Modification to the ARM7 demo application serial port driver.
  2317. Changes between V2.4.0 and V2.4.1 - Released July 2, 2004
  2318. + Rationalised the ARM7 port version of portEXIT_CRITICAL() -
  2319. improvements provided by Bill Knight.
  2320. + Made demo serial driver more complete and robust.
  2321. Changes between V2.4.0 and V2.3.1 - Released June 30, 2004
  2322. + Added the first ARM7 port - thanks to Bill Knight for the assistance
  2323. provided.
  2324. + Added extra files to the Demo/Common/Minimal directory. These are
  2325. equivalent to their Demo/Common/Full counterparts but with the
  2326. calls to the functions defined in print.c removed.
  2327. + Added TABLAT to the list of registers saved as part of a PIC18 context.
  2328. Changes between V2.3.0 and V2.3.1 - Released June 25, 2004
  2329. + Changed the way the vector table is defined to be more portable.
  2330. + Corrected the definitions of SPH and SPL in portmacro.s90.
  2331. The previous definitions prevented V2.3.0 operating if the iom323.h
  2332. header file was included in portmacro.s90.
  2333. Changes between V2.2.0 and V2.3.0 - Released June 19, 2004
  2334. + Added an AVR port that uses the IAR compiler.
  2335. + Explicit use of 'signed' qualifier on plain char types.
  2336. + Modified the Open Watcom project files to use 'signed' as the
  2337. default char type.
  2338. + Changed odd calculation of initial pxTopOfStack value when
  2339. portSTACK_GROWTH < 0.
  2340. + Added inline qualifier to context switch functions within task.c.
  2341. Ports that do not support the (non ANSI) inline keyword have the
  2342. inline #define'd away in their respective portmacro.h files.
  2343. Changes between V2.1.1 and V2.2.0 - Released May 18, 2004
  2344. + Added Cygnal 8051 port.
  2345. + PCLATU and PCLATH are now saved as part of the PIC18 context. This
  2346. allows function pointers to be used within tasks. Thanks to Javier
  2347. Espeche for the enhancement.
  2348. + Minor changes to demo application files to reduce stack usage.
  2349. + Minor changes to prevent compiler warnings when compiling the new port.
  2350. Changes between V2.1.0 and V2.1.1 - Released March 12, 2004
  2351. + Bug fix - pxCurrentTCB is now initialised before the call to
  2352. prvInitialiseTaskLists(). Previously pxCurrentTCB could be accessed
  2353. while null during the initialisation sequence. Thanks to Giuseppe
  2354. Franco for the correction.
  2355. Changes between V2.0.0 and V2.1.0 - Released Feb 29, 2004
  2356. V2.1.0 has significant reworks that greatly reduce the amount of time
  2357. the kernel has interrupts disabled. The first section of modifications
  2358. listed here must be taken into account by users. The second section
  2359. are related to the kernel implementation and as such are transparent.
  2360. Section1 :
  2361. + The typedef TickType_t has been introduced. All delay times should
  2362. now use a variable of type TickType_t in place of the unsigned long's
  2363. used previously. API function prototypes have been updated
  2364. appropriately.
  2365. + The configuration macro USE_16_BIT_TICKS has been introduced. If set
  2366. to 1 TickType_t is defined as an unsigned short. If set to 0
  2367. TickType_t is defined as an unsigned long. See the configuration
  2368. section of the API documentation for more details.
  2369. + The configuration macro INCLUDE_vTaskSuspendAll is now obsolete.
  2370. + vTaskResumeAll() has been renamed cTaskResumeAll() as it now returns a
  2371. value (see the API documentation).
  2372. + ulTaskGetTickCount() has been renamed xTaskGetTickCount() as the type
  2373. it returns now depends on the USE_16_BIT_TICKS definition.
  2374. + cQueueReceive() must now >never< be used from within an ISR. Use the new
  2375. cQueueReceiveFromISR() function instead.
  2376. Section 2:
  2377. + A mechanism has been introduced that allows a queue to be accessed by
  2378. a task and ISR simultaneously.
  2379. + A "pending ready" queue has been introduced that enables interrupts to
  2380. be processed when the scheduler is suspended.
  2381. + The list implementation has been improved to provide faster item
  2382. removal.
  2383. + The scheduler now makes use of the scheduler suspend mechanism in places
  2384. where previously interrupts were disabled.
  2385. Changes between V1.2.6 and V2.0.0 - Released Jan 31, 2004
  2386. + Introduced new API functions:
  2387. vTaskPriorityGet ()
  2388. vTaskPrioritySet ()
  2389. vTaskSuspend ()
  2390. vTaskResume ()
  2391. vTaskSuspendAll ()
  2392. vTaskResumeAll ()
  2393. + Added conditional compilation options that allow the components of the
  2394. kernel that are unused by an application to be excluded from the build.
  2395. See the Configuration section on the WEB site for more information (on
  2396. the API pages). The macros have been added to each portmacro.h file (
  2397. sometimes called prtmacro.h).
  2398. + Rearranged tasks.c.
  2399. + Added demo application file dynamic.c.
  2400. + Updated the PC demo application to make use of dynamic.c.
  2401. + Updated the documentation contained in the kernel header files.
  2402. + Creating a task now causes a context switch if the task being created
  2403. has a higher priority than the calling task - assuming the kernel is
  2404. running.
  2405. + vTaskDelete() now only causes a context switch if the calling task is
  2406. the task being deleted.
  2407. Changes between V1.2.5 and V1.2.6 - Released December 31, 2003
  2408. Barring the change to the interrupt vector (PIC port) these are minor
  2409. enhancements.
  2410. + The interrupt vector used for the PIC master ISR has been changed from
  2411. 0x18 to 0x08 - where it should have always been. The incorrect address
  2412. still works but probably executes a number of NOP's before getting to the
  2413. ISR.
  2414. + Changed the baud rate used by the AVR demo application to 38400. This
  2415. has an error percentage of less than one percent with an 8MHz clock.
  2416. + Raised the priority of the Rx task in demo\full\comtest.c. This only
  2417. affects the Flashlite and PC ports. This was done to prevent the Rx
  2418. buffer becoming full.
  2419. + Reverted the Flashlite COM port driver back so it does not use the DMA.
  2420. The DMA appears to miss characters under stress. The Borland Flashlite
  2421. port was also calculating a register value incorrectly resulting in the
  2422. wrong DMA source address being used. The same code worked fine when
  2423. compiling with Open Watcom. Other minor enhancements were made to the
  2424. interrupt handling.
  2425. + Modified the PIC serial Rx ISR to check for and clear overrun errors.
  2426. Overrun errors seem to prevent any further characters being received.
  2427. + The PIC demo projects now have some optimisation switched on.
  2428. Changes between V1.2.4 and V1.2.5
  2429. Small fix made to the PIC specific port.c file described below.
  2430. + Introduced portGLOBAL_INTERRUPT_FLAG definition to test the global
  2431. interrupt flag setting. Using the two bits defined within
  2432. portINITAL_INTERRUPT_STATE was causing the w register to get clobbered
  2433. before the test was performed.
  2434. Changes between V1.2.3 and V1.2.4
  2435. V1.2.4 contains a release version of the PIC18 port.
  2436. An optional exception has been included with the GPL. See the licensing
  2437. section of www.FreeRTOS.org for details.
  2438. + The function xPortInitMinimal() has been renamed to
  2439. xSerialPortInitMinimal() and the function xPortInit() has been renamed
  2440. to xSerialPortInit().
  2441. + The function sSerialPutChar() has been renamed cSerialPutChar() and
  2442. the function return type chaned to portCHAR.
  2443. + The integer and flop tasks now include calls to tskYIELD(), allowing
  2444. them to be used with the cooperative scheduler.
  2445. + All the demo applications now use the integer and comtest tasks when the
  2446. cooperative scheduler is being used. Previously they were only used with
  2447. the preemptive scheduler.
  2448. + Minor changes made to operation of minimal versions of comtest.c and
  2449. integer.c.
  2450. + The ATMega port definition of portCPU_CLOSK_HZ definition changed to
  2451. 8MHz base 10, previously it base 16.
  2452. Changes between V1.2.2a and V1.2.3
  2453. The only change of any significance is to the license, which has changed
  2454. from the Open Software License to the GNU GPL.
  2455. The zip file also contains a pre-release version of the PIC18 port. This
  2456. has not yet completed testing and as such does not constitute part of the
  2457. V1.2.3 release. It is still however covered by the GNU GPL.
  2458. There are minor source code changes to accommodate the PIC C compiler.
  2459. These mainly involve more explicit casting.
  2460. + sTaskCreate() has been modified slightly to make use of the
  2461. portSTACK_GROWTH macro. This is required for the PIC port where the
  2462. stack grows in the opposite direction to the other existing ports.
  2463. + prvCheckTasksWaitingTermination() has been modified slightly to bring
  2464. the decrementing of usCurrentNumberOfTasks within the critical section,
  2465. where it should have been since the creation of an eight bit port.
  2466. Changes between V1.2.2 and V1.2.2a
  2467. The makefile and buildcoff.bat files included with the AVR demo application
  2468. have been modified for use with the September 2003 build of WinAVR. No
  2469. source files have changed.
  2470. Changes between V1.2.1 and V1.2.2
  2471. There are only minor changes here to allow the PC and Flashlite 186 ports
  2472. to use the Borland V4.52 compiler, as supplied with the Flashlite 186
  2473. development kit.
  2474. + Introduced a BCC directory under source\portable. This contains all the
  2475. files specific to the Borland compiler port.
  2476. + Corrected the macro naming of portMS_PER_TICK to portTICKS_PER_MS.
  2477. + Modified comtest.c to increase the rate at which the string is
  2478. transmitted and received on the serial port. The Flashlite 186 demo
  2479. app baud rate has also been increased.
  2480. + The values of the constants used in both integer.c files have been
  2481. increased to force the Borland compiler to use 32 bit values. The
  2482. Borland optimiser placed the previous values in 16 bit registers, and in
  2483. So doing invalidated the test.
  2484. Changes between V1.2.0 and V1.2.1
  2485. This version includes some minor changes to the list implementation aimed
  2486. at improving the context switch time - with is now approximately 10% faster.
  2487. Changes include the removal of some null pointer assignment checks. These
  2488. were redundant where the scheduler uses the list functions, but means any
  2489. user application choosing to use the same list functions must now check
  2490. that no NULL pointers are passed as a parameter.
  2491. The Flashlite 186 serial port driver has also been modified to use a DMA
  2492. channel for transmissions. The serial driver is fully functional but still
  2493. under development. Flashlite users may prefer to use V1.2.0 for now.
  2494. Details:
  2495. + Changed the baud rate for the ATMega323 serial test from 19200 to 57600.
  2496. + Use vSerialPutString() instead of single character puts in
  2497. Demo\Full\Comtest.c. This allows the use of the flashlite DMA serial
  2498. driver. Also the check variable only stops incrementing after two
  2499. consecutive failures.
  2500. + semtest.c creates four tasks, two of which operate at the idle priority.
  2501. The tasks that operate at the idle priority now use a lower expected
  2502. count than those running at a higher priority. This prevents the low
  2503. priority tasks from signalling an error because they have not been
  2504. scheduled enough time for each of them to count the shared variable to
  2505. the higher original value.
  2506. + The flashlite 186 serial driver now uses a DMA channel for transmissions.
  2507. + Removed the volatile modifier from the list function parameters. This was
  2508. only ever included to prevent compiler warnings. Now warnings are
  2509. removed by casting parameters where the calls are made.
  2510. + prvListGetOwnerOfNextEntry() and prvListGetOwnerOfHeadEntry() have been
  2511. removed from list.c and added as macros in list.h.
  2512. + usNumberOfItems has been added to the list structure. This removes the
  2513. need for a pointer comparison when checking if a list is empty, and so
  2514. is slightly faster.
  2515. + Removed the NULL check in vListRemove(). This makes the call faster but
  2516. necessitates any application code utilising the list implementation to
  2517. ensure NULL pointers are not passed.
  2518. + Renamed portTICKS_PER_MS definition to portMS_PER_TICK (milli seconds
  2519. per tick). This is what it always should have been.
  2520. Changes between V1.01 and V1.2.0
  2521. The majority of these changes were made to accommodate the 8bit AVR port.
  2522. The scheduler workings have not changed, but some of the data types used
  2523. have been made more friendly to an eight bit environment.
  2524. Details:
  2525. + Changed the version numbering format.
  2526. + Added AVR port.
  2527. + Split the directory demo\common into demo\common\minimal and
  2528. demo\common\full. The files in the full directory are for systems with
  2529. a display (currently PC and Flashlite 186 demo's). The files in the
  2530. minimal directory are for systems with limited RAM and no display
  2531. (currently MegaAVR).
  2532. + Minor changes to demo application function prototypes to make more use
  2533. of 8bit data types.
  2534. + Within the scheduler itself the following functions have slightly
  2535. modified declarations to make use of 8bit data types where possible:
  2536. xQueueCreate(),
  2537. sQueueReceive(),
  2538. sQUeueReceive(),
  2539. usQueueMessageWaiting(),
  2540. sQueueSendFromISR(),
  2541. sSemaphoreTake(),
  2542. sSemaphoreGive(),
  2543. sSemaphoreGiveFromISR(),
  2544. sTaskCreate(),
  2545. sTaskMoveFromEventList().
  2546. Where the return type has changed the function name has also changed in
  2547. accordance with the naming convention. For example
  2548. usQueueMessageWaiting() has become ucQueueMessageWaiting().
  2549. + The definition tskMAX_PRIORITIES has been moved from task.h to
  2550. portmacro.h and renamed portMAX_PRIORITIES. This allows different
  2551. ports to allocate a different maximum number of priorities.
  2552. + By default the trace facility is off, previously USE_TRACE_FACILITY
  2553. was defined.
  2554. + comtest.c now uses a psuedo random delay between sends. This allows for
  2555. better testing as the interrupts do not arrive at regular intervals.
  2556. + Minor change to the Flashlite serial port driver. The driver is written
  2557. to demonstrate the scheduler and is not written to be efficient.
  2558. Changes between V1.00 and V1.01
  2559. These changes improve the ports. The scheduler itself has not changed.
  2560. Improved context switch mechanism used when performing a context
  2561. switch from an ISR (both the tick ISR and the serial comms ISR's within
  2562. the demo application). The new mechanism is faster and uses less stack.
  2563. The assembler file portasm.asm has been replaced by a header file
  2564. portasm.h. This includes a few assembler macro definitions.
  2565. All saving and restoring of registers onto/off of the stack is now handled
  2566. by the compiler. This means the initial stack setup for a task has to
  2567. mimic the stack used by the compiler, which is different for debug and
  2568. release builds.
  2569. Slightly changed the operation of the demo application, details below.
  2570. Details:
  2571. + portSWITCH_CONTEXT() replaced by vPortFirstContext().
  2572. + pxPortInitialiseStack() modified to replicate the stack used by the
  2573. compiler.
  2574. + portasm.asm file removed.
  2575. + portasm.h introduced. This contains macro definitions for
  2576. portSWITCH_CONTEXT() and portFIRST_CONTEXT().
  2577. + Context switch from ISR now uses the compiler generated interrupt
  2578. mechanism. This is done simply by calling portSWITCH_CONTEXT and leaving
  2579. the save/restore to compiler generated code.
  2580. + Calls to taskYIELD() during ISR's have been replaced by calling the
  2581. simpler and faster portSWITCH_CONTEXT().
  2582. + The Flashlite 186 port now uses 186 instruction set (used to use 80x86
  2583. instructions only).
  2584. + The blocking queue tasks within the demo application did not operate
  2585. quite as described. This has been corrected.
  2586. + The priority of the comtest Rx task within the demo application has been
  2587. lowered. Received characters are now processed (read from the queue) at
  2588. the idle priority, allowing low priority tasks to run evenly at times of
  2589. a high communications overhead.
  2590. + Prevent the call to kbhit() in main.c for debug builds as the debugger
  2591. seems to have problems stepping over the call. This if for the PC port
  2592. only.