sirmrakandQwen-Coder
adac79e765
- Перемещена документация в 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>
78 lines
2.3 KiB
Markdown
Executable File
78 lines
2.3 KiB
Markdown
Executable File
# Interactive Installer Tutorial
|
|
|
|
Create a voice satellite using a Raspberry Pi 3+ and USB microphone and speakers.
|
|
|
|
**Prerequisites:** See [Deployment Guide](../../DEPLOY.md) for base installation.
|
|
|
|
## Install OS
|
|
|
|
Follow instructions to [install Raspberry Pi OS](https://www.raspberrypi.com/software/). Under "Choose OS", pick "Raspberry Pi OS (other)" and "Raspberry Pi OS (**64-bit**) Lite".
|
|
|
|
When asking if you'd like to apply customization settings, choose "Edit Settings" and:
|
|
|
|
* Set a username/password
|
|
* Configure the wireless LAN
|
|
* Under the Services tab, enable SSH and use password authentication
|
|
|
|
## Install Dependencies
|
|
|
|
After flashing and booting the satellite, connect to it over SSH using the username/password you configured during flashing.
|
|
|
|
**On the satellite**, make sure system dependencies are installed:
|
|
|
|
```sh
|
|
sudo apt-get update
|
|
sudo apt-get install --no-install-recommends \
|
|
git \
|
|
python3-venv
|
|
```
|
|
|
|
Clone the `wyoming-satellite` repository:
|
|
|
|
```sh
|
|
git clone https://github.com/rhasspy/wyoming-satellite.git
|
|
```
|
|
|
|
Now you can run the installer:
|
|
|
|
```sh
|
|
cd wyoming-satellite/
|
|
python3 -m installer
|
|
```
|
|
|
|
## Satellite
|
|
|
|
Under the "Satellite" menu, select "Satellite Type" and choose "Local wake word detection" (with the space bar).
|
|
|
|
## Microphone
|
|
|
|
Make sure you USB microphone is plugged in.
|
|
|
|
Under the "Microphone" menu, select "Autodetect", and speak loudly into the microphone for a few seconds.
|
|
|
|
In "Audio Settings", set "Noise Suppression" to "Medium" and "Auto Gain" to 15.
|
|
|
|
## Speakers
|
|
|
|
Make sure your USB speakers are plugged in.
|
|
|
|
Under the "Speakers" menu, choose "Test All Speakers". For each device, choose "Play Sound" and listen. If you hear the sound, select "Choose This Device"; otherwise, select "Next Device".
|
|
|
|
In "Toggle Feedback Sounds", enable "On wake-up" and "After voice command" (with the space bar).
|
|
|
|
## Wake Word
|
|
|
|
Under the "Wake Word" menu, select "Wake Word System" and choose "openWakeWord" (with the space bar). When prompted, install openWakeWord.
|
|
|
|
In the "openWakeWord" menu, choose "Download Community Wake Words". Back in the "Wake Word" menu, select "Choose Wake Word" and select one (with the space bar).
|
|
|
|
## Apply Settings
|
|
|
|
From the main menu, select "Apply Settings" and enter your password.
|
|
|
|
Check logs with:
|
|
|
|
```sh
|
|
sudo journalctl -f -u wyoming-satellite.service
|
|
```
|