car_ui/docs/first-system-setup.md
2026-09-15 16:14:49 +03:00

101 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# First system setup
Первоначальная настройка Raspberry Pi для запуска Car UI.
Инструкция рассчитана на Debian 13 (Trixie).
## 1. Установить системные зависимости
```bash
sudo apt update
sudo apt install \
python3 \
python3-venv \
rfkill \
bluetooth \
bluez \
fonts-noto
```
## 2. Настроить пользователя
Добавить пользователя в группы, необходимые для работы с оборудованием:
```bash
sudo usermod -aG audio,video,render,input,bluetooth cheykrym
```
После изменения групп необходимо перелогиниться или перезагрузить систему:
```bash
sudo reboot
```
Проверить группы:
```bash
groups cheykrym
```
## 3. Проверить Bluetooth вручную
Проверить состояние RFKill:
```bash
rfkill list
````
При необходимости вручную снять блокировку:
```bash
sudo rfkill unblock bluetooth
```
Проверить Bluetooth service:
```bash
systemctl status bluetooth.service
```
При автоматическом запуске снятие RFKill-блокировки выполняется
`bt-unblock.service`.
## 4. Подготовить проект
Перейти в директорию проекта и выполнить:
```bash
./scripts/build.sh
```
Скрипт автоматически:
* создаст `.venv`, если его ещё нет;
* установит Python-зависимости из `requirements.txt`;
* соберёт приложение через PyInstaller.
Готовая сборка появится в:
```text
dist/car_ui/
```
## 5. Установить приложение
```bash
sudo ./scripts/deploy.sh
```
Приложение будет установлено в:
```text
/opt/car_ui/
```
## 6. Настроить автоматический запуск
После установки приложения выполнить настройку systemd согласно:
[`docs/auto-start.md`](auto-start.md)