khodowany
57 lines
2.6 KiB
Markdown
57 lines
2.6 KiB
Markdown
# Product Vamp Device Setup
|
|
|
|
## Raspberry Pi Zero 2 W
|
|
|
|
Flash Raspberry Pi OS Lite 64-bit, enable SSH, and boot the device.
|
|
|
|
Install the package tarball from Gitea or build one locally:
|
|
|
|
```sh
|
|
python3 modulus.py package
|
|
```
|
|
|
|
Copy the tarball to the Zero, verify its `.sha256`, unpack it anywhere, and run:
|
|
|
|
```sh
|
|
sudo zero/install_zero.sh
|
|
```
|
|
|
|
The installer loads `zero/product_vamp_zero_linux_arm64.docker.tar`, installs `/etc/product_vamp/vamp.json` if missing, configures NetworkManager AP mode, and enables the systemd units.
|
|
|
|
Project-owned install paths, services, executables, and archives use underscores. The checkout and Git URL remain `product-vamp`. On upgrades, the installer validates and probes the incoming image before removing the old hyphenated Product Vamp paths, services, and network profile. Unrelated services, networks, and data are preserved; symlinked installation paths are rejected.
|
|
|
|
On reinstalls, the installer skips apt entirely when the required OS packages are already present. If packages are missing, the Zero needs upstream internet before the installer can finish provisioning Docker, NetworkManager, and SQLite.
|
|
|
|
Product Vamp owns `tty1` while the display service is running so the DISP-7A shows the appliance UI instead of the Raspberry Pi OS Lite login console. Use SSH for normal administration. `tty2` is enabled as the local fallback console.
|
|
|
|
Defaults:
|
|
|
|
- SSID: `Vamp Control`
|
|
- Passphrase: `vamp-control`
|
|
- Zero IP: `192.168.42.1`
|
|
- API: `http://192.168.42.1:8080`
|
|
|
|
For API-only quick checks, set `runtime.headless` to `true` or run `vamp_zero --once` from a development build.
|
|
|
|
Score inputs are tracked under `data/songs/`. The build/package step generates acoustic, electric, and vocal parts, engraved pages, audio, and the read-only catalog database. Installation replaces these assets together; no database migration or runtime score import is needed.
|
|
|
|
## Raspberry Pi Pico 2 W
|
|
|
|
Hold BOOTSEL while plugging the Pico into USB, then copy:
|
|
|
|
```text
|
|
pico/product_vamp_pico2w.uf2
|
|
```
|
|
|
|
to the mounted `RPI-RP2` drive.
|
|
|
|
The default firmware connects to SSID `Vamp Control` with passphrase `vamp-control`, then talks to `192.168.42.1:8080`.
|
|
|
|
The Pico screen is landscape. Its top bar is blue while connecting, yellow while retrying or when the Zero API is unavailable, and green when the Zero responds. The area below the bar stays blank until a score is active, then it shows the title, selected part, and page count.
|
|
|
|
Controls:
|
|
|
|
- Tap: next menu item or next page.
|
|
- Double tap: previous menu item or previous page.
|
|
- Tap and hold: select the highlighted menu row, or return from score view to the previous menu.
|