Quality RTOS & Embedded Software

 Real time embedded FreeRTOS RSS feed 
Quick Start Supported MCUs PDF Books Trace Tools Ecosystem


Upgrading to FreeRTOS V5.0.0
[API]

Important information on upgrading existing FreeRTOS application to FreeRTOS V5.0.0

The parameters to the functions xQueueSendFromISR(), xQueueSendToFrontFromISR(), xQueueSendToBackFromISR and xSemaphoreGiveFromISR() have changed. The old functions all had similar prototypes of the form ...:


BaseType_t xQueueSendFromISR(
                                   QueueHandle_t xQueue,
                                   void *pvItemToQueue,
                                   BaseType_t xTaskPreviouslyWoken
                               );
... returning pdTRUE if the send (or give in the case of the semaphores) caused a higher priority task to unblock.

The new functions all have prototypes of the form:


BaseType_t xQueueSendFromISR(
                                    QueueHandle_t xQueue,
                                    void *pvItemToQueue,
                                    BaseType_t *pxHigherPriorityTaskWoken
                               );
The major difference is the third parameter, which is now a pointer. If sending to the queue (or giving the semaphore) caused a higher priority ask to unblock then xQueueSendFromISR will set *pxHigherPriorityTaskWoken to pdTRUE. The return value can now be either pdPASS to indicate that the send was successful, or errQUEUE_FULL if the send was not successful.

Please read the FreeRTOS API documentation pages for full descriptions and examples. The demo applications within the FreeRTOS.org download have also been updated to use this new scheme.

You must update all calls to xQueueSendFromISR(), xQueueSendToFrontFromISR(), xQueueSendToBackFromISR() and xSemaphoreGiveFromISR() as passing pdFALSE in as the third parameter might not genereate a compiler warning - but could result in an assignment to NULL.





[ Back to the top ]    [ About FreeRTOS ]    [ Privacy ]    [ Sitemap ]    [ ]


Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.

Latest News

FreeRTOS v10.2.1 is available for immediate download. MIT licensed, includes 64-bit RISC-V, NXP Cortex-M33 demo & Nuvoton Cortex-M23 demo.

NXP tweet showing LPC5500 (ARMv8-M Cortex-M33) running FreeRTOS.

View a recording of the "OTA Update Security and Reliability" webinar, presented by TI and AWS.


Careers

FreeRTOS and other embedded software careers at AWS.



FreeRTOS Partners

ARM Connected RTOS partner for all ARM microcontroller cores

Cadence Tensilica Cortes

Espressif ESP32

IAR Partner

Microchip Premier RTOS Partner

RTOS partner of NXP for all NXP ARM microcontrollers

Mediatek

Renesas

RISC-V

SiFIve RISC-V

STMicro RTOS partner supporting ARM7, ARM Cortex-M3, ARM Cortex-M4 and ARM Cortex-M0

Texas Instruments MCU Developer Network RTOS partner for ARM and MSP430 microcontrollers

OpenRTOS and SafeRTOS

Xilinx Microblaze and Zynq partner