/** ****************************************************************************** * @file Examples_LL/RTC/RTC_Alarm/Src/main.c * @author MCD Application Team * @brief This example code shows how to use STM32F4xx RTC LL API to configure * an alarm. * Peripheral initialization done using LL unitary services functions. ****************************************************************************** * @attention * *

© Copyright (c) 2017 STMicroelectronics. * All rights reserved.

* * This software component is licensed by ST under BSD 3-Clause license, * the "License"; You may not use this file except in compliance with the * License. You may obtain a copy of the License at: * opensource.org/licenses/BSD-3-Clause * ****************************************************************************** */ /* Includes ------------------------------------------------------------------*/ #include "main.h" /** @addtogroup STM32F4xx_LL_Examples * @{ */ /** @addtogroup RTC_Alarm * @{ */ /* Private typedef -----------------------------------------------------------*/ /* Private define ------------------------------------------------------------*/ /* Oscillator time-out values */ #define LSI_TIMEOUT_VALUE ((uint32_t)2) /* 2 ms */ #define LSE_TIMEOUT_VALUE ((uint32_t)5000) /* 5 s */ #define RTC_TIMEOUT_VALUE ((uint32_t)1000) /* 1 s */ /* Defines related to Clock configuration */ /* Uncomment to enable the adequate Clock Source */ #define RTC_CLOCK_SOURCE_LSI /*#define RTC_CLOCK_SOURCE_LSE*/ #ifdef RTC_CLOCK_SOURCE_LSI /* ck_apre=LSIFreq/(ASYNC prediv + 1) with LSIFreq=32 kHz RC */ #define RTC_ASYNCH_PREDIV ((uint32_t)0x7F) /* ck_spre=ck_apre/(SYNC prediv + 1) = 1 Hz */ #define RTC_SYNCH_PREDIV ((uint32_t)0x00F9) #endif #ifdef RTC_CLOCK_SOURCE_LSE /* ck_apre=LSEFreq/(ASYNC prediv + 1) = 256Hz with LSEFreq=32768Hz */ #define RTC_ASYNCH_PREDIV ((uint32_t)0x7F) /* ck_spre=ck_apre/(SYNC prediv + 1) = 1 Hz */ #define RTC_SYNCH_PREDIV ((uint32_t)0x00FF) #endif /* Private macro -------------------------------------------------------------*/ /* Private variables ---------------------------------------------------------*/ /* Buffers used for displaying Time and Date */ uint8_t aShowTime[50] = {0}; uint8_t aShowDate[50] = {0}; #if (USE_TIMEOUT == 1) uint32_t Timeout = 0; /* Variable used for Timeout management */ #endif /* USE_TIMEOUT */ /* Private function prototypes -----------------------------------------------*/ void SystemClock_Config(void); void Configure_RTC(void); void Configure_RTC_Alarm(void); uint32_t Enter_RTC_InitMode(void); uint32_t Exit_RTC_InitMode(void); uint32_t WaitForSynchro_RTC(void); void Show_RTC_Calendar(void); void LED_Init(void); void LED_On(void); void LED_Blinking(uint32_t Period); /* Private functions ---------------------------------------------------------*/ /** * @brief Main program * @param None * @retval None */ int main(void) { /* Configure the system clock to 100 MHz */ SystemClock_Config(); /* Initialize LED2 */ LED_Init(); /*##-1- Configure the RTC peripheral #######################################*/ Configure_RTC(); /*##-2- Configure Alarm ####################################################*/ /* Configure RTC Alarm */ Configure_RTC_Alarm(); /* Infinite loop */ while (1) { /*##-3- Display the updated Time and Date ################################*/ Show_RTC_Calendar(); } } /** * @brief Configure RTC. * @note Peripheral configuration is minimal configuration from reset values. * Thus, some useless LL unitary functions calls below are provided as * commented examples - setting is default configuration from reset. * @param None * @retval None */ void Configure_RTC(void) { /*##-1- Enables the PWR Clock and Enables access to the backup domain #######*/ /* To change the source clock of the RTC feature (LSE, LSI), you have to: - Enable the power clock - Enable write access to configure the RTC clock source (to be done once after reset). - Reset the Back up Domain - Configure the needed RTC clock source */ LL_APB1_GRP1_EnableClock(LL_APB1_GRP1_PERIPH_PWR); LL_PWR_EnableBkUpAccess(); /*##-2- Configure LSE/LSI as RTC clock source ###############################*/ #ifdef RTC_CLOCK_SOURCE_LSE /* Enable LSE only if disabled.*/ if (LL_RCC_LSE_IsReady() == 0) { LL_RCC_ForceBackupDomainReset(); LL_RCC_ReleaseBackupDomainReset(); LL_RCC_LSE_Enable(); #if (USE_TIMEOUT == 1) Timeout = LSE_TIMEOUT_VALUE; #endif /* USE_TIMEOUT */ while (LL_RCC_LSE_IsReady() != 1) { #if (USE_TIMEOUT == 1) if (LL_SYSTICK_IsActiveCounterFlag()) { Timeout --; } if (Timeout == 0) { /* LSE activation error */ LED_Blinking(LED_BLINK_ERROR); } #endif /* USE_TIMEOUT */ } LL_RCC_SetRTCClockSource(LL_RCC_RTC_CLKSOURCE_LSE); /*##-3- Enable RTC peripheral Clocks #######################################*/ /* Enable RTC Clock */ LL_RCC_EnableRTC(); } #elif defined(RTC_CLOCK_SOURCE_LSI) /* Enable LSI */ LL_RCC_LSI_Enable(); #if (USE_TIMEOUT == 1) Timeout = LSI_TIMEOUT_VALUE; #endif /* USE_TIMEOUT */ while (LL_RCC_LSI_IsReady() != 1) { #if (USE_TIMEOUT == 1) if (LL_SYSTICK_IsActiveCounterFlag()) { Timeout --; } if (Timeout == 0) { /* LSI activation error */ LED_Blinking(LED_BLINK_ERROR); } #endif /* USE_TIMEOUT */ } LL_RCC_ForceBackupDomainReset(); LL_RCC_ReleaseBackupDomainReset(); LL_RCC_SetRTCClockSource(LL_RCC_RTC_CLKSOURCE_LSI); /*##-3- Enable RTC peripheral Clocks #######################################*/ /* Enable RTC Clock */ LL_RCC_EnableRTC(); #else #error "configure clock for RTC" #endif /*##-4- Disable RTC registers write protection ##############################*/ LL_RTC_DisableWriteProtection(RTC); /*##-5- Enter in initialization mode #######################################*/ if (Enter_RTC_InitMode() != RTC_ERROR_NONE) { /* Initialization Error */ LED_Blinking(LED_BLINK_ERROR); } /*##-6- Configure RTC ######################################################*/ /* Configure RTC prescaler and RTC data registers */ /* Set Hour Format */ LL_RTC_SetHourFormat(RTC, LL_RTC_HOURFORMAT_AMPM); /* Set Asynch Prediv (value according to source clock) */ LL_RTC_SetAsynchPrescaler(RTC, RTC_ASYNCH_PREDIV); /* Set Synch Prediv (value according to source clock) */ LL_RTC_SetSynchPrescaler(RTC, RTC_SYNCH_PREDIV); /* Set OutPut */ /* Reset value is LL_RTC_ALARMOUT_DISABLE */ //LL_RTC_SetAlarmOutEvent(RTC, LL_RTC_ALARMOUT_DISABLE); /* Set OutPutPolarity */ /* Reset value is LL_RTC_OUTPUTPOLARITY_PIN_HIGH */ //LL_RTC_SetOutputPolarity(RTC, LL_RTC_OUTPUTPOLARITY_PIN_HIGH); /* Set OutPutType */ /* Reset value is LL_RTC_ALARM_OUTPUTTYPE_OPENDRAIN */ //LL_RTC_SetAlarmOutputType(RTC, LL_RTC_ALARM_OUTPUTTYPE_OPENDRAIN); /*##-7- Exit of initialization mode #######################################*/ Exit_RTC_InitMode(); /*##-8- Enable RTC registers write protection #############################*/ LL_RTC_EnableWriteProtection(RTC); } /** * @brief Configure the current time and date. * @note Peripheral configuration is minimal configuration from reset values. * Thus, some useless LL unitary functions calls below are provided as * commented examples - setting is default configuration from reset. * @param None * @param None * @retval None */ void Configure_RTC_Alarm(void) { /*##-1- Disable RTC registers write protection ############################*/ LL_RTC_DisableWriteProtection(RTC); /*##-2- Enter in initialization mode ######################################*/ if (Enter_RTC_InitMode() != RTC_ERROR_NONE) { /* Initialization Error */ LED_Blinking(LED_BLINK_ERROR); } /*##-3- Configure the Date ################################################*/ /* Note: __LL_RTC_CONVERT_BIN2BCD helper macro can be used if user wants to*/ /* provide directly the decimal value: */ /* LL_RTC_DATE_Config(RTC, LL_RTC_WEEKDAY_MONDAY, */ /* __LL_RTC_CONVERT_BIN2BCD(31), (...)) */ /* Set Date: Friday December 29th 2016 */ LL_RTC_DATE_Config(RTC, LL_RTC_WEEKDAY_FRIDAY, 0x29, LL_RTC_MONTH_DECEMBER, 0x16); /*##-4- Configure the Time ################################################*/ /* Set Time: 11:59:55 PM*/ LL_RTC_TIME_Config(RTC, LL_RTC_TIME_FORMAT_PM, 0x11, 0x59, 0x55); /*##-5- Configure the RTC Alarm peripheral #################################*/ /* Set Alarm to 12:00:25 RTC Alarm Generation: Alarm on Hours, Minutes and Seconds (ignore date/weekday)*/ LL_RTC_ALMA_ConfigTime(RTC, LL_RTC_ALMA_TIME_FORMAT_AM, 0x12, 0x00, 0x25); LL_RTC_ALMA_SetMask(RTC, LL_RTC_ALMA_MASK_DATEWEEKDAY); /* Note: following interfaces may be used but not needed as default values are used.*/ //LL_RTC_ALMA_DisableWeekday(RTC); //LL_RTC_ALMA_SetDay(RTC, 0x01); /* Enable Alarm*/ LL_RTC_ALMA_Enable(RTC); /* Clear the Alarm interrupt pending bit */ LL_RTC_ClearFlag_ALRA(RTC); /* Enable IT Alarm */ LL_RTC_EnableIT_ALRA(RTC); /* RTC Alarm Interrupt Configuration: EXTI configuration */ LL_EXTI_EnableIT_0_31(LL_EXTI_LINE_17); LL_EXTI_EnableRisingTrig_0_31(LL_EXTI_LINE_17); /*##-6- Configure the NVIC for RTC Alarm ###############################*/ NVIC_SetPriority(RTC_Alarm_IRQn, 0x0F); NVIC_EnableIRQ(RTC_Alarm_IRQn); /*##-7- Exit of initialization mode #######################################*/ if (Exit_RTC_InitMode() != RTC_ERROR_NONE) { /* Initialization Error */ LED_Blinking(LED_BLINK_ERROR); } /*##-8- Enable RTC registers write protection #############################*/ LL_RTC_EnableWriteProtection(RTC); } /** * @brief Enter in initialization mode * @note In this mode, the calendar counter is stopped and its value can be updated * @param None * @retval RTC_ERROR_NONE if no error */ uint32_t Enter_RTC_InitMode(void) { /* Set Initialization mode */ LL_RTC_EnableInitMode(RTC); #if (USE_TIMEOUT == 1) Timeout = RTC_TIMEOUT_VALUE; #endif /* USE_TIMEOUT */ /* Check if the Initialization mode is set */ while (LL_RTC_IsActiveFlag_INIT(RTC) != 1) { #if (USE_TIMEOUT == 1) if (LL_SYSTICK_IsActiveCounterFlag()) { Timeout --; } if (Timeout == 0) { return RTC_ERROR_TIMEOUT; } #endif /* USE_TIMEOUT */ } return RTC_ERROR_NONE; } /** * @brief Exit Initialization mode * @param None * @retval RTC_ERROR_NONE if no error */ uint32_t Exit_RTC_InitMode(void) { LL_RTC_DisableInitMode(RTC); /* Wait for synchro */ /* Note: Needed only if Shadow registers is enabled */ /* LL_RTC_IsShadowRegBypassEnabled function can be used */ return (WaitForSynchro_RTC()); } /** * @brief Wait until the RTC Time and Date registers (RTC_TR and RTC_DR) are * synchronized with RTC APB clock. * @param None * @retval RTC_ERROR_NONE if no error (RTC_ERROR_TIMEOUT will occur if RTC is * not synchronized) */ uint32_t WaitForSynchro_RTC(void) { /* Clear RSF flag */ LL_RTC_ClearFlag_RS(RTC); #if (USE_TIMEOUT == 1) Timeout = RTC_TIMEOUT_VALUE; #endif /* USE_TIMEOUT */ /* Wait the registers to be synchronised */ while(LL_RTC_IsActiveFlag_RS(RTC) != 1) { #if (USE_TIMEOUT == 1) if (LL_SYSTICK_IsActiveCounterFlag()) { Timeout --; } if (Timeout == 0) { return RTC_ERROR_TIMEOUT; } #endif /* USE_TIMEOUT */ } return RTC_ERROR_NONE; } /** * @brief Display the current time and date. * @param None * @retval None */ void Show_RTC_Calendar(void) { /* Note: need to convert in decimal value in using __LL_RTC_CONVERT_BCD2BIN helper macro */ /* Display time Format : hh:mm:ss */ sprintf((char*)aShowTime,"%.2d:%.2d:%.2d", __LL_RTC_CONVERT_BCD2BIN(LL_RTC_TIME_GetHour(RTC)), __LL_RTC_CONVERT_BCD2BIN(LL_RTC_TIME_GetMinute(RTC)), __LL_RTC_CONVERT_BCD2BIN(LL_RTC_TIME_GetSecond(RTC))); /* Display date Format : mm-dd-yy */ sprintf((char*)aShowDate,"%.2d-%.2d-%.2d", __LL_RTC_CONVERT_BCD2BIN(LL_RTC_DATE_GetMonth(RTC)), __LL_RTC_CONVERT_BCD2BIN(LL_RTC_DATE_GetDay(RTC)), 2000 + __LL_RTC_CONVERT_BCD2BIN(LL_RTC_DATE_GetYear(RTC))); } /** * @brief Initialize LED2. * @param None * @retval None */ void LED_Init(void) { /* Enable the LED2 Clock */ LED2_GPIO_CLK_ENABLE(); /* Configure IO in output push-pull mode to drive external LED2 */ LL_GPIO_SetPinMode(LED2_GPIO_PORT, LED2_PIN, LL_GPIO_MODE_OUTPUT); /* Reset value is LL_GPIO_OUTPUT_PUSHPULL */ //LL_GPIO_SetPinOutputType(LED2_GPIO_PORT, LED2_PIN, LL_GPIO_OUTPUT_PUSHPULL); /* Reset value is LL_GPIO_SPEED_FREQ_LOW */ //LL_GPIO_SetPinSpeed(LED2_GPIO_PORT, LED2_PIN, LL_GPIO_SPEED_FREQ_LOW); /* Reset value is LL_GPIO_PULL_NO */ //LL_GPIO_SetPinPull(LED2_GPIO_PORT, LED2_PIN, LL_GPIO_PULL_NO); } /** * @brief Turn-on LED2. * @param None * @retval None */ void LED_On(void) { /* Turn LED2 on */ LL_GPIO_SetOutputPin(LED2_GPIO_PORT, LED2_PIN); } /** * @brief Set LED2 to Blinking mode for an infinite loop (toggle period based on value provided as input parameter). * @param Period : Period of time (in ms) between each togg ling of LED * This parameter can be user defined values. Pre-defined values used in that example are : * @arg LED_BLINK_FAST : Fast Blinking * @arg LED_BLINK_SLOW : Slow Blinking * @arg LED_BLINK_ERROR : Error specific Blinking * @retval None */ void LED_Blinking(uint32_t Period) { /* Toggle IO in an infinite loop */ while (1) { LL_GPIO_TogglePin(LED2_GPIO_PORT, LED2_PIN); LL_mDelay(Period); } } /** * @brief System Clock Configuration * The system Clock is configured as follow : * System Clock source = PLL (HSE) * SYSCLK(Hz) = 100000000 * HCLK(Hz) = 100000000 * AHB Prescaler = 1 * APB1 Prescaler = 2 * APB2 Prescaler = 1 * HSE Frequency(Hz) = 8000000 * PLL_M = 8 * PLL_N = 400 * PLL_P = 4 * VDD(V) = 3.3 * Main regulator output voltage = Scale1 mode * Flash Latency(WS) = 3 * @param None * @retval None */ void SystemClock_Config(void) { /* Enable HSE oscillator */ LL_RCC_HSE_EnableBypass(); LL_RCC_HSE_Enable(); while(LL_RCC_HSE_IsReady() != 1) { }; /* Set FLASH latency */ LL_FLASH_SetLatency(LL_FLASH_LATENCY_3); /* Main PLL configuration and activation */ LL_RCC_PLL_ConfigDomain_SYS(LL_RCC_PLLSOURCE_HSE, LL_RCC_PLLM_DIV_8, 400, LL_RCC_PLLP_DIV_4); LL_RCC_PLL_Enable(); while(LL_RCC_PLL_IsReady() != 1) { }; /* Sysclk activation on the main PLL */ LL_RCC_SetAHBPrescaler(LL_RCC_SYSCLK_DIV_1); LL_RCC_SetSysClkSource(LL_RCC_SYS_CLKSOURCE_PLL); while(LL_RCC_GetSysClkSource() != LL_RCC_SYS_CLKSOURCE_STATUS_PLL) { }; /* Set APB1 & APB2 prescaler */ LL_RCC_SetAPB1Prescaler(LL_RCC_APB1_DIV_2); LL_RCC_SetAPB2Prescaler(LL_RCC_APB2_DIV_1); /* Set systick to 1ms */ SysTick_Config(100000000 / 1000); /* Update CMSIS variable (which can be updated also through SystemCoreClockUpdate function) */ SystemCoreClock = 100000000; } /******************************************************************************/ /* USER IRQ HANDLER TREATMENT */ /******************************************************************************/ /** * @brief Alarm callback * @param None * @retval None */ void Alarm_Callback(void) { /* Turn LED2 on: Alarm generation */ LED_On(); } #ifdef USE_FULL_ASSERT /** * @brief Reports the name of the source file and the source line number * where the assert_param error has occurred. * @param file: pointer to the source file name * @param line: assert_param error line source number * @retval None */ void assert_failed(uint8_t *file, uint32_t line) { /* User can add his own implementation to report the file name and line number, ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */ /* Infinite loop */ while (1) { } } #endif /** * @} */ /** * @} */ /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/