module ti.sysbios.family.c7x.TaskSupport
index URL

C71 Task Support Module

C synopsis target-domain sourced in ti/sysbios/family/c7x/TaskSupport.xdc
#include <ti/sysbios/family/c7x/TaskSupport.h>
Functions common to all target modules
TaskSupport_Module_getMask// Returns the diagnostics mask for this module, TaskSupport_Module_hasMask// Test whether this module has a diagnostics mask, TaskSupport_Module_heap// The heap from which this module allocates memory, TaskSupport_Module_id// Get this module's unique id, TaskSupport_Module_setMask// Set the diagnostics mask for this module, TaskSupport_Module_startupDone// Test if this module has completed startup
Constants
extern const Assert_Id 
TaskSupport_A_stackSizeTooSmall// Asserted in TaskSupport_start;
extern const SizeT 
TaskSupport_defaultStackSize// Default Task stack size;
extern const UInt 
TaskSupport_stackAlignment// Required stack alignment (in MAUs);
 
 
config TaskSupport_defaultStackSize  // module-wide
index URL

Default Task stack size

C synopsis target-domain
extern const SizeT TaskSupport_defaultStackSize;
 
DETAILS
The C7x CPU uses 2 stacks during interrupt processing. The CPU automatically saves some context to the memory block to which the TCSP register points, and SW will save some context to the Task's SW stack during interrupt processing. In order to keep specification and processing compatible across different CPU targets, SYS/BIOS uses a single stack memory block for both of these stacks (although there isn't really any stacking with TCSP since there is a distinct block for each Task which is used only once). Due to HW alignment and size requirements for the TCSP block, there is a strict minimum of 16KB for the Task stack.
 
config TaskSupport_stackAlignment  // module-wide
index URL

Required stack alignment (in MAUs)

C synopsis target-domain
extern const UInt TaskSupport_stackAlignment;
 
DETAILS
The C7x CPU TCSP register requires this alignment (see defaultStackSize for further information).
 
config TaskSupport_A_stackSizeTooSmall  // module-wide
index URL

Asserted in TaskSupport_start

C synopsis target-domain
extern const Assert_Id TaskSupport_A_stackSizeTooSmall;
 
Module-Wide Built-Ins
index URL

C synopsis target-domain
Types_ModuleId TaskSupport_Module_id();
// Get this module's unique id
 
Bool TaskSupport_Module_startupDone();
// Test if this module has completed startup
 
IHeap_Handle TaskSupport_Module_heap();
// The heap from which this module allocates memory
 
Bool TaskSupport_Module_hasMask();
// Test whether this module has a diagnostics mask
 
Bits16 TaskSupport_Module_getMask();
// Returns the diagnostics mask for this module
 
Void TaskSupport_Module_setMask(Bits16 mask);
// Set the diagnostics mask for this module
 
Configuration settings sourced in ti/sysbios/family/c7x/TaskSupport.xdc
var TaskSupport = xdc.useModule('ti.sysbios.family.c7x.TaskSupport');
module-wide config parameters
    const TaskSupport.defaultStackSize// Default Task stack size = SizeT 0x4000;
    const TaskSupport.stackAlignment// Required stack alignment (in MAUs) = UInt 0x2000;
 
    TaskSupport.A_stackSizeTooSmall// Asserted in TaskSupport_start = Assert.Desc {
        msg: "A_stackSizeTooSmall: Task stack size must be >= 16KB."
    };
 
    TaskSupport.common$// Common module configuration parameters = Types.Common$ undefined;
 
 
config TaskSupport.defaultStackSize  // module-wide
index URL

Default Task stack size

Configuration settings
const TaskSupport.defaultStackSize = SizeT 0x4000;
 
DETAILS
The C7x CPU uses 2 stacks during interrupt processing. The CPU automatically saves some context to the memory block to which the TCSP register points, and SW will save some context to the Task's SW stack during interrupt processing. In order to keep specification and processing compatible across different CPU targets, SYS/BIOS uses a single stack memory block for both of these stacks (although there isn't really any stacking with TCSP since there is a distinct block for each Task which is used only once). Due to HW alignment and size requirements for the TCSP block, there is a strict minimum of 16KB for the Task stack.
C SYNOPSIS
TaskSupport_defaultStackSize
 
config TaskSupport.stackAlignment  // module-wide
index URL

Required stack alignment (in MAUs)

Configuration settings
const TaskSupport.stackAlignment = UInt 0x2000;
 
DETAILS
The C7x CPU TCSP register requires this alignment (see defaultStackSize for further information).
C SYNOPSIS
TaskSupport_stackAlignment
 
config TaskSupport.A_stackSizeTooSmall  // module-wide
index URL

Asserted in TaskSupport_start

Configuration settings
TaskSupport.A_stackSizeTooSmall = Assert.Desc {
    msg: "A_stackSizeTooSmall: Task stack size must be >= 16KB."
};
 
C SYNOPSIS
TaskSupport_A_stackSizeTooSmall
 
metaonly config TaskSupport.common$  // module-wide
index URL

Common module configuration parameters

Configuration settings
TaskSupport.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 Thu, 23 May 2019 00:22:30 GMT