Bob Seque / mbed-dev

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of mbed-dev by mbed official

targets/hal/TARGET_STM/TARGET_STM32F3/rtc_api.c@48:b854a29e778d, 2016-01-12 (annotated)

Committer:
mbed_official
Date:
Tue Jan 12 09:45:14 2016 +0000
Revision:
48:b854a29e778d
Parent:
34:bb6061527455 
Synchronized with git revision 26e3c619834959fb5e3b3094c197b9e1cf65b31d



Full URL: https://github.com/mbedmicro/mbed/commit/26e3c619834959fb5e3b3094c197b9e1cf65b31d/



Need to keep PWR_CLK_ENABLE and LSE LSI oscillator configuration.

Just skip the HAL_RTC_Init in case INITS flag is already set.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 0:9b334a45a8ff 1 /* mbed Microcontroller Library
bogdanm 0:9b334a45a8ff 2 *******************************************************************************
bogdanm 0:9b334a45a8ff 3 * Copyright (c) 2014, STMicroelectronics
bogdanm 0:9b334a45a8ff 4 * All rights reserved.
bogdanm 0:9b334a45a8ff 5 *
bogdanm 0:9b334a45a8ff 6 * Redistribution and use in source and binary forms, with or without
bogdanm 0:9b334a45a8ff 7 * modification, are permitted provided that the following conditions are met:
bogdanm 0:9b334a45a8ff 8 *
bogdanm 0:9b334a45a8ff 9 * 1. Redistributions of source code must retain the above copyright notice,
bogdanm 0:9b334a45a8ff 10 * this list of conditions and the following disclaimer.
bogdanm 0:9b334a45a8ff 11 * 2. Redistributions in binary form must reproduce the above copyright notice,
bogdanm 0:9b334a45a8ff 12 * this list of conditions and the following disclaimer in the documentation
bogdanm 0:9b334a45a8ff 13 * and/or other materials provided with the distribution.
bogdanm 0:9b334a45a8ff 14 * 3. Neither the name of STMicroelectronics nor the names of its contributors
bogdanm 0:9b334a45a8ff 15 * may be used to endorse or promote products derived from this software
bogdanm 0:9b334a45a8ff 16 * without specific prior written permission.
bogdanm 0:9b334a45a8ff 17 *
bogdanm 0:9b334a45a8ff 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
bogdanm 0:9b334a45a8ff 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
bogdanm 0:9b334a45a8ff 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
bogdanm 0:9b334a45a8ff 21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
bogdanm 0:9b334a45a8ff 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
bogdanm 0:9b334a45a8ff 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
bogdanm 0:9b334a45a8ff 24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
bogdanm 0:9b334a45a8ff 25 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
bogdanm 0:9b334a45a8ff 26 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
bogdanm 0:9b334a45a8ff 27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
bogdanm 0:9b334a45a8ff 28 *******************************************************************************
bogdanm 0:9b334a45a8ff 29 */
bogdanm 0:9b334a45a8ff 30 #include "rtc_api.h"
bogdanm 0:9b334a45a8ff 31
bogdanm 0:9b334a45a8ff 32 #if DEVICE_RTC
bogdanm 0:9b334a45a8ff 33
bogdanm 0:9b334a45a8ff 34 #include "mbed_error.h"
bogdanm 0:9b334a45a8ff 35
bogdanm 0:9b334a45a8ff 36 static int rtc_inited = 0;
bogdanm 0:9b334a45a8ff 37
bogdanm 0:9b334a45a8ff 38 static RTC_HandleTypeDef RtcHandle;
bogdanm 0:9b334a45a8ff 39
bogdanm 0:9b334a45a8ff 40 void rtc_init(void)
bogdanm 0:9b334a45a8ff 41 {
bogdanm 0:9b334a45a8ff 42 RCC_OscInitTypeDef RCC_OscInitStruct;
bogdanm 0:9b334a45a8ff 43 uint32_t rtc_freq = 0;
bogdanm 0:9b334a45a8ff 44
bogdanm 0:9b334a45a8ff 45 if (rtc_inited) return;
bogdanm 0:9b334a45a8ff 46 rtc_inited = 1;
bogdanm 0:9b334a45a8ff 47
bogdanm 0:9b334a45a8ff 48 RtcHandle.Instance = RTC;
bogdanm 0:9b334a45a8ff 49
bogdanm 0:9b334a45a8ff 50 // Enable Power clock
bogdanm 0:9b334a45a8ff 51 __PWR_CLK_ENABLE();
bogdanm 0:9b334a45a8ff 52
bogdanm 0:9b334a45a8ff 53 // Enable access to Backup domain
bogdanm 0:9b334a45a8ff 54 HAL_PWR_EnableBkUpAccess();
bogdanm 0:9b334a45a8ff 55
bogdanm 0:9b334a45a8ff 56 // Reset Backup domain
bogdanm 0:9b334a45a8ff 57 __HAL_RCC_BACKUPRESET_FORCE();
bogdanm 0:9b334a45a8ff 58 __HAL_RCC_BACKUPRESET_RELEASE();
bogdanm 0:9b334a45a8ff 59
bogdanm 0:9b334a45a8ff 60 // Enable LSE Oscillator
bogdanm 0:9b334a45a8ff 61 RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_LSE;
bogdanm 0:9b334a45a8ff 62 RCC_OscInitStruct.PLL.PLLState = RCC_PLL_NONE; /* Mandatory, otherwise the PLL is reconfigured! */
bogdanm 0:9b334a45a8ff 63 RCC_OscInitStruct.LSEState = RCC_LSE_ON; /* External 32.768 kHz clock on OSC_IN/OSC_OUT */
bogdanm 0:9b334a45a8ff 64 if (HAL_RCC_OscConfig(&RCC_OscInitStruct) == HAL_OK) {
bogdanm 0:9b334a45a8ff 65 // Connect LSE to RTC
bogdanm 0:9b334a45a8ff 66 __HAL_RCC_RTC_CONFIG(RCC_RTCCLKSOURCE_LSE);
bogdanm 0:9b334a45a8ff 67 rtc_freq = LSE_VALUE;
bogdanm 0:9b334a45a8ff 68 } else {
bogdanm 0:9b334a45a8ff 69 // Enable LSI clock
bogdanm 0:9b334a45a8ff 70 RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_LSI | RCC_OSCILLATORTYPE_LSE;
bogdanm 0:9b334a45a8ff 71 RCC_OscInitStruct.PLL.PLLState = RCC_PLL_NONE; // Mandatory, otherwise the PLL is reconfigured!
bogdanm 0:9b334a45a8ff 72 RCC_OscInitStruct.LSEState = RCC_LSE_OFF;
bogdanm 0:9b334a45a8ff 73 RCC_OscInitStruct.LSIState = RCC_LSI_ON;
bogdanm 0:9b334a45a8ff 74 if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK) {
bogdanm 0:9b334a45a8ff 75 error("RTC error: LSI clock initialization failed.");
bogdanm 0:9b334a45a8ff 76 }
bogdanm 0:9b334a45a8ff 77 // Connect LSI to RTC
bogdanm 0:9b334a45a8ff 78 __HAL_RCC_RTC_CONFIG(RCC_RTCCLKSOURCE_LSI);
bogdanm 0:9b334a45a8ff 79 // Note: The LSI clock can be measured precisely using a timer input capture.
bogdanm 0:9b334a45a8ff 80 rtc_freq = LSI_VALUE;
bogdanm 0:9b334a45a8ff 81 }
bogdanm 0:9b334a45a8ff 82
mbed_official 48:b854a29e778d 83 // Check if RTC is already initialized
mbed_official 48:b854a29e778d 84 if ((RTC->ISR & RTC_ISR_INITS) == RTC_ISR_INITS) return;
mbed_official 48:b854a29e778d 85
bogdanm 0:9b334a45a8ff 86 // Enable RTC
bogdanm 0:9b334a45a8ff 87 __HAL_RCC_RTC_ENABLE();
bogdanm 0:9b334a45a8ff 88
bogdanm 0:9b334a45a8ff 89 RtcHandle.Init.HourFormat = RTC_HOURFORMAT_24;
bogdanm 0:9b334a45a8ff 90 RtcHandle.Init.AsynchPrediv = 127;
bogdanm 0:9b334a45a8ff 91 RtcHandle.Init.SynchPrediv = (rtc_freq / 128) - 1;
bogdanm 0:9b334a45a8ff 92 RtcHandle.Init.OutPut = RTC_OUTPUT_DISABLE;
bogdanm 0:9b334a45a8ff 93 RtcHandle.Init.OutPutPolarity = RTC_OUTPUT_POLARITY_HIGH;
bogdanm 0:9b334a45a8ff 94 RtcHandle.Init.OutPutType = RTC_OUTPUT_TYPE_OPENDRAIN;
bogdanm 0:9b334a45a8ff 95
bogdanm 0:9b334a45a8ff 96 if (HAL_RTC_Init(&RtcHandle) != HAL_OK) {
bogdanm 0:9b334a45a8ff 97 error("RTC error: RTC initialization failed.");
bogdanm 0:9b334a45a8ff 98 }
bogdanm 0:9b334a45a8ff 99 }
bogdanm 0:9b334a45a8ff 100
bogdanm 0:9b334a45a8ff 101 void rtc_free(void)
bogdanm 0:9b334a45a8ff 102 {
bogdanm 0:9b334a45a8ff 103 // Enable Power clock
bogdanm 0:9b334a45a8ff 104 __PWR_CLK_ENABLE();
bogdanm 0:9b334a45a8ff 105
bogdanm 0:9b334a45a8ff 106 // Enable access to Backup domain
bogdanm 0:9b334a45a8ff 107 HAL_PWR_EnableBkUpAccess();
bogdanm 0:9b334a45a8ff 108
bogdanm 0:9b334a45a8ff 109 // Reset Backup domain
bogdanm 0:9b334a45a8ff 110 __HAL_RCC_BACKUPRESET_FORCE();
bogdanm 0:9b334a45a8ff 111 __HAL_RCC_BACKUPRESET_RELEASE();
bogdanm 0:9b334a45a8ff 112
bogdanm 0:9b334a45a8ff 113 // Disable access to Backup domain
bogdanm 0:9b334a45a8ff 114 HAL_PWR_DisableBkUpAccess();
bogdanm 0:9b334a45a8ff 115
bogdanm 0:9b334a45a8ff 116 // Disable LSI and LSE clocks
bogdanm 0:9b334a45a8ff 117 RCC_OscInitTypeDef RCC_OscInitStruct;
bogdanm 0:9b334a45a8ff 118 RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_LSI | RCC_OSCILLATORTYPE_LSE;
bogdanm 0:9b334a45a8ff 119 RCC_OscInitStruct.PLL.PLLState = RCC_PLL_NONE;
bogdanm 0:9b334a45a8ff 120 RCC_OscInitStruct.LSIState = RCC_LSI_OFF;
bogdanm 0:9b334a45a8ff 121 RCC_OscInitStruct.LSEState = RCC_LSE_OFF;
bogdanm 0:9b334a45a8ff 122 HAL_RCC_OscConfig(&RCC_OscInitStruct);
bogdanm 0:9b334a45a8ff 123
bogdanm 0:9b334a45a8ff 124 rtc_inited = 0;
bogdanm 0:9b334a45a8ff 125 }
bogdanm 0:9b334a45a8ff 126
bogdanm 0:9b334a45a8ff 127 int rtc_isenabled(void)
bogdanm 0:9b334a45a8ff 128 {
bogdanm 0:9b334a45a8ff 129 return rtc_inited;
bogdanm 0:9b334a45a8ff 130 }
bogdanm 0:9b334a45a8ff 131
bogdanm 0:9b334a45a8ff 132 /*
bogdanm 0:9b334a45a8ff 133 RTC Registers
bogdanm 0:9b334a45a8ff 134 RTC_WeekDay 1=monday, 2=tuesday, ..., 7=sunday
bogdanm 0:9b334a45a8ff 135 RTC_Month 1=january, 2=february, ..., 12=december
bogdanm 0:9b334a45a8ff 136 RTC_Date day of the month 1-31
bogdanm 0:9b334a45a8ff 137 RTC_Year year 0-99
bogdanm 0:9b334a45a8ff 138 struct tm
bogdanm 0:9b334a45a8ff 139 tm_sec seconds after the minute 0-61
bogdanm 0:9b334a45a8ff 140 tm_min minutes after the hour 0-59
bogdanm 0:9b334a45a8ff 141 tm_hour hours since midnight 0-23
bogdanm 0:9b334a45a8ff 142 tm_mday day of the month 1-31
bogdanm 0:9b334a45a8ff 143 tm_mon months since January 0-11
bogdanm 0:9b334a45a8ff 144 tm_year years since 1900
bogdanm 0:9b334a45a8ff 145 tm_wday days since Sunday 0-6
bogdanm 0:9b334a45a8ff 146 tm_yday days since January 1 0-365
bogdanm 0:9b334a45a8ff 147 tm_isdst Daylight Saving Time flag
bogdanm 0:9b334a45a8ff 148 */
bogdanm 0:9b334a45a8ff 149 time_t rtc_read(void)
bogdanm 0:9b334a45a8ff 150 {
bogdanm 0:9b334a45a8ff 151 RTC_DateTypeDef dateStruct;
bogdanm 0:9b334a45a8ff 152 RTC_TimeTypeDef timeStruct;
bogdanm 0:9b334a45a8ff 153 struct tm timeinfo;
bogdanm 0:9b334a45a8ff 154
bogdanm 0:9b334a45a8ff 155 RtcHandle.Instance = RTC;
bogdanm 0:9b334a45a8ff 156
bogdanm 0:9b334a45a8ff 157 // Read actual date and time
bogdanm 0:9b334a45a8ff 158 // Warning: the time must be read first!
bogdanm 0:9b334a45a8ff 159 HAL_RTC_GetTime(&RtcHandle, &timeStruct, FORMAT_BIN);
bogdanm 0:9b334a45a8ff 160 HAL_RTC_GetDate(&RtcHandle, &dateStruct, FORMAT_BIN);
bogdanm 0:9b334a45a8ff 161
bogdanm 0:9b334a45a8ff 162 // Setup a tm structure based on the RTC
bogdanm 0:9b334a45a8ff 163 timeinfo.tm_wday = dateStruct.WeekDay;
bogdanm 0:9b334a45a8ff 164 timeinfo.tm_mon = dateStruct.Month - 1;
bogdanm 0:9b334a45a8ff 165 timeinfo.tm_mday = dateStruct.Date;
bogdanm 0:9b334a45a8ff 166 timeinfo.tm_year = dateStruct.Year + 100;
bogdanm 0:9b334a45a8ff 167 timeinfo.tm_hour = timeStruct.Hours;
bogdanm 0:9b334a45a8ff 168 timeinfo.tm_min = timeStruct.Minutes;
bogdanm 0:9b334a45a8ff 169 timeinfo.tm_sec = timeStruct.Seconds;
bogdanm 0:9b334a45a8ff 170
bogdanm 0:9b334a45a8ff 171 // Convert to timestamp
bogdanm 0:9b334a45a8ff 172 time_t t = mktime(&timeinfo);
bogdanm 0:9b334a45a8ff 173
bogdanm 0:9b334a45a8ff 174 return t;
bogdanm 0:9b334a45a8ff 175 }
bogdanm 0:9b334a45a8ff 176
bogdanm 0:9b334a45a8ff 177 void rtc_write(time_t t)
bogdanm 0:9b334a45a8ff 178 {
bogdanm 0:9b334a45a8ff 179 RTC_DateTypeDef dateStruct;
bogdanm 0:9b334a45a8ff 180 RTC_TimeTypeDef timeStruct;
bogdanm 0:9b334a45a8ff 181
bogdanm 0:9b334a45a8ff 182 RtcHandle.Instance = RTC;
bogdanm 0:9b334a45a8ff 183
bogdanm 0:9b334a45a8ff 184 // Convert the time into a tm
bogdanm 0:9b334a45a8ff 185 struct tm *timeinfo = localtime(&t);
bogdanm 0:9b334a45a8ff 186
bogdanm 0:9b334a45a8ff 187 // Fill RTC structures
bogdanm 0:9b334a45a8ff 188 dateStruct.WeekDay = timeinfo->tm_wday;
bogdanm 0:9b334a45a8ff 189 dateStruct.Month = timeinfo->tm_mon + 1;
bogdanm 0:9b334a45a8ff 190 dateStruct.Date = timeinfo->tm_mday;
bogdanm 0:9b334a45a8ff 191 dateStruct.Year = timeinfo->tm_year - 100;
bogdanm 0:9b334a45a8ff 192 timeStruct.Hours = timeinfo->tm_hour;
bogdanm 0:9b334a45a8ff 193 timeStruct.Minutes = timeinfo->tm_min;
bogdanm 0:9b334a45a8ff 194 timeStruct.Seconds = timeinfo->tm_sec;
bogdanm 0:9b334a45a8ff 195 timeStruct.TimeFormat = RTC_HOURFORMAT12_PM;
bogdanm 0:9b334a45a8ff 196 timeStruct.DayLightSaving = RTC_DAYLIGHTSAVING_NONE;
bogdanm 0:9b334a45a8ff 197 timeStruct.StoreOperation = RTC_STOREOPERATION_RESET;
bogdanm 0:9b334a45a8ff 198
bogdanm 0:9b334a45a8ff 199 // Change the RTC current date/time
bogdanm 0:9b334a45a8ff 200 HAL_RTC_SetDate(&RtcHandle, &dateStruct, FORMAT_BIN);
bogdanm 0:9b334a45a8ff 201 HAL_RTC_SetTime(&RtcHandle, &timeStruct, FORMAT_BIN);
bogdanm 0:9b334a45a8ff 202 }
bogdanm 0:9b334a45a8ff 203
bogdanm 0:9b334a45a8ff 204 #endif