Using FreeRTOS on NXP IMXRT1064-EVK

Compatible versions

Qt Quick Ultralite for FreeRTOS has been tested with FreeRTOS v10.0.1, which is the officially supported version for NXP IMXRT1064-EVK.

Note: If you are using the precompiled platform library for NXP IMXRT1064-EVK then part of the FreeRTOS sources are already compiled into it. If you would like to change the FreeRTOS version then the platform library has to be rebuilt.

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.

Note: The directory name for FreeRTOS sources in MCUXpresso SDK is subject to changes. Check the correct path from the rtos directory.

The directory must contain at least the following:

  • include directory containing FreeRTOS header files. If you are using FreeRTOS from MCUXpresso SDK 2.6 or older, the include is searched from the upper directory.
  • 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 cannot provide heap_4.c or want to use your own implementation, change the implementation by setting the QUL_FREERTOS_HEAP_POLICY target property. See changing heap policies.
  • Depending on the toolchain you are using the following files are required:
    • For the Arm GCC toolchain:
      • port.c file under portable/GCC/ARM_CM4F.
      • fsl_tickless_systick.c file under portable/GCC/ARM_CM4F if using FreeRTOS from MCUXpresso SDK 2.6 or older.
    • For the IAR toolchain:
      • port.c file under portable/IAR/ARM_CM4F.
      • portasm.s file under portable/IAR/ARM_CM4F.
      • fsl_tickless_systick.c file under portable/IAR/ARM_CM4F if using FreeRTOS from MCUXpresso SDK 2.6 or older.
  • stream_buffer.c
  • 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 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. See this page for detailed flashing instructions.

RLE decompression

For performance reasons, opaque RLE images with opacity applied are decompressed into intermediate buffers of a limited size, before blending them using PXP onto the framebuffer in SDRAM.

Performance can be improved to some degree by increasing the size of qul_scratch_buffer in platform_nxp.cpp, at the cost of more RAM usage.

Available under certain Qt licenses.
Find out more.