Подготовка Radxa ROCK 3A к запуску примеров
Коммутация компьютера и Radxa ROCK 3A
Чтобы видеть вывод с Radxa ROCK 3A на компьютере и иметь возможность отладки, выполните следующие действия:
- Соедините пины преобразователей USB-UART с соответствующими GPIO-пинами Radxa ROCK 3A (см. рис. ниже). Если отладку выполнять не требуется, то достаточно подключить один преобразователь USB-UART для вывода.
Схема соединения преобразователей USB-UART и Radxa ROCK 3A
- Соедините USB-порты компьютера и преобразователи USB-UART.
- Установите PuTTY или другую аналогичную программу. Настройте параметры следующим образом:
bps = 1500000, data bits = 8, stop bits = 1, parity = none, flow control = none
. Задайте порт USB, через который подключен преобразователь USB-UART, используемый для получения вывода с Radxa ROCK 3A.
Чтобы компьютер и Radxa ROCK 3A могли взаимодействовать через сеть Ethernet, выполните следующие действия:
- Соедините сетевые карты компьютера и Radxa ROCK 3A с коммутатором или друг с другом.
- Выполните настройку сетевой карты компьютера, чтобы ее IP-адрес был в одной подсети с IP-адресом сетевой карты Radxa ROCK 3A (параметры сетевой карты Radxa ROCK 3A задаются в файле
dhcpcd.conf
, который находится по пути<название примера>/resources/...
).
Отладка программ на для Radxa ROCK 3A
Для того чтобы выполнять отладку программ, запущенных на Radxa ROCK 3A, необходимо:
- Подключить второй преобразователь USB-UART (см. рис. выше).
- В домашней директории пользователя создать файл
.gdbinit
и добавить в него следующие строки:set sysroot /opt/KasperskyOS-Community-Edition-<version>/sysroot-aarch64-kos add-symbol-file <path_to_debuggee>/build/einit/EinitQemu-kss/ksm.module set follow-fork-mode parent set follow-exec-mode same set detach-on-fork off set schedule-multiple on set serial baud 115200 target extended-remote /dev/ttyUSB[n] - В файл
CmakeLists.txt
в директории<path_to_debuggee>/einit
добавить параметрGDBSTUB_KERNEL
в вызов командыbuild_kos_hw_image ()
. - Выполнить сборку программы. После запуска и инициализации в выводе появится запись:
[KDBG ] Waiting for GDB connection infinitely
. Приложение остановится, ожидая подключения отладчика. - Для подключения отладчика необходимо запустить gdb из SDK:
/opt/KasperskyOS-Community-Edition-<version>/toolchain/bin/aarch64-kos-gdb
. - После запуска отладчика в выводе появится запись:
[KDBG ] Connection to GDB was established
.Подробнее см. "Подготовка к отладке на аппаратной платформе" и "Начальные шаги отладки на аппаратной платформе".
Подготовка загрузочной SD-карты для Radxa ROCK 3A
Если при сборке примера был создан образ hdd.img
, то достаточно записать получившийся образ на SD-карту. Для этого подключите SD-карту к компьютеру и выполните следующую команду:
Если при сборке примера был создан образ kos-image
, то перед записью образа на SD-карту, её нужно дополнительно подготовить. Загрузочную SD-карту для Radxa ROCK 3A можно подготовить автоматически и вручную. После подготовки SD-карты, необходимо скопировать файл kos-image
из директории <название примера>/build/einit
в загрузочную область (раздел с FAT32) подготовленной SD-карты.
Чтобы подготовить загрузочную SD-карту автоматически, подключите SD-карту к компьютеру и выполните следующие команды:
Очистка flash памяти Radxa ROCK 3A
В некоторых модификациях Radxa ROCK 3A во флеш-памяти может находиться загрузчик, который несовместим с картой, подготовленной по инструкции выше.
Если при запуске примеров на Radxa ROCK 3A вы видите сообщение "SPL: failed to boot from all boot devices"
, то вам необходимо очистить флеш-память Radxa ROCK 3A перед запуском примеров.
Чтобы очистить флеш-память Radxa ROCK 3A:
- Скачайте и установите утилиту
rkdeveloptool
.Инструкции по установке утилиты приведены в документации: https://docs.radxa.com/en/rock3/rock3a/low-level-dev/rkdeveloptool?host-os=debian#installation-for-rkdeveloptool
- Скачайте загрузчик для взаимодействия с Radxa ROCK 3A: https://dl.radxa.com/rock3/images/loader/rk356x_spl_loader_ddr1056_v1.12.109_no_check_todly.bin
- Переведите Radxa ROCK 3A в режим
Maskrom
:- Отключите питание.
- Извлеките SD-карту (и модуль eMMC при наличии).
- Соедините USB-порт компьютера с портом ROCK 3A OTG (верхний порт USB3.0).
- Соедините пины Radxa ROCK 3A как показано на рисунке ниже и подайте питание на Radxa ROCK 3A.
- Разомкните пины, соединенные на предыдущем шаге.
- Убедитесь, что Radxa ROCK 3A находится в режиме
Maskrom
, выполнив в терминале следующую команду:$: rkdeveloptool ld DevNo=1 Vid=0x2207,Pid=0x350a,LocationID=104 Maskrom
- Скопируйте на Radxa ROCK 3A загрузчик для инициализации оперативной памяти и подготовки среды прошивки, выполнив в терминале следующую команду:rkdeveloptool db rk356x_spl_loader_ddr1056_v1.12.109_no_check_todly.bin
- Очистите флеш-память Radxa ROCK 3A, выполнив в терминале следующие команды:rkdeveloptool ef rkdeveloptool rd