mbed-os
Fork of mbed-os by
targets/TARGET_NXP/TARGET_LPC43XX/rtc_api.c@0:f269e3021894, 2016-10-23 (annotated)
- Committer:
- elessair
- Date:
- Sun Oct 23 15:10:02 2016 +0000
- Revision:
- 0:f269e3021894
Initial commit
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
elessair | 0:f269e3021894 | 1 | /* mbed Microcontroller Library |
elessair | 0:f269e3021894 | 2 | * Copyright (c) 2006-2013 ARM Limited |
elessair | 0:f269e3021894 | 3 | * |
elessair | 0:f269e3021894 | 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
elessair | 0:f269e3021894 | 5 | * you may not use this file except in compliance with the License. |
elessair | 0:f269e3021894 | 6 | * You may obtain a copy of the License at |
elessair | 0:f269e3021894 | 7 | * |
elessair | 0:f269e3021894 | 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
elessair | 0:f269e3021894 | 9 | * |
elessair | 0:f269e3021894 | 10 | * Unless required by applicable law or agreed to in writing, software |
elessair | 0:f269e3021894 | 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
elessair | 0:f269e3021894 | 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
elessair | 0:f269e3021894 | 13 | * See the License for the specific language governing permissions and |
elessair | 0:f269e3021894 | 14 | * limitations under the License. |
elessair | 0:f269e3021894 | 15 | * |
elessair | 0:f269e3021894 | 16 | * Ported to NXP LPC43XX by Micromint USA <support@micromint.com> |
elessair | 0:f269e3021894 | 17 | */ |
elessair | 0:f269e3021894 | 18 | #include "rtc_api.h" |
elessair | 0:f269e3021894 | 19 | |
elessair | 0:f269e3021894 | 20 | // ensure rtc is running (unchanged if already running) |
elessair | 0:f269e3021894 | 21 | |
elessair | 0:f269e3021894 | 22 | /* Setup the RTC based on a time structure, ensuring RTC is enabled |
elessair | 0:f269e3021894 | 23 | * |
elessair | 0:f269e3021894 | 24 | * Can be clocked by a 32.768KHz oscillator or prescale divider based on the APB clock |
elessair | 0:f269e3021894 | 25 | * - We want to use the 32khz clock, allowing for sleep mode |
elessair | 0:f269e3021894 | 26 | * |
elessair | 0:f269e3021894 | 27 | * Most registers are not changed by a Reset |
elessair | 0:f269e3021894 | 28 | * - We must initialize these registers between power-on and setting the RTC into operation |
elessair | 0:f269e3021894 | 29 | |
elessair | 0:f269e3021894 | 30 | * Clock Control Register |
elessair | 0:f269e3021894 | 31 | * RTC_CCR[0] : Enable - 0 = Disabled, 1 = Enabled |
elessair | 0:f269e3021894 | 32 | * RTC_CCR[1] : Reset - 0 = Normal, 1 = Reset |
elessair | 0:f269e3021894 | 33 | * RTC_CCR[4] : Clock Source - 0 = Prescaler, 1 = 32k Xtal |
elessair | 0:f269e3021894 | 34 | * |
elessair | 0:f269e3021894 | 35 | * The RTC may already be running, so we should set it up |
elessair | 0:f269e3021894 | 36 | * without impacting if it is the case |
elessair | 0:f269e3021894 | 37 | */ |
elessair | 0:f269e3021894 | 38 | |
elessair | 0:f269e3021894 | 39 | void rtc_init(void) { |
elessair | 0:f269e3021894 | 40 | // Return, if already enabled |
elessair | 0:f269e3021894 | 41 | if (LPC_RTC->CCR & 1) |
elessair | 0:f269e3021894 | 42 | return; |
elessair | 0:f269e3021894 | 43 | |
elessair | 0:f269e3021894 | 44 | // Enable 1kHz output of 32kHz oscillator |
elessair | 0:f269e3021894 | 45 | LPC_CREG->CREG0 &= ~((1 << 3) | (1 << 2)); |
elessair | 0:f269e3021894 | 46 | LPC_CREG->CREG0 |= (0x03 << 6) | (1 << 1) | (1 << 0); |
elessair | 0:f269e3021894 | 47 | |
elessair | 0:f269e3021894 | 48 | // Enable RTC |
elessair | 0:f269e3021894 | 49 | do { |
elessair | 0:f269e3021894 | 50 | LPC_RTC->CCR |= 1 << 0; |
elessair | 0:f269e3021894 | 51 | } while ((LPC_RTC->CCR & 1) == 0); |
elessair | 0:f269e3021894 | 52 | } |
elessair | 0:f269e3021894 | 53 | |
elessair | 0:f269e3021894 | 54 | void rtc_free(void) { |
elessair | 0:f269e3021894 | 55 | // [TODO] |
elessair | 0:f269e3021894 | 56 | } |
elessair | 0:f269e3021894 | 57 | |
elessair | 0:f269e3021894 | 58 | /* |
elessair | 0:f269e3021894 | 59 | * Little check routine to see if the RTC has been enabled |
elessair | 0:f269e3021894 | 60 | * |
elessair | 0:f269e3021894 | 61 | * Clock Control Register |
elessair | 0:f269e3021894 | 62 | * RTC_CCR[0] : 0 = Disabled, 1 = Enabled |
elessair | 0:f269e3021894 | 63 | * |
elessair | 0:f269e3021894 | 64 | */ |
elessair | 0:f269e3021894 | 65 | int rtc_isenabled(void) { |
elessair | 0:f269e3021894 | 66 | return(((LPC_RTC->CCR) & 0x01) != 0); |
elessair | 0:f269e3021894 | 67 | } |
elessair | 0:f269e3021894 | 68 | |
elessair | 0:f269e3021894 | 69 | /* |
elessair | 0:f269e3021894 | 70 | * RTC Registers |
elessair | 0:f269e3021894 | 71 | * RTC_SEC Seconds 0-59 |
elessair | 0:f269e3021894 | 72 | * RTC_MIN Minutes 0-59 |
elessair | 0:f269e3021894 | 73 | * RTC_HOUR Hour 0-23 |
elessair | 0:f269e3021894 | 74 | * RTC_DOM Day of Month 1-28..31 |
elessair | 0:f269e3021894 | 75 | * RTC_DOW Day of Week 0-6 |
elessair | 0:f269e3021894 | 76 | * RTC_DOY Day of Year 1-365 |
elessair | 0:f269e3021894 | 77 | * RTC_MONTH Month 1-12 |
elessair | 0:f269e3021894 | 78 | * RTC_YEAR Year 0-4095 |
elessair | 0:f269e3021894 | 79 | * |
elessair | 0:f269e3021894 | 80 | * struct tm |
elessair | 0:f269e3021894 | 81 | * tm_sec seconds after the minute 0-61 |
elessair | 0:f269e3021894 | 82 | * tm_min minutes after the hour 0-59 |
elessair | 0:f269e3021894 | 83 | * tm_hour hours since midnight 0-23 |
elessair | 0:f269e3021894 | 84 | * tm_mday day of the month 1-31 |
elessair | 0:f269e3021894 | 85 | * tm_mon months since January 0-11 |
elessair | 0:f269e3021894 | 86 | * tm_year years since 1900 |
elessair | 0:f269e3021894 | 87 | * tm_wday days since Sunday 0-6 |
elessair | 0:f269e3021894 | 88 | * tm_yday days since January 1 0-365 |
elessair | 0:f269e3021894 | 89 | * tm_isdst Daylight Saving Time flag |
elessair | 0:f269e3021894 | 90 | */ |
elessair | 0:f269e3021894 | 91 | time_t rtc_read(void) { |
elessair | 0:f269e3021894 | 92 | // Setup a tm structure based on the RTC |
elessair | 0:f269e3021894 | 93 | struct tm timeinfo; |
elessair | 0:f269e3021894 | 94 | timeinfo.tm_sec = LPC_RTC->TIME[RTC_TIMETYPE_SECOND]; |
elessair | 0:f269e3021894 | 95 | timeinfo.tm_min = LPC_RTC->TIME[RTC_TIMETYPE_MINUTE]; |
elessair | 0:f269e3021894 | 96 | timeinfo.tm_hour = LPC_RTC->TIME[RTC_TIMETYPE_HOUR]; |
elessair | 0:f269e3021894 | 97 | timeinfo.tm_mday = LPC_RTC->TIME[RTC_TIMETYPE_DAYOFMONTH]; |
elessair | 0:f269e3021894 | 98 | timeinfo.tm_wday = LPC_RTC->TIME[RTC_TIMETYPE_DAYOFWEEK]; |
elessair | 0:f269e3021894 | 99 | timeinfo.tm_yday = LPC_RTC->TIME[RTC_TIMETYPE_DAYOFYEAR]; |
elessair | 0:f269e3021894 | 100 | timeinfo.tm_mon = LPC_RTC->TIME[RTC_TIMETYPE_MONTH] - 1; |
elessair | 0:f269e3021894 | 101 | timeinfo.tm_year = LPC_RTC->TIME[RTC_TIMETYPE_YEAR] - 1900; |
elessair | 0:f269e3021894 | 102 | |
elessair | 0:f269e3021894 | 103 | // Convert to timestamp |
elessair | 0:f269e3021894 | 104 | time_t t = mktime(&timeinfo); |
elessair | 0:f269e3021894 | 105 | |
elessair | 0:f269e3021894 | 106 | return t; |
elessair | 0:f269e3021894 | 107 | } |
elessair | 0:f269e3021894 | 108 | |
elessair | 0:f269e3021894 | 109 | void rtc_write(time_t t) { |
elessair | 0:f269e3021894 | 110 | // Convert the time in to a tm |
elessair | 0:f269e3021894 | 111 | struct tm *timeinfo = localtime(&t); |
elessair | 0:f269e3021894 | 112 | |
elessair | 0:f269e3021894 | 113 | // Pause clock, and clear counter register (clears us count) |
elessair | 0:f269e3021894 | 114 | LPC_RTC->CCR |= 2; |
elessair | 0:f269e3021894 | 115 | |
elessair | 0:f269e3021894 | 116 | // Set the RTC |
elessair | 0:f269e3021894 | 117 | LPC_RTC->TIME[RTC_TIMETYPE_SECOND] = timeinfo->tm_sec; |
elessair | 0:f269e3021894 | 118 | LPC_RTC->TIME[RTC_TIMETYPE_MINUTE] = timeinfo->tm_min; |
elessair | 0:f269e3021894 | 119 | LPC_RTC->TIME[RTC_TIMETYPE_HOUR] = timeinfo->tm_hour; |
elessair | 0:f269e3021894 | 120 | LPC_RTC->TIME[RTC_TIMETYPE_DAYOFMONTH] = timeinfo->tm_mday; |
elessair | 0:f269e3021894 | 121 | LPC_RTC->TIME[RTC_TIMETYPE_DAYOFWEEK] = timeinfo->tm_wday; |
elessair | 0:f269e3021894 | 122 | LPC_RTC->TIME[RTC_TIMETYPE_DAYOFYEAR] = timeinfo->tm_yday; |
elessair | 0:f269e3021894 | 123 | LPC_RTC->TIME[RTC_TIMETYPE_MONTH] = timeinfo->tm_mon + 1; |
elessair | 0:f269e3021894 | 124 | LPC_RTC->TIME[RTC_TIMETYPE_YEAR] = timeinfo->tm_year + 1900; |
elessair | 0:f269e3021894 | 125 | |
elessair | 0:f269e3021894 | 126 | // Restart clock |
elessair | 0:f269e3021894 | 127 | LPC_RTC->CCR &= ~((uint32_t)2); |
elessair | 0:f269e3021894 | 128 | } |