This module is used to define the ACLK, SMCLK, and HSMCLK frequencies in effect when BIOS_start() is called at the end of main(). It also provides runtime functions that can be used to query or set individual clock frequencies.

If the application defines values for these three clocks, the application is responsible for setting up the clocks to the corresponding frequencies. This module will simply hold the values specified, for reference by other SYS/BIOS modules, or for query by the application at runtime.

If the application configuration specifies (in its .cfg file) a value for one of these three clock frequencies, it must specify values for all three clocks; if it does not, a build error will be thrown.

If the application does not define values for these clocks, the values will default either to the device reset values, or the boost values setup by the Boot module (ti.sysbios.family.arm.msp432.init.Boot). For example, if the application does not configure values for ClockFreq, and does not turn off the Boot module's default frequency boost, then the Boot module boost frequencies are used.

If the application does not configure values for ClockFreq, and *does* turn off the Boot module's frequency boost (see snippet below), then the default reset frequency values will be used.

      var Boot = xdc.module('ti.sysbios.family.arm.msp432.init.Boot');
      Boot.configureClocks = false;

Currently the reset and Boot module boost values are fixed, as shown below.

The default reset values are:

      ACLK  = 32768 Hz
      SMCLK = 3 MHz
      HSMCLK = 3 MHz

The default Boot module boost values are:

      ACLK  = 32768 Hz
      SMCLK = 12 MHz
      HSMCLK = 24 MHz

Note: This module only tracks the ACLK, SMCLK, and HSMCLK values. It does not track the CPU clock (MCLK) frequency. MCLK can be configured and queried with the BIOS module. For example, to configure the CPU frequency:

var BIOS = xdc.useModule('ti.sysbios.BIOS'); BIOS.cpuFreq.lo = 48000000; BIOS.cpuFreq.hi = 0;

Calling Context

Function	Hwi	Swi	Task	Main	Startup
getFrequency	Y	Y	Y	Y	Y
setFrequency	Y	Y	Y	Y	Y
Definitions: Hwi: API is callable from a Hwi thread. Swi: API is callable from a Swi thread. Task: API is callable from a Task thread. Main: API is callable from main(). Startup: API is callable during any module startup.