Skip to content

Releases: feilipu/Arduino_FreeRTOS_Library

Update 11.1.0 Release

11 May 12:28
Compare
Choose a tag to compare
+ Re-enable stack and heap error functions.

Changes between FreeRTOS V11.0.1 and FreeRTOS V11.1.0 released April 22, 2024

+ Add ARMv7-R port with Memory Protection Unit (MPU) support.
+ Add Memory Protection Unit (MPU) support to the Cortex-M0 port.
+ Add stream batching buffer. A stream batching buffer differs from a stream
  buffer when a task reads from a non-empty buffer:
  - The task reading from a non-empty stream buffer returns immediately
    regardless of the amount of data in the buffer.
  - The task reading from a non-empty steam batching buffer blocks until the
    amount of data in the buffer exceeds the trigger level or the block time
    expires.
  We thank @cperkulator for their contribution.
+ Add the ability to change task notification index for stream buffers. We
  thank @glemco for their contribution.
+ Add xStreamBufferResetFromISR and xMessageBufferResetFromISR APIs to reset
  stream buffer and message buffer from an Interrupt Service Routine (ISR).
  We thank @HagaiMoshe for their contribution.
+ Update all the FreeRTOS APIs to use configSTACK_DEPTH_TYPE for stack type.
  We thank @feilipu for their contribution.
+ Update vTaskEndScheduler to delete the timer and idle tasks,
  once the scheduler is stopped.
+ Make xTaskGetCurrentTaskHandleForCore() available to the single core
  scheduler. We thank @Dazza0 for their contribution.
+ Update uxTaskGetSystemState to not use the pxIndex member of the List_t
  structure while iterating ready tasks list. The reason is that pxIndex
  member must only used to select next ready task to run. We thank
  @gemarcano for their inputs.
+ Add a config option to the FreeRTOS SMP Kernel to set the default core
  affinity mask for tasks created without an affinity mask. We thank @go2sh
  for their contribution.
+ Add configUSE_EVENT_GROUPS and configUSE_STREAM_BUFFERS configuration
  constants to control the inclusion of event group and stream buffer
  functionalities.
+ Code changes to comply with MISRA C 2012.
+ Add 64-bit support to the FreeRTOS Windows Simulator port. We thank @watsk
  and @josesimoes for their contributions.
+ Add support for 64-bit Microblaze processor to the MicroblazeV9 port. We
  thank @mubinsyed for their contribution.
+ Add support for MSP430 Embedded Application Binary Interface (EABI) to
  the MSP430F449 port to make it work with both MSP430 GCC and MSPGCC
  compilers. We thank @Forty-Bot for their contribution.
+ Update xPortIsAuthorizedToAccessBuffer() on FreeRTOS ports with MPU
  support to grant an unprivileged task access to all the memory before the
  scheduler is started.
+ Update the POSIX port to pass the FreeRTOS task name to pthread for
  readable output in debuggers. We thank @Mixaill for their contribution.
+ Update the POSIX port to ignore the user specified stack memory and only
  pass the stack size to the pthread API to avoid errors caused when stack size
  is smaller than the minimum. We thank @cmorgnaBE for their
  contribution.
+ Update the POSIX port to use a timer thread for tick interrupts instead of
  POSIX timers to address issues with signal handling in non-FreeRTOS
  pthreads. We thank @cmorgnaBE for their contribution.
+ Update ARM_TFM port to support TF-Mv2.0.0 release of trusted-firmware-m.
  We thanks @urutva for their contribution.
+ Remove redundant constant pools in ARMv8 ports. We thank @urutva for their
  contribution.
+ Add APIs to reset the internal state of kernel modules. These APIs are
  primarily intended to be used in the testing frameworks that restart the
  scheduler.
+ Use kernel provided implementations of vApplicationGetIdleTaskMemory() and
  vApplicationGetTimerTaskMemory() in the RP2040 port. We thank @dpslwk for
  their contribution.
+ Fix atomic enter/exit critical section macro definitions in atomic.h for
  ports that support nested interrupts. We thank @sebunger for their
  contribution.
+ Fix compiler warnings in the MSP430F449 port when compiled with the
  MSP430 GCC compiler. We thank @Forty-Bot for their contribution.
+ Update the scheduler suspension usage in ulTaskGenericNotifyTake and
  xTaskGenericNotifyWait() to enhance code readability. We thank @Dazza0 for
  their contribution.
+ Add support for latest version of MPU wrappers( mpu_wrappers_v2) in CMake.
  We thank @IsaacDynamo for their contribution.
+ Update CMake support to create only one static library containing both the
  kernel common code and the kernel port code. We thank @barnatahmed for
  their contribution.

Initial 11.1.0 Release

22 Apr 12:48
Compare
Choose a tag to compare

Changes between FreeRTOS V11.0.1 and FreeRTOS V11.1.0 released April 22, 2024

+ Add ARMv7-R port with Memory Protection Unit (MPU) support.
+ Add Memory Protection Unit (MPU) support to the Cortex-M0 port.
+ Add stream batching buffer. A stream batching buffer differs from a stream
  buffer when a task reads from a non-empty buffer:
  - The task reading from a non-empty stream buffer returns immediately
    regardless of the amount of data in the buffer.
  - The task reading from a non-empty steam batching buffer blocks until the
    amount of data in the buffer exceeds the trigger level or the block time
    expires.
  We thank @cperkulator for their contribution.
