Jump to main content

# 1.6 FreeRTOS Task Notification

This example application is to illustrate the FreeRTOS Task Notification feature which is used as a lightweight binary semaphore.

## Description

- This demonstration creates two tasks that send notifications back and forth to each other:
  - Task2 blocks to wait for Task1 to notify and will be blocked for 500 ms
  - Task1 sends a notification to Task2, bringing it out of the blocked state and toggles an LED
  - Task1 blocks to wait for Task2 to notify
  - Task2 sends notification to Task1, bringing it out of the blocked state
- The above steps will be repeated, i.e., an LED toggles for every 500 ms

## 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 apps/rtos/freertos/task_notification_freertos/firmware.

To build the application, refer to the following table and open the project using its IDE.

Project Name | Description
--- | ---
pic32mk_gp_db.X | MPLAB X project for PIC32MK GP Development Kit

## Setting Up the Hardware

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

Project Name | Description
--- | ---
pic32mk_gp_db.X | PIC32MK GP Development Kit

### Setting Up PIC32MK GP Development Kit

- Connect micro USB cable to the Debug USB connector (J12) on the board to the computer

## Running the Application

1. Build and program the application using its IDE.
2. The LED toggles on success for every 500 ms.

Refer to the following table for LED name:

Board | LED Name
--- | ---
PIC32MK GP Development Kit | LED1

Rev: D