Configuration of Functional Resources

Flag macros used to enhance functional resources. More...

Macros
#define	configBSP430_TIMER_CCACLK   0
#define	configBSP430_TIMER_CCACLK_HAL   indirectly defaulted
#define	configBSP430_TIMER_CCACLK_HAL_ISR   indirectly defaulted
#define	configBSP430_TIMER_CCACLK_HAL_CC0_ISR   indirectly defaulted
#define	configBSP430_TIMER_CCACLK_CLK_PORT   indirectly defaulted
#define	configBSP430_TIMER_CCACLK_CLK_PORT_HAL   indirectly defaulted 0
#define	configBSP430_TIMER_CCACLK_CC0_PORT   indirectly defaulted
#define	configBSP430_TIMER_CCACLK_CC0_PORT_HAL   indirectly defaulted 0
#define	configBSP430_TIMER_CCACLK_CC1_PORT   indirectly defaulted
#define	configBSP430_TIMER_CCACLK_CC1_PORT_HAL   indirectly defaulted 0
#define	configBSP430_UPTIME_TIMER_HAL_CC0_ISR   indirectly defaulted

Detailed Description

Flag macros used to enhance functional resources.

BSP430 provides an indirection facility that allows applications to use a functional peripheral handle while delegating selection of the specific peripheral to the application or platform. The following functional resources are supported by the infrastructure; options which influence secondary capabilities associated with those resources are documented below.

• configBSP430_UPTIME provides an uptime timer via BSP430_UPTIME_TIMER_PERIPH_HANDLE with the corresponding HPL, HAL, and primary interrupt capabilities enabled.

• configBSP430_TIMER_CCACLK provides a secondary timer via BSP430_TIMER_CCACLK_PERIPH_HANDLE. Associated with this are additional optional functional resources that identify ports on which the secondary clock source and capture/compare inputs can be accessed. See Platform-independent Secondary Timer Functionality for more details.

• configBSP430_CONSOLE provides a serial console via BSP430_CONSOLE_SERIAL_PERIPH_HANDLE with the corresponding HPL, HAL, and interrupt capabilities enabled. There are no optional functional resources associated with the console.

Macro Definition Documentation

#define configBSP430_TIMER_CCACLK   0

Define to true to indicate that the application or infrastructure would like to use a timer that supports using ACLK as a capture/compare input signal. The timer is identified by BSP430_TIMER_CCACLK_PERIPH_CPPID, and that macro is defined only if such a timer is available on the platform.

This timer is used by selecting an alternative clock source, then using the ACLK signal to capture the number of pulses on that source over a known period. For example, this is used to measure the relative speed of SMCLK and ACLK when manually trimming the FLL in iBSP430ucsTrimDCOCLKDIV_ni().

Note

Where possible, the selected timer should not conflict with the BSP430_UPTIME_TIMER_PERIPH_HANDLE. If this cannot be satisfied, the timer should still be made available; code that is concerned about the possibility of conflict should validate that the timers are different, which can be done at compile time:

#if BSP430_UPTIME_TIMER_PERIPH_CPPID == BSP430_TIMER_CCACLK_PERIPH_CPPID
#error Cannot use both
#endif // uptime == ccaclk

Note

Setting this flag only enables the HPL for BSP430_TIMER_CCACLK_PERIPH_HANDLE. To delegate control of additional capabilities see configBSP430_TIMER_CCACLK_HAL, configBSP430_TIMER_CCACLK_HAL_ISR, and configBSP430_TIMER_CCACLK_HAL_CC0_ISR.

C Preprocessor Only:

This macro may have a value that restricts its use to C preprocessor conditional directives.

Affects:

BSP430_TIMER_CCACLK

Defaulted:

The value here is superseded by previously encountered definitions.

#define configBSP430_TIMER_CCACLK_CC0_PORT   indirectly defaulted

Indirect control inclusion of the HPL for BSP430_TIMER_CCACLK_CC0_PORT_PERIPH_HANDLE