+ Add the ability to change task notification index for stream buffers. We
  thank @glemco for their contribution.
+ Add xStreamBufferResetFromISR and xMessageBufferResetFromISR APIs to reset
  stream buffer and message buffer from an Interrupt Service Routine (ISR).
  We thank @HagaiMoshe for their contribution.
+ Update all the FreeRTOS APIs to use configSTACK_DEPTH_TYPE for stack type.
  We thank @feilipu for their contribution.
+ Update vTaskEndScheduler to delete the timer and idle tasks,
  once the scheduler is stopped.
+ Make xTaskGetCurrentTaskHandleForCore() available to the single core
  scheduler. We thank @Dazza0 for their contribution.
+ Update uxTaskGetSystemState to not use the pxIndex member of the List_t
  structure while iterating ready tasks list. The reason is that pxIndex
  member must only used to select next ready task to run. We thank
  @gemarcano for their inputs.
+ Add a config option to the FreeRTOS SMP Kernel to set the default core
  affinity mask for tasks created without an affinity mask. We thank @go2sh
  for their contribution.
+ Add configUSE_EVENT_GROUPS and configUSE_STREAM_BUFFERS configuration
  constants to control the inclusion of event group and stream buffer
  functionalities.
+ Code changes to comply with MISRA C 2012.
+ Add 64-bit support to the FreeRTOS Windows Simulator port. We thank @watsk
  and @josesimoes for their contributions.
+ Add support for 64-bit Microblaze processor to the MicroblazeV9 port. We
  thank @mubinsyed for their contribution.
+ Add support for MSP430 Embedded Application Binary Interface (EABI) to
  the MSP430F449 port to make it work with both MSP430 GCC and MSPGCC
  compilers. We thank @Forty-Bot for their contribution.
+ Update xPortIsAuthorizedToAccessBuffer() on FreeRTOS ports with MPU
  support to grant an unprivileged task access to all the memory before the
  scheduler is started.
+ Update the POSIX port to pass the FreeRTOS task name to pthread for
  readable output in debuggers. We thank @Mixaill for their contribution.
+ Update the POSIX port to ignore the user specified stack memory and only
  pass the stack size to the pthread API to avoid errors caused when stack size
  is smaller than the minimum. We thank @cmorgnaBE for their
  contribution.
+ Update the POSIX port to use a timer thread for tick interrupts instead of
  POSIX timers to address issues with signal handling in non-FreeRTOS
  pthreads. We thank @cmorgnaBE for their contribution.
+ Update ARM_TFM port to support TF-Mv2.0.0 release of trusted-firmware-m.
  We thanks @urutva for their contribution.
+ Remove redundant constant pools in ARMv8 ports. We thank @urutva for their
  contribution.
+ Add APIs to reset the internal state of kernel modules. These APIs are
  primarily intended to be used in the testing frameworks that restart the
  scheduler.
+ Use kernel provided implementations of vApplicationGetIdleTaskMemory() and
  vApplicationGetTimerTaskMemory() in the RP2040 port. We thank @dpslwk for
  their contribution.
+ Fix atomic enter/exit critical section macro definitions in atomic.h for
  ports that support nested interrupts. We thank @sebunger for their
  contribution.
+ Fix compiler warnings in the MSP430F449 port when compiled with the
  MSP430 GCC compiler. We thank @Forty-Bot for their contribution.
+ Update the scheduler suspension usage in ulTaskGenericNotifyTake and
  xTaskGenericNotifyWait() to enhance code readability. We thank @Dazza0 for
  their contribution.
+ Add support for latest version of MPU wrappers( mpu_wrappers_v2) in CMake.
  We thank @IsaacDynamo for their contribution.
+ Update CMake support to create only one static library containing both the
  kernel common code and the kernel port code. We thank @barnatahmed for
  their contribution.

Update 11.0.1 Release

30 Jan 00:29
Compare
Choose a tag to compare

Changes between FreeRTOS V11.0.0 and FreeRTOS V11.0.1 released January 23, 2023

+ Updated the SBOM file.
+ Updated stream buffer notifications.
+ Update MPU Idle Task assignment.
+ Modify unpaired critical section for readability
+ Move prvDeleteTCB out of critical section for SMP
+ Add missing Task Notification #IFDEF

Changes between FreeRTOS V10.6.2 and FreeRTOS V11.0.0 released December 18, 2023

+ SMP merged into the mainline:  While FreeRTOS introduced Asymmetric
  Multiprocessing (AMP) support in 2017, FreeRTOS Version 11.0.0 is the
  first to merge Symmetric Multiprocessing (SMP) support into the mainline
  release. SMP enables one instance of the FreeRTOS Kernel to schedule tasks
  across multiple identical processor cores.  We thank Mike Bruno and Jerry
  McCarthy of XMOS and, Darian Liang, Sudeep Mohanty and Zim Kalinowski of
  Espressif Systems for their contributions.
+ Switch MISRA compliance checking from PC Lint to Coverity, and update from
  MISRA C:2004 to MISRA C:2012.
+ Add a template FreeRTOSConfig.h, inclusive of an abbreviated explanation of
  each configuration item. Application writers can use this template as a
  starting point to create the FreeRTOSConfig.h file for their application.
+ Add a template FreeRTOS port which can be used as a starting point for
  developing a new FreeRTOS port.
