Commit graph

3 commits

Author SHA1 Message Date
Me Here
f0a07c269d Restructure into a reusable, genericized deploy kit
Reorganize the repo so it can rebuild the audio hub on any Pi, not just
the live `adac` box:

- README.md: now a project landing page (overview, repo map, deploy
  summary) instead of the adac-specific maintenance guide.
- MAINTENANCE.md: the "how it's wired / day-to-day upkeep" guide,
  genericized with <pi-host>/<pi-ip>/<lan-cidr>/<desktop-host> placeholders.
- config/: the actual PipeWire/WirePlumber drop-ins as deploy-ready
  templates (<VOLT_SOURCE>/<VOLT_SINK>/<LAN_CIDR> placeholders, with the
  commands to resolve them in each file's header comment).
- systemd/bt-agent.service, firmware/config.txt.snippet: the remaining
  deployable artifacts.
- instances/adac.md: the live deployment's real values (host, IP, Volt
  serial, paired phones, history) — the one place machine-specific data
  lives.
- RUNBOOK.md: replace the hardcoded LAN subnet with <lan-cidr>.
- root-README.md: genericized; .gitignore keeps local harness settings out.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 08:06:03 -05:00
Me Here
9507f259d9 Add audio hub maintenance guide and root redirect README
README.md: maintenance guide describing how the adac PipeWire audio
hub is wired together — the four audio paths, the five config drop-ins,
services, firmware, and common maintenance tasks. Written as a mental
model for upkeep rather than install/troubleshooting commands.

root-README.md: short redirect telling anyone on the root account to
log in as the `user` account (PipeWire is a per-user service), pointing
to the maintenance guide.

These mirror the files deployed at /home/user/README.md and
/root/README.md on the Pi.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 07:23:55 -05:00
Me Here
e0a2b8df5b Add Raspberry Pi 4 PipeWire audio hub runbook
Manual SSH setup guide: PipeWire 1.4/WirePlumber 0.5 from Trixie stock, UA Volt 476P (outputs 1/2 + inputs 3/4), Bluetooth A2DP sink, network audio (mixer return -> OBS, desktop -> outputs 3/4), boot persistence, troubleshooting, and teardown. Validated on hardware.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-23 02:57:56 -05:00