Ermanno Brusadin / mbed

mbed library sources

Dependents:   FRDM-KL46Z_LCD_Test FRDM-KL46Z_LCD_Test FRDM-KL46Z_Plantilla FRDM-KL46Z_Plantilla ... more

targets/hal/TARGET_STM/TARGET_NUCLEO_F401RE/rtc_api.c@0:6bc4ac881c8e, 2016-07-28 (annotated)

Committer:
ebrus
Date:
Thu Jul 28 15:56:34 2016 +0000
Revision:
0:6bc4ac881c8e
1;

Who changed what in which revision?

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