RTCC.alarmRepeatEveryHour

Name

 * RTCC.alarmRepeatEveryHour

Description
Sets the alarm of the Real Time Clock and Calendar (RTCC) to occur when the value of the minutes and the seconds in the RTC Time Value Register (RTCTIME) matches the value of the minutes and the seconds in the Alarm Time Value Register (ALRMTIME). In this instance the values in the RTC Date Value (RTCDATE) and Alarm Date Value (ALRMDATE) Registers have no effect on the operation of the alarm.

If the alarm time is set for, say, 23:12:14 then, subject to the other alarm settings, the alarm will occur every time the minutes and seconds are 12:14, i.e. at 12:14 of every hour of every day of every year - in other words once every hour.

Details of the which parts of the RTCTIME and RTCDATE Registers are compared with the ALRMTIME and ALRMDate Registers for the various alarmRepeat periods can be found in Figure 29-7: Alarm Mask Settings of the Microchip PIC32 Family Reference Manual, Section 29. Real-Time Clock and Calendar (RTCC) (see below).

Note 1: The various RTCC.RepeatAlarmEvery~ functions are mutually exclusive and the alarm operation is determined by the last such function used, i.e. if the RTCC.RepeatAlarmEveryHour function is used followed by RTCC.RepeatAlarmEveryDay function then the alarm occurs every day as the effect of the earlier function (RTCC.RepeatAlarmEveryHour) is overwritten by the later function (RTCC.RepeatAlarmEveryDay).

Note 2: The behaviour of the RTCC Alarm is dependent not only on the values in the Alarm Time Value Register (ALRMTIME) and in the Alarm Date Value Register (ALRMDATE) but also the values in the RTC Alarm Control Register (RTCALRM) which are determined by other settings including the various RTCC.AlarmRepeat~ functions.

Note 3: Only works for 32-bit Pinguinos with a 32,768 kHz quartz crystal which allows the use of the built-in RTCC functionality of the PIC32, such as the Olimex PIC32 Pinguino OTG.

Syntax
void RTCC.alarmRepeatEveryHour(void)


 * Parameters:
 * [None]


 * Returns/Output:
 * [None]