shao ziyang / mbed-src-kl05

mbed library sources

Dependents:   frdm_kl05z_gpio_test

Fork of mbed-src by mbed official

targets/hal/TARGET_STM/TARGET_NUCLEO_F030R8/rtc_api.c@323:9e901b0a5aa1, 2014-09-13 (annotated)

Committer:
shaoziyang
Date:
Sat Sep 13 14:25:46 2014 +0000
Revision:
323:9e901b0a5aa1
Parent:
216:577900467c9e 
test with CLOCK_SETUP = 0

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 216:577900467c9e 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 216:577900467c9e 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 216:577900467c9e 65 // The RTC Clock may vary due to LSI frequency dispersion.
mbed_official 216:577900467c9e 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 216:577900467c9e 70 rtc_freq = 40000; // [TODO] To be measured precisely using a timer input capture
mbed_official 216:577900467c9e 71 } else {
mbed_official 166:cb4253f91ada 72 // The LSE has correctly started
mbed_official 166:cb4253f91ada 73 RCC_RTCCLKConfig(RCC_RTCCLKSource_LSE); // Select the RTC Clock Source
mbed_official 166:cb4253f91ada 74 rtc_freq = LSE_VALUE;
mbed_official 166:cb4253f91ada 75 }
mbed_official 216:577900467c9e 76
mbed_official 216:577900467c9e 77 RCC_RTCCLKCmd(ENABLE); // Enable RTC Clock
mbed_official 216:577900467c9e 78
mbed_official 76:aeb1df146756 79 RTC_WaitForSynchro(); // Wait for RTC registers synchronization
mbed_official 76:aeb1df146756 80
mbed_official 76:aeb1df146756 81 RTC_InitTypeDef RTC_InitStructure;
mbed_official 76:aeb1df146756 82 RTC_InitStructure.RTC_AsynchPrediv = 127;
mbed_official 216:577900467c9e 83 RTC_InitStructure.RTC_SynchPrediv = (rtc_freq / 128) - 1;
mbed_official 76:aeb1df146756 84 RTC_InitStructure.RTC_HourFormat = RTC_HourFormat_24;
mbed_official 76:aeb1df146756 85 RTC_Init(&RTC_InitStructure);
mbed_official 216:577900467c9e 86
mbed_official 166:cb4253f91ada 87 PWR_BackupAccessCmd(DISABLE); // Disable access to Backup domain
mbed_official 216:577900467c9e 88
mbed_official 76:aeb1df146756 89 rtc_inited = 1;
mbed_official 76:aeb1df146756 90 }
mbed_official 76:aeb1df146756 91
mbed_official 76:aeb1df146756 92 void rtc_free(void) {
mbed_official 216:577900467c9e 93 // Reset RTC
mbed_official 216:577900467c9e 94 PWR_BackupAccessCmd(ENABLE); // Enable access to Backup Domain
mbed_official 216:577900467c9e 95 RTC_DeInit();
mbed_official 216:577900467c9e 96 RCC_BackupResetCmd(ENABLE);
mbed_official 216:577900467c9e 97 RCC_BackupResetCmd(DISABLE);
mbed_official 216:577900467c9e 98 // Disable RTC, LSE and LSI clocks
mbed_official 216:577900467c9e 99 RCC_RTCCLKCmd(DISABLE);
mbed_official 216:577900467c9e 100 RCC_LSEConfig(RCC_LSE_OFF);
mbed_official 216:577900467c9e 101 RCC_LSICmd(DISABLE);
mbed_official 216:577900467c9e 102
mbed_official 76:aeb1df146756 103 rtc_inited = 0;
mbed_official 76:aeb1df146756 104 }
mbed_official 76:aeb1df146756 105
mbed_official 76:aeb1df146756 106 int rtc_isenabled(void) {
mbed_official 76:aeb1df146756 107 return rtc_inited;
mbed_official 76:aeb1df146756 108 }
mbed_official 76:aeb1df146756 109
mbed_official 76:aeb1df146756 110 /*
mbed_official 76:aeb1df146756 111 RTC Registers
mbed_official 76:aeb1df146756 112 RTC_WeekDay 1=monday, 2=tuesday, ..., 7=sunday
mbed_official 76:aeb1df146756 113 RTC_Month 1=january, 2=february, ..., 12=december
mbed_official 76:aeb1df146756 114 RTC_Date day of the month 1-31
mbed_official 76:aeb1df146756 115 RTC_Year year 0-99
mbed_official 76:aeb1df146756 116 struct tm
mbed_official 76:aeb1df146756 117 tm_sec seconds after the minute 0-61
mbed_official 76:aeb1df146756 118 tm_min minutes after the hour 0-59
mbed_official 76:aeb1df146756 119 tm_hour hours since midnight 0-23
mbed_official 76:aeb1df146756 120 tm_mday day of the month 1-31
mbed_official 76:aeb1df146756 121 tm_mon months since January 0-11
mbed_official 76:aeb1df146756 122 tm_year years since 1900
mbed_official 76:aeb1df146756 123 tm_wday days since Sunday 0-6
mbed_official 76:aeb1df146756 124 tm_yday days since January 1 0-365
mbed_official 76:aeb1df146756 125 tm_isdst Daylight Saving Time flag
mbed_official 76:aeb1df146756 126 */
mbed_official 76:aeb1df146756 127 time_t rtc_read(void) {
mbed_official 76:aeb1df146756 128 RTC_DateTypeDef dateStruct;
mbed_official 76:aeb1df146756 129 RTC_TimeTypeDef timeStruct;
mbed_official 76:aeb1df146756 130 struct tm timeinfo;
mbed_official 216:577900467c9e 131
mbed_official 76:aeb1df146756 132 // Read actual date and time
mbed_official 76:aeb1df146756 133 RTC_GetTime(RTC_Format_BIN, &timeStruct);
mbed_official 76:aeb1df146756 134 RTC_GetDate(RTC_Format_BIN, &dateStruct);
mbed_official 216:577900467c9e 135
mbed_official 76:aeb1df146756 136 // Setup a tm structure based on the RTC
mbed_official 76:aeb1df146756 137 timeinfo.tm_wday = dateStruct.RTC_WeekDay;
mbed_official 76:aeb1df146756 138 timeinfo.tm_mon = dateStruct.RTC_Month - 1;
mbed_official 76:aeb1df146756 139 timeinfo.tm_mday = dateStruct.RTC_Date;
mbed_official 76:aeb1df146756 140 timeinfo.tm_year = dateStruct.RTC_Year + 100;
mbed_official 76:aeb1df146756 141 timeinfo.tm_hour = timeStruct.RTC_Hours;
mbed_official 76:aeb1df146756 142 timeinfo.tm_min = timeStruct.RTC_Minutes;
mbed_official 76:aeb1df146756 143 timeinfo.tm_sec = timeStruct.RTC_Seconds;
mbed_official 216:577900467c9e 144
mbed_official 76:aeb1df146756 145 // Convert to timestamp
mbed_official 76:aeb1df146756 146 time_t t = mktime(&timeinfo);
mbed_official 216:577900467c9e 147
mbed_official 216:577900467c9e 148 return t;
mbed_official 76:aeb1df146756 149 }
mbed_official 76:aeb1df146756 150
mbed_official 76:aeb1df146756 151 void rtc_write(time_t t) {
mbed_official 76:aeb1df146756 152 RTC_DateTypeDef dateStruct;
mbed_official 76:aeb1df146756 153 RTC_TimeTypeDef timeStruct;
mbed_official 76:aeb1df146756 154
mbed_official 76:aeb1df146756 155 // Convert the time into a tm
mbed_official 76:aeb1df146756 156 struct tm *timeinfo = localtime(&t);
mbed_official 216:577900467c9e 157
mbed_official 76:aeb1df146756 158 // Fill RTC structures
mbed_official 76:aeb1df146756 159 dateStruct.RTC_WeekDay = timeinfo->tm_wday;
mbed_official 76:aeb1df146756 160 dateStruct.RTC_Month = timeinfo->tm_mon + 1;
mbed_official 76:aeb1df146756 161 dateStruct.RTC_Date = timeinfo->tm_mday;
mbed_official 76:aeb1df146756 162 dateStruct.RTC_Year = timeinfo->tm_year - 100;
mbed_official 76:aeb1df146756 163 timeStruct.RTC_Hours = timeinfo->tm_hour;
mbed_official 76:aeb1df146756 164 timeStruct.RTC_Minutes = timeinfo->tm_min;
mbed_official 76:aeb1df146756 165 timeStruct.RTC_Seconds = timeinfo->tm_sec;
mbed_official 76:aeb1df146756 166 timeStruct.RTC_H12 = RTC_HourFormat_24;
mbed_official 216:577900467c9e 167
mbed_official 76:aeb1df146756 168 // Change the RTC current date/time
mbed_official 216:577900467c9e 169 PWR_BackupAccessCmd(ENABLE); // Enable access to RTC
mbed_official 76:aeb1df146756 170 RTC_SetDate(RTC_Format_BIN, &dateStruct);
mbed_official 216:577900467c9e 171 RTC_SetTime(RTC_Format_BIN, &timeStruct);
mbed_official 76:aeb1df146756 172 PWR_BackupAccessCmd(DISABLE); // Disable access to RTC
mbed_official 76:aeb1df146756 173 }
mbed_official 166:cb4253f91ada 174
mbed_official 166:cb4253f91ada 175 #endif