Files

T

sirmrakandQwen-Coder adac79e765 Документация: рефакторинг структуры docs/ и очистка мусора

- Перемещена документация в docs/ с четкой структурой:
  - tutorials/ — пошаговые руководства (2mic-hat, installer)
  - integration/ — техническая интеграция (vad-wakeword, mqtt-led)
  - deployment/ — развёртывание (systemd-services)
  - architecture/ — архитектура проекта (overview)
- Обновлён README.md с навигацией по документации
- DEPLOY.md сокращён до quick start с ссылками на docs/
- Добавлен docs/README.md — индекс документации
- Создан QWEN.md — контекст для ИИ-ассистента
- Удалён мусор:
  - wyoming_satellite.zip (build artifact)
  - wyoming-led.service, wyoming-satellite.service (дубликаты)
  - .qwen/settings.json.orig (бэкап)
  - .lgd-nfy0 (пустой файл)
  - docker/run (заглушка)
- Обновлён .gitignore:
  - examples/led_brightness_config.json (автогенерируемый конфиг)
  - *.old, *.bak, *~ (бэкапы)
  - *.zip (архивы)
  - .qwen/settings.json.orig
  - *.lgd-* (пустые файлы)
- led_brightness_config.json исключён из отслеживания (assume-unchanged)

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>

2026-05-19 20:12:20 +03:00

3.4 KiB

Raw Blame History

systemd Services Configuration

Detailed guide for configuring and managing Wyoming Satellite systemd services.

Service Files Location

Service files are in the services/ directory:

services/
├── wyoming-event.service         # LED control + MQTT
├── wyoming-satelite-vosk.service # Main satellite
└── wyoming-wakeword-vosk.service # Wake word detection

Installation Script

The install_systemd_services.sh script automatically:

Detects your virtual environment path
Determines the current user
Substitutes placeholders in service files
Copies services to /etc/systemd/system/
Installs the satellite-python wrapper to /usr/local/bin/

Manual Installation

If the script doesn't work, install manually:

# 1. Edit service files, replacing placeholders:
#    __SAT_BASE_DIR__ → /home/sirmrak/projects/Satellite
#    __SAT_VENV__ → /home/sirmrak/.venv_satellite
#    __CURRENT_USER__ → sirmrak

# 2. Copy to systemd directory
sudo cp services/*.service /etc/systemd/system/

# 3. Reload systemd
sudo systemctl daemon-reload

# 4. Enable and start
sudo systemctl enable --now wyoming-satelite-vosk.service

Service Details

wyoming-satelite-vosk.service

Main Wyoming satellite service. Connects to:

Microphone (arecord)
Speaker (aplay)
Wake word service (optional, port 10400)
Event service (optional, port 10500)

Ports: 10700 (Wyoming protocol)

Dependencies: network.target

wyoming-wakeword-vosk.service

Vosk-based wake word detection service. Listens for Russian wake words:

"привет дроид"
"привет придурок"
"привет жопа с ушами"

Ports: 10400 (Wyoming protocol)

Configuration: local/vosk-wake-dev/wyoming_vosk_wake/config.yaml

wyoming-event.service

LED control and MQTT integration for ReSpeaker XVF3800.

Ports: 10500 (Wyoming event protocol)

MQTT Topics:

wyoming/led/command — Commands from Home Assistant
wyoming/led/brightness/set — Set brightness (0-255)
wyoming/led/brightness/state — Current brightness state
wyoming/led/state — LED state
wyoming/led/availability — Online/offline status

Management Commands

# Check status
sudo systemctl status wyoming-satelite-vosk.service

# View logs (real-time)
journalctl -u wyoming-satelite-vosk.service -f

# Restart service
sudo systemctl restart wyoming-satelite-vosk.service

# Disable service
sudo systemctl disable --now wyoming-satelite-vosk.service

# Reload systemd after changes
sudo systemctl daemon-reload

Troubleshooting

Service won't start

# Check status and recent errors
sudo systemctl status wyoming-satelite-vosk.service

# View full logs
journalctl -u wyoming-satelite-vosk.service -n 100

# Check Python path
which satellite-python
satellite-python --version

Common Issues

Issue	Solution
`ModuleNotFoundError`	Check venv path in service file
`arecord: command not found`	Install `alsa-utils`
Permission denied	Check `User=` directive matches your username
Port already in use	Check if another instance is running

Wrapper Script

The satellite-python wrapper allows running Python from venv without full path:

# Installed to /usr/local/bin/satellite-python
satellite-python --version  # Uses venv Python

Used in service files:

ExecStart=satellite-python -m wyoming_satellite ...

3.4 KiB Raw Blame History