Пример uart

Пример демонстрирует использование драйвера универсального асинхронного приемопередатчика (УАПП, англ. Universal Asynchronous Receiver-Transmitter, UART) в KasperskyOS.

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

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

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

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

• Client – прикладная программа, которая использует интерфейс драйвера UART. Полное описание интерфейса драйвера UART содержится в файле /opt/KasperskyOS-Community-Edition-<platform>-<version>/sysroot-*-kos/include/uart/uart.h.
• UART – драйвер для работы с универсальным асинхронным приемопередатчиком.
• DCM – системная программа, позволяющая динамически создавать IPC-каналы.

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

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

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

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

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

Файл security.psl содержит описание политики безопасности решения и генерируется в процессе сборки решения на основе шаблона ./einit/src/security.psl.in. Подробнее см. "Шаблон security.psl.in".

Описание политики безопасности решения в этом примере разрешает любые взаимодействия процессов между собой и ядром. Эту политику можно использовать только в качестве заглушки на ранних стадиях разработки решения, чтобы модуль безопасности не препятствовал взаимодействиям. В реальном решении на базе KasperskyOS применять такую политику недопустимо.

Ресурсы

В директории ./resources/xdl/uart содержится EDL-описание для программы Client.

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

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

1. Переносит журналирование в пользовательское пространство, чтобы получить эксклюзивный доступ к UART-порту.
2. Инициализирует драйвер UART.
3. Открывает порт с номером, заданным макросом PORT_NAME, и настраивает его с заданными параметрами.
4. Отправляет строку Hello world with UART! в открытый порт.
5. Закрывает порт, деинициализирует драйвер и завершает программу с кодом EXIT_SUCCESS при отсутствии ошибок, иначе – EXIT_FAILURE.

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

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

Для корректной работы примера на Radxa ROCK 3A выполните следующие действия:

• Подключите вывод UART8_TX_M1 (пин 29) на плате Radxa ROCK 3A к выводу RXD преобразователя USB-UART.
• Примените DTBO-оверлей rk3568-uart2-m0.dtbo к бинарному файлу описания аппаратной конфигурации rk3568-rock-3a.dtb согласно инструкции по применению оверлеев в разделе "Сборка драйверов для аппаратной платформы Radxa ROCK 3A".

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