BSP430  20141115
Board Support Package for MSP430 microcontrollers
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Modules Pages
Macros
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.

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.