Releases: feilipu/Arduino_FreeRTOS_Library
Releases · feilipu/Arduino_FreeRTOS_Library
Update 11.1.0 Release
+ Fix queue size creation to match upstream. See Issue #136. + Move header includes before extern C. + Re-enable stack and heap error functions.
Changes between FreeRTOS V11.0.1 and FreeRTOS V11.1.0 released April 22, 2024
See earlier point releases.
Update 11.1.0 Release
+ Move header includes before extern C + 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
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
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,...
Initial 11.0.1 Release
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...
Update 10.5.1 Release
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,
APIsxStreamBufferCreateWithCallback()
orxStreamBufferCreateStaticWithCallback()
(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()
andsbRECEIVE_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
andMiniLitItem_t
remain separate types.
However, whenconfigUSE_MINI_LIST_ITEM == 0
,MiniLitItem_t
andListItem_t
are both typedefs of the same structxLIST_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
andcTxLock
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
andcTxLock
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 toxAutoReload
. The
type is nowBaseType_t
. This matches the type ofpdTRUE
andpdFALSE
.
The new functionxTimerGetAutoReload()
provides the auto-reload state as
aBaseType_t
. The legacy functionuxTimerGetAutoReload
is retained with the
originalUBaseType_t
return value.
Update 10.5.1 Release
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,
APIsxStreamBufferCreateWithCallback()
orxStreamBufferCreateStaticWithCallback()
(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()
andsbRECEIVE_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
andMiniLitItem_t
remain separate types.
However, whenconfigUSE_MINI_LIST_ITEM == 0
,MiniLitItem_t
andListItem_t
are both typedefs of the same structxLIST_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
andcTxLock
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
andcTxLock
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 toxAutoReload
. The
type is nowBaseType_t
. This matches the type ofpdTRUE
andpdFALSE
.
The new functionxTimerGetAutoReload()
provides the auto-reload state as
aBaseType_t
. The legacy functionuxTimerGetAutoReload
is retained with the
originalUBaseType_t
return value.
Initial 10.5.0 Release
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,
APIsxStreamBufferCreateWithCallback()
orxStreamBufferCreateStaticWithCallback()
(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()
andsbRECEIVE_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
andMiniLitItem_t
remain separate types.
However, whenconfigUSE_MINI_LIST_ITEM == 0
,MiniLitItem_t
andListItem_t
are both typedefs of the same structxLIST_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
andcTxLock
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
andcTxLock
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 toxAutoReload
. The
type is nowBaseType_t
. This matches the type ofpdTRUE
andpdFALSE
.
The new functionxTimerGetAutoReload()
provides the auto-reload state as
aBaseType_t
. The legacy functionuxTimerGetAutoReload
is retained with the
originalUBaseType_t
return value.
Update 10.4.6 Release
Changes between FreeRTOS V10.4.6 and V10.4.6 snapshot August 7 2022
- Changed
uxAutoReload
parameter in timer functions toxAutoReload
. The
type is nowBaseType_t
. This matches the type ofpdTRUE
andpdFALSE
.
The new functionxTimerGetAutoReload()
provides the auto-reload state as
aBaseType_t
. The legacy functionuxTimerGetAutoReload
is retained with the
originalUBaseType_t
return value. - Introduce the
configUSE_MINI_LIST_ITEM
configuration option. When this
option is set to 1,ListItem_t
andMiniLitItem_t
remain separate types.
However, whenconfigUSE_MINI_LIST_ITEM == 0
,MiniLitItem_t
andListItem_t
are both typedefs of the same structxLIST_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 optionconfigUSE_SB_COMPLETED_CALLBACK
in
FreeRTOSConfig.h
. When the option is set to 1, APIs
xStreamBufferCreateWithCallback()
orxStreamBufferCreateStaticWithCallback()
(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()
andsbRECEIVE_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 touint16_t
for backward compatibility.#define configSTACK_DEPTH_TYPE
to a type
(for example,uint8_t
) inFreeRTOSConfig.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
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 touint16_t
for backward compatibility.#define configSTACK_DEPTH_TYPE
to a type (for example,uint8_t
) inFreeRTOSConfig.h
to override the default. - Introduce
configUSE_PORT_DELAY
to redefine the Arduinodelay()
function to the FreeRTOS providedvTaskDelay()
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 touint32_t
for backward compatibility.#define configRUN_TIME_COUNTER_TYPE
to a type (for example,uint64_t
) inFreeRTOSConfig.h
to override the default. - Introduce
ulTaskGetIdleRunTimePercent()
to complement the pre-existingulTaskGetIdleRunTimeCounter()
. 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, andconfigIDLE_SHOULD_YIELD
is set to0
.