Team DIANA / mbed-src

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.

Dependents:   MX106-finaltest

Fork of mbed-src by mbed official

targets/hal/TARGET_STM/TARGET_STM32F3/rtc_api.c@508:4f5903e025e6, 2015-04-09 (annotated)

Committer:
mbed_official
Date:
Thu Apr 09 06:45:08 2015 +0100
Revision:
508:4f5903e025e6
Parent:
targets/hal/TARGET_STM/TARGET_NUCLEO_F302R8/rtc_api.c@330:c80ac197fa6a 
Synchronized with git revision 643cd23443352254ef51f4be0974b6e526142078



Full URL: https://github.com/mbedmicro/mbed/commit/643cd23443352254ef51f4be0974b6e526142078/



STM32F3xx - hal reorganization

Who changed what in which revision?

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