inkplate10/advanced/rtc/rtc_alarm_interrupt

# RTC Alarm Interrupt

RTC alarm interrupt example for Soldered Inkplate 10.

## Overview

Sets RTC time to 14:30:00 and an alarm at 14:31:00. The RTC INT pin (GPIO 39) triggers a GPIO interrupt which directly notifies the main task via FreeRTOS task notification. When the alarm fires the display shows "ALARM!". The display also refreshes every 60 s via timeout if no interrupt arrives sooner.

## Hardware Required

- Soldered Inkplate 10
- USB cable
- CR2032 battery (optional, keeps RTC running without USB power)

## Setup

Run `idf.py menuconfig` and navigate to:
**Inkplate Boards → Inkplate10**

## Build and Flash

```
idf.py build
idf.py -p PORT flash monitor
```

## Expected Output

- Display shows current time.
- "ALARM!" appears approximately 60 s after boot.

## Notes

- GPIO 39 is the RTC INT pin (active-low, stays low until alarm flag is cleared).
- `GPIO_INTR_LOW_LEVEL` is used instead of edge — reliable even if the falling edge occurs during display refresh.
- ISR disables its own interrupt; main loop re-enables after `clearAlarmFlag()`.
- FreeRTOS task notification is used for ISR-to-task signalling (safer than a volatile flag on dual-core ESP32).
- `lv_refr_now()` renders the LVGL scene into the framebuffer.
- `display.display()` must be called to update the physical e-paper panel.

## Resources

- Docs: https://docs.soldered.com/inkplate
- Support: https://forum.soldered.com/
- Image tool: https://tools.soldered.com/tools/image-converter/

To create a project from this example, run:

idf.py create-project-from-example "solderedelectronics/inkplate_lvgl=1.1.1:inkplate10/advanced/rtc/rtc_alarm_interrupt"

or download archive (~3.96 KB)