Пример gpio_input

Пример демонстрирует использование драйвера GPIO для ввода через GPIO-пины.

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

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

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

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

• 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_input расположен файл Client.edl – EDL-описание программы Client.

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

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

• Инициализирует драйверы: BSP и GPIO.
• Открывает GPIO-порты с именами gpio0, gpio1, ... (общее количество открываемых портов задается в макросе GPIO_BANK_COUNT).
• Настраивает все GPIO-пины, кроме указанных в массиве исключений ExceptionPinArr, как входные с включённой внутренней подтяжкой к логическому нулю (GPIO_DIR_IN | GPIO_PULL_MODE_DOWN).

  Общее количество GPIO-пинов на плате задается макросом GPIO_PIN_NUM.

  ExceptionPinArr – массив номеров GPIO-пинов, которые необходимо исключить из обработки (например, используемых для отладочного UART-соединения).

• Последовательно считывает состояния всех GPIO-пинов (кроме исключенных) и выводит в консоль сообщения об этих состояниях. Задержка между считываниями смежных пинов задается макросом DELAY_S (время указывается в секундах).
• Закрывает GPIO-порты, деинициализирует драйвера и завершает свою работу с кодом EXIT_SUCCESS при отсутствии ошибок.

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

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

Для корректной работы примера gpio_input необходимо подать напряжение 3,3 В (логическая единица) на все GPIO-пины, кроме указанных в массиве ExceptionPinArr.

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