+ Add bounds checking and obfuscation to internal heap block pointers in
  heap_4.c and heap_5.c to help catch pointer corruptions. The application can
  enable these checks by setting configENABLE_HEAP_PROTECTOR to 1 in their
  FreeRTOSConfig.h. We thank @oliverlavery for their contribution.
+ Update vTaskList and vTaskGetRunTimeStats APIs to replace the use of sprintf
  with snprintf.
+ Add trace macros to ports that enable tracing the interaction of ISRs with
  scheduler events. We thank @conara for their contribution.
+ Add trace macros that enable tracing of entering and exiting all APIs. We
  thank @Techcore123 for their contribution.
+ Add uxTaskBasePriorityGet and uxTaskBasePriorityGetFromISR APIs to get the
  base priority of a task. The base priority of a task is the priority that
  was last assigned to the task - which due to priority inheritance, may not
  be the current priority of the task.
+ Add pdTICKS_TO_MS macro to convert time in FreeRTOS ticks to time in
  milliseconds. We thank @Dazza0 for their contribution.
+ Add default implementations of vApplicationGetIdleTaskMemory and
  vApplicationGetTimerTaskMemory. The application can enable these default
  implementations by setting configKERNEL_PROVIDED_STATIC_MEMORY to 1 in their
  FreeRTOSConfig.h. We thank @mdnr-g for their contribution.
+ Update vTaskGetInfo to include start and end of the stack whenever both
  values are available. We thank @vinceburns for their contribution.
+ Prevent tasks waiting for a notification from being resumed by calls to
  vTaskResume or vTaskResumeFromISR. We thank @Moral-Hao for their
  contribution.
+ Add asserts to validate that the application has correctly installed
  FreeRTOS handlers for PendSV and SVCall interrupts on Cortex-M devices.
  We thank @jefftenney for their contribution.
+ Rename ARM_CA53_64_BIT and ARM_CA53_64_BIT_SRE ports to Arm_AARCH64 and
  Arm_AARCH64_SRE respectively as these ports are applicable to all AArch64
  architecture. We thank @urutva for their contribution.
+ Add CMake support to allow the application writer to select the RISC-V
  chip extension. We thank @JoeBenczarski for their contribution.
+ Add CMake support to allow the application writer to build an application
  with static allocation only. We thank @conara for their contribution.
+ Make taskYIELD available to unprivileged tasks for ARMv8-M ports.
+ Update Cortex-M23 ports to not use PSPLIM_NS. We thank @urutva for their
  contribution.
+ Update the SysTick setup code for ARMv8-M ports to first configure the clock
  source and then enable SysTick. This is needed to address a bug in QEMU
  versions older than 7.0.0, which causes an emulation error if SysTick is
  enabled without first selecting a valid clock source. We thank @jefftenney
  for their contribution.
+ Add the port-optimized task selection algorithm optionally available for
  ARMv7-M ports to the ARMv8-M ports. We thank @jefftenney for their
  contribution.
+ Improve the speed of pvPortMalloc in heap_4.c and heap_5.c by removing
  unnecessary steps while splitting a large memory block into two. We thank
  @Moral-Hao for their contribution.
+ Shorten the critical section in pvPortMalloc in heap_2.c, heap_4.c and
  heap_5.c by moving the size calculation out of the critical section. We thank
  @Moral-Hao for their contribution.
+ Update xTaskNotifyWait and ulTaskNotifyTake to remove the non-deterministic
  operation of traversing a linked link from a critical section. We thank
  @karver8 for their contribution.
+ Fix stack end and stack size computation in POSIX port to meet the stack
  alignment requirements on MacOS. We thank @tegimeki for their contribution.
+ Update the vTaskPrioritySet implementation to use the new priority when the
  task has inherited priority from a mutex it is holding, and the new priority
  is bigger than the inherited priority. We thank @Moral-Hao for their
  contribution.
+ Add stack alignment adjustment if stack grows upwards. We thank @ivq for
  their contribution.
+ Fix pxTopOfStack calculation in configINIT_TLS_BLOCK when picolib C is
  selected as the C library implementation to ensure that
  pxPortInitialiseStack does not overwrite the data in the TLS block portion
  of the stack. We thank @bebebib-rs for their contribution.
+ Fix vPortEndScheduler() for the MSVC port so that the function
  prvProcessSimulatedInterrupts is not stuck in an infinite loop when the
  scheduler is stopped. We thank @Ju1He1 for their contribution.
+ Add the Pull Request (PR) Process explaining the stages a PR goes through.

Changes between FreeRTOS V10.6.1 and FreeRTOS V10.6.2 released November 29, 2023

+ Add the following improvements to the new MPU wrapper (mpu_wrappers_v2.c)
  introduced in version 10.6.0:
  - Introduce Access Control List (ACL) feature to allow the application
    writer to control an unprivileged task’s access to kernel objects.
  - Update the system call entry mechanism to only require one Supervisor
    Call (SVC) instruction.
  - Wrap parameters for system calls with more than four parameters in a
    struct to avoid special handling during system call entry.
  - Fix 2 possible integer overflows.
  - Convert some asserts to run time parameter checks.

Changes between FreeRTOS V10.6.0 and FreeRTOS V10.6.1 released August 17, 2023

