Пример i2c_bm8563_rtc

Пример демонстрирует работу с I2C (Inter-Integrated Circuit) для управления модулем часов реального времени на базе микросхемы BM8563 в KasperskyOS.

Этот пример предназначен только для запуска на Radxa ROCK 3A.

Директория примера в SDK

Код примера и скрипты для сборки находятся по следующему пути:

/opt/KasperskyOS-Community-Edition-<platform>-<version>/examples/i2c_bm8563_rtc

Список программ

• BM8563 – прикладная программа, которая использует интерфейс драйвера I2C.
• I2C – драйвер I2C.
• DCM – системная программа, позволяющая динамически создавать IPC-каналы.
• BSP – пакет поддержки аппаратной платформы (англ. Board Support Package). Обеспечивает кросс-платформенную настройку периферии.

Для корректной работы драйверов I2C и BSP необходимо выполнить следующие условия:

• скомпоновать программу BM8563 с клиентскими библиотеками i2c::process_interface и bsp::client;
• создать IPC-каналы между программами: BM8563 и I2C, BM8563 и BSP.

Описание инициализации

Файл описания инициализации решения init.yaml генерируется в процессе сборки решения на основе шаблона ./einit/src/init.yaml.in. Макросы вида @INIT_*@, которые содержатся в шаблоне, автоматически раскрываются в итоговом файле init.yaml. Подробнее см. "Шаблон init.yaml.in".

Описание политики безопасности

Файл security.psl содержит описание политики безопасности решения на базе KasperskyOS и находится в директории ./einit/src. Декларации в PSL-файле снабжены комментариями, которые поясняют назначение этих деклараций.

Ресурсы

В директории ./resources/xdl/bm8563_rtc содержится файл BM8563.edl – EDL-описание для программы BM8563.

Сценарий работы

Программа BM8563 выполняет следующие действия:

1. Инициализирует драйвер BSP и применяет предопределенную конфигурацию модуля I2C, настраивая мультиплексирование выводов для указанного I2C-канала.
2. Инициализирует драйвер I2C и открывает I2C-канал для работы.
3. Последовательно считывает текущие значения регистров часов реального времени (начиная с регистра, заданного макросом BM8563_SECONDS_REG) и выводит их в стандартный вывод ошибок в формате даты и времени.
4. Приостанавливает работу часов установкой бита BM8563_STOP_RTC_BIT в регистр управления BM8563_CTRLSTS1_REG.
5. Считывает и выводит обновленные значения регистров часов для подтверждения остановки.
6. Записывает тестовые значения даты и времени в регистры (начиная с регистра BM8563_SECONDS_REG).
7. Запускает часы сбросом бита остановки (запись нулевого значения в регистр BM8563_CTRLSTS1_REG).
8. Считывает и выводит обновленные значения регистров часов для подтверждения запуска.
9. Закрывает I2C-канал и завершает свою работу с кодом EXIT_SUCCESS при отсутствии ошибок, иначе – EXIT_FAILURE.

Сборка и запуск примера

Для сборки и запуска примера используется система CMake из состава KasperskyOS Community Edition.

См. "Сборка и запуск примеров".