Jump to main content

##

# 1.14 RTC Alarm Interrupt

This example shows how to use the RTC to configure the time and generate the alarm.

## Description

This example application shows how to setup system time and configure alarm using the RTC Peripheral Library. The application sets up an alarm to be generated after 20 seconds of the configured system time. The application displays a message on the alarm trigger.

## Downloading and Building the Application

To clone or download this application from Github, go to the main page of this repository and then click Clone button to clone this repository or download as zip file. This content can also be downloaded using content manager by following these instructions.

Path of the application within the repository is apps/rtc/rtc_alarm/firmware/.

To build the application, refer to the following table and open the project using its IDE.

Project Name | Description
--- | ---
pic32cx_sg41_cult.X | MPLABX project for PIC32CX SG41 Curiosity Ultra Evaluation Board

## Setting Up the Hardware

The following table shows the target hardware for the application projects.

Project Name | Board
--- | ---
pic32cx_sg41_cult.X | PIC32CX SG41 Curiosity Ultra Evaluation Board

### Setting Up PIC32CX SG41 Curiosity Ultra Evaluation Board

- Connect the Debug USB port on the board to the computer using a micro USB cable

## Running the Application

1. Open the Terminal application (Ex.: Tera term) on the computer
2. Connect to the EDBG Virtual COM port and configure the serial settings as follows:
   - Baud : 115200
   - Data : 8 Bits
   - Parity : None
   - Stop : 1 Bit
   - Flow Control : None
3. Build and Program the application project using its IDE
4. The console displays the current time and the alarm time (System time starts at 12:00:00 and gets updated every second)
5. Once the alarm time is reached, it print the alarm message and turns on the LED (System time keeps updating)
   Following table provides the LED name:

   Board | LED Name
   --- | ---
   PIC32CX SG41 Curiosity Ultra Evaluation Board | LED1