Пример i2c_ds1307_rtc

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

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

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

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

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

• В пример входят системные программы, поставляемые в загрузочном образе KasperskyOS, а также дополнительные системные программы и драйверы, необходимые для работы с эмулятором или конкретной аппаратной платформе, где будет запускаться решение. Подробнее см. "Архитектура и запуск решения на базе KasperskyOS".

  Системные программы добавляются в образ решения автоматически при сборке.

• I2cClient – прикладная программа, которая использует интерфейс драйвера I2C. – прикладная программа, изменяющая текущее системное время. В скрипте сборки программы (файл ./i2c_client/CMakeLists.txt) содержатся инструкции для упаковки прикладной программы в KPA-пакет.

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

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

Дополнительные файлы

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

Файл ./einit/CMakeLists.txt содержит инструкции для сборки загрузочного образа KasperskyOS.

В директории ./einit/src/ расположены файлы настроек системной программы ServiceManager, которая отвечает за установку и запуск KPA-пакетов:

• Файл initial_install.json содержит список KPA-пакетов, которые должны быть установлены при первом запуске KasperskyOS.
• Файл system_services.json содержит список установленных программ, которые должны запускаться каждый раз при запуске KasperskyOS.

Файлы ./einit/src/product_init_qemu.yaml и ./einit/src/product_init_rpi4.yaml и ./einit/src/product_init_opirv2.yaml содержат параметры запуска системных программ DNetSrv, VfsNet, UART и подсистемы логирования в формате Init-описания.

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

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

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

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

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

Для корректной работы примера необходимо подключить к 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).

Схема подключения DS1307Z к OrangePi RV2:

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

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