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. Установка программного обеспечения

Скопировать архив на Raspberry Pi в каталог /tmp:
```
scp uwblandle-rpi4b.deploy.tar.gz user@<rpi_ip>:/tmp/
```
Распаковать архив и перейти в каталог установки:
```
cd /tmp
tar -xzvf uwblandle-rpi4b.deploy.tar.gz
cd uwblandle_deploy
```
Запустить установку:
```
./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. Каталоги и установленные файлы

Путь	Назначение
`/home/uwblandle/bin/uwblandle`	Исполняемый файл LE
`/home/uwblandle/config/config.json`	Конфигурационный файл
`/home/uwblandle/logs/`	Каталог логов
`/etc/systemd/system/uwblandle.service`	Systemd-юнит службы

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

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

Скопировать новый архив uwblandle-rpi4b.deploy.tar.gz в каталог /tmp.
Выполнить команды:
```
cd /tmp
tar -xzvf uwblandle-rpi4b.deploy.tar.gz
cd uwblandle_deploy
./scripts/update.sh
```
Скрипт автоматически остановит службу, заменит бинарные и служебные файлы,
сохранит конфигурацию и перезапустит uwblandle.service.
Проверить состояние после обновления:
```
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
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━