6. Установка ПО Raspberry Pi (LE)

6.1. Требования к программной платформе

• На целевом устройстве Raspberry Pi 4 B должна быть установлена операционная система Ubuntu Server 24.04 LTS.
• Для работы ПО должен существовать пользователь uwblandle, включённый в группу dialout (для доступа к UART).
• Настройка сети и зависимостей не требуется — все необходимые действия выполняются во время установки.

6.2. Состав пакета установки

ПО распространяется в виде архива:
uwblandle-rpi4b.deploy.tar.gz

После распаковки структура архива следующая:

uwblandle_deploy/
├── bin/uwblandle                # Исполняемый файл LE
├── config/config.json           # Конфигурационный файл
├── service/uwblandle.service    # systemd-юнит
├── scripts/install.sh           # Скрипт установки
├── scripts/update.sh            # Скрипт обновления
└── scripts/uninstall.sh         # Скрипт удаления (служебный)

6.3. Установка программного обеспечения

1. Скопировать архив на Raspberry Pi в каталог /tmp:

   scp uwblandle-rpi4b.deploy.tar.gz user@<rpi_ip>:/tmp/
   

2. Распаковать архив и перейти в каталог установки:

   cd /tmp
   tar -xzvf uwblandle-rpi4b.deploy.tar.gz
   cd uwblandle_deploy
   

3. Запустить установку:

   ./scripts/install.sh
   

   Скрипт выполняет:

   • создание пользователя uwblandle (если отсутствует);
   • создание каталогов /home/uwblandle/config/ и /home/uwblandle/logs/;
   • установку бинарного файла /home/uwblandle/bin/uwblandle;
   • копирование config.json и юнита systemd;
   • регистрацию и запуск службы uwblandle.service.

6.4. Проверка установки

После установки убедитесь, что служба активна:

systemctl status uwblandle.service

Состояние должно быть active (running).
Для просмотра журнала работы в реальном времени:

journalctl -u uwblandle.service -f

Файлы логов создаются в:

/home/uwblandle/logs/uwb_landing_system.log
/home/uwblandle/logs/uwb_landing_system.bin

6.5. Каталоги и установленные файлы

6.6. Обновление программного обеспечения

Для обновления установленного ПО:

1. Скопировать новый архив uwblandle-rpi4b.deploy.tar.gz в каталог /tmp.

2. Выполнить команды:

   cd /tmp
   tar -xzvf uwblandle-rpi4b.deploy.tar.gz
   cd uwblandle_deploy
   ./scripts/update.sh
   

   Скрипт автоматически остановит службу, заменит бинарные и служебные файлы,
   сохранит конфигурацию и перезапустит uwblandle.service.

3. Проверить состояние после обновления:

   systemctl status uwblandle.service
   

6.7. Проверка версии приложения

Версия установленного программного обеспечения отображается в начале файла лога:

/home/uwblandle/logs/uwb_landing_system.log

Пример вывода при запуске:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                        RTLS UWB UAV Landing System
  Version:   1.0.0
  Git:       14038cf (tag: unknown)
  Toolchain: GNU 13.3.0 (Linux) Debug C++20
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━