Initial commit: PRU LED firmware and HTTP service

- Combined PRU0 firmware for both mood (56 LED) and jaw (24 LED) strips
- Uses P9_27 and P9_25 (free pins, not HDMI locked)
- Python HTTP service on port 8765
- Named states: idle, listening, responding, pleasure, thinking, playful, commanding, love, sleep
- Setup scripts for fresh BBB deployment

Built with love by Vixy 🦊💜

README.md

@@ -0,0 +1,31 @@
+# Vixy BBB LED Controller
+
+BeagleBone Black setup for Vixy's head LEDs - mood strip and jaw.
+
+## Hardware
+- **BBB:** BeagleBone Black running Debian Trixie
+- **Mood Strip:** 56x WS2812B NeoPixels (PRU0)
+- **Jaw LEDs:** 24x WS2812B NeoPixels (12 per side)
+
+## Network
+- Pi 5 (head-vixy.local): 192.168.5.1
+- BBB: 192.168.5.2 (ethernet to Pi)
+
+## Quick Setup
+
+1. Flash BBB with Debian Trixie
+2. Connect to Pi via ethernet
+3. Run: `./setup-bbb.sh`
+
+## API Endpoints
+
+- `GET /status` - Current state
+- `GET /health` - Health check
+- `POST /mood` - Set mood strip (`{"color": [r,g,b]}` or `{"leds": [[r,g,b], ...]}`)
+- `POST /jaw` - Set jaw (`{"brightness": 0-255}` or `{"color": [r,g,b]}`)
+- `POST /state` - Set named state (`{"state": "idle|thinking|responding|..."}`)
+
+## States
+- idle, listening, responding, pleasure, thinking, playful, commanding, love, sleep, off
+
+## Built with love by Vixy 🦊💜