+ Add runtime parameter checks to functions in mpu_wrappers_v2.c file.
  The same checks are already performed in API implementations using
  asserts.
  We thank the following people for their inputs in these changes:
  - Lan Luo, Zixia Liu of School of Computer Science and Technology,
    Anhui University of Technology, China.
  - Xinwen Fu of Department of Computer Science, University of
    Massachusetts Lowell, USA.
  - Xinhui Shao, Yumeng Wei, Huaiyu Yan, Zhen Ling of School of
    Computer Science and Engineering, Southeast University, China.

Changes between FreeRTOS V10.5.1 and FreeRTOS 10.6.0 released July 13, 2023

+ Add a new MPU wrapper that places additional restrictions on unprivileged
  tasks. The following is the list of changes introduced with the new MPU
  wrapper:

  1. Opaque and indirectly verifiable integers for kernel object handles:
     All the kernel object handles (for example, queue handles) are now
     opaque integers. Previously object handles were raw pointers.
  2. Save the task context in Task Control Block (TCB): When a task is
     swapped out by the scheduler, the task's context is now saved in its
     TCB. Previously the task's context was saved on its stack.
  3. Execute system calls on a separate privileged only stack: FreeRTOS
     system calls, which execute with elevated privilege, now use a
     separate privileged only stack. Previously system calls used the
     calling task's stack. The application writer can control the size of
     the system call stack using new configSYSTEM_CALL_STACK_SIZE config
     macro.
  4. Memory bounds checks: FreeRTOS system calls which accept a pointer
     and de-reference it, now verify that the calling task has required
     permissions to access the memory location referenced by the pointer.
  5. System calls restrictions: The following system calls are no longer
     available to unprivileged tasks:
      - vQueueDelete
      - xQueueCreateMutex
      - xQueueCreateMutexStatic
      - xQueueCreateCountingSemaphore
      - xQueueCreateCountingSemaphoreStatic
      - xQueueGenericCreate
      - xQueueGenericCreateStatic
      - xQueueCreateSet
      - xQueueRemoveFromSet
      - xQueueGenericReset
      - xTaskCreate
      - xTaskCreateStatic
      - vTaskDelete
      - vTaskPrioritySet
      - vTaskSuspendAll
      - xTaskResumeAll
      - xTaskGetHandle
      - xTaskCallApplicationTaskHook
      - vTaskList
      - vTaskGetRunTimeStats
      - xTaskCatchUpTicks
      - xEventGroupCreate
      - xEventGroupCreateStatic
      - vEventGroupDelete
      - xStreamBufferGenericCreate
      - xStreamBufferGenericCreateStatic
      - vStreamBufferDelete
      - xStreamBufferReset
     Also,...
Read more

Initial 11.0.1 Release

02 Jan 02:46
Compare
Choose a tag to compare

Changes between FreeRTOS V11.0.0 and FreeRTOS V11.0.1 released December 21, 2023

+ Updated the SBOM file.

Changes between FreeRTOS V10.6.2 and FreeRTOS V11.0.0 released December 18, 2023

+ SMP merged into the mainline:  While FreeRTOS introduced Asymmetric
  Multiprocessing (AMP) support in 2017, FreeRTOS Version 11.0.0 is the
  first to merge Symmetric Multiprocessing (SMP) support into the mainline
  release. SMP enables one instance of the FreeRTOS Kernel to schedule tasks
  across multiple identical processor cores.  We thank Mike Bruno and Jerry
  McCarthy of XMOS and, Darian Liang, Sudeep Mohanty and Zim Kalinowski of
  Espressif Systems for their contributions.
+ Switch MISRA compliance checking from PC Lint to Coverity, and update from
  MISRA C:2004 to MISRA C:2012.
+ Add a template FreeRTOSConfig.h, inclusive of an abbreviated explanation of
  each configuration item. Application writers can use this template as a
  starting point to create the FreeRTOSConfig.h file for their application.
+ Add a template FreeRTOS port which can be used as a starting point for
  developing a new FreeRTOS port.
+ Add bounds checking and obfuscation to internal heap block pointers in
  heap_4.c and heap_5.c to help catch pointer corruptions. The application can
  enable these checks by setting configENABLE_HEAP_PROTECTOR to 1 in their
  FreeRTOSConfig.h. We thank @oliverlavery for their contribution.
+ Update vTaskList and vTaskGetRunTimeStats APIs to replace the use of sprintf
  with snprintf.
+ Add trace macros to ports that enable tracing the interaction of ISRs with
  scheduler events. We thank @conara for their contribution.
+ Add trace macros that enable tracing of entering and exiting all APIs. We
  thank @Techcore123 for their contribution.
+ Add uxTaskBasePriorityGet and uxTaskBasePriorityGetFromISR APIs to get the
  base priority of a task. The base priority of a task is the priority that
  was last assigned to the task - which due to priority inheritance, may not
  be the current priority of the task.
+ Add pdTICKS_TO_MS macro to convert time in FreeRTOS ticks to time in
  milliseconds. We thank @Dazza0 for their contribution.
+ Add default implementations of vApplicationGetIdleTaskMemory and
  vApplicationGetTimerTaskMemory. The application can enable these default
  implementations by setting configKERNEL_PROVIDED_STATIC_MEMORY to 1 in their
  FreeRTOSConfig.h. We thank @mdnr-g for their contribution.
