/*************************************************************************************************************
  Copyright (C) 2016-2022 JSC "ICC Milandr" 

*************************************************************************************************************/

/*
 *
 *  Файл:      readme.txt
 *  Описание:  Описание примера RTC_Alarm
 *
 *  История:
 *             06.10.22  - cоздан
 *
 */


/* Описание примера ----------------------------------------------------------------------------------------*/

В данном примере приведено, как настроить часы реального времени RTC и установить будильник для генерации 
запроса прерывания.

Период формирования тик-импульсов устанавливается с помощью макроопределения RTC_TICK_PERIOD_US, значение 
задаётся в микросекундах. Время, через которое будильник должен сформироват запрос прерывания, устанавливается
с помощью макроопределения RTC_ALARM_S, значение задаётся в секундах.

При возникновении прерывания от будильника RTC переключается состояние на выводах PC[1:0] (светодиоды FLAG[1:0])
и установливается новое время для будильник. В основном цикле программа выводит в отладочную консоль текущее 
время часов RTC.

Обратите внимание, что функцию обработчика прерывания необходимо объявлять с атрибутом __attribute((interrupt)).
В этом случае исполняемый обработчик прерывания не может быть прерван другим прерыванием, даже более 
высокоприоритетным.
Если в программе требуется, чтобы исполняемый обработчик прерывания мог быть прерван более высокоприоритетным
прерыванием, то такой обработчик прерывания необходимо объявить с другим атрибутом, а именно 
__attribute__((interrupt("reentrant"))).


/* Содержание каталога -------------------------------------------------------------------------------------*/

    - main.c               Основная программа
    - project.ldf          Файл сценария для компоновщика
    - session.lldbinit     Файл инициализации периферии до запуска отладки
    - .cproject, .project  Файлы конфигурации проекта


/* Аппаратная и программная среда --------------------------------------------------------------------------*/

    - Интегрированная среда разработки CM-LYNX.
    - Отладочная плата для процессора 1967ВН044.


/* Использование -------------------------------------------------------------------------------------------*/

Для запуска примера необходимо выполнить следующие действия:
    - Создать новое или открыть существующее рабочее пространство (Workspace).
    - Выполнить импорт проекта "RTC_Alarm" в соответствии с "ML_GUI_Руководство_пользователя_R_Vx", 
      п. "Импорт существующего проекта".
    - Выполнить сборку проекта.
    - Создать конфигурацию отладки в соответствии с "ML_GUI_Руководство_пользователя_R_Vx", п. "Настройка 
      конфигурации и запуск отладки".
    - Запустить пример в режиме отладки.

Подробное описание библиотеки HAL с примерами использования функций приведено в каталоге по пути:
"CM-LYNX.x.yy.zz\toolchain\1967VN044\HAL\doc".