Propagated as default for configBSP430_HPL_PORT1 or other flag determined by BSP430_TIMER_CCACLK_CC0_PORT_PERIPH_CPPID.

You would use this if the source for the clock being timed was external to the microcontroller. See Sensors: HH10D for an example.

Note

Setting this flag only enables the HPL for BSP430_TIMER_CCACLK_CC0_PORT_PERIPH_HANDLE. To delegate control of additional capabilities see configBSP430_TIMER_CCACLK_CC0_PORT_HAL. Port ISR capabilities are not available through this interface.

C Preprocessor Only:

This macro may have a value that restricts its use to C preprocessor conditional directives.

Defaulted:

The value here is superseded by previously encountered definitions.

Affects:

BSP430_TIMER_CCACLK_CC0_PORT_PERIPH_HANDLE

See also

configBSP430_TIMER_CCACLK_CC0_PORT_HAL

#define configBSP430_TIMER_CCACLK_CC0_PORT_HAL   indirectly defaulted 0

Indirect control inclusion of the HAL for BSP430_TIMER_CCACLK_CC0_PORT_PERIPH_HANDLE

Propagated as default for configBSP430_HAL_PORT1 or other flag determined by BSP430_TIMER_CCACLK_CC0_PORT_PERIPH_CPPID.

You might need to use this to select the peripheral function for the clock source.

C Preprocessor Only:

This macro may have a value that restricts its use to C preprocessor conditional directives.

Defaulted:

The value here is superseded by previously encountered definitions.

#define configBSP430_TIMER_CCACLK_CC1_PORT   indirectly defaulted

Indirect control inclusion of the HPL for BSP430_TIMER_CCACLK_CC1_PORT_PERIPH_HANDLE

Propagated as default for configBSP430_HPL_PORT1 or other flag determined by BSP430_TIMER_CCACLK_CC1_PORT_PERIPH_CPPID.

You would use this if the source for the clock being timed was external to the microcontroller. See Sensors: HH10D for an example.

Note

Setting this flag only enables the HPL for BSP430_TIMER_CCACLK_CC1_PORT_PERIPH_HANDLE. To delegate control of additional capabilities see configBSP430_TIMER_CCACLK_CC1_PORT_HAL. Port ISR capabilities are not available through this interface.

C Preprocessor Only:

This macro may have a value that restricts its use to C preprocessor conditional directives.

Defaulted:

The value here is superseded by previously encountered definitions.

Affects:

BSP430_TIMER_CCACLK_CC1_PORT_PERIPH_HANDLE

See also

configBSP430_TIMER_CCACLK_CC1_PORT_HAL

#define configBSP430_TIMER_CCACLK_CC1_PORT_HAL   indirectly defaulted 0

Indirect control inclusion of the HAL for BSP430_TIMER_CCACLK_CC1_PORT_PERIPH_HANDLE

Propagated as default for configBSP430_HAL_PORT1 or other flag determined by BSP430_TIMER_CCACLK_CC1_PORT_PERIPH_CPPID.

You might need to use this to select the peripheral function for the clock source.

C Preprocessor Only:

This macro may have a value that restricts its use to C preprocessor conditional directives.

Defaulted:

The value here is superseded by previously encountered definitions.

#define configBSP430_TIMER_CCACLK_CLK_PORT   indirectly defaulted

Indirect control inclusion of the HPL for BSP430_TIMER_CCACLK_CLK_PORT_PERIPH_HANDLE

Propagated as default for configBSP430_HPL_PORT1 or other flag determined by BSP430_TIMER_CCACLK_CLK_PORT_PERIPH_CPPID.

You would use this if the source for the clock being timed was external to the microcontroller. See Sensors: HH10D for an example.

Note

Setting this flag only enables the HPL for BSP430_TIMER_CCACLK_CLK_PORT_PERIPH_HANDLE. To delegate control of additional capabilities see configBSP430_TIMER_CCACLK_CLK_PORT_HAL. Port ISR capabilities are not available through this interface.

