342 lines
12 KiB
C
342 lines
12 KiB
C
/************************************************************************************
|
|
* arch/arm/src/stm32/stm32_rcc.h
|
|
*
|
|
* Copyright (C) 2009, 2011-2014 Gregory Nutt. All rights reserved.
|
|
* Author: Gregory Nutt <gnutt@nuttx.orgr>
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in
|
|
* the documentation and/or other materials provided with the
|
|
* distribution.
|
|
* 3. Neither the name NuttX nor the names of its contributors may be
|
|
* used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
|
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
************************************************************************************/
|
|
|
|
#ifndef __ARCH_ARM_SRC_STM32_STM32_RRC_H
|
|
#define __ARCH_ARM_SRC_STM32_STM32_RRC_H
|
|
|
|
/************************************************************************************
|
|
* Included Files
|
|
************************************************************************************/
|
|
|
|
#include <nuttx/config.h>
|
|
|
|
#include "up_arch.h"
|
|
#include "chip.h"
|
|
|
|
#if defined(CONFIG_STM32_STM32L15XX)
|
|
# include "chip/stm32l15xxx_rcc.h"
|
|
#elif defined(CONFIG_STM32_STM32F10XX)
|
|
# include "chip/stm32f10xxx_rcc.h"
|
|
#elif defined(CONFIG_STM32_STM32F20XX)
|
|
# include "chip/stm32f20xxx_rcc.h"
|
|
#elif defined(CONFIG_STM32_STM32F30XX)
|
|
# include "chip/stm32f30xxx_rcc.h"
|
|
#elif defined(CONFIG_STM32_STM32F37XX)
|
|
# include "chip/stm32f37xxx_rcc.h"
|
|
#elif defined(CONFIG_STM32_STM32F40XX)
|
|
# include "chip/stm32f40xxx_rcc.h"
|
|
#endif
|
|
|
|
/************************************************************************************
|
|
* Pre-processor Definitions
|
|
************************************************************************************/
|
|
|
|
#ifndef __ASSEMBLY__
|
|
|
|
#undef EXTERN
|
|
#if defined(__cplusplus)
|
|
#define EXTERN extern "C"
|
|
extern "C"
|
|
{
|
|
#else
|
|
#define EXTERN extern
|
|
#endif
|
|
|
|
/************************************************************************************
|
|
* Public Data
|
|
************************************************************************************/
|
|
|
|
/* This symbol references the Cortex-M3 vector table (as positioned by the linker
|
|
* script, ld.script or ld.script.dfu. The standard location for the vector table is
|
|
* at the beginning of FLASH at address 0x0800:0000. If we are using the STMicro DFU
|
|
* bootloader, then the vector table will be offset to a different location in FLASH
|
|
* and we will need to set the NVIC vector location to this alternative location.
|
|
*/
|
|
|
|
extern uint32_t _vectors[]; /* See stm32_vectors.S */
|
|
|
|
/************************************************************************************
|
|
* Inline Functions
|
|
************************************************************************************/
|
|
|
|
/************************************************************************************
|
|
* Name: stm32_mco1config
|
|
*
|
|
* Description:
|
|
* Selects the clock source to output on MCO1 pin (PA8). PA8 should be configured in
|
|
* alternate function mode.
|
|
*
|
|
* Input Parameters:
|
|
* source - One of the definitions for the RCC_CFGR_MCO1 definitions from
|
|
* chip/stm32f4xxxx_rcc.h {RCC_CFGR_MCO1_HSI, RCC_CFGR_MCO1_LSE,
|
|
* RCC_CFGR_MCO1_HSE, RCC_CFGR_MCO1_PLL}
|
|
* div - One of the definitions for the RCC_CFGR_MCO1PRE definitions from
|
|
* chip/stm32f4xxxx_rcc.h {RCC_CFGR_MCO1PRE_NONE, RCC_CFGR_MCO1PRE_DIV2,
|
|
* RCC_CFGR_MCO1PRE_DIV3, RCC_CFGR_MCO1PRE_DIV4, RCC_CFGR_MCO1PRE_DIV5}
|
|
*
|
|
* Returned Value:
|
|
* None
|
|
*
|
|
************************************************************************************/
|
|
|
|
#if defined(CONFIG_STM32_STM32F20XX) || defined(CONFIG_STM32_STM32F40XX)
|
|
static inline void stm32_mco1config(uint32_t source, uint32_t div)
|
|
{
|
|
uint32_t regval;
|
|
|
|
regval = getreg32(STM32_RCC_CFGR);
|
|
regval &= ~(RCC_CFGR_MCO1_MASK|RCC_CFGR_MCO1PRE_MASK);
|
|
regval |= (source | div);
|
|
putreg32(regval, STM32_RCC_CFGR);
|
|
}
|
|
#endif
|
|
|
|
/************************************************************************************
|
|
* Name: stm32_mcoconfig
|
|
*
|
|
* Description:
|
|
* Selects the clock source to output on MC pin (PA8) for stm32f10xxx.
|
|
* PA8 should be configured in alternate function mode.
|
|
*
|
|
* Input Parameters:
|
|
* source - One of the definitions for the RCC_CFGR_MCO definitions from
|
|
* chip/stm32f10xxx_rcc.h {RCC_CFGR_SYSCLK, RCC_CFGR_INTCLK, RCC_CFGR_EXTCLK,
|
|
* RCC_CFGR_PLLCLKd2, RCC_CFGR_PLL2CLK, RCC_CFGR_PLL3CLKd2, RCC_CFGR_XT1,
|
|
* RCC_CFGR_PLL3CLK}
|
|
*
|
|
* Returned Value:
|
|
* None
|
|
*
|
|
************************************************************************************/
|
|
|
|
#if defined(CONFIG_STM32_CONNECTIVITYLINE)
|
|
static inline void stm32_mcoconfig(uint32_t source)
|
|
{
|
|
uint32_t regval;
|
|
|
|
/* Set MCO source */
|
|
|
|
regval = getreg32(STM32_RCC_CFGR);
|
|
regval &= ~(RCC_CFGR_MCO_MASK);
|
|
regval |= (source & RCC_CFGR_MCO_MASK);
|
|
putreg32(regval, STM32_RCC_CFGR);
|
|
}
|
|
#endif
|
|
|
|
/************************************************************************************
|
|
* Name: stm32_mcodivconfig
|
|
*
|
|
* Description:
|
|
* Selects the clock source to output and clock divider on MC pin (PA4) for
|
|
* stm32l1xxx. PA4 should be configured in alternate function mode.
|
|
*
|
|
* Input Parameters:
|
|
* source - One of the definitions for the RCC_CFGR_MCOSEL definitions from
|
|
* chip/stm32l15xxx_rcc.h {RCC_CFGR_MCOSEL_DISABLED, RCC_CFGR_MCOSEL_SYSCLK,
|
|
* RCC_CFGR_MCOSEL_HSICLK, RCC_CFGR_MCOSEL_MSICLK, RCC_CFGR_MCOSEL_HSECLK,
|
|
* RCC_CFGR_MCOSEL_PLLCLK, RCC_CFGR_MCOSEL_LSICLK, RCC_CFGR_MCOSEL_LSECLK}
|
|
* divider - One of the definitions for the RCC_CFGR_MCOPRE definitions from
|
|
* chip/stm32l15xxx_rcc.h {RCC_CFGR_MCOPRE_DIV1, RCC_CFGR_MCOPRE_DIV2,
|
|
* RCC_CFGR_MCOPRE_DIV4, RCC_CFGR_MCOPRE_DIV8, RCC_CFGR_MCOPRE_DIV16}
|
|
*
|
|
* Returned Value:
|
|
* None
|
|
*
|
|
************************************************************************************/
|
|
|
|
#if defined(CONFIG_STM32_STM32L15XX)
|
|
static inline void stm32_mcodivconfig(uint32_t source, uint32_t divider)
|
|
{
|
|
uint32_t regval;
|
|
|
|
/* Set MCO source */
|
|
|
|
regval = getreg32(STM32_RCC_CFGR);
|
|
regval &= ~(RCC_CFGR_MCOSEL_MASK);
|
|
regval |= (source & RCC_CFGR_MCOSEL_MASK);
|
|
regval &= ~(RCC_CFGR_MCOPRE_MASK);
|
|
regval |= (divider & RCC_CFGR_MCOPRE_MASK);
|
|
putreg32(regval, STM32_RCC_CFGR);
|
|
}
|
|
#endif
|
|
|
|
/************************************************************************************
|
|
* Name: stm32_mco2config
|
|
*
|
|
* Description:
|
|
* Selects the clock source to output on MCO2 pin (PC9). PC9 should be configured in
|
|
* alternate function mode.
|
|
*
|
|
* Input Parameters:
|
|
* source - One of the definitions for the RCC_CFGR_MCO2 definitions from
|
|
* chip/stm32f4xxxx_rcc.h {RCC_CFGR_MCO2_SYSCLK, RCC_CFGR_MCO2_PLLI2S,
|
|
* RCC_CFGR_MCO2_HSE, RCC_CFGR_MCO2_PLL}
|
|
* div - One of the definitions for the RCC_CFGR_MCO2PRE definitions from
|
|
* chip/stm32f4xxxx_rcc.h {RCC_CFGR_MCO2PRE_NONE, RCC_CFGR_MCO2PRE_DIV2,
|
|
* RCC_CFGR_MCO2PRE_DIV3, RCC_CFGR_MCO2PRE_DIV4, RCC_CFGR_MCO2PRE_DIV5}
|
|
*
|
|
* Returned Value:
|
|
* None
|
|
*
|
|
************************************************************************************/
|
|
|
|
#if defined(CONFIG_STM32_STM32F20XX) || defined(CONFIG_STM32_STM32F40XX)
|
|
static inline void stm32_mco2config(uint32_t source, uint32_t div)
|
|
{
|
|
uint32_t regval;
|
|
|
|
regval = getreg32(STM32_RCC_CFGR);
|
|
regval &= ~(RCC_CFGR_MCO2_MASK|RCC_CFGR_MCO2PRE_MASK);
|
|
regval |= (source | div);
|
|
putreg32(regval, STM32_RCC_CFGR);
|
|
}
|
|
#endif
|
|
|
|
/************************************************************************************
|
|
* Public Function Prototypes
|
|
************************************************************************************/
|
|
|
|
/************************************************************************************
|
|
* Name: stm32_clockconfig
|
|
*
|
|
* Description:
|
|
* Called to establish the clock settings based on the values in board.h. This
|
|
* function (by default) will reset most everything, enable the PLL, and enable
|
|
* peripheral clocking for all periperipherals enabled in the NuttX configuration
|
|
* file.
|
|
*
|
|
* If CONFIG_ARCH_BOARD_STM32_CUSTOM_CLOCKCONFIG is defined, then clocking will
|
|
* be enabled by an externally provided, board-specific function called
|
|
* stm32_board_clockconfig().
|
|
*
|
|
* Input Parameters:
|
|
* None
|
|
*
|
|
* Returned Value:
|
|
* None
|
|
*
|
|
************************************************************************************/
|
|
|
|
void stm32_clockconfig(void);
|
|
|
|
/************************************************************************************
|
|
* Name: stm32_board_clockconfig
|
|
*
|
|
* Description:
|
|
* Any STM32 board may replace the "standard" board clock configuration logic with
|
|
* its own, custom clock cofiguration logic.
|
|
*
|
|
************************************************************************************/
|
|
|
|
#ifdef CONFIG_ARCH_BOARD_STM32_CUSTOM_CLOCKCONFIG
|
|
void stm32_board_clockconfig(void);
|
|
#endif
|
|
|
|
/************************************************************************************
|
|
* Name: stm32_clockenable
|
|
*
|
|
* Description:
|
|
* Re-enable the clock and restore the clock settings based on settings in board.h.
|
|
* This function is only available to support low-power modes of operation: When
|
|
* re-awakening from deep-sleep modes, it is necessary to re-enable/re-start the
|
|
* PLL
|
|
*
|
|
* This functional performs a subset of the operations performed by
|
|
* stm32_clockconfig(): It does not reset any devices, and it does not reset the
|
|
* currenlty enabled peripheral clocks.
|
|
*
|
|
* If CONFIG_ARCH_BOARD_STM32_CUSTOM_CLOCKCONFIG is defined, then clocking will
|
|
* be enabled by an externally provided, board-specific function called
|
|
* stm32_board_clockconfig().
|
|
*
|
|
* Input Parameters:
|
|
* None
|
|
*
|
|
* Returned Value:
|
|
* None
|
|
*
|
|
************************************************************************************/
|
|
|
|
#ifdef CONFIG_PM
|
|
void stm32_clockenable(void);
|
|
#endif
|
|
|
|
/************************************************************************************
|
|
* Name: stm32_rcc_enablelse
|
|
*
|
|
* Description:
|
|
* Enable the External Low-Speed (LSE) Oscillator and, if the RTC is
|
|
* configured, setup the LSE as the RTC clock source, and enable the RTC.
|
|
*
|
|
* For the STM32L15X family, this will also select the LSE as the clock source of
|
|
* the LCD.
|
|
*
|
|
* Input Parameters:
|
|
* None
|
|
*
|
|
* Returned Value:
|
|
* None
|
|
*
|
|
************************************************************************************/
|
|
|
|
void stm32_rcc_enablelse(void);
|
|
|
|
/****************************************************************************
|
|
* Name: stm32_rcc_enablelsi
|
|
*
|
|
* Description:
|
|
* Enable the Internal Low-Speed (LSI) RC Oscillator.
|
|
*
|
|
****************************************************************************/
|
|
|
|
void stm32_rcc_enablelsi(void);
|
|
|
|
/****************************************************************************
|
|
* Name: stm32_rcc_disablelsi
|
|
*
|
|
* Description:
|
|
* Disable the Internal Low-Speed (LSI) RC Oscillator.
|
|
*
|
|
****************************************************************************/
|
|
|
|
void stm32_rcc_disablelsi(void);
|
|
|
|
#undef EXTERN
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
#endif /* __ASSEMBLY__ */
|
|
#endif /* __ARCH_ARM_SRC_STM32_STM32_RRC_H */
|