Пример gpio_echo

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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