The benchmark project contains a set of tests aimed to measure the performance of certain OS operations. It currently supports both the qemu_x86 and frdm_k64f boards on Zephyr and only the frdm_k64f board on FreeRTOS. Additional boards and RTOSes are expected to be added in the future.
It is recognized that running a benchmark test suite on QEMU is not generally recommended, and any results from that should be taken with a grain of salt. That being said, the primary reason it has been added has been to act as a blueprint for integrating additional boards and architectures.
Install the GNU ARM compiler for the frdm_k64f board,
GNU ARM Embedded toolchain
and set ARMGCC_DIR to the installation directory.
Refer to the Zephyr Getting Started Guide
for installing and setting up the Zephyr environment. This must be done so that
a freestanding application can be built. As indicated under "Common", be sure
to set the ARMGCC_DIR environment variable appropriately.
To enable use of the 3rd Party GNU ARM Embedded toolchain, set the following environment variables.
export ZEPHYR_TOOLCHAIN_VARIANT=gnuarmemb
export GNUARMEMB_TOOLCHAIN_PATH=<path to installed toolchain>
Build and download the FRDM-K64F SDK from the NXP MCUXpresso SDK Builder.
Select Linux as your host OS and GCC ARM Embedded as your toolchain.
Be sure to also check the FreeRTOS checkbox to build FreeRTOS
awareness and examples into the SDK.
mkdir freertos/SDK_<version>_FRDM-K64F
unzip ~/Downloads/SDK_<version>_FRDM-K64F.zip -d <SDK Install Dir>/SDK_<version>_FRDM-K64F
Install pyOCD - tool used to flash FRDM_K64F.
cmake -GNinja -DRTOS=zephyr -DBOARD=frdm_k64f -S . -B build
ninja -C build
ninja -C build flash
Similar steps apply to when building for a different board. In the cmake
command, specify the name of the board after -DBOARD. For example ...
cmake -GNinja -DRTOS=zephyr -DBOARD=qemu_x86 -S . -B build
Remember that the ZEPHYR_BASE environment variable must be set so that the
Zephyr west tool can be found.
cmake -GNinja -DRTOS=freertos -DBOARD=frdm_k64f -DMCUX_SDK_PATH=<SDK Install Dir>/SDK_<version>_FRDM-K64F -S . -B build
ninja -C build
ninja -C build flash
Connect the frdm_k64f to your host via USB. In another terminal, open
a serial terminal (such as screen, minicom, etc) to see the output:
minicom -D /dev/ttyACM0
Debugging on both Zephyr and FreeRTOS are quite similar.
cmake <RTOS Debug Options>
ninja -C build debugserver
In another terminal, start GDB:
$ARMGCC_DIR/bin/arm-none-eabi-gdb build/freertos.elf
(gdb) target remote :3333
Nothing extra--just the standard cmake instruction.
cmake -GNinja -DRTOS=zephyr -DBOARD=frdm_k64f -S . -B build
Add -DCMAKE_BUILD_TYPE=debug to the build options:
cmake -GNinja -DCMAKE_BUILD_TYPE=debug -DRTOS=freertos -DBOARD=frdm_k64f -DMCUX_SDK_PATH=SDK_<version>_FRDM-K64F -S . -B build