Пример gpio_echo

Пример демонстрирует использование драйвера GPIO для проверки функциональности ввода/вывода GPIO-пинов, а также работу прерываний для GPIO-пинов.

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

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

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

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

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

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

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

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

Файл описания инициализации решения 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/gpio_echo расположен файл Client.edl – EDL-описание программы Client.

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

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

• Инициализирует драйверы: BSP и GPIO. Открывает GPIO-порт с именем, заданным в макросе HW_MODULE_NAME.
• Настраивает GPIO-пины:
  • пин с номером, заданным в макросе GPIO_PIN_OUT, настраивается как выходной;
  • пин с номером, заданным в макросе GPIO_PIN_IN, настраивается как входной с включенными прерываниями при переходе состояния (макрос IN_MODE).
• Устанавливает пин вывода в состояние логической единицы и проверяет, что событие прерывания было зафиксировано от пина ввода. Проверяет, что состояние пина ввода соответствует логической единице.
• Устанавливает пин вывода в состояние логического нуля и проверяет получение события прерывания от пина ввода. Проверяет, что состояние пина ввода соответствует логическому нулю.
• Закрывает GPIO-порт, деинициализирует драйвера и завершает свою работу с кодом EXIT_SUCCESS при отсутствии ошибок.

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

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

Для корректной работы примера gpio_echo необходимо физически соединить пин вывода (номер пина задается в макросе GPIO_PIN_OUT) с пином ввода (GPIO_PIN_IN). Это обеспечивает обратную связь, при которой изменение состояния пина вывода вызывает событие прерывания на пине ввода.

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