1.14 TrustZone® FreeRTOS Basic

This example application blinks an LED to show the FreeRTOS threads that are running in Non-Secure mode and to indicate status.

Description

This demonstrates the TrustZone feature and uses two projects, Secure and Non-Secure, that work together on the same MCU and offer security isolation between the trusted and the non-trusted resources in the device.

FreeRTOS and BSP are configured and run in Non-Secure mode.

This demonstration creates three tasks and a queue. Task1 sends a message to Task2 and Task3 to unblock and toggle an LED. Task1 priority is low compared to Task2 and Task3, which share the same priority.

  • Task1: This task sends the data (i.e., delay, which is the amount of time for which the task needs to be blocked) to Task2 and Task3 using a queue. Then, Task1 blocks itself for 200 ms to allow other tasks to be scheduled and run.
  • Task2: This task blocks until it receives the data from the queue. If Task2 receives the expected delay (1000 ms) from Task1, it then toggles the LED and blocks itself for the amount of delay received.
  • Task3: This task blocks until it receives the data from the queue. If Task3 receives the expected delay (100 ms) from Task1, it then toggles the LED and blocks itself for the amount of delay received.

Downloading and Building the Application

To clone or download this application from GitHub, go to the main page of this repository and then click Clone button to clone this repository or download as zip file. This content can also be downloaded using content manager by following these instructions.

Path of the application within the repository is as shown below:
TypePath
Project groupapps/rtos/freertos/basic_freertos_trustZone
Secure Projectapps/rtos/freertos/basic_freertos_trustZone/Secure/firmware
Non-Secure Projectapps/rtos/freertos/basic_freertos_trustZone/NonSecure/firmware
To build the application, refer to the following table and open the project using its IDE.
Project NameDescription

pic32ck_sg01_cult_Secure.X

pic32ck_sg01_cult_NonSecure.X

Secure and Non-Secure MPLAB X project for PIC32CK SG01 Curiosity Ultra Development Board

Setting Up the Hardware

The following table shows the target hardware for the application projects.

Project NameDescription

pic32ck_sg01_cult_Secure.X

pic32ck_sg01_cult_NonSecure.X

PIC32CK SG01 Curiosity Ultra Development Board

Setting Up PIC32CK SG01 Curiosity Ultra Development Board

  • Connect the Debug USB port on the board to the computer using a micro USB cable

Running the Application

  1. Build and program the application using its IDE.
  2. The LED indicates the success or failure.
    • The LED toggles on success, i.e., each time when the Task2 or Task3 receives a valid message
Refer to the following table for LED name: