FreeRTOS+POSIX
Portable Operating System Interface (POSIX threading wrapper) for FreeRTOS

On this page:

1. Introduction
2. Pre-configured example project
3. Supported features
4. FreeRTOS+POSIX source code organisation
5. Dependencies
6. Developer references and API documentation
7. Porting
8. Code Size

Introduction

The Portable Operating System Interface (POSIX) is a family of standards specified by the IEEE Computer Society for maintaining compatibility between operating systems. FreeRTOS+POSIX implements a subset of the POSIX threading API.

With FreeRTOS+POSIX, an existing POSIX threading compliant application can be ported to run on the FreeRTOS kernel, and therefor leverage all the FreeRTOS functionality. Additionally, a library designed for use with POSIX threading compatible operating systems can be ported to FreeRTOS kernel based applications.

Location of FreeRTOS+POSIX when used with FreeRTOS libraries

Example Pre-configure Project

Please see the FreeRTOS+POSIX Pre-configured Example documentation page.

Currently Supported Features

FreeRTOS+POSIX partially implements IEEE Std 1003.1-2017 Edition The Open Group Technical Standard Base Specifications, Issue 7. FreeRTOS+POSIX includes implementations for the following POSIX threading header files - please refer to the FreeRTOS+POSIX API documentation for specifics on the features supported within each header file:

FreeRTOS+POSIX Source Code Organisation

Porting related headers and implementation source code

/lib/FreeRTOS-Plus-POSIX
        |-- include
        |   |
        |   +- FreeRTOS_POSIX.h
        |   +- FreeRTOS_POSIX_internal.h
        |   +- FreeRTOS_POSIX_types.h
        |   +- portable
        |        |
        |        +- [target]
        |        |    |
        |        |    +- [development board]
        |        |            |
        |        |            +- FreeRTOS_POSIX_portable.h
        |        |
        |        +- FreeRTOS_POSIX_portable_default.h
        |
        +- source
            +- FreeRTOS_POSIX_clock.c
            +- FreeRTOS_POSIX_mqueue.c
            +- FreeRTOS_POSIX_pthread_barrier.c
            +- FreeRTOS_POSIX_pthread.c
            +- FreeRTOS_POSIX_pthread_cond.c
            +- FreeRTOS_POSIX_pthread_mutex.c
            +- FreeRTOS_POSIX_sched.c
            +- FreeRTOS_POSIX_semaphore.c
            +- FreeRTOS_POSIX_timer.c
            +- FreeRTOS_POSIX_unistd.c
            +- FreeRTOS_POSIX_utils.c

FreeRTOS+POSIX headers

	/lib/include/FreeRTOS_POSIX
                    +- errno.h
                    +- fcntl.h
                    +- mqueue.h
                    +- pthread.h
                    +- sched.h
                    +- semaphore.h
                    +- signal.h
                    +- sys
                    |    |
                    |    +- types.h
                    |
                    +- time.h
                    +- unistd.h
                    +- utils.h

Dependencies

Both configUSE_POSIX_ERRNO and configUSE_APPLICATION_TASK_TAG must be set to 1 in FreeRTOSConfig.h.

Developer References and API Documents

Please refer to the reference material (links to Doxygen output).

Porting

Porting Related Header Files

FreeRTOS+POSIX Include Paths

Note that a project only needs platform specific header from this path /lib/FreeRTOS-Plus-POSIX/include/portable.

Code Size