module ti.catalog.arm.cortexm3.concertoInit.Boot |
![](../../../../../Arrow_up.png) |
Concerto M3 Boot Support
The Boot module supports boot initialization for the Concerto M3 core.
A special boot init function is created based on the configuration
settings for this module. This function is hooked into the
xdc.runtime.Reset.fxns[] array and called very early at boot time (prior
to cinit processing).
[
more ... ]
#include <ti/catalog/arm/cortexm3/concertoInit/Boot.h>
Functions common to all target modules |
|
|
Constants |
extern const Bool | |
DETAILS
The Boot module supports boot initialization for the Concerto M3 core.
A special boot init function is created based on the configuration
settings for this module. This function is hooked into the
xdc.runtime.Reset.fxns[] array and called very early at boot time (prior
to cinit processing).
The code to support the boot module is placed in a separate section
named
".text:.bootCodeSection" to allow placement of this section in
the linker .cmd file if necessary. This section is a subsection of the
".text" section so this code will be placed into the .text section unless
explicitly placed, either through
Program.sectMap or through a linker
command file.
config Boot_configureClocks // module-wide |
![](../../../../../Arrow_up.png) |
Clock configuration flag, default is false
extern const Bool Boot_configureClocks;
DETAILS
Set to true to configure the PLL and system and M3 subsystem clock
dividers.
Module-Wide Built-Ins |
![](../../../../../Arrow_up.png) |
// Get this module's unique id
Bool Boot_Module_startupDone();
// Test if this module has completed startup
// The heap from which this module allocates memory
Bool Boot_Module_hasMask();
// Test whether this module has a diagnostics mask
Bits16 Boot_Module_getMask();
// Returns the diagnostics mask for this module
Void Boot_Module_setMask(Bits16 mask);
// Set the diagnostics mask for this module
var Boot = xdc.useModule('ti.catalog.arm.cortexm3.concertoInit.Boot');
module-wide constants & types
module-wide config parameters
metaonly enum Boot.FractMult |
![](../../../../../Arrow_up.png) |
System PLL Fractional Multiplier (SPLLFMULT) value
XDCscript usage |
meta-domain |
values of type Boot.FractMult
const Boot.Fract_0;
// Fractional multiplier is 0
const Boot.Fract_25;
// Fractional multiplier is 0.25
const Boot.Fract_50;
// Fractional multiplier is 0.5
const Boot.Fract_75;
// Fractional multiplier is 0.75
metaonly enum Boot.M3Div |
![](../../../../../Arrow_up.png) |
M3 Subsystem Clock Divider (M3SSDIVSEL) value
XDCscript usage |
meta-domain |
values of type Boot.M3Div
const Boot.M3Div_1;
// Divide by 1
const Boot.M3Div_2;
// Divide by 2
const Boot.M3Div_4;
// Divide by 4
metaonly enum Boot.SysDiv |
![](../../../../../Arrow_up.png) |
System Clock Divider (SYSDIVSEL) value
XDCscript usage |
meta-domain |
values of type Boot.SysDiv
const Boot.Div_1;
// Divide by 1
const Boot.Div_2;
// Divide by 2
const Boot.Div_4;
// Divide by 4
const Boot.Div_8;
// Divide by 8
metaonly struct Boot.ModuleView |
![](../../../../../Arrow_up.png) |
XDCscript usage |
meta-domain |
var obj = new Boot.ModuleView;
obj.configureClocks = Bool ...
obj.OSCCLK = UInt ...
obj.SPLLIMULT = UInt ...
obj.SPLLFMULT = String ...
obj.SYSDIVSEL = String ...
obj.M3SSDIVSEL = String ...
obj.bootC28 = Bool ...
config Boot.configureClocks // module-wide |
![](../../../../../Arrow_up.png) |
Clock configuration flag, default is false
XDCscript usage |
meta-domain |
Boot.configureClocks = Bool false;
DETAILS
Set to true to configure the PLL and system and M3 subsystem clock
dividers.
C SYNOPSIS
metaonly config Boot.M3SSDIVSEL // module-wide |
![](../../../../../Arrow_up.png) |
M3 Subsystem Clock Divider (M3SSDIVSEL) value
XDCscript usage |
meta-domain |
metaonly config Boot.OSCCLK // module-wide |
![](../../../../../Arrow_up.png) |
OSCCLK input frequency to PLL, in MHz. Default is 20 MHz
XDCscript usage |
meta-domain |
DETAILS
This is the frequency of the oscillator clock (OSCCLK) input to the
PLL.
metaonly config Boot.SPLLFMULT // module-wide |
![](../../../../../Arrow_up.png) |
System PLL Fractional Multiplier (SPLLFMULT) value
XDCscript usage |
meta-domain |
metaonly config Boot.SPLLIMULT // module-wide |
![](../../../../../Arrow_up.png) |
System PLL Integer Multiplier (SPLLIMULT) value
XDCscript usage |
meta-domain |
metaonly config Boot.SYSDIVSEL // module-wide |
![](../../../../../Arrow_up.png) |
System Clock Divider (SYSDIVSEL) value
XDCscript usage |
meta-domain |
metaonly config Boot.bootC28 // module-wide |
![](../../../../../Arrow_up.png) |
Initiate booting of the C28 processor. Default is false
XDCscript usage |
meta-domain |
Boot.bootC28 = Bool false;
DETAILS
Set to true to enable the M3 to initiate boot of the C28.
If enabled, this will occur after the optional clock configuration
step, enabled by
configureClocks.
metaonly config Boot.bootFromFlash // module-wide |
![](../../../../../Arrow_up.png) |
Boot from FLASH flag. Default is true
XDCscript usage |
meta-domain |
Boot.bootFromFlash = Bool true;
DETAILS
Set to true to enable booting the M3 from FLASH.
metaonly config Boot.common$ // module-wide |
![](../../../../../Arrow_up.png) |
Common module configuration parameters
XDCscript usage |
meta-domain |
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.
metaonly config Boot.limpAbortFunction // module-wide |
![](../../../../../Arrow_up.png) |
Function to be called when Limp mode is detected
XDCscript usage |
meta-domain |
Boot.limpAbortFunction = Fxn undefined;
DETAILS
This function is called when the Boot module is about to configure
the PLL, but finds the device operating in Limp mode (i.e., the mode
when a missing OSCCLK input has been detected).
If this function is not specified by the application, a default
function will be used, which spins in an infinite loop.
metaonly config Boot.rovViewInfo // module-wide |
![](../../../../../Arrow_up.png) |
XDCscript usage |
meta-domain |
generated on Thu, 17 Nov 2011 02:03:45 GMT