C Preprocessor Only:

This macro may have a value that restricts its use to C preprocessor conditional directives.

Defaulted:

The value here is superseded by previously encountered definitions.

Affects:

BSP430_TIMER_CCACLK_CLK_PORT_PERIPH_HANDLE

See also

configBSP430_TIMER_CCACLK_CLK_PORT_HAL

#define configBSP430_TIMER_CCACLK_CLK_PORT_HAL   indirectly defaulted 0

Indirect control inclusion of the HAL for BSP430_TIMER_CCACLK_CLK_PORT_PERIPH_HANDLE

Propagated as default for configBSP430_HAL_PORT1 or other flag determined by BSP430_TIMER_CCACLK_CLK_PORT_PERIPH_CPPID.

You might need to use this to select the peripheral function for the clock source.

C Preprocessor Only:

This macro may have a value that restricts its use to C preprocessor conditional directives.

Defaulted:

The value here is superseded by previously encountered definitions.

#define configBSP430_TIMER_CCACLK_HAL   indirectly defaulted

Indirect control inclusion of the HAL interface for BSP430_TIMER_CCACLK_PERIPH_HANDLE.

Propagated as the default for configBSP430_HAL_TA0 or other timer peripheral determined by BSP430_TIMER_CCACLK_PERIPH_CPPID.

C Preprocessor Only:

This macro may have a value that restricts its use to C preprocessor conditional directives.

Defaulted:

The value here is superseded by previously encountered definitions.

Dependent Value:

The value is dependent on other settings.

#define configBSP430_TIMER_CCACLK_HAL_CC0_ISR   indirectly defaulted

Indirect control inclusion of the CC0 HAL interrupt handler for BSP430_TIMER_CCACLK_PERIPH_HANDLE.

Propagated as default for configBSP430_HAL_TA0_CC0_ISR or other timer peripheral determined by BSP430_TIMER_CCACLK_PERIPH_CPPID.

C Preprocessor Only:

This macro may have a value that restricts its use to C preprocessor conditional directives.

Defaulted:

The value here is superseded by previously encountered definitions.

Dependent Value:

The value is dependent on other settings.

#define configBSP430_TIMER_CCACLK_HAL_ISR   indirectly defaulted

Indirect control inclusion of the primary HAL interrupt handler for BSP430_TIMER_CCACLK_PERIPH_HANDLE.

Propagated as default for configBSP430_HAL_TA0_ISR or other timer peripheral determined by BSP430_TIMER_CCACLK_PERIPH_CPPID.

C Preprocessor Only:

This macro may have a value that restricts its use to C preprocessor conditional directives.

Defaulted:

The value here is superseded by previously encountered definitions.

Dependent Value:

The value is dependent on other settings.

#define configBSP430_UPTIME_TIMER_HAL_CC0_ISR   indirectly defaulted

Indirect control inclusion of the HAL CC0 interrupt handler for BSP430_UPTIME_TIMER_PERIPH_HANDLE

Propagated as default for configBSP430_HAL_TA0 or other flag determined by BSP430_UPTIME_TIMER_PERIPH_CPPID.

The dedicated CC0 ISR associated with the uptime timer is an ideal place to support timeslicing for an RTOS. Normally the CC0 interrupt HAL ISR is left unmanaged by BSP430.

Set this flag to 1 if you want BSP430 to provide an implementation for the CC0 interrupt for the HAL timer that underlies the implementation, thereby allowing BSP430 to dispatch CC0 events to callbacks registered in sBSP430halTIMER.

Set this flag to 0 (or leave it unset) if you don't need CC0 or intend to implement your own CC0 ISR.

C Preprocessor Only:

This macro may have a value that restricts its use to C preprocessor conditional directives.

Defaulted:

The value here is superseded by previously encountered definitions.

Dependent Value:

The value is dependent on other settings.