2 * -------------------------------------------
3 * MSP432 DriverLib - v3_10_00_09
4 * -------------------------------------------
6 * --COPYRIGHT--,BSD,BSD
7 * Copyright (c) 2014, Texas Instruments Incorporated
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
14 * * Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
17 * * Redistributions in binary form must reproduce the above copyright
18 * notice, this list of conditions and the following disclaimer in the
19 * documentation and/or other materials provided with the distribution.
21 * * Neither the name of Texas Instruments Incorporated nor the names of
22 * its contributors may be used to endorse or promote products derived
23 * from this software without specific prior written permission.
25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
26 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
27 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
29 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
30 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
31 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
32 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
33 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
34 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
35 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
38 #include <interrupt.h>
40 #include <hw_memmap.h>
42 void RTC_C_startClock(void)
44 RTC_C->CTL0 = (RTC_C->CTL0 & ~RTC_C_CTL0_KEY_MASK) | RTC_C_KEY;
45 BITBAND_PERI(RTC_C->CTL13, RTC_C_CTL13_HOLD_OFS) = 0;
46 BITBAND_PERI(RTC_C->CTL0, RTC_C_CTL0_KEY_OFS) = 0;
49 void RTC_C_holdClock(void)
51 RTC_C->CTL0 = (RTC_C->CTL0 & ~RTC_C_CTL0_KEY_MASK) | RTC_C_KEY;
52 BITBAND_PERI(RTC_C->CTL13, RTC_C_CTL13_HOLD_OFS) = 1;
53 BITBAND_PERI(RTC_C->CTL0, RTC_C_CTL0_KEY_OFS) = 0;
56 void RTC_C_setCalibrationFrequency(uint_fast16_t frequencySelect)
58 RTC_C->CTL0 = (RTC_C->CTL0 & ~RTC_C_CTL0_KEY_MASK) | RTC_C_KEY;
59 RTC_C->CTL13 = (RTC_C->CTL13 & ~(RTC_C_CTL13_CALF_3)) | frequencySelect;
60 BITBAND_PERI(RTC_C->CTL0, RTC_C_CTL0_KEY_OFS) = 0;
63 void RTC_C_setCalibrationData(uint_fast8_t offsetDirection,
64 uint_fast8_t offsetValue)
66 RTC_C->CTL0 = (RTC_C->CTL0 & ~RTC_C_CTL0_KEY_MASK) | RTC_C_KEY;
67 RTC_C->OCAL = offsetValue + offsetDirection;
68 BITBAND_PERI(RTC_C->CTL0, RTC_C_CTL0_KEY_OFS) = 0;
71 bool RTC_C_setTemperatureCompensation(uint_fast16_t offsetDirection,
72 uint_fast8_t offsetValue)
74 while (!BITBAND_PERI(RTC_C->TCMP, RTC_C_TCMP_TCRDY_OFS))
77 RTC_C->TCMP = offsetValue + offsetDirection;
79 if (BITBAND_PERI(RTC_C->TCMP, RTC_C_TCMP_TCOK_OFS))
85 void RTC_C_initCalendar(const RTC_C_Calendar *calendarTime,
86 uint_fast16_t formatSelect)
88 RTC_C->CTL0 = (RTC_C->CTL0 & ~RTC_C_CTL0_KEY_MASK) | RTC_C_KEY;
90 BITBAND_PERI(RTC_C->CTL13, RTC_C_CTL13_HOLD_OFS) = 1;
93 BITBAND_PERI(RTC_C->CTL13, RTC_C_CTL13_BCD_OFS) = 1;
95 BITBAND_PERI(RTC_C->CTL13, RTC_C_CTL13_BCD_OFS) = 0;
97 RTC_C->TIM0 = (calendarTime->minutes<<RTC_C_TIM0_MIN_OFS) | calendarTime->seconds;
98 RTC_C->TIM1 = (calendarTime->dayOfWeek<<RTC_C_TIM1_DOW_OFS) | calendarTime->hours;
99 RTC_C->DATE = (calendarTime->month<<RTC_C_DATE_MON_OFS) | calendarTime->dayOfmonth;
100 RTC_C->YEAR = calendarTime->year;
102 BITBAND_PERI(RTC_C->CTL0, RTC_C_CTL0_KEY_OFS) = 0;
105 RTC_C_Calendar RTC_C_getCalendarTime(void)
107 RTC_C_Calendar tempCal;
109 while (!(BITBAND_PERI(RTC_C->CTL13, RTC_C_CTL13_RDY_OFS)))
112 tempCal.seconds = RTC_C->TIM0 & RTC_C_TIM0_SEC_MASK;
113 tempCal.minutes = (RTC_C->TIM0 & RTC_C_TIM0_MIN_MASK)>>RTC_C_TIM0_MIN_OFS;
114 tempCal.hours = RTC_C->TIM1 & RTC_C_TIM1_HOUR_MASK;
115 tempCal.dayOfWeek = (RTC_C->TIM1 & RTC_C_TIM1_DOW_MASK)>>RTC_C_TIM1_DOW_OFS;
116 tempCal.dayOfmonth = RTC_C->DATE & RTC_C_DATE_DAY_MASK;
117 tempCal.month = (RTC_C->DATE & RTC_C_DATE_MON_MASK)>>RTC_C_DATE_MON_OFS;
118 tempCal.year = RTC_C->YEAR;
123 void RTC_C_setCalendarAlarm(uint_fast8_t minutesAlarm, uint_fast8_t hoursAlarm,
124 uint_fast8_t dayOfWeekAlarm, uint_fast8_t dayOfmonthAlarm)
126 //Each of these is XORed with 0x80 to turn on if an integer is passed,
127 //or turn OFF if RTC_ALARM_OFF (0x80) is passed.
128 RTC_C->AMINHR = ((hoursAlarm ^ 0x80) << 8 )| (minutesAlarm ^ 0x80);
129 RTC_C->ADOWDAY = ((dayOfmonthAlarm ^ 0x80) << 8 )| (dayOfWeekAlarm ^ 0x80);
132 void RTC_C_setCalendarEvent(uint_fast16_t eventSelect)
134 RTC_C->CTL0 = (RTC_C->CTL0 & ~RTC_C_CTL0_KEY_MASK) | RTC_C_KEY;
135 RTC_C->CTL13 = (RTC_C->CTL13 & ~(RTC_C_CTL13_TEV_3)) | eventSelect;
136 BITBAND_PERI(RTC_C->CTL0, RTC_C_CTL0_KEY_OFS) = 0;
139 void RTC_C_definePrescaleEvent(uint_fast8_t prescaleSelect,
140 uint_fast8_t prescaleEventDivider)
142 HWREG8(&RTC_C->PS0CTL + prescaleSelect) &= ~(RTC_C_PS0CTL_RT0IP_7);
143 HWREG8(&RTC_C->PS0CTL + prescaleSelect) |=
144 prescaleEventDivider;
147 uint_fast8_t RTC_C_getPrescaleValue(uint_fast8_t prescaleSelect)
149 if (RTC_C_PRESCALE_0 == prescaleSelect)
151 return (RTC_C->PS & RTC_C_PS_RT0PS_MASK);
152 } else if (RTC_C_PRESCALE_1 == prescaleSelect)
154 return (RTC_C->PS & RTC_C_PS_RT1PS_MASK)>>RTC_C_PS_RT1PS_OFS;
161 void RTC_C_setPrescaleValue(uint_fast8_t prescaleSelect,
162 uint_fast8_t prescaleCounterValue)
164 RTC_C->CTL0 = (RTC_C->CTL0 & ~RTC_C_CTL0_KEY_MASK) | RTC_C_KEY;
166 if (RTC_C_PRESCALE_0 == prescaleSelect)
168 RTC_C->PS = (RTC_C->PS & ~RTC_C_PS_RT0PS_MASK) | prescaleCounterValue;
169 } else if (RTC_C_PRESCALE_1 == prescaleSelect)
171 RTC_C->PS = (RTC_C->PS & ~RTC_C_PS_RT1PS_MASK)
172 | (prescaleCounterValue << RTC_C_PS_RT1PS_OFS);
175 BITBAND_PERI(RTC_C->CTL0, RTC_C_CTL0_KEY_OFS) = 0;
178 uint16_t RTC_C_convertBCDToBinary(uint16_t valueToConvert)
180 RTC_C->BCD2BIN = valueToConvert;
181 return (RTC_C->BCD2BIN);
184 uint16_t RTC_C_convertBinaryToBCD(uint16_t valueToConvert)
186 RTC_C->BIN2BCD = valueToConvert;
187 return (RTC_C->BIN2BCD);
190 void RTC_C_enableInterrupt(uint8_t interruptMask)
192 if (interruptMask & (RTC_C_CTL0_OFIE + RTC_C_CTL0_TEVIE + RTC_C_CTL0_AIE
195 RTC_C->CTL0 = RTC_C_KEY | (interruptMask
196 & (RTC_C_CTL0_OFIE + RTC_C_CTL0_TEVIE + RTC_C_CTL0_AIE
197 + RTC_C_CTL0_RDYIE));
198 BITBAND_PERI(RTC_C->CTL0, RTC_C_CTL0_KEY_OFS) = 0;
201 if (interruptMask & RTC_C_PRESCALE_TIMER0_INTERRUPT)
203 BITBAND_PERI(RTC_C->PS0CTL, RTC_C_PS0CTL_RT0PSIE_OFS) = 1;
206 if (interruptMask & RTC_C_PRESCALE_TIMER1_INTERRUPT)
208 BITBAND_PERI(RTC_C->PS1CTL,RTC_C_PS1CTL_RT1PSIE_OFS) = 1;
212 void RTC_C_disableInterrupt(uint8_t interruptMask)
214 if (interruptMask & (RTC_C_CTL0_OFIE + RTC_C_CTL0_TEVIE + RTC_C_CTL0_AIE
217 RTC_C->CTL0 = RTC_C_KEY
218 | (RTC_C->CTL0 & ~((interruptMask | RTC_C_CTL0_KEY_MASK)
219 & (RTC_C_CTL0_OFIE + RTC_C_CTL0_TEVIE + RTC_C_CTL0_AIE
220 + RTC_C_CTL0_RDYIE)));
221 BITBAND_PERI(RTC_C->CTL0, RTC_C_CTL0_KEY_OFS) = 0;
224 if (interruptMask & RTC_C_PRESCALE_TIMER0_INTERRUPT)
226 BITBAND_PERI(RTC_C->PS0CTL, RTC_C_PS0CTL_RT0PSIE_OFS) = 0;
229 if (interruptMask & RTC_C_PRESCALE_TIMER1_INTERRUPT)
231 BITBAND_PERI(RTC_C->PS1CTL, RTC_C_PS1CTL_RT1PSIE_OFS) = 0;
235 uint_fast8_t RTC_C_getInterruptStatus(void)
237 uint_fast8_t tempInterruptFlagMask = 0x00;
238 uint_fast8_t interruptFlagMask = RTC_C_TIME_EVENT_INTERRUPT
239 | RTC_C_CLOCK_ALARM_INTERRUPT | RTC_C_CLOCK_READ_READY_INTERRUPT
240 | RTC_C_PRESCALE_TIMER0_INTERRUPT | RTC_C_PRESCALE_TIMER1_INTERRUPT
241 | RTC_C_OSCILLATOR_FAULT_INTERRUPT;
243 tempInterruptFlagMask |= (RTC_C->CTL0 & (interruptFlagMask >> 4));
245 tempInterruptFlagMask = tempInterruptFlagMask << 4;
247 if (interruptFlagMask & RTC_C_PRESCALE_TIMER0_INTERRUPT)
249 if (BITBAND_PERI(RTC_C->PS0CTL, RTC_C_PS0CTL_RT0PSIFG_OFS))
251 tempInterruptFlagMask |= RTC_C_PRESCALE_TIMER0_INTERRUPT;
255 if (interruptFlagMask & RTC_C_PRESCALE_TIMER1_INTERRUPT)
257 if (BITBAND_PERI(RTC_C->PS1CTL, RTC_C_PS1CTL_RT1PSIFG_OFS))
259 tempInterruptFlagMask |= RTC_C_PRESCALE_TIMER1_INTERRUPT;
263 return (tempInterruptFlagMask);
266 uint_fast8_t RTC_C_getEnabledInterruptStatus(void)
269 uint32_t intStatus = RTC_C_getInterruptStatus();
271 if (!BITBAND_PERI(RTC_C->CTL0, RTC_C_CTL0_OFIE_OFS))
273 intStatus &= ~RTC_C_OSCILLATOR_FAULT_INTERRUPT;
276 if (!BITBAND_PERI(RTC_C->CTL0, RTC_C_CTL0_TEVIE_OFS))
278 intStatus &= ~RTC_C_TIME_EVENT_INTERRUPT;
281 if (!BITBAND_PERI(RTC_C->CTL0, RTC_C_CTL0_AIE_OFS))
283 intStatus &= ~RTC_C_CLOCK_ALARM_INTERRUPT;
286 if (!BITBAND_PERI(RTC_C->CTL0, RTC_C_CTL0_RDYIE_OFS))
288 intStatus &= ~RTC_C_CLOCK_READ_READY_INTERRUPT;
291 if (!BITBAND_PERI(RTC_C->PS0CTL, RTC_C_PS0CTL_RT0PSIE_OFS))
293 intStatus &= ~RTC_C_PRESCALE_TIMER0_INTERRUPT;
296 if (!BITBAND_PERI(RTC_C->PS1CTL, RTC_C_PS1CTL_RT1PSIE_OFS))
298 intStatus &= ~RTC_C_PRESCALE_TIMER1_INTERRUPT;
304 void RTC_C_clearInterruptFlag(uint_fast8_t interruptFlagMask)
306 if (interruptFlagMask
307 & (RTC_C_TIME_EVENT_INTERRUPT + RTC_C_CLOCK_ALARM_INTERRUPT
308 + RTC_C_CLOCK_READ_READY_INTERRUPT
309 + RTC_C_OSCILLATOR_FAULT_INTERRUPT))
311 RTC_C->CTL0 = RTC_C_KEY
312 | (RTC_C->CTL0 & ~((interruptFlagMask >> 4) | RTC_C_CTL0_KEY_MASK));
313 BITBAND_PERI(RTC_C->CTL0, RTC_C_CTL0_KEY_OFS) = 0;
316 if (interruptFlagMask & RTC_C_PRESCALE_TIMER0_INTERRUPT)
318 BITBAND_PERI(RTC_C->PS0CTL, RTC_C_PS0CTL_RT0PSIFG_OFS) = 0;
321 if (interruptFlagMask & RTC_C_PRESCALE_TIMER1_INTERRUPT)
323 BITBAND_PERI(RTC_C->PS1CTL, RTC_C_PS1CTL_RT1PSIFG_OFS) = 0;
327 void RTC_C_registerInterrupt(void (*intHandler)(void))
329 Interrupt_registerInterrupt(INT_RTC_C, intHandler);
330 Interrupt_enableInterrupt(INT_RTC_C);
333 void RTC_C_unregisterInterrupt(void)
335 Interrupt_disableInterrupt(INT_RTC_C);
336 Interrupt_unregisterInterrupt(INT_RTC_C);