[freertos] / FreeRTOS / Demo / MSP430FR5969_LaunchPad / driverlib / MSP430FR5xx_6xx / cs.h

/* --COPYRIGHT--,BSD\r
 * Copyright (c) 2014, Texas Instruments Incorporated\r
 * All rights reserved.\r
 *\r
 * Redistribution and use in source and binary forms, with or without\r
 * modification, are permitted provided that the following conditions\r
 * are met:\r
 *\r
 * *  Redistributions of source code must retain the above copyright\r
 *    notice, this list of conditions and the following disclaimer.\r
 *\r
 * *  Redistributions in binary form must reproduce the above copyright\r
 *    notice, this list of conditions and the following disclaimer in the\r
 *    documentation and/or other materials provided with the distribution.\r
 *\r
 * *  Neither the name of Texas Instruments Incorporated nor the names of\r
 *    its contributors may be used to endorse or promote products derived\r
 *    from this software without specific prior written permission.\r
 *\r
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"\r
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,\r
 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR\r
 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR\r
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,\r
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,\r
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;\r
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,\r
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR\r
 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,\r
 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
 * --/COPYRIGHT--*/\r
//*****************************************************************************\r
//\r
// cs.h - Driver for the CS Module.\r
//\r
//*****************************************************************************\r
\r
#ifndef __MSP430WARE_CS_H__\r
#define __MSP430WARE_CS_H__\r
\r
#include "inc/hw_memmap.h"\r
\r
#if defined(__MSP430_HAS_CS__) || defined(__MSP430_HAS_SFR__)\r
\r
//*****************************************************************************\r
//\r
// If building with a C++ compiler, make all of the definitions in this header\r
// have a C binding.\r
//\r
//*****************************************************************************\r
#ifdef __cplusplus\r
extern "C"\r
{\r
#endif\r
\r
//*****************************************************************************\r
//\r
// The following are values that can be passed to the clockSourceDivider\r
// parameter for functions: CS_initClockSignal().\r
//\r
//*****************************************************************************\r
#define CS_CLOCK_DIVIDER_1                                              DIVM__1\r
#define CS_CLOCK_DIVIDER_2                                              DIVM__2\r
#define CS_CLOCK_DIVIDER_4                                              DIVM__4\r
#define CS_CLOCK_DIVIDER_8                                              DIVM__8\r
#define CS_CLOCK_DIVIDER_16                                            DIVM__16\r
#define CS_CLOCK_DIVIDER_32                                            DIVM__32\r
\r
//*****************************************************************************\r
//\r
// The following are values that can be passed to the selectClock parameter for\r
// functions: CS_enableClockRequest(), and CS_disableClockRequest(); the\r
// selectedClockSignal parameter for functions: CS_initClockSignal().\r
//\r
//*****************************************************************************\r
#define CS_ACLK                                                            0x01\r
#define CS_MCLK                                                            0x02\r
#define CS_SMCLK                                                           0x04\r
#define CS_MODOSC                                                   MODCLKREQEN\r
\r
//*****************************************************************************\r
//\r
// The following are values that can be passed to the clockSource parameter for\r
// functions: CS_initClockSignal().\r
//\r
//*****************************************************************************\r
#define CS_VLOCLK_SELECT                                           SELM__VLOCLK\r
#define CS_DCOCLK_SELECT                                           SELM__DCOCLK\r
#define CS_LFXTCLK_SELECT                                         SELM__LFXTCLK\r
#define CS_HFXTCLK_SELECT                                         SELM__HFXTCLK\r
#define CS_LFMODOSC_SELECT                                       SELM__LFMODOSC\r
#define CS_MODOSC_SELECT                                           SELM__MODOSC\r
\r
//*****************************************************************************\r
//\r
// The following are values that can be passed to the lfxtdrive parameter for\r
// functions: CS_turnOnLFXT(), and CS_turnOnLFXTWithTimeout().\r
//\r
//*****************************************************************************\r
#define CS_LFXT_DRIVE_0                                             LFXTDRIVE_0\r
#define CS_LFXT_DRIVE_1                                             LFXTDRIVE_1\r
#define CS_LFXT_DRIVE_2                                             LFXTDRIVE_2\r
#define CS_LFXT_DRIVE_3                                             LFXTDRIVE_3\r
\r
//*****************************************************************************\r
//\r
// The following are values that can be passed to the hfxtdrive parameter for\r
// functions: CS_turnOnHFXT(), and CS_turnOnHFXTWithTimeout().\r
//\r
//*****************************************************************************\r
#define CS_HFXT_DRIVE_4MHZ_8MHZ                                     HFXTDRIVE_0\r
#define CS_HFXT_DRIVE_8MHZ_16MHZ                                    HFXTDRIVE_1\r
#define CS_HFXT_DRIVE_16MHZ_24MHZ                                   HFXTDRIVE_2\r
#define CS_HFXT_DRIVE_24MHZ_32MHZ                                   HFXTDRIVE_3\r
\r
//*****************************************************************************\r
//\r
// The following are values that can be passed to the mask parameter for\r
// functions: CS_getFaultFlagStatus(), and CS_clearFaultFlag() as well as\r
// returned by the CS_getFaultFlagStatus() function.\r
//\r
//*****************************************************************************\r
#define CS_LFXTOFFG                                                    LFXTOFFG\r
#define CS_HFXTOFFG                                                    HFXTOFFG\r
\r
//*****************************************************************************\r
//\r
// The following are values that can be passed to the dcorsel parameter for\r
// functions: CS_setDCOFreq().\r
//\r
//*****************************************************************************\r
#define CS_DCORSEL_0                                                       0x00\r
#define CS_DCORSEL_1                                                    DCORSEL\r
\r
//*****************************************************************************\r
//\r
// The following are values that can be passed to the dcofsel parameter for\r
// functions: CS_setDCOFreq().\r
//\r
//*****************************************************************************\r
#define CS_DCOFSEL_0                                                  DCOFSEL_0\r
#define CS_DCOFSEL_1                                                  DCOFSEL_1\r
#define CS_DCOFSEL_2                                                  DCOFSEL_2\r
#define CS_DCOFSEL_3                                                  DCOFSEL_3\r
#define CS_DCOFSEL_4                                                  DCOFSEL_4\r
#define CS_DCOFSEL_5                                                  DCOFSEL_5\r
#define CS_DCOFSEL_6                                                  DCOFSEL_6\r
\r
//*****************************************************************************\r
//\r
// Prototypes for the APIs.\r
//\r
//*****************************************************************************\r
\r
//*****************************************************************************\r
//\r
//! \brief Sets the external clock source\r
//!\r
//! This function sets the external clock sources LFXT and HFXT crystal\r
//! oscillator frequency values. This function must be called if an external\r
//! crystal LFXT or HFXT is used and the user intends to call CS_getMCLK,\r
//! CS_getSMCLK, CS_getACLK and CS_turnOnLFXT, CS_LFXTByPass,\r
//! CS_turnOnLFXTWithTimeout, CS_LFXTByPassWithTimeout, CS_turnOnHFXT,\r
//! CS_HFXTByPass, CS_turnOnHFXTWithTimeout, CS_HFXTByPassWithTimeout.\r
//!\r
//! \param LFXTCLK_frequency is the LFXT crystal frequencies in Hz\r
//! \param HFXTCLK_frequency is the HFXT crystal frequencies in Hz\r
//!\r
//! \return None\r
//\r
//*****************************************************************************\r
extern void CS_setExternalClockSource(uint32_t LFXTCLK_frequency,\r
                                      uint32_t HFXTCLK_frequency);\r
\r
//*****************************************************************************\r
//\r
//! \brief Initializes clock signal\r
//!\r
//! This function initializes each of the clock signals. The user must ensure\r
//! that this function is called for each clock signal. If not, the default\r
//! state is assumed for the particular clock signal. Refer to MSP430ware\r
//! documentation for CS module or Device Family User's Guide for details of\r
//! default clock signal states.\r
//!\r
//! \param selectedClockSignal Selected clock signal\r
//!        Valid values are:\r
//!        - \b CS_ACLK\r
//!        - \b CS_MCLK\r
//!        - \b CS_SMCLK\r
//!        - \b CS_MODOSC\r
//! \param clockSource is the selected clock signal\r
//!        Valid values are:\r
//!        - \b CS_VLOCLK_SELECT\r
//!        - \b CS_DCOCLK_SELECT - [Not available for ACLK]\r
//!        - \b CS_LFXTCLK_SELECT\r
//!        - \b CS_HFXTCLK_SELECT - [Not available for ACLK]\r
//!        - \b CS_LFMODOSC_SELECT\r
//!        - \b CS_MODOSC_SELECT - [Not available for ACLK]\r
//! \param clockSourceDivider is the selected clock divider to calculate clock\r
//!        signal from clock source.\r
//!        Valid values are:\r
//!        - \b CS_CLOCK_DIVIDER_1 - [Default for ACLK]\r
//!        - \b CS_CLOCK_DIVIDER_2\r
//!        - \b CS_CLOCK_DIVIDER_4\r
//!        - \b CS_CLOCK_DIVIDER_8 - [Default for SMCLK and MCLK]\r
//!        - \b CS_CLOCK_DIVIDER_16\r
//!        - \b CS_CLOCK_DIVIDER_32\r
//!\r
//! Modified bits of \b CSCTL0 register, bits of \b CSCTL3 register and bits of\r
//! \b CSCTL2 register.\r
//!\r
//! \return None\r
//\r
//*****************************************************************************\r
extern void CS_initClockSignal(uint8_t selectedClockSignal,\r
                               uint16_t clockSource,\r
                               uint16_t clockSourceDivider);\r
\r
//*****************************************************************************\r
//\r
//! \brief Initializes the LFXT crystal in low frequency mode.\r
//!\r
//! Initializes the LFXT crystal oscillator in low frequency mode. Loops until\r
//! all oscillator fault flags are cleared, with no timeout. See the device-\r
//! specific data sheet for appropriate drive settings. IMPORTANT: User must\r
//! call CS_setExternalClockSource function to set frequency of external clocks\r
//! before calling this function.\r
//!\r
//! \param lfxtdrive is the target drive strength for the LFXT crystal\r
//!        oscillator.\r
//!        Valid values are:\r
//!        - \b CS_LFXT_DRIVE_0\r
//!        - \b CS_LFXT_DRIVE_1\r
//!        - \b CS_LFXT_DRIVE_2\r
//!        - \b CS_LFXT_DRIVE_3 [Default]\r
//!\r
//! Modified bits of \b CSCTL0 register, bits of \b CSCTL5 register, bits of \b\r
//! CSCTL4 register and bits of \b SFRIFG1 register.\r
//!\r
//! \return None\r
//\r
//*****************************************************************************\r
extern void CS_turnOnLFXT(uint16_t lfxtdrive);\r
\r
//*****************************************************************************\r
//\r
//! \brief Bypasses the LFXT crystal oscillator.\r
//!\r
//! Bypasses the LFXT crystal oscillator. Loops until all oscillator fault\r
//! flags are cleared, with no timeout. IMPORTANT: User must call\r
//! CS_setExternalClockSource function to set frequency of external clocks\r
//! before calling this function.\r
//!\r
//!\r
//! Modified bits of \b CSCTL0 register, bits of \b CSCTL5 register, bits of \b\r
//! CSCTL4 register and bits of \b SFRIFG register.\r
//!\r
//! \return None\r
//\r
//*****************************************************************************\r
extern void CS_bypassLFXT(void);\r
\r
//*****************************************************************************\r
//\r
//! \brief Initializes the LFXT crystal oscillator in low frequency mode with\r
//! timeout.\r
//!\r
//! Initializes the LFXT crystal oscillator in low frequency mode with timeout.\r
//! Loops until all oscillator fault flags are cleared or until a timeout\r
//! counter is decremented and equals to zero. See the device-specific\r
//! datasheet for appropriate drive settings. IMPORTANT: User must call\r
//! CS_setExternalClockSource to set frequency of external clocks before\r
//! calling this function.\r
//!\r
//! \param lfxtdrive is the target drive strength for the LFXT crystal\r
//!        oscillator.\r
//!        Valid values are:\r
//!        - \b CS_LFXT_DRIVE_0\r
//!        - \b CS_LFXT_DRIVE_1\r
//!        - \b CS_LFXT_DRIVE_2\r
//!        - \b CS_LFXT_DRIVE_3 [Default]\r
//! \param timeout is the count value that gets decremented every time the loop\r
//!        that clears oscillator fault flags gets executed.\r
//!\r
//! Modified bits of \b CSCTL0 register, bits of \b CSCTL5 register, bits of \b\r
//! CSCTL4 register and bits of \b SFRIFG1 register.\r
//!\r
//! \return STATUS_SUCCESS or STATUS_FAIL indicating if the LFXT crystal\r
//!         oscillator was initialized successfully\r
//\r
//*****************************************************************************\r
extern bool CS_turnOnLFXTWithTimeout(uint16_t lfxtdrive,\r
                                     uint32_t timeout);\r
\r
//*****************************************************************************\r
//\r
//! \brief Bypass the LFXT crystal oscillator with timeout.\r
//!\r
//! Bypasses the LFXT crystal oscillator with timeout. Loops until all\r
//! oscillator fault flags are cleared or until a timeout counter is\r
//! decremented and equals to zero. NOTE: User must call\r
//! CS_setExternalClockSource to set frequency of external clocks before\r
//! calling this function.\r
//!\r
//! \param timeout is the count value that gets decremented every time the loop\r
//!        that clears oscillator fault flags gets executed.\r
//!\r
//! Modified bits of \b CSCTL0 register, bits of \b CSCTL5 register, bits of \b\r
//! CSCTL4 register and bits of \b SFRIFG register.\r
//!\r
//! \return STATUS_SUCCESS or STATUS_FAIL\r
//\r
//*****************************************************************************\r
extern bool CS_bypassLFXTWithTimeout(uint32_t timeout);\r
\r
//*****************************************************************************\r
//\r
//! \brief Stops the LFXT oscillator using the LFXTOFF bit.\r
//!\r
//!\r
//! Modified bits of \b CSCTL4 register.\r
//!\r
//! \return None\r
//\r
//*****************************************************************************\r
extern void CS_turnOffLFXT(void);\r
\r
//*****************************************************************************\r
//\r
//! \brief Starts the HFXFT crystal\r
//!\r
//! Initializes the HFXT crystal oscillator, which supports crystal frequencies\r
//! between 0 MHz and 24 MHz, depending on the selected drive strength. Loops\r
//! until all oscillator fault flags are cleared, with no timeout. See the\r
//! device-specific data sheet for appropriate drive settings. NOTE: User must\r
//! call CS_setExternalClockSource to set frequency of external clocks before\r
//! calling this function.\r
//!\r
//! \param hfxtdrive is the target drive strength for the HFXT crystal\r
//!        oscillator.\r
//!        Valid values are:\r
//!        - \b CS_HFXT_DRIVE_4MHZ_8MHZ\r
//!        - \b CS_HFXT_DRIVE_8MHZ_16MHZ\r
//!        - \b CS_HFXT_DRIVE_16MHZ_24MHZ\r
//!        - \b CS_HFXT_DRIVE_24MHZ_32MHZ [Default]\r
//!\r
//! Modified bits of \b CSCTL5 register, bits of \b CSCTL4 register and bits of\r
//! \b SFRIFG1 register.\r
//!\r
//! \return None\r
//\r
//*****************************************************************************\r
extern void CS_turnOnHFXT(uint16_t hfxtdrive);\r
\r
//*****************************************************************************\r
//\r
//! \brief Bypasses the HFXT crystal oscillator\r
//!\r
//! Bypasses the HFXT crystal oscillator, which supports crystal frequencies\r
//! between 0 MHz and 24 MHz. Loops until all oscillator fault flags are\r
//! cleared, with no timeout.NOTE: User must call CS_setExternalClockSource to\r
//! set frequency of external clocks before calling this function.\r
//!\r
//!\r
//! Modified bits of \b CSCTL5 register, bits of \b CSCTL4 register and bits of\r
//! \b SFRIFG register.\r
//!\r
//! \return None\r
//\r
//*****************************************************************************\r
extern void CS_bypassHFXT(void);\r
\r
//*****************************************************************************\r
//\r
//! \brief Initializes the HFXT crystal oscillator with timeout.\r
//!\r
//! Initializes the HFXT crystal oscillator, which supports crystal frequencies\r
//! between 0 MHz and 24 MHz, depending on the selected drive strength. Loops\r
//! until all oscillator fault flags are cleared or until a timeout counter is\r
//! decremented and equals to zero. See the device-specific data sheet for\r
//! appropriate drive settings. NOTE: User must call CS_setExternalClockSource\r
//! to set frequency of external clocks before calling this function.\r
//!\r
//! \param hfxtdrive is the target drive strength for the HFXT crystal\r
//!        oscillator.\r
//!        Valid values are:\r
//!        - \b CS_HFXT_DRIVE_4MHZ_8MHZ\r
//!        - \b CS_HFXT_DRIVE_8MHZ_16MHZ\r
//!        - \b CS_HFXT_DRIVE_16MHZ_24MHZ\r
//!        - \b CS_HFXT_DRIVE_24MHZ_32MHZ [Default]\r
//! \param timeout is the count value that gets decremented every time the loop\r
//!        that clears oscillator fault flags gets executed.\r
//!\r
//! Modified bits of \b CSCTL5 register, bits of \b CSCTL4 register and bits of\r
//! \b SFRIFG1 register.\r
//!\r
//! \return STATUS_SUCCESS or STATUS_FAIL\r
//\r
//*****************************************************************************\r
extern bool CS_turnOnHFXTWithTimeout(uint16_t hfxtdrive,\r
                                     uint32_t timeout);\r
\r
//*****************************************************************************\r
//\r
//! \brief Bypasses the HFXT crustal oscillator with timeout\r
//!\r
//! Bypasses the HFXT crystal oscillator, which supports crystal frequencies\r
//! between 0 MHz and 24 MHz. Loops until all oscillator fault flags are\r
//! cleared or until a timeout counter is decremented and equals to zero. NOTE:\r
//! User must call CS_setExternalClockSource to set frequency of external\r
//! clocks before calling this function.\r
//!\r
//! \param timeout is the count value that gets decremented every time the loop\r
//!        that clears oscillator fault flags gets executed.\r
//!\r
//! Modified bits of \b CSCTL5 register, bits of \b CSCTL4 register and bits of\r
//! \b SFRIFG1 register.\r
//!\r
//! \return STATUS_SUCCESS or STATUS_FAIL\r
//\r
//*****************************************************************************\r
extern bool CS_bypassHFXTWithTimeout(uint32_t timeout);\r
\r
//*****************************************************************************\r
//\r
//! \brief Stops the HFXT oscillator using the HFXTOFF bit.\r
//!\r
//!\r
//! Modified bits of \b CSCTL4 register.\r
//!\r
//! \return None\r
//\r
//*****************************************************************************\r
extern void CS_turnOffHFXT(void);\r
\r
//*****************************************************************************\r
//\r
//! \brief Enables conditional module requests\r
//!\r
//! \param selectClock selects specific request enables.\r
//!        Valid values are:\r
//!        - \b CS_ACLK\r
//!        - \b CS_MCLK\r
//!        - \b CS_SMCLK\r
//!        - \b CS_MODOSC\r
//!\r
//! Modified bits of \b CSCTL6 register.\r
//!\r
//! \return None\r
//\r
//*****************************************************************************\r
extern void CS_enableClockRequest(uint8_t selectClock);\r
\r
//*****************************************************************************\r
//\r
//! \brief Disables conditional module requests\r
//!\r
//! \param selectClock selects specific request enables.\r
//!        Valid values are:\r
//!        - \b CS_ACLK\r
//!        - \b CS_MCLK\r
//!        - \b CS_SMCLK\r
//!        - \b CS_MODOSC\r
//!\r
//! Modified bits of \b CSCTL6 register.\r
//!\r
//! \return None\r
//\r
//*****************************************************************************\r
extern void CS_disableClockRequest(uint8_t selectClock);\r
\r
//*****************************************************************************\r
//\r
//! \brief Gets the current CS fault flag status.\r
//!\r
//! \param mask is the masked interrupt flag status to be returned. Mask\r
//!        parameter can be either any of the following selection.\r
//!        Mask value is the logical OR of any of the following:\r
//!        - \b CS_LFXTOFFG - LFXT oscillator fault flag\r
//!        - \b CS_HFXTOFFG - HFXT oscillator fault flag\r
//!\r
//! \return Logical OR of any of the following:\r
//!         - \b CS_LFXTOFFG LFXT oscillator fault flag\r
//!         - \b CS_HFXTOFFG HFXT oscillator fault flag\r
//!         \n indicating the status of the masked interrupts\r
//\r
//*****************************************************************************\r
extern uint8_t CS_getFaultFlagStatus(uint8_t mask);\r
\r
//*****************************************************************************\r
//\r
//! \brief Clears the current CS fault flag status for the masked bit.\r
//!\r
//! \param mask is the masked interrupt flag status to be returned. mask\r
//!        parameter can be any one of the following\r
//!        Mask value is the logical OR of any of the following:\r
//!        - \b CS_LFXTOFFG - LFXT oscillator fault flag\r
//!        - \b CS_HFXTOFFG - HFXT oscillator fault flag\r
//!\r
//! Modified bits of \b CSCTL5 register.\r
//!\r
//! \return None\r
//\r
//*****************************************************************************\r
extern void CS_clearFaultFlag(uint8_t mask);\r
\r
//*****************************************************************************\r
//\r
//! \brief Get the current ACLK frequency.\r
//!\r
//! If a oscillator fault is set, the frequency returned will be based on the\r
//! fail safe mechanism of CS module. The user of this API must ensure that\r
//! CS_externalClockSourceInit API was invoked before in case LFXT or HFXT is\r
//! being used.\r
//!\r
//!\r
//! \return Current ACLK frequency in Hz\r
//\r
//*****************************************************************************\r
extern uint32_t CS_getACLK(void);\r
\r
//*****************************************************************************\r
//\r
//! \brief Get the current SMCLK frequency.\r
//!\r
//! If a oscillator fault is set, the frequency returned will be based on the\r
//! fail safe mechanism of CS module. The user of this API must ensure that\r
//! CS_externalClockSourceInit API was invoked before in case LFXT or HFXT is\r
//! being used.\r
//!\r
//!\r
//! \return Current SMCLK frequency in Hz\r
//\r
//*****************************************************************************\r
extern uint32_t CS_getSMCLK(void);\r
\r
//*****************************************************************************\r
//\r
//! \brief Get the current MCLK frequency.\r
//!\r
//! If a oscillator fault is set, the frequency returned will be based on the\r
//! fail safe mechanism of CS module. The user of this API must ensure that\r
//! CS_externalClockSourceInit API was invoked before in case LFXT or HFXT is\r
//! being used.\r
//!\r
//!\r
//! \return Current MCLK frequency in Hz\r
//\r
//*****************************************************************************\r
extern uint32_t CS_getMCLK(void);\r
\r
//*****************************************************************************\r
//\r
//! \brief Turns off VLO\r
//!\r
//!\r
//! Modified bits of \b CSCTL4 register.\r
//!\r
//! \return None\r
//\r
//*****************************************************************************\r
extern void CS_turnOffVLO(void);\r
\r
//*****************************************************************************\r
//\r
//! \brief Clears all the Oscillator Flags\r
//!\r
//! \param timeout is the count value that gets decremented every time the loop\r
//!        that clears oscillator fault flags gets executed.\r
//!\r
//! Modified bits of \b CSCTL5 register and bits of \b SFRIFG1 register.\r
//!\r
//! \return the mask of the oscillator flag status\r
//\r
//*****************************************************************************\r
extern uint16_t CS_clearAllOscFlagsWithTimeout(uint32_t timeout);\r
\r
//*****************************************************************************\r
//\r
//! \brief Set DCO frequency\r
//!\r
//! \param dcorsel selects frequency range option.\r
//!        Valid values are:\r
//!        - \b CS_DCORSEL_0 [Default] - Low Frequency Option\r
//!        - \b CS_DCORSEL_1 - High Frequency Option\r
//! \param dcofsel selects valid frequency options based on dco frequency range\r
//!        selection (dcorsel)\r
//!        Valid values are:\r
//!        - \b CS_DCOFSEL_0 - Low frequency option 1MHz. High frequency option\r
//!           1MHz.\r
//!        - \b CS_DCOFSEL_1 - Low frequency option 2.67MHz. High frequency\r
//!           option 5.33MHz.\r
//!        - \b CS_DCOFSEL_2 - Low frequency option 3.33MHz. High frequency\r
//!           option 6.67MHz.\r
//!        - \b CS_DCOFSEL_3 - Low frequency option 4MHz. High frequency option\r
//!           8MHz.\r
//!        - \b CS_DCOFSEL_4 - Low frequency option 5.33MHz. High frequency\r
//!           option 16MHz.\r
//!        - \b CS_DCOFSEL_5 - Low frequency option 6.67MHz. High frequency\r
//!           option 20MHz.\r
//!        - \b CS_DCOFSEL_6 - Low frequency option 8MHz. High frequency option\r
//!           24MHz.\r
//!\r
//! \return None\r
//\r
//*****************************************************************************\r
extern void CS_setDCOFreq(uint16_t dcorsel,\r
                          uint16_t dcofsel);\r
\r
//*****************************************************************************\r
//\r
// Mark the end of the C bindings section for C++ compilers.\r
//\r
//*****************************************************************************\r
#ifdef __cplusplus\r
}\r
#endif\r
\r
#endif\r
#endif // __MSP430WARE_CS_H__\r