mbed official / mbed-src

mbed library sources

Dependents:   Encrypted my_mbed lklk CyaSSL_DTLS_Cellular ... more

Superseded

This library was superseded by mbed-dev - https://os.mbed.com/users/mbed_official/code/mbed-dev/.

Development branch of the mbed library sources. This library is kept in synch with the latest changes from the mbed SDK and it is not guaranteed to work.

If you are looking for a stable and tested release, please import one of the official mbed library releases:

Import librarymbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Last commit 20 Feb 2019 by mbed official

targets/hal/TARGET_STM/TARGET_STM32F0/rtc_api.c@469:fc4922e0c183, 2015-02-09 (annotated)

Committer:
mbed_official
Date:
Mon Feb 09 09:30:07 2015 +0000
Revision:
469:fc4922e0c183
Parent:
targets/hal/TARGET_STM/TARGET_NUCLEO_F070RB/rtc_api.c@441:d2c15dda23c1
Child:
630:825f75ca301e
Synchronized with git revision 06e2b3c8802cb4f78e9958ba9923755bd458e8b7



Full URL: https://github.com/mbedmicro/mbed/commit/06e2b3c8802cb4f78e9958ba9923755bd458e8b7/

Who changed what in which revision?

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