Process for adding port for a proprietary core in FreeRTOS official package

VBT289 · November 11, 2021, 2:31pm

Hi,
I want to know details on adding FreeRTOS port for a proprietary core in FreeRTOS official release package.

I am also looking for FreeRTOS device qualification to test the port for this core. Does qualifyng the device is sufficient to add the port to the official package or we need to follow some other steps as well. Detailed information on this would be helpful.

rtel · November 11, 2021, 5:25pm

Are you looking to contribute a kernel port, or qualify a cloud connected integration?

If the kernel port only then we are in the process of categorising kernel ports as being supported directly by ourselves, supported by our partners, or “unsupported” - unsupported meaning we make the code available and will do our best to support users but nobody is really responsible for maintaining a test setup. This is not fully documented yet but you will see the idea on the following links:

github.com

FreeRTOS/FreeRTOS/blob/main/FreeRTOS/Demo/ThirdParty/Template/README.md

# Create a Test Project

## Initial Setup

1. Create a new directory in the [FreeRTOS Partner Supported Demos Repository](https://github.com/FreeRTOS/FreeRTOS-Partner-Supported-Demos/tree/main)
   or [FreeRTOS Community Supported Demos Repository](https://github.com/FreeRTOS/FreeRTOS-Community-Supported-Demos/tree/main).
   The suggested name for the directory is `<hardware_name>_<compiler_name>`.
2. Create a project for your hardware and tool-chain in this directory.
3. Copy all the files in the [FreeRTOS/Demo/ThirdParty/Template](https://github.com/FreeRTOS/FreeRTOS/tree/main/FreeRTOS/Demo/ThirdParty/Template)
   directory to your project directory:
   * `IntQueueTimer.h`
   * `IntQueueTimer.c`
   * `TestRunner.h`
   * `TestRunner.c`
   * `RegTests.h`
   * `RegTests.c`

## Project Configuration

1. Compile the following additional files in your project:

This file has been truncated. show original

aggarg · November 11, 2021, 6:57pm

To add to what Richard already mentioned, if you want to put a FreeRTOS-Kernel port for a proprietary core, you can put it in the “Community Supported Ports” repository.

This document defines how the support differs for different third party ports - FreeRTOS-Kernel/README.md at main · FreeRTOS/FreeRTOS-Kernel · GitHub

This document describes the process to contribute a community port - FreeRTOS-Kernel-Community-Supported-Ports/README.md at main · FreeRTOS/FreeRTOS-Kernel-Community-Supported-Ports · GitHub

Let us know if you face any problem.

Thanks.

VBT289 · November 15, 2021, 12:06pm

Thanks Richard. I am looking to contribute kernel port along with some demos which can be downloaded as part of official FreeRTOS release. Currently we provide a separate FreeRTOS support package with the kernel port and some demos for this proprietary core and this package can be used on top of official FreeRTOS pachage. Interested in added the port to FreeRTOS package itself to avoid the extra steps to run the demos for this core.

VBT289 · November 15, 2021, 12:10pm

Thanks Gaurav. I did come across this link for community supported ports but I think these ports wont be added to FreeRTOS releases. We are interested in adding the port and demos to the official download package to facilitate users.

rtel · November 15, 2021, 4:29pm

Sounds interesting - you can contact me directly using the Business Related Inquiries link to let me know which processor this is, etc. Thanks.

aggarg · November 15, 2021, 6:04pm

These ports are included with FreeRTOS releases - putting them in those locations just clarifies support.

Thanks.