+ Update vTaskGetInfo to include start and end of the stack whenever both
  values are available. We thank @vinceburns for their contribution.
+ Prevent tasks waiting for a notification from being resumed by calls to
  vTaskResume or vTaskResumeFromISR. We thank @Moral-Hao for their
  contribution.
+ Add asserts to validate that the application has correctly installed
  FreeRTOS handlers for PendSV and SVCall interrupts on Cortex-M devices.
  We thank @jefftenney for their contribution.
+ Rename ARM_CA53_64_BIT and ARM_CA53_64_BIT_SRE ports to Arm_AARCH64 and
  Arm_AARCH64_SRE respectively as these ports are applicable to all AArch64
  architecture. We thank @urutva for their contribution.
+ Add CMake support to allow the application writer to select the RISC-V
  chip extension. We thank @JoeBenczarski for their contribution.
+ Add CMake support to allow the application writer to build an application
  with static allocation only. We thank @conara for their contribution.
+ Make taskYIELD available to unprivileged tasks for ARMv8-M ports.
+ Update Cortex-M23 ports to not use PSPLIM_NS. We thank @urutva for their
  contribution.
+ Update the SysTick setup code for ARMv8-M ports to first configure the clock
  source and then enable SysTick. This is needed to address a bug in QEMU
  versions older than 7.0.0, which causes an emulation error if SysTick is
  enabled without first selecting a valid clock source. We thank @jefftenney
  for their contribution.
+ Add the port-optimized task selection algorithm optionally available for
  ARMv7-M ports to the ARMv8-M ports. We thank @jefftenney for their
  contribution.
+ Improve the speed of pvPortMalloc in heap_4.c and heap_5.c by removing
  unnecessary steps while splitting a large memory block into two. We thank
  @Moral-Hao for their contribution.
+ Shorten the critical section in pvPortMalloc in heap_2.c, heap_4.c and
  heap_5.c by moving the size calculation out of the critical section. We thank
  @Moral-Hao for their contribution.
+ Update xTaskNotifyWait and ulTaskNotifyTake to remove the non-deterministic
  operation of traversing a linked link from a critical section. We thank
  @karver8 for their contribution.
+ Fix stack end and stack size computation in POSIX port to meet the stack
  alignment requirements on MacOS. We thank @tegimeki for their contribution.
+ Update the vTaskPrioritySet implementation to use the new priority when the
  task has inherited priority from a mutex it is holding, and the new priority
  is bigger than the inherited priority. We thank @Moral-Hao for their
  contribution.
+ Add stack alignment adjustment if stack grows upwards. We thank @ivq for
  their contribution.
+ Fix pxTopOfStack calculation in configINIT_TLS_BLOCK when picolib C is
  selected as the C library implementation to ensure that
  pxPortInitialiseStack does not overwrite the data in the TLS block portion
  of the stack. We thank @bebebib-rs for their contribution.
+ Fix vPortEndScheduler() for the MSVC port so that the function
  prvProcessSimulatedInterrupts is not stuck in an infinite loop when the
  scheduler is stopped. We thank @Ju1He1 for their contribution.
+ Add the Pull Request (PR) Process explaining the stages a PR goes through.

Changes between FreeRTOS V10.6.1 and FreeRTOS V10.6.2 released November 29, 2023

+ Add the following improvements to the new MPU wrapper (mpu_wrappers_v2.c)
  introduced in version 10.6.0:
  - Introduce Access Control List (ACL) feature to allow the application
    writer to control an unprivileged task’s access to kernel objects.
  - Update the system call entry mechanism to only require one Supervisor
    Call (SVC) instruction.
  - Wrap parameters for system calls with more than four parameters in a
    struct to avoid special handling during system call entry.
  - Fix 2 possible integer overflows.
  - Convert some asserts to run time parameter checks.

Changes between FreeRTOS V10.6.0 and FreeRTOS V10.6.1 released August 17, 2023

+ Add runtime parameter checks to functions in mpu_wrappers_v2.c file.
  The same checks are already performed in API implementations using
  asserts.
  We thank the following people for their inputs in these changes:
  - Lan Luo, Zixia Liu of School of Computer Science and Technology,
    Anhui University of Technology, China.
  - Xinwen Fu of Department of Computer Science, University of
    Massachusetts Lowell, USA.
  - Xinhui Shao, Yumeng Wei, Huaiyu Yan, Zhen Ling of School of
    Computer Science and Engineering, Southeast University, China.

Changes between FreeRTOS V10.5.1 and FreeRTOS 10.6.0 released July 13, 2023

+ Add a new MPU wrapper that places additional restrictions on unprivileged
  tasks. The following is the list of changes introduced with the new MPU
  wrapper:

  1. Opaque and indirectly verifiable integers for kernel object handles:
     All the kernel object handles (for example, queue handles) are now
     opaque integers. Previously object handles were raw pointers.
  2. Save the task context in Task Control Block (TCB): When a task is
     swapped out by the scheduler, the task's context is now saved in its
     TCB. Previously the task's context was saved on its stack.
  3. Execute system calls on a separate privileged only stack: FreeRTOS
     system calls, which execute with elevated privilege, now use a
     separate privileged only stack. Previously system calls used the
     calling task's stack. The application writer can control the size of
     the system call stack using new configSYSTEM_CALL_STACK_SIZE config
     macro.
  4. Memory bounds checks: FreeRTOS system calls which accept a pointer
     and de-reference it, now verify that the calling task has required
     permissions to access the memory location referenced by the pointer.
  5. System calls restrictions: The following system calls are no longer
     available to unprivileged tasks:
      - vQueueDelete
      - xQueueCreateMutex
      - xQueueCreateMutexStatic
      - xQueueCreateCountingSemaphore
      - xQueueCreateCountingSemaphoreStatic
      - xQueueGenericCreate
      - xQueueGenericCreateStatic
      - xQueueCreateSet
      - xQueueRemoveFromSet
      - xQueueGenericReset
      - xTaskCreate
      - xTaskCreateStatic
      - vTaskDelete
      - vTaskPrioritySet
      - vTaskSuspendAll
      - xTaskResumeAll
      - xTaskGetHandle
      - xTaskCallApplicationTaskHook
      - vTaskList
      - vTaskGetRunTimeStats
      - xTaskCatchUpTicks
      - xEventGroupCreate
      - xEventGroupCreateStatic
      - vEventGroupDelete
      - xStreamBufferGenericCreate
      - xStreamBufferGenericCreateStatic
      - vStreamBufferDelete
      - xStreamBufferReset
     Also, an unprivileged task can no longer use vTaskSuspend to suspend
     any task other than itself.

  We thank the following people for their inputs in these enhancements:
    - David Reiss of Meta Platforms, Inc.
    - Lan Luo, Xinh...
Read more

Update 10.5.1 Release

24 Aug 12:58
Compare
Choose a tag to compare

Changes between FreeRTOS V10.5.0 and V10.5.1+ May 3 2023

  • Minor updates from the repository, mainly typos and formatting for consistency. See commit for details.
  • Removed Timer0 settings to documentation and provided a usage example. No functional change.
  • Initial (untested) support for Logic Green LGT8F328P.

Changes between FreeRTOS V10.4.6 and V10.5.0 September 16 2022

  • Update the pointer types to portPOINTER_SIZE_TYPE.
  • Add the ability to override send and receive completed callbacks for each
    instance of a stream buffer or message buffer. Earlier there could be
    one send and one receive callback for all instances of stream and message
    buffers. Having separate callbacks per instance allows different message
    and stream buffers to be used differently - for example, some for inter core
    communication and others for same core communication.
    The feature can be controlled by setting the configuration option
    configUSE_SB_COMPLETED_CALLBACK in FreeRTOSConfig.h. When the option is set to 1,
    APIs xStreamBufferCreateWithCallback() or xStreamBufferCreateStaticWithCallback()
    (and likewise APIs for message buffer) can be used to create a stream buffer
    or message buffer instance with application provided callback overrides. When
    the option is set to 0, then the default callbacks as defined by
    sbSEND_COMPLETED() and sbRECEIVE_COMPLETED() macros are invoked. To maintain
    backwards compatibility, configUSE_SB_COMPLETED_CALLBACK defaults to 0. The
    functionality is currently not supported for MPU enabled ports.
  • Introduce the configUSE_MINI_LIST_ITEM configuration option. When this
    option is set to 1, ListItem_t and MiniLitItem_t remain separate types.
    However, when configUSE_MINI_LIST_ITEM == 0, MiniLitItem_t and ListItem_t
    are both typedefs of the same struct xLIST_ITEM. This addresses some issues
    observed when strict-aliasing and link time optimization are enabled.
    To maintain backwards compatibility, configUSE_MINI_LIST_ITEM defaults to 1.
  • Simplify prvInitialiseNewTask to memset newly allocated TCB structures
    to zero, and remove code that set individual structure members to zero.
  • Add top of stack and end of stack to the task info report obtained using
    vTaskGetInfo().
  • Add a cap to the cRxLock and cTxLock members of the queue data structure.
    These locks count the number items received and sent to the queue while
    the queue was locked. These are later used to unblock tasks waiting on
    the queue when the queue is unlocked. This PR caps the values of the
    cRxLock and cTxLock to the number of tasks in the system because we cannot
    unblock more tasks than there are in the system. Note that the same assert
    could still be triggered is the application creates more than 127 tasks.
  • Changed uxAutoReload parameter in timer functions to xAutoReload. The
    type is now BaseType_t. This matches the type of pdTRUE and pdFALSE.
    The new function xTimerGetAutoReload() provides the auto-reload state as
    a BaseType_t. The legacy function uxTimerGetAutoReload is retained with the
    original UBaseType_t return value.

Update 10.5.1 Release

03 May 04:28
Compare
Choose a tag to compare

Changes between FreeRTOS V10.5.0 and V10.5.1+ May 3 2023

  • Minor updates from the repository, mainly typos and formatting for consistency. See commit for details.
  • Removed Timer0 settings to documentation and provided a usage example. No functional change.

Changes between FreeRTOS V10.4.6 and V10.5.0 September 16 2022

  • Update the pointer types to portPOINTER_SIZE_TYPE.
  • Add the ability to override send and receive completed callbacks for each
    instance of a stream buffer or message buffer. Earlier there could be
    one send and one receive callback for all instances of stream and message
    buffers. Having separate callbacks per instance allows different message
    and stream buffers to be used differently - for example, some for inter core
    communication and others for same core communication.
    The feature can be controlled by setting the configuration option
    configUSE_SB_COMPLETED_CALLBACK in FreeRTOSConfig.h. When the option is set to 1,
    APIs xStreamBufferCreateWithCallback() or xStreamBufferCreateStaticWithCallback()
    (and likewise APIs for message buffer) can be used to create a stream buffer
    or message buffer instance with application provided callback overrides. When
    the option is set to 0, then the default callbacks as defined by
    sbSEND_COMPLETED() and sbRECEIVE_COMPLETED() macros are invoked. To maintain
    backwards compatibility, configUSE_SB_COMPLETED_CALLBACK defaults to 0. The
    functionality is currently not supported for MPU enabled ports.
  • Introduce the configUSE_MINI_LIST_ITEM configuration option. When this
    option is set to 1, ListItem_t and MiniLitItem_t remain separate types.
    However, when configUSE_MINI_LIST_ITEM == 0, MiniLitItem_t and ListItem_t
    are both typedefs of the same struct xLIST_ITEM. This addresses some issues
    observed when strict-aliasing and link time optimization are enabled.
    To maintain backwards compatibility, configUSE_MINI_LIST_ITEM defaults to 1.
  • Simplify prvInitialiseNewTask to memset newly allocated TCB structures
    to zero, and remove code that set individual structure members to zero.
  • Add top of stack and end of stack to the task info report obtained using
    vTaskGetInfo().
  • Add a cap to the cRxLock and cTxLock members of the queue data structure.
    These locks count the number items received and sent to the queue while
    the queue was locked. These are later used to unblock tasks waiting on
    the queue when the queue is unlocked. This PR caps the values of the
    cRxLock and cTxLock to the number of tasks in the system because we cannot
    unblock more tasks than there are in the system. Note that the same assert
    could still be triggered is the application creates more than 127 tasks.
  • Changed uxAutoReload parameter in timer functions to xAutoReload. The
    type is now BaseType_t. This matches the type of pdTRUE and pdFALSE.
    The new function xTimerGetAutoReload() provides the auto-reload state as
    a BaseType_t. The legacy function uxTimerGetAutoReload is retained with the
    original UBaseType_t return value.

Initial 10.5.0 Release

17 Sep 07:23
Compare
Choose a tag to compare

Changes between FreeRTOS V10.4.6 and V10.5.0 September 16 2022

  • Update the pointer types to portPOINTER_SIZE_TYPE.
  • Add the ability to override send and receive completed callbacks for each
    instance of a stream buffer or message buffer. Earlier there could be
    one send and one receive callback for all instances of stream and message
    buffers. Having separate callbacks per instance allows different message
    and stream buffers to be used differently - for example, some for inter core
    communication and others for same core communication.
    The feature can be controlled by setting the configuration option
    configUSE_SB_COMPLETED_CALLBACK in FreeRTOSConfig.h. When the option is set to 1,
    APIs xStreamBufferCreateWithCallback() or xStreamBufferCreateStaticWithCallback()
    (and likewise APIs for message buffer) can be used to create a stream buffer
    or message buffer instance with application provided callback overrides. When
    the option is set to 0, then the default callbacks as defined by
    sbSEND_COMPLETED() and sbRECEIVE_COMPLETED() macros are invoked. To maintain
    backwards compatibility, configUSE_SB_COMPLETED_CALLBACK defaults to 0. The
    functionality is currently not supported for MPU enabled ports.
  • Introduce the configUSE_MINI_LIST_ITEM configuration option. When this
    option is set to 1, ListItem_t and MiniLitItem_t remain separate types.
    However, when configUSE_MINI_LIST_ITEM == 0, MiniLitItem_t and ListItem_t
    are both typedefs of the same struct xLIST_ITEM. This addresses some issues
    observed when strict-aliasing and link time optimization are enabled.
    To maintain backwards compatibility, configUSE_MINI_LIST_ITEM defaults to 1.
  • Simplify prvInitialiseNewTask to memset newly allocated TCB structures
    to zero, and remove code that set individual structure members to zero.
  • Add top of stack and end of stack to the task info report obtained using
    vTaskGetInfo().
  • Add a cap to the cRxLock and cTxLock members of the queue data structure.
    These locks count the number items received and sent to the queue while
    the queue was locked. These are later used to unblock tasks waiting on
    the queue when the queue is unlocked. This PR caps the values of the
    cRxLock and cTxLock to the number of tasks in the system because we cannot
    unblock more tasks than there are in the system. Note that the same assert
    could still be triggered is the application creates more than 127 tasks.
  • Changed uxAutoReload parameter in timer functions to xAutoReload. The
    type is now BaseType_t. This matches the type of pdTRUE and pdFALSE.
    The new function xTimerGetAutoReload() provides the auto-reload state as
    a BaseType_t. The legacy function uxTimerGetAutoReload is retained with the
    original UBaseType_t return value.

Update 10.4.6 Release

07 Aug 13:09
Compare
Choose a tag to compare

Changes between FreeRTOS V10.4.6 and V10.4.6 snapshot August 7 2022

  • Changed uxAutoReload parameter in timer functions to xAutoReload. The
    type is now BaseType_t. This matches the type of pdTRUE and pdFALSE.
    The new function xTimerGetAutoReload() provides the auto-reload state as
    a BaseType_t. The legacy function uxTimerGetAutoReload is retained with the
    original UBaseType_t return value.
  • Introduce the configUSE_MINI_LIST_ITEM configuration option. When this
    option is set to 1, ListItem_t and MiniLitItem_t remain separate types.
    However, when configUSE_MINI_LIST_ITEM == 0, MiniLitItem_t and ListItem_t
    are both typedefs of the same struct xLIST_ITEM. This addresses some issues
    observed when strict-aliasing and link time optimization are enabled.
    To maintain backwards compatibility, configUSE_MINI_LIST_ITEM defaults to 1.
  • Add the ability to override send and receive completed callbacks for each
    instance of a stream buffer or message buffer. The feature can be controlled
    by setting the configuration option configUSE_SB_COMPLETED_CALLBACK in
    FreeRTOSConfig.h. When the option is set to 1, APIs
    xStreamBufferCreateWithCallback() or xStreamBufferCreateStaticWithCallback()
    (and likewise APIs from message buffer) can be used to create a stream buffer
    or message buffer instance with application provided callback overrides. When
    the option is set to 0, then the default callbacks as defined by
    sbSEND_COMPLETED() and sbRECEIVE_COMPLETED() macros are invoked. To maintain
    backwards compatibility, configUSE_SB_COMPLETED_CALLBACK defaults to 0. The
    functionality is currently not supported for MPU enabled ports.

Changes between FreeRTOS V10.4.5 and FreeRTOS V10.4.6 released November 12 2021

  • Extend use of the configSTACK_DEPTH_TYPE which enables developers to define
    the type used to hold stack counter variables. Defaults to uint16_t
    for backward compatibility. #define configSTACK_DEPTH_TYPE to a type
    (for example, uint8_t) in FreeRTOSConfig.h to override the default.
  • Introduce a new config configALLOW_UNPRIVILEGED_CRITICAL_SECTIONS which
    enables developers to prevent critical sections from unprivileged tasks.
    It defaults to 1 for backward compatibility. Application should set it to
    0 to disable critical sections from unprivileged tasks.
  • Deleted all references to Coroutines.

Update 10.4.6 Release

09 Jul 04:22
Compare
Choose a tag to compare

Changes between FreeRTOS V10.4.5 and V10.4.6 snapshot January 1, 2022

  • Extend use of the configSTACK_DEPTH_TYPE which enables developers to define the type used to hold stack counter variables. Defaults to uint16_t for backward compatibility. #define configSTACK_DEPTH_TYPE to a type (for example, uint8_t) in FreeRTOSConfig.h to override the default.
  • Introduce configUSE_PORT_DELAY to redefine the Arduino delay() function to the FreeRTOS provided vTaskDelay() function where the delay requested is longer than one Tick.
  • Deleted all references to Coroutines.

Changes between FreeRTOS V10.4.4 and FreeRTOS V10.4.5 released September 10, 2021

  • Introduce configRUN_TIME_COUNTER_TYPE which enables developers to define the type used to hold run time statistic counters. Defaults to uint32_t for backward compatibility. #define configRUN_TIME_COUNTER_TYPE to a type (for example, uint64_t) in FreeRTOSConfig.h to override the default.
  • Introduce ulTaskGetIdleRunTimePercent() to complement the pre-existing ulTaskGetIdleRunTimeCounter(). Whereas the pre-existing function returns the raw run time counter value, the new function returns the percentage of the entire run time consumed by the idle task. Note the amount of idle time is only a good measure of the slack time in a system if there are no other tasks executing at the idle priority, tickless idle is not used, and configIDLE_SHOULD_YIELD is set to 0.

Final 10.4.4 Release

01 Jul 00:08
Compare
Choose a tag to compare

Changes between FreeRTOS V10.4.3 and FreeRTOS V10.4.4 released May 28 2021

  • Minor performance improvements to xTaskIncrementTick() achieved by providing macro versions of uxListRemove() and vListInsertEnd().
  • Minor refactor of timers.c that obsoletes the need for the tmrCOMMAND_START_DONT_TRACE macro and removes the need for timers.c to post to its own event queue. A consequence of this change is that auto-reload timers that miss their intended next execution time will execute again immediately rather than executing again the next time the command queue is processed. (thanks Jeff Tenney).
  • Fix a race condition in the message buffer implementation. The underlying cause was that length and data bytes are written and read as two distinct operations, which both modify the size of the buffer. If a context switch occurs after adding or removing the length bytes, but before adding or removing the data bytes, then another task may observe the message buffer in an invalid state.
  • The xTaskCreate() and xTaskCreateStatic() functions accept a task priority as an input parameter. The priority has always been silently capped to (configMAX_PRIORITIES - 1) should it be set to a value above that priority. Now values above that priority will also trigger a configASSERT() failure.
  • Replace configASSERT( pcQueueName ) in vQueueAddToRegistry with a NULL pointer check.
  • Introduce the configSTACK_ALLOCATION_FROM_SEPARATE_HEAP configuration constant that enables the stack allocated to tasks to come from a heap other than the heap used by other memory allocations. This enables stacks to be placed within special regions, such as fast tightly coupled memory.
  • If there is an attempt to add the same queue or semaphore handle to the queue registry more than once then prior versions would create two separate entries. Now if this is done the first entry is overwritten rather than duplicated.
  • Other minor updates include adding additional configASSERT() checks and correcting and improving code comments.
  • Renamed variables affected by configSTACK_DEPTH_TYPE to match their type.