module ti.sysbios.rts.iar.MultithreadSupport
index URL

This Multithread support module uses Hook Functions, Hook Context and an overloaded implementation of the library's lock and thread local storage access functions to make C runtime library calls re-entrant

Multithread support will be enabled when IAR linker option "--threaded_lib" is passed as the target's linker options prefix. This can be done in one of the following ways: - When building an application in IAR Embedded Workbench, under Project -> Options -> General Options -> Library Configuration, check the "Enable thread support in Library" box. - When building an application through makefile using configuro, pass the linker options on configuro command line using "--linkOptions" option. - When building an application through XDC build system using config.bld, pass the linker options through the XDC target linkOpts.prefix in config.bld. [ more ... ]
C synopsis target-domain sourced in ti/sysbios/rts/iar/MultithreadSupport.xdc
#include <ti/sysbios/rts/iar/MultithreadSupport.h>
Functions common to all target modules
MultithreadSupport_Module_getMask// Returns the diagnostics mask for this module, MultithreadSupport_Module_hasMask// Test whether this module has a diagnostics mask, MultithreadSupport_Module_heap// The heap from which this module allocates memory, MultithreadSupport_Module_id// Get this module's unique id, MultithreadSupport_Module_setMask// Set the diagnostics mask for this module, MultithreadSupport_Module_startupDone// Test if this module has completed startup
 
DETAILS
Multithread support will be enabled when IAR linker option "--threaded_lib" is passed as the target's linker options prefix. This can be done in one of the following ways: - When building an application in IAR Embedded Workbench, under Project -> Options -> General Options -> Library Configuration, check the "Enable thread support in Library" box. - When building an application through makefile using configuro, pass the linker options on configuro command line using "--linkOptions" option. - When building an application through XDC build system using config.bld, pass the linker options through the XDC target linkOpts.prefix in config.bld.
Note: Calling C runtime functions from SWI and HWI threads is not supported and will generate an exception if multithread support is enabled.
Module-Wide Built-Ins
index URL

C synopsis target-domain
Types_ModuleId MultithreadSupport_Module_id();
// Get this module's unique id
 
Bool MultithreadSupport_Module_startupDone();
// Test if this module has completed startup
 
IHeap_Handle MultithreadSupport_Module_heap();
// The heap from which this module allocates memory
 
Bool MultithreadSupport_Module_hasMask();
// Test whether this module has a diagnostics mask
 
Bits16 MultithreadSupport_Module_getMask();
// Returns the diagnostics mask for this module
 
Void MultithreadSupport_Module_setMask(Bits16 mask);
// Set the diagnostics mask for this module
 
Configuration settings sourced in ti/sysbios/rts/iar/MultithreadSupport.xdc
var MultithreadSupport = xdc.useModule('ti.sysbios.rts.iar.MultithreadSupport');
module-wide config parameters
    MultithreadSupport.common$// Common module configuration parameters = Types.Common$ undefined;
 
 
metaonly config MultithreadSupport.common$  // module-wide
index URL

Common module configuration parameters

Configuration settings
MultithreadSupport.common$ = Types.Common$ undefined;
 
DETAILS
All modules have this configuration parameter. Its name contains the '$' character to ensure it does not conflict with configuration parameters declared by the module. This allows new configuration parameters to be added in the future without any chance of breaking existing modules.
generated on Tue, 14 Feb 2017 19:59:46 GMT