Пример i2c_ds1307_rtc

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

Этот пример предназначен только для запуска на Raspberry Pi.

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

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

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

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

• I2cClient – прикладная программа, которая использует интерфейс драйвера I2C.
• I2C – драйвер I2C.
• DCM – системная программа, позволяющая динамически создавать IPC-каналы.

При сборке примера для целевой аппаратной платформы в решение автоматически включаются драйверы:

• BSP – пакет поддержки аппаратной платформы (Board Support Package), обеспечивающий кросс-платформенную настройку периферии для Raspberry Pi 4 B.
• Bcm2711MboxArmToVc – драйвер для работы с сопроцессором VideoCore (VC6) через технологию mailbox для Raspberry Pi 4 B.

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

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

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

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

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

Файлы описания политики безопасности решения на базе KasperskyOS находятся в директории ./einit/src.

Файл security.psl содержит описание политики безопасности решения. Этот файл является файлом верхнего уровня, в который через декларацию use включена часть описания политики безопасности решения в виде PSL-файла dynld.psl. (Декларации в PSL-файле снабжены комментариями, которые поясняют назначение этих деклараций.) Файл dynld.psl содержит часть описания политики безопасности, используемую при динамической компоновке компонентов решения.

Ресурсы

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

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

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

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

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

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

Для корректной работы примера необходимо подключить к I2C-порту модуль часов реального времени на базе микросхемы DS1307Z. Схема подключения DS1307Z к Raspberry Pi:

• SDA (Serial Data) подключите к GPIO 0 (пин 27);
• SCL (Serial Clock) подключите к GPIO 1 (пин 28);
• VCC подключите к 5V power (пин 2 или 4);
• GND подключите к Ground (пин 6).

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