====== IrtcSetAlarm1() ======

''IrtcSetAlarm1()'' sets alarm 1, including seconds.

{{:en-us_commands:reference:irtcsetalarm1.svg?900|IrtcSetAlarm1 command operation flow}}

''bool IrtcSetAlarm1(uint8_t mode, uint8_t dayOrDate = 1, uint8_t hour = 0, uint8_t minute = 0, uint8_t second = 0)''

===== Commands =====

^ Command ^ Arguments ^ Return Value ^ Operation ^
| ''IrtcSetAlarm1(mode, dayOrDate, hour, minute, second)'' | ''uint8_t mode''\\ ''uint8_t dayOrDate = 1''\\ ''uint8_t hour = 0'' — ''0~23''\\ ''uint8_t minute = 0'' — ''0~59''\\ ''uint8_t second = 0'' — ''0~59'' | ''bool'' | Sets alarm 1, including seconds. |


===== Example =====

<code cpp>
void setup() {
  Serial.begin(115200);
  if (!IrtcBegin()) return;  // Check the DS3231 RTC connection and begin operation.
  IrtcSetAlarm1(IRTC_ALARM1_MATCH_HOUR_MINUTE_SECOND, 1, 8, 30, 0);  // Set alarm 1, including seconds.
  IrtcSetAlarm2(IRTC_ALARM2_MATCH_HOUR_MINUTE, 1, 17, 30);  // Set alarm 2 with minute resolution.
  IrtcAlarmEnable(1, true);  // Enable or disable the specified alarm.
  IrtcAlarmEnable(2, true);  // Enable or disable the specified alarm.
}

void loop() {
  bool alarm1Enabled = false;
  bool alarm1Triggered = false;
  IrtcAlarmEnabled(1, alarm1Enabled);  // Check whether the specified alarm is enabled.
  if (alarm1Enabled && IrtcAlarmTriggered(1, alarm1Triggered, true) && alarm1Triggered) {  // Check whether an alarm has triggered and optionally clear its status.
    Serial.println(F("alarm 1"));
  }
  delay(50);
}
</code>

===== Precautions =====

Run each device's corresponding ''Begin'' command first. Check I²C addresses and pin sharing; if the ''bool'' return value is ''false'', inspect wiring and power.

===== Built-in Commands in the Same Category =====

  * [[:en-us_commands:reference:irtcbegin|IrtcBegin() View detailed description]]
  * [[:en-us_commands:reference:irtcread|IrtcRead() View detailed description]]
  * [[:en-us_commands:reference:irtcset|IrtcSet() View detailed description]]
  * [[:en-us_commands:reference:irtcunixtime|IrtcUnixTime() View detailed description]]
  * [[:en-us_commands:reference:irtcgettemperature|IrtcGetTemperature() View detailed description]]
  * [[:en-us_commands:reference:irtctimevalid|IrtcTimeValid() View detailed description]]
  * [[:en-us_commands:reference:irtcclearoscillatorstopflag|IrtcClearOscillatorStopFlag() View detailed description]]
  * [[:en-us_commands:reference:irtcsetalarm2|IrtcSetAlarm2() View detailed description]]
  * [[:en-us_commands:reference:irtcalarmenable|IrtcAlarmEnable() View detailed description]]
  * [[:en-us_commands:reference:irtcalarmenabled|IrtcAlarmEnabled() View detailed description]]
  * [[:en-us_commands:reference:irtcalarmtriggered|IrtcAlarmTriggered() View detailed description]]
  * [[:en-us_commands:reference:irtcsquarewave|IrtcSquareWave() View detailed description]]
  * [[:en-us_commands:reference:irtc32khz|Irtc32kHz() View detailed description]]

[[:en-us_commands:builtin|← Built-in Command List]]