Quality RTOS & Embedded Software

KERNEL
WHAT'S NEW
Featured FreeRTOS IoT Integrations:
Introducing three featured integrations for more secure IoT applications. See the blog post.
Extended Maintenance Plan (EMP):
Announcing the EMP for FreeRTOS, provided by AWS. See the blog post.
Delta Over-the-Air Updates:
Announcing Delta OTA updates. See the blog post.
December 2021 Releases:
Include MCUBoot demo and a new FreeRTOS download. See the blog post.
FreeRTOS LTS libraries:
The LTS libraries are now included in our partner toolchains. See the blog post.

Co-routines
[More about co-routines...]

Implementing a Co-Routine

A co-routine should have the following structure: 
    void vACoRoutineFunction( CoRoutineHandle_t xHandle,
                              UBaseType_t uxIndex )
    {
        crSTART( xHandle );

        for( ;; )
        {
            -- Co-routine application code here. --
        }

        crEND();
    }
The type crCOROUTINE_CODE is defined as a function that returns void and takes an CoRoutineHandle_t and an index as its parameters. All functions that implement a co-routine should be of this type (demonstrated above).

Co-routines are created by calling xCoRoutineCreate().

Points to note:

  • All co-routine functions must start with a call to crSTART().
  • All co-routine functions must end with a call to crEND().
  • Co-routine functions should never return so are typically implemented as a continuous loop.
  • Many co-routines can be created from a single co-routine function. The uxIndex parameter is provided as a means of distinguishing between such co-routines.

Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.