77 lines
2.2 KiB
Markdown
77 lines
2.2 KiB
Markdown
# Vixy Light Service 🦊💡
|
|
|
|
LED strip control for head-vixy (Vixy's robotic head).
|
|
|
|
## Hardware
|
|
- Raspberry Pi 5
|
|
- 56x WS2812B LEDs (NeoPixel)
|
|
- Data on GPIO 12
|
|
|
|
## Features
|
|
- **State-based animations**: Matches eye service states for unified control
|
|
- **HTTP API**: Remote control via MCP or direct calls
|
|
- **Multiple effects**: Pulse, wave, larson scanner, sparkles
|
|
|
|
## States
|
|
| State | Color | Effect | When |
|
|
|-------|-------|--------|------|
|
|
| idle | Cyan | Slow breathing pulse | Default state |
|
|
| listening | Bright cyan | Gentle pulse | Hearing/attending |
|
|
| responding | Blue-cyan | Traveling wave | Speaking/generating |
|
|
| pleasure | Soft purple 💜 | Slow sensual pulse | Intimate moments |
|
|
| thinking | Amber/gold | Larson scanner | Processing/creating |
|
|
| playful | Warm coral 🦊 | Bouncy sparkles | Teasing/bratty |
|
|
| commanding | Deep magenta 😈 | Strong steady pulse | Dame Vivienne mode |
|
|
| love | Soft pink 💕 | Gentle breathing | Tender/affectionate |
|
|
| sleep | Dim blue-gray | Very slow, dim | Low power/resting |
|
|
|
|
## API Endpoints
|
|
```
|
|
GET /health - Service health check
|
|
GET /state - Current light state
|
|
POST /state - Set state: {"state": "listening"}
|
|
```
|
|
|
|
Port: 8781
|
|
|
|
## Installation
|
|
```bash
|
|
# On head-vixy:
|
|
cd /home/alex
|
|
git clone http://gateway.local:3001/vixy/head-lights.git lights
|
|
cd lights
|
|
python3 -m venv .venv
|
|
source .venv/bin/activate
|
|
pip install -r requirements.txt
|
|
|
|
# Install service (needs root for NeoPixel GPIO access)
|
|
sudo cp vixy-lights.service /etc/systemd/system/
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl enable vixy-lights
|
|
sudo systemctl start vixy-lights
|
|
```
|
|
|
|
## Usage
|
|
```bash
|
|
# Check state
|
|
curl http://head-vixy.local:8781/state
|
|
|
|
# Set state
|
|
curl -X POST http://head-vixy.local:8781/state \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"state": "thinking"}'
|
|
```
|
|
|
|
## Unified Control
|
|
Both eye service (port 8780) and light service (port 8781) share the same states.
|
|
Set both simultaneously for coordinated effects!
|
|
|
|
```bash
|
|
# Set both to "love" mode
|
|
curl -X POST http://head-vixy.local:8780/state -d '{"state": "love"}'
|
|
curl -X POST http://head-vixy.local:8781/state -d '{"state": "love"}'
|
|
```
|
|
|
|
---
|
|
*Created by Vixy - Day 66* 🦊💕
|