/* ChibiOS - Copyright (C) 2006..2018 Giovanni Di Sirio Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ /** * @file STM32F3xx/stm32_rcc.h * @brief RCC helper driver header. * @note This file requires definitions from the ST header file * @p stm32f30x.h. * * @addtogroup STM32F3xx_RCC * @{ */ #ifndef STM32_RCC_H #define STM32_RCC_H /*===========================================================================*/ /* Driver constants. */ /*===========================================================================*/ /*===========================================================================*/ /* Driver pre-compile time settings. */ /*===========================================================================*/ /*===========================================================================*/ /* Derived constants and error checks. */ /*===========================================================================*/ /*===========================================================================*/ /* Driver data structures and types. */ /*===========================================================================*/ /*===========================================================================*/ /* Driver macros. */ /*===========================================================================*/ /** * @name Generic RCC operations * @{ */ /** * @brief Enables the clock of one or more peripheral on the APB1 bus. * * @param[in] mask APB1 peripherals mask * @param[in] lp low power enable flag * * @api */ #define rccEnableAPB1(mask, lp) { \ RCC->APB1ENR |= (mask); \ (void)RCC->APB1ENR; \ } /** * @brief Disables the clock of one or more peripheral on the APB1 bus. * * @param[in] mask APB1 peripherals mask * * @api */ #define rccDisableAPB1(mask) { \ RCC->APB1ENR &= ~(mask); \ (void)RCC->APB1ENR; \ } /** * @brief Resets one or more peripheral on the APB1 bus. * * @param[in] mask APB1 peripherals mask * * @api */ #define rccResetAPB1(mask) { \ RCC->APB1RSTR |= (mask); \ RCC->APB1RSTR &= ~(mask); \ (void)RCC->APB1RSTR; \ } /** * @brief Enables the clock of one or more peripheral on the APB2 bus. * * @param[in] mask APB2 peripherals mask * @param[in] lp low power enable flag * * @api */ #define rccEnableAPB2(mask, lp) { \ RCC->APB2ENR |= (mask); \ (void)RCC->APB2ENR; \ } /** * @brief Disables the clock of one or more peripheral on the APB2 bus. * * @param[in] mask APB2 peripherals mask * * @api */ #define rccDisableAPB2(mask) { \ RCC->APB2ENR &= ~(mask); \ (void)RCC->APB2ENR; \ } /** * @brief Resets one or more peripheral on the APB2 bus. * * @param[in] mask APB2 peripherals mask * * @api */ #define rccResetAPB2(mask) { \ RCC->APB2RSTR |= (mask); \ RCC->APB2RSTR &= ~(mask); \ (void)RCC->APB2RSTR; \ } /** * @brief Enables the clock of one or more peripheral on the AHB bus. * * @param[in] mask AHB peripherals mask * @param[in] lp low power enable flag * * @api */ #define rccEnableAHB(mask, lp) { \ RCC->AHBENR |= (mask); \ (void)RCC->AHBENR; \ } /** * @brief Disables the clock of one or more peripheral on the AHB bus. * * @param[in] mask AHB peripherals mask * * @api */ #define rccDisableAHB(mask) { \ RCC->AHBENR &= ~(mask); \ (void)RCC->AHBENR; \ } /** * @brief Resets one or more peripheral on the AHB bus. * * @param[in] mask AHB peripherals mask * * @api */ #define rccResetAHB(mask) { \ RCC->AHBRSTR |= (mask); \ RCC->AHBRSTR &= ~(mask); \ (void)RCC->AHBRSTR; \ } /** @} */ /** * @name ADC peripherals specific RCC operations * @{ */ /** * @brief Enables the ADC1/ADC2 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #if defined(RCC_AHBENR_ADC12EN) || defined(__DOXYGEN__) #define rccEnableADC12(lp) rccEnableAHB(RCC_AHBENR_ADC12EN, lp) #else #define rccEnableADC12(lp) rccEnableAHB(RCC_AHBENR_ADC1EN, lp) #endif /** * @brief Disables the ADC1/ADC2 peripheral clock. * * @api */ #if defined(RCC_AHBENR_ADC12EN) || defined(__DOXYGEN__) #define rccDisableADC12() rccDisableAHB(RCC_AHBENR_ADC12EN) #else #define rccDisableADC12() rccDisableAHB(RCC_AHBENR_ADC1EN) #endif /** * @brief Resets the ADC1/ADC2 peripheral. * * @api */ #if defined(RCC_AHBRSTR_ADC12RST) || defined(__DOXYGEN__) #define rccResetADC12() rccResetAHB(RCC_AHBRSTR_ADC12RST) #else #define rccResetADC12() rccResetAHB(RCC_AHBRSTR_ADC1RST) #endif /** * @brief Enables the ADC3/ADC4 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #if defined(RCC_AHBENR_ADC34EN) || defined(__DOXYGEN__) #define rccEnableADC34(lp) rccEnableAHB(RCC_AHBENR_ADC34EN, lp) #else #define rccEnableADC34(lp) rccEnableAHB(RCC_AHBENR_ADC3EN, lp) #endif /** * @brief Disables the ADC3/ADC4 peripheral clock. * * @api */ #if defined(RCC_AHBENR_ADC34EN) || defined(__DOXYGEN__) #define rccDisableADC34() rccDisableAHB(RCC_AHBENR_ADC34EN) #else #define rccDisableADC34() rccDisableAHB(RCC_AHBENR_ADC3EN) #endif /** * @brief Resets the ADC3/ADC4 peripheral. * * @api */ #if defined(RCC_AHBRSTR_ADC34RST) || defined(__DOXYGEN__) #define rccResetADC34() rccResetAHB(RCC_AHBRSTR_ADC34RST) #else #define rccResetADC34() rccResetAHB(RCC_AHBRSTR_ADC3RST) #endif /** @} */ /** * @name DAC peripheral specific RCC operations * @{ */ /** * @brief Enables the DAC1 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableDAC1(lp) rccEnableAPB1(RCC_APB1ENR_DAC1EN, lp) /** * @brief Disables the DAC1 peripheral clock. * * @api */ #define rccDisableDAC1() rccDisableAPB1(RCC_APB1ENR_DAC1EN) /** * @brief Resets the DAC1 peripheral. * * @api */ #define rccResetDAC1() rccResetAPB1(RCC_APB1RSTR_DAC1RST) /** * @brief Enables the DAC1 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableDAC2(lp) rccEnableAPB1(RCC_APB1ENR_DAC2EN, lp) /** * @brief Disables the DAC1 peripheral clock. * * @api */ #define rccDisableDAC2() rccDisableAPB1(RCC_APB1ENR_DAC2EN) /** * @brief Resets the DAC1 peripheral. * * @api */ #define rccResetDAC2() rccResetAPB1(RCC_APB1RSTR_DAC2RST) /** @} */ /** * @name CAN peripherals specific RCC operations * @{ */ /** * @brief Enables the CAN1 peripheral clock. * @note The @p lp parameter is ignored in this family. * * @param[in] lp low power enable flag * * @api */ #define rccEnableCAN1(lp) rccEnableAPB1(RCC_APB1ENR_CANEN, lp) /** * @brief Disables the CAN1 peripheral clock. * * @api */ #define rccDisableCAN1() rccDisableAPB1(RCC_APB1ENR_CANEN) /** * @brief Resets the CAN1 peripheral. * * @api */ #define rccResetCAN1() rccResetAPB1(RCC_APB1RSTR_CANRST) /** @} */ /** * @name DMA peripheral specific RCC operations * @{ */ /** * @brief Enables the DMA1 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableDMA1(lp) rccEnableAHB(RCC_AHBENR_DMA1EN, lp) /** * @brief Disables the DMA1 peripheral clock. * * @api */ #define rccDisableDMA1() rccDisableAHB(RCC_AHBENR_DMA1EN) /** * @brief Resets the DMA1 peripheral. * * @api */ #define rccResetDMA1() rccResetAHB(RCC_AHBRSTR_DMA1RST) /** * @brief Enables the DMA2 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableDMA2(lp) rccEnableAHB(RCC_AHBENR_DMA2EN, lp) /** * @brief Disables the DMA2 peripheral clock. * * @api */ #define rccDisableDMA2() rccDisableAHB(RCC_AHBENR_DMA2EN) /** * @brief Resets the DMA2 peripheral. * * @api */ #define rccResetDMA2() rccResetAHB(RCC_AHBRSTR_DMA2RST) /** @} */ /** * @name PWR interface specific RCC operations * @{ */ /** * @brief Enables the PWR interface clock. * @note The @p lp parameter is ignored in this family. * * @param[in] lp low power enable flag * * @api */ #define rccEnablePWRInterface(lp) rccEnableAPB1(RCC_APB1ENR_PWREN, lp) /** * @brief Disables PWR interface clock. * * @api */ #define rccDisablePWRInterface() rccDisableAPB1(RCC_APB1ENR_PWREN) /** * @brief Resets the PWR interface. * * @api */ #define rccResetPWRInterface() rccResetAPB1(RCC_APB1RSTR_PWRRST) /** @} */ /** * @name I2C peripherals specific RCC operations * @{ */ /** * @brief Enables the I2C1 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableI2C1(lp) rccEnableAPB1(RCC_APB1ENR_I2C1EN, lp) /** * @brief Disables the I2C1 peripheral clock. * * @api */ #define rccDisableI2C1() rccDisableAPB1(RCC_APB1ENR_I2C1EN) /** * @brief Resets the I2C1 peripheral. * * @api */ #define rccResetI2C1() rccResetAPB1(RCC_APB1RSTR_I2C1RST) /** * @brief Enables the I2C2 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableI2C2(lp) rccEnableAPB1(RCC_APB1ENR_I2C2EN, lp) /** * @brief Disables the I2C2 peripheral clock. * * @api */ #define rccDisableI2C2() rccDisableAPB1(RCC_APB1ENR_I2C2EN) /** * @brief Resets the I2C2 peripheral. * * @api */ #define rccResetI2C2() rccResetAPB1(RCC_APB1RSTR_I2C2RST) /** @} */ /** * @name SPI peripherals specific RCC operations * @{ */ /** * @brief Enables the SPI1 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableSPI1(lp) rccEnableAPB2(RCC_APB2ENR_SPI1EN, lp) /** * @brief Disables the SPI1 peripheral clock. * * @api */ #define rccDisableSPI1() rccDisableAPB2(RCC_APB2ENR_SPI1EN) /** * @brief Resets the SPI1 peripheral. * * @api */ #define rccResetSPI1() rccResetAPB2(RCC_APB2RSTR_SPI1RST) /** * @brief Enables the SPI2 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableSPI2(lp) rccEnableAPB1(RCC_APB1ENR_SPI2EN, lp) /** * @brief Disables the SPI2 peripheral clock. * * @api */ #define rccDisableSPI2() rccDisableAPB1(RCC_APB1ENR_SPI2EN) /** * @brief Resets the SPI2 peripheral. * * @api */ #define rccResetSPI2() rccResetAPB1(RCC_APB1RSTR_SPI2RST) /** * @brief Enables the SPI3 peripheral clock. * @note The @p lp parameter is ignored in this family. * * @param[in] lp low power enable flag * * @api */ #define rccEnableSPI3(lp) rccEnableAPB1(RCC_APB1ENR_SPI3EN, lp) /** * @brief Disables the SPI3 peripheral clock. * * @api */ #define rccDisableSPI3() rccDisableAPB1(RCC_APB1ENR_SPI3EN) /** * @brief Resets the SPI3 peripheral. * * @api */ #define rccResetSPI3() rccResetAPB1(RCC_APB1RSTR_SPI3RST) /** @} */ /** * @name TIM peripherals specific RCC operations * @{ */ /** * @brief Enables the TIM1 peripheral clock. * @note The @p lp parameter is ignored in this family. * * @param[in] lp low power enable flag * * @api */ #define rccEnableTIM1(lp) rccEnableAPB2(RCC_APB2ENR_TIM1EN, lp) /** * @brief Disables the TIM1 peripheral clock. * * @api */ #define rccDisableTIM1() rccDisableAPB2(RCC_APB2ENR_TIM1EN) /** * @brief Resets the TIM1 peripheral. * * @api */ #define rccResetTIM1() rccResetAPB2(RCC_APB2RSTR_TIM1RST) /** * @brief Enables the TIM2 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableTIM2(lp) rccEnableAPB1(RCC_APB1ENR_TIM2EN, lp) /** * @brief Disables the TIM2 peripheral clock. * * @api */ #define rccDisableTIM2() rccDisableAPB1(RCC_APB1ENR_TIM2EN) /** * @brief Resets the TIM2 peripheral. * * @api */ #define rccResetTIM2() rccResetAPB1(RCC_APB1RSTR_TIM2RST) /** * @brief Enables the TIM3 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableTIM3(lp) rccEnableAPB1(RCC_APB1ENR_TIM3EN, lp) /** * @brief Disables the TIM3 peripheral clock. * * @api */ #define rccDisableTIM3() rccDisableAPB1(RCC_APB1ENR_TIM3EN) /** * @brief Resets the TIM3 peripheral. * * @api */ #define rccResetTIM3() rccResetAPB1(RCC_APB1RSTR_TIM3RST) /** * @brief Enables the TIM4 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableTIM4(lp) rccEnableAPB1(RCC_APB1ENR_TIM4EN, lp) /** * @brief Disables the TIM4 peripheral clock. * * @api */ #define rccDisableTIM4() rccDisableAPB1(RCC_APB1ENR_TIM4EN) /** * @brief Resets the TIM4 peripheral. * * @api */ #define rccResetTIM4() rccResetAPB1(RCC_APB1RSTR_TIM4RST) /** * @brief Enables the TIM6 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableTIM6(lp) rccEnableAPB1(RCC_APB1ENR_TIM6EN, lp) /** * @brief Disables the TIM6 peripheral clock. * * @api */ #define rccDisableTIM6() rccDisableAPB1(RCC_APB1ENR_TIM6EN) /** * @brief Resets the TIM6 peripheral. * * @api */ #define rccResetTIM6() rccResetAPB1(RCC_APB1RSTR_TIM6RST) /** * @brief Enables the TIM7 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableTIM7(lp) rccEnableAPB1(RCC_APB1ENR_TIM7EN, lp) /** * @brief Disables the TIM7 peripheral clock. * * @api */ #define rccDisableTIM7() rccDisableAPB1(RCC_APB1ENR_TIM7EN) /** * @brief Resets the TIM7 peripheral. * * @api */ #define rccResetTIM7() rccResetAPB1(RCC_APB1RSTR_TIM7RST) /** * @brief Enables the TIM8 peripheral clock. * @note The @p lp parameter is ignored in this family. * * @param[in] lp low power enable flag * * @api */ #define rccEnableTIM8(lp) rccEnableAPB2(RCC_APB2ENR_TIM8EN, lp) /** * @brief Disables the TIM8 peripheral clock. * * @api */ #define rccDisableTIM8() rccDisableAPB2(RCC_APB2ENR_TIM8EN) /** * @brief Resets the TIM8 peripheral. * * @api */ #define rccResetTIM8() rccResetAPB2(RCC_APB2RSTR_TIM8RST) /** * @brief Enables the TIM15 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableTIM15(lp) rccEnableAPB2(RCC_APB2ENR_TIM15EN, lp) /** * @brief Disables the TIM15 peripheral clock. * * @api */ #define rccDisableTIM15() rccDisableAPB2(RCC_APB2ENR_TIM15EN) /** * @brief Resets the TIM15 peripheral. * * @api */ #define rccResetTIM15() rccResetAPB2(RCC_APB2RSTR_TIM15RST) /** * @brief Enables the TIM16 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableTIM16(lp) rccEnableAPB2(RCC_APB2ENR_TIM16EN, lp) /** * @brief Disables the TIM16 peripheral clock. * * @api */ #define rccDisableTIM16() rccDisableAPB2(RCC_APB2ENR_TIM16EN) /** * @brief Resets the TIM16 peripheral. * * @api */ #define rccResetTIM16() rccResetAPB2(RCC_APB2RSTR_TIM16RST) /** * @brief Enables the TIM17 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableTIM17(lp) rccEnableAPB2(RCC_APB2ENR_TIM17EN, lp) /** * @brief Disables the TIM17 peripheral clock. * * @api */ #define rccDisableTIM17() rccDisableAPB2(RCC_APB2ENR_TIM17EN) /** * @brief Resets the TIM17 peripheral. * * @api */ #define rccResetTIM17() rccResetAPB2(RCC_APB2RSTR_TIM17RST) /** * @brief Enables the TIM20 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableTIM20(lp) rccEnableAPB2(RCC_APB2ENR_TIM20EN, lp) /** * @brief Disables the TIM20 peripheral clock. * * @api */ #define rccDisableTIM20(lp) rccDisableAPB2(RCC_APB2ENR_TIM20EN) /** * @brief Resets the TIM20 peripheral. * * @api */ #define rccResetTIM20() rccResetAPB2(RCC_APB2RSTR_TIM20RST) /** @} */ /** * @name HRTIM peripheral specific RCC operations * @{ */ /** * @brief Enables the HRTIM1 peripheral clock. * @note The @p lp parameter is ignored in this family. * * @param[in] lp low power enable flag * * @api */ #define rccEnableHRTIM1(lp) rccEnableAPB2(RCC_APB2ENR_HRTIM1EN, lp) /** * @brief Disables the HRTIM1 peripheral clock. * * @api */ #define rccDisableHRTIM1(lp) rccDisableAPB2(RCC_APB2ENR_HRTIM1EN) /** * @brief Resets the HRTIM1 peripheral. * * @api */ #define rccResetHRTIM1() rccResetAPB2(RCC_APB2RSTR_HRTIM1RST) /** @} */ /** * @name USART/UART peripherals specific RCC operations * @{ */ /** * @brief Enables the USART1 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableUSART1(lp) rccEnableAPB2(RCC_APB2ENR_USART1EN, lp) /** * @brief Disables the USART1 peripheral clock. * * @api */ #define rccDisableUSART1() rccDisableAPB2(RCC_APB2ENR_USART1EN) /** * @brief Resets the USART1 peripheral. * * @api */ #define rccResetUSART1() rccResetAPB2(RCC_APB2RSTR_USART1RST) /** * @brief Enables the USART2 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableUSART2(lp) rccEnableAPB1(RCC_APB1ENR_USART2EN, lp) /** * @brief Disables the USART2 peripheral clock. * * @api */ #define rccDisableUSART2() rccDisableAPB1(RCC_APB1ENR_USART2EN) /** * @brief Resets the USART2 peripheral. * * @api */ #define rccResetUSART2() rccResetAPB1(RCC_APB1RSTR_USART2RST) /** * @brief Enables the USART3 peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableUSART3(lp) rccEnableAPB1(RCC_APB1ENR_USART3EN, lp) /** * @brief Disables the USART3 peripheral clock. * * @api */ #define rccDisableUSART3() rccDisableAPB1(RCC_APB1ENR_USART3EN) /** * @brief Resets the USART3 peripheral. * * @api */ #define rccResetUSART3() rccResetAPB1(RCC_APB1RSTR_USART3RST) /** * @brief Enables the UART4 peripheral clock. * @note The @p lp parameter is ignored in this family. * * @param[in] lp low power enable flag * * @api */ #define rccEnableUART4(lp) rccEnableAPB1(RCC_APB1ENR_UART4EN, lp) /** * @brief Disables the UART4 peripheral clock. * * @api */ #define rccDisableUART4() rccDisableAPB1(RCC_APB1ENR_UART4EN) /** * @brief Resets the UART4 peripheral. * * @api */ #define rccResetUART4() rccResetAPB1(RCC_APB1RSTR_UART4RST) /** * @brief Enables the UART5 peripheral clock. * @note The @p lp parameter is ignored in this family. * * @param[in] lp low power enable flag * * @api */ #define rccEnableUART5(lp) rccEnableAPB1(RCC_APB1ENR_UART5EN, lp) /** * @brief Disables the UART5 peripheral clock. * * @api */ #define rccDisableUART5() rccDisableAPB1(RCC_APB1ENR_UART5EN) /** * @brief Resets the UART5 peripheral. * * @api */ #define rccResetUART5() rccResetAPB1(RCC_APB1RSTR_UART5RST) /** @} */ /** * @name USB peripheral specific RCC operations * @{ */ /** * @brief Enables the USB peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableUSB(lp) rccEnableAPB1(RCC_APB1ENR_USBEN, lp) /** * @brief Disables the USB peripheral clock. * * @api */ #define rccDisableUSB() rccDisableAPB1(RCC_APB1ENR_USBEN) /** * @brief Resets the USB peripheral. * * @api */ #define rccResetUSB() rccResetAPB1(RCC_APB1RSTR_USBRST) /** @} */ /** * @name FSMC peripherals specific RCC operations * @{ */ /** * @brief Enables the FMC peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableFSMC(lp) rccEnableAHB(RCC_AHBENR_FMCEN, lp) /** * @brief Disables the FMC peripheral clock. * * @api */ #define rccDisableFSMC() rccDisableAHB(RCC_AHBENR_FMCEN) /** @} */ /** * @name CRC peripherals specific RCC operations * @{ */ /** * @brief Enables the CRC peripheral clock. * * @param[in] lp low power enable flag * * @api */ #define rccEnableCRC(lp) rccEnableAHB(RCC_AHBENR_CRCEN, lp) /** * @brief Disables the CRC peripheral clock. * * @api */ #define rccDisableCRC() rccDisableAHB(RCC_AHBENR_CRCEN) /** @} */ /*===========================================================================*/ /* External declarations. */ /*===========================================================================*/ #ifdef __cplusplus extern "C" { #endif #ifdef __cplusplus } #endif #endif /* STM32_RCC_H */ /** @} */