Using FreeRTOS on EK-RA6M3G

Compatible versions

Qt Quick Ultralite for FreeRTOS has been tested with FreeRTOS v10.6.1 from Flexible Software Package (FSP) v5.2.0, which is the officially supported version for EK-RA6M3G.

Note: If you are using the precompiled platform library for EK-RA6M3G then part of the FreeRTOS sources are already compiled into it. If you want to use a different FreeRTOS version, you must rebuild the platform library.

For a list of supported platforms and FreeRTOS versions, see supported architectures, platforms and FreeRTOS versions.

Providing FreeRTOS symbols and libraries for Qt Quick Ultralite

If you are using app_common in your project, provide a path to FreeRTOS sources for Qt Quick Ultralite by setting the FREERTOS_DIR CMake cache entry. The directory must contain at least the following:

  • include directory containing FreeRTOS header files
  • portable directory
  • MemMang directory under portable. This directory should contain memory manager implementations for FreeRTOS.
  • heap_4.c file under portable/MemMang. This is the memory allocator implementation, which Qt Quick Ultralite uses by default. If you can't provide heap_4.c or want to use your own implementation, you can change the used implementation by setting QUL_FREERTOS_HEAP_POLICY target property. See changing heap policies.
  • Following files are required:
    • port.c file under ra/fsp/src/rm_freertos_port from Flexible Software Package (FSP) sources.
    • portmacro.h file under ra/fsp/src/rm_freertos_port from Flexible Software Package (FSP) sources.
  • event_groups.c
  • list.c
  • queue.c
  • tasks.c
  • timers.c

FreeRTOSConfig.h is provided by the platform library. The application must use the same FreeRTOSConfig.h that is used for compiling the platform library. The platform package must be recompiled in order to use your own FreeRTOS configuration.

If you are not using app_common in your project, you do not need to set the FREERTOS_DIR CMake cache entry. However, you must provide the following headers and functions for Qt Quick Ultralite (that is, these headers must be in your project):

  • FreeRTOS.h
  • task.h
  • portable.h
  • memory.h
  • void xPortSysTickHandler(void)
  • void *pvPortMalloc(size_t xSize)
  • void vPortFree(void *pv)

See building application without app_common for instructions on how to setup your project without app_common.

Flashing FreeRTOS projects

The flashing process is the same for projects using FreeRTOS. For more information, see Flashing Instructions for EK-RA6M3G.

Available under certain Qt licenses.
Find out more.