Overview

The CLib Support Library provides the necessary hooks to make C library functions such as malloc and free thread safe. This implementation supports FreeRTOS and ThreadX and requires the appropriate RTOS to be present to build. For details on what this library provides see the toolchain specific documentation at:

The startup code must call cy_toolchain_init (for GCC and IAR). This must occur after static data initialization and before static constructors. This is done automatically for PSoC™ devices. See the PSoC™ startup files for an example.

In FreeRTOS to enable Thread Local Storage, configUSE_NEWLIB_REENTRANT must be enabled.

While this is specific to FreeRTOS and ThreadX, it can be used as a basis for supporting other RTOSes as well.

FreeRTOS Requirements

To use this library, the following configuration options must be enabled in FreeRTOSConfig.h:

configUSE_MUTEXES
configUSE_RECURSIVE_MUTEXES
configSUPPORT_STATIC_ALLOCATION

ThreadX Requirements

To use this library, the following configuration option must be enabled:

TX_DISABLE_REDUNDANT_CLEARING

When building with IAR, the '–threaded_lib' argument must be provided when linking. This is done automatically with psoc6make 1.3.1 and later. Also, 'TX_ENABLE_IAR_LIBRARY_SUPPORT' must be defined in the application when building with IAR. This enables the ThreadX IAR-specific port for clib thread safety. For more information about porting with ThreadX, see the ThreadX GitHub: https://github.com/azure-rtos/threadx/tree/master/ports

Features

GCC Newlib implementations for:
- _sbrk
- __malloc_lock
- __malloc_unlock
- __env_lock
- __env_unlock
ARM C library implementations for:
- _platform_post_stackheap_init
- __user_perthread_libspace
- _mutex_initialize
- _mutex_acquire
- _mutex_release
- _mutex_free
- _sys_exit
- $Sub$$_sys_open
- _ttywrch
- _sys_command_string
IAR C library implementations for:
- __aeabi_read_tp (FreeRTOS)
- _reclaim_reent
- __iar_system_Mtxinit (FreeRTOS)
- __iar_system_Mtxlock (FreeRTOS)
- __iar_system_Mtxunlock (FreeRTOS)
- __iar_system_Mtxdst (FreeRTOS)
- __iar_file_Mtxinit
- __iar_file_Mtxlock
- __iar_file_Mtxunlock
- __iar_file_Mtxdst
- __iar_Initdynamiclock
- __iar_Lockdynamiclock
- __iar_Unlockdynamiclock
- __iar_Dstdynamiclock
- __close
- __lseek
- remove
C++ implementations for:
- __cxa_guard_acquire
- __cxa_guard_abort
- __cxa_guard_release
time function implementation from time.h

Time Support Details

When using the HAL the time function returns the time in seconds from microcontroller Real-Time Clock (RTC). Additionally, functions mtb_clib_support_init and mtb_clib_support_get_rtc are provided to interact with the CLIB support RTC handle used. Follow below steps to set this up.

Setup using an existing CLIB support RTC handle:
- Application initializes RTC handle using PDL API
- Application writes the current time to RTC using PDL API
- Application sets the CLIB support RTC handle using mtb_clib_support_init API
- Application calls time function to get the time from CLIB support RTC

NOTE: For MTB_HAL_API_VERSION >= 3, mtb_clib_support_init must be called before time is invoked. Otherwise, time will assert and (if asserts are enabled) and return a default time value.

More information

Use the following links for more information, as needed: