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_NUCLEO_F030R8/rtc_api.c@166:cb4253f91ada, 2014-04-22 (annotated)

Committer:
mbed_official
Date:
Tue Apr 22 16:00:06 2014 +0100
Revision:
166:cb4253f91ada
Parent:
76:aeb1df146756
Child:
216:577900467c9e
Synchronized with git revision a519f94f35c3993310499623be5c28f74b80485c



Full URL: https://github.com/mbedmicro/mbed/commit/a519f94f35c3993310499623be5c28f74b80485c/



[NUCLEO_F030R8] Many improvements added

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 76:aeb1df146756 1 /* mbed Microcontroller Library
mbed_official 76:aeb1df146756 2 *******************************************************************************
mbed_official 76:aeb1df146756 3 * Copyright (c) 2014, STMicroelectronics
mbed_official 76:aeb1df146756 4 * All rights reserved.
mbed_official 76:aeb1df146756 5 *
mbed_official 76:aeb1df146756 6 * Redistribution and use in source and binary forms, with or without
mbed_official 76:aeb1df146756 7 * modification, are permitted provided that the following conditions are met:
mbed_official 76:aeb1df146756 8 *
mbed_official 76:aeb1df146756 9 * 1. Redistributions of source code must retain the above copyright notice,
mbed_official 76:aeb1df146756 10 * this list of conditions and the following disclaimer.
mbed_official 76:aeb1df146756 11 * 2. Redistributions in binary form must reproduce the above copyright notice,
mbed_official 76:aeb1df146756 12 * this list of conditions and the following disclaimer in the documentation
mbed_official 76:aeb1df146756 13 * and/or other materials provided with the distribution.
mbed_official 76:aeb1df146756 14 * 3. Neither the name of STMicroelectronics nor the names of its contributors
mbed_official 76:aeb1df146756 15 * may be used to endorse or promote products derived from this software
mbed_official 76:aeb1df146756 16 * without specific prior written permission.
mbed_official 76:aeb1df146756 17 *
mbed_official 76:aeb1df146756 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
mbed_official 76:aeb1df146756 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
mbed_official 76:aeb1df146756 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
mbed_official 76:aeb1df146756 21 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
mbed_official 76:aeb1df146756 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
mbed_official 76:aeb1df146756 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
mbed_official 76:aeb1df146756 24 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
mbed_official 76:aeb1df146756 25 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
mbed_official 76:aeb1df146756 26 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
mbed_official 76:aeb1df146756 27 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
mbed_official 76:aeb1df146756 28 *******************************************************************************
mbed_official 76:aeb1df146756 29 */
mbed_official 76:aeb1df146756 30 #include "rtc_api.h"
mbed_official 76:aeb1df146756 31
mbed_official 166:cb4253f91ada 32 #if DEVICE_RTC
mbed_official 166:cb4253f91ada 33
mbed_official 166:cb4253f91ada 34 #include "wait_api.h"
mbed_official 166:cb4253f91ada 35
mbed_official 166:cb4253f91ada 36 #define LSE_STARTUP_TIMEOUT ((uint16_t)500) // delay in ms
mbed_official 166:cb4253f91ada 37
mbed_official 76:aeb1df146756 38 static int rtc_inited = 0;
mbed_official 76:aeb1df146756 39
mbed_official 76:aeb1df146756 40 void rtc_init(void) {
mbed_official 166:cb4253f91ada 41 uint32_t StartUpCounter = 0;
mbed_official 166:cb4253f91ada 42 uint32_t LSEStatus = 0;
mbed_official 166:cb4253f91ada 43 uint32_t rtc_freq = 0;
mbed_official 166:cb4253f91ada 44
mbed_official 76:aeb1df146756 45 RCC_APB1PeriphClockCmd(RCC_APB1Periph_PWR, ENABLE); // Enable PWR clock
mbed_official 76:aeb1df146756 46
mbed_official 166:cb4253f91ada 47 PWR_BackupAccessCmd(ENABLE); // Enable access to Backup domain
mbed_official 166:cb4253f91ada 48
mbed_official 166:cb4253f91ada 49 // Reset back up registers
mbed_official 166:cb4253f91ada 50 RCC_BackupResetCmd(ENABLE);
mbed_official 166:cb4253f91ada 51 RCC_BackupResetCmd(DISABLE);
mbed_official 166:cb4253f91ada 52
mbed_official 166:cb4253f91ada 53 // Enable LSE clock
mbed_official 166:cb4253f91ada 54 RCC_LSEConfig(RCC_LSE_ON);
mbed_official 76:aeb1df146756 55
mbed_official 166:cb4253f91ada 56 // Wait till LSE is ready
mbed_official 166:cb4253f91ada 57 do {
mbed_official 166:cb4253f91ada 58 LSEStatus = RCC_GetFlagStatus(RCC_FLAG_LSERDY);
mbed_official 166:cb4253f91ada 59 wait_ms(1);
mbed_official 166:cb4253f91ada 60 StartUpCounter++;
mbed_official 166:cb4253f91ada 61 } while((LSEStatus == 0) && (StartUpCounter <= LSE_STARTUP_TIMEOUT));
mbed_official 166:cb4253f91ada 62
mbed_official 166:cb4253f91ada 63 if (StartUpCounter > LSE_STARTUP_TIMEOUT) {
mbed_official 166:cb4253f91ada 64 // The LSE has not started, use LSI instead.
mbed_official 166:cb4253f91ada 65 // The RTC Clock may vary due to LSI frequency dispersion.
mbed_official 166:cb4253f91ada 66 RCC_LSEConfig(RCC_LSE_OFF);
mbed_official 166:cb4253f91ada 67 RCC_LSICmd(ENABLE); // Enable LSI
mbed_official 166:cb4253f91ada 68 while (RCC_GetFlagStatus(RCC_FLAG_LSIRDY) == RESET) {} // Wait until ready
mbed_official 166:cb4253f91ada 69 RCC_RTCCLKConfig(RCC_RTCCLKSource_LSI); // Select the RTC Clock Source
mbed_official 166:cb4253f91ada 70 rtc_freq = 40000; // [TODO] To be measured precisely using a timer input capture
mbed_official 166:cb4253f91ada 71 }
mbed_official 166:cb4253f91ada 72 else {
mbed_official 166:cb4253f91ada 73 // The LSE has correctly started
mbed_official 166:cb4253f91ada 74 RCC_RTCCLKConfig(RCC_RTCCLKSource_LSE); // Select the RTC Clock Source
mbed_official 166:cb4253f91ada 75 rtc_freq = LSE_VALUE;
mbed_official 166:cb4253f91ada 76 }
mbed_official 76:aeb1df146756 77
mbed_official 76:aeb1df146756 78 RCC_RTCCLKCmd(ENABLE); // Enable RTC Clock
mbed_official 76:aeb1df146756 79
mbed_official 76:aeb1df146756 80 RTC_WaitForSynchro(); // Wait for RTC registers synchronization
mbed_official 76:aeb1df146756 81
mbed_official 76:aeb1df146756 82 RTC_InitTypeDef RTC_InitStructure;
mbed_official 76:aeb1df146756 83 RTC_InitStructure.RTC_AsynchPrediv = 127;
mbed_official 166:cb4253f91ada 84 RTC_InitStructure.RTC_SynchPrediv = (rtc_freq / 128) - 1;
mbed_official 76:aeb1df146756 85 RTC_InitStructure.RTC_HourFormat = RTC_HourFormat_24;
mbed_official 76:aeb1df146756 86 RTC_Init(&RTC_InitStructure);
mbed_official 76:aeb1df146756 87
mbed_official 166:cb4253f91ada 88 PWR_BackupAccessCmd(DISABLE); // Disable access to Backup domain
mbed_official 76:aeb1df146756 89
mbed_official 76:aeb1df146756 90 rtc_inited = 1;
mbed_official 76:aeb1df146756 91 }
mbed_official 76:aeb1df146756 92
mbed_official 76:aeb1df146756 93 void rtc_free(void) {
mbed_official 76:aeb1df146756 94 RCC_DeInit(); // Resets the RCC clock configuration to the default reset state
mbed_official 76:aeb1df146756 95 rtc_inited = 0;
mbed_official 76:aeb1df146756 96 }
mbed_official 76:aeb1df146756 97
mbed_official 76:aeb1df146756 98 int rtc_isenabled(void) {
mbed_official 76:aeb1df146756 99 return rtc_inited;
mbed_official 76:aeb1df146756 100 }
mbed_official 76:aeb1df146756 101
mbed_official 76:aeb1df146756 102 /*
mbed_official 76:aeb1df146756 103 RTC Registers
mbed_official 76:aeb1df146756 104 RTC_WeekDay 1=monday, 2=tuesday, ..., 7=sunday
mbed_official 76:aeb1df146756 105 RTC_Month 1=january, 2=february, ..., 12=december
mbed_official 76:aeb1df146756 106 RTC_Date day of the month 1-31
mbed_official 76:aeb1df146756 107 RTC_Year year 0-99
mbed_official 76:aeb1df146756 108 struct tm
mbed_official 76:aeb1df146756 109 tm_sec seconds after the minute 0-61
mbed_official 76:aeb1df146756 110 tm_min minutes after the hour 0-59
mbed_official 76:aeb1df146756 111 tm_hour hours since midnight 0-23
mbed_official 76:aeb1df146756 112 tm_mday day of the month 1-31
mbed_official 76:aeb1df146756 113 tm_mon months since January 0-11
mbed_official 76:aeb1df146756 114 tm_year years since 1900
mbed_official 76:aeb1df146756 115 tm_wday days since Sunday 0-6
mbed_official 76:aeb1df146756 116 tm_yday days since January 1 0-365
mbed_official 76:aeb1df146756 117 tm_isdst Daylight Saving Time flag
mbed_official 76:aeb1df146756 118 */
mbed_official 76:aeb1df146756 119 time_t rtc_read(void) {
mbed_official 76:aeb1df146756 120 RTC_DateTypeDef dateStruct;
mbed_official 76:aeb1df146756 121 RTC_TimeTypeDef timeStruct;
mbed_official 76:aeb1df146756 122 struct tm timeinfo;
mbed_official 76:aeb1df146756 123
mbed_official 76:aeb1df146756 124 // Read actual date and time
mbed_official 76:aeb1df146756 125 RTC_GetTime(RTC_Format_BIN, &timeStruct);
mbed_official 76:aeb1df146756 126 RTC_GetDate(RTC_Format_BIN, &dateStruct);
mbed_official 76:aeb1df146756 127
mbed_official 76:aeb1df146756 128 // Setup a tm structure based on the RTC
mbed_official 76:aeb1df146756 129 timeinfo.tm_wday = dateStruct.RTC_WeekDay;
mbed_official 76:aeb1df146756 130 timeinfo.tm_mon = dateStruct.RTC_Month - 1;
mbed_official 76:aeb1df146756 131 timeinfo.tm_mday = dateStruct.RTC_Date;
mbed_official 76:aeb1df146756 132 timeinfo.tm_year = dateStruct.RTC_Year + 100;
mbed_official 76:aeb1df146756 133 timeinfo.tm_hour = timeStruct.RTC_Hours;
mbed_official 76:aeb1df146756 134 timeinfo.tm_min = timeStruct.RTC_Minutes;
mbed_official 76:aeb1df146756 135 timeinfo.tm_sec = timeStruct.RTC_Seconds;
mbed_official 76:aeb1df146756 136
mbed_official 76:aeb1df146756 137 // Convert to timestamp
mbed_official 76:aeb1df146756 138 time_t t = mktime(&timeinfo);
mbed_official 76:aeb1df146756 139
mbed_official 76:aeb1df146756 140 return t;
mbed_official 76:aeb1df146756 141 }
mbed_official 76:aeb1df146756 142
mbed_official 76:aeb1df146756 143 void rtc_write(time_t t) {
mbed_official 76:aeb1df146756 144 RTC_DateTypeDef dateStruct;
mbed_official 76:aeb1df146756 145 RTC_TimeTypeDef timeStruct;
mbed_official 76:aeb1df146756 146
mbed_official 76:aeb1df146756 147 // Convert the time into a tm
mbed_official 76:aeb1df146756 148 struct tm *timeinfo = localtime(&t);
mbed_official 76:aeb1df146756 149
mbed_official 76:aeb1df146756 150 // Fill RTC structures
mbed_official 76:aeb1df146756 151 dateStruct.RTC_WeekDay = timeinfo->tm_wday;
mbed_official 76:aeb1df146756 152 dateStruct.RTC_Month = timeinfo->tm_mon + 1;
mbed_official 76:aeb1df146756 153 dateStruct.RTC_Date = timeinfo->tm_mday;
mbed_official 76:aeb1df146756 154 dateStruct.RTC_Year = timeinfo->tm_year - 100;
mbed_official 76:aeb1df146756 155 timeStruct.RTC_Hours = timeinfo->tm_hour;
mbed_official 76:aeb1df146756 156 timeStruct.RTC_Minutes = timeinfo->tm_min;
mbed_official 76:aeb1df146756 157 timeStruct.RTC_Seconds = timeinfo->tm_sec;
mbed_official 76:aeb1df146756 158 timeStruct.RTC_H12 = RTC_HourFormat_24;
mbed_official 76:aeb1df146756 159
mbed_official 76:aeb1df146756 160 // Change the RTC current date/time
mbed_official 76:aeb1df146756 161 PWR_BackupAccessCmd(ENABLE); // Enable access to RTC
mbed_official 76:aeb1df146756 162 RTC_SetDate(RTC_Format_BIN, &dateStruct);
mbed_official 76:aeb1df146756 163 RTC_SetTime(RTC_Format_BIN, &timeStruct);
mbed_official 76:aeb1df146756 164 PWR_BackupAccessCmd(DISABLE); // Disable access to RTC
mbed_official 76:aeb1df146756 165 }
mbed_official 166:cb4253f91ada 166
mbed_official 166:cb4253f91ada 167 #endif