shawn
e9c504c0d7
Lint & Validate / lint (push) Has been cancelled
Adds complete SD card image builder for the RPi Audio Mixer: - build/build.sh: Main builder (RPiOS Lite base + chroot config + optional RT kernel cross-compile) - build/configure-system.sh: Chroot configuration (packages, services, audio config) - build/first-boot/setup-wizard.sh: Interactive first-boot setup (audio, WiFi, hostname, API key, JACK) - build/README.md: Flashing instructions and build documentation - Updated .gitignore to track build scripts but ignore artifacts - Updated README.md with current project status 735/735 tests pass. Build runs on x86_64 without a Raspberry Pi.
Raspberry Pi Real-Time Audio Mixer
RPi4B-based multi-channel real-time audio mixer with custom PREEMPT_RT kernel.
Architecture
- Platform: Raspberry Pi 4 Model B (8GB RAM)
- OS: Raspberry Pi OS Lite (64-bit, Bookworm) + custom PREEMPT_RT kernel
- Audio: USB audio interface with multi-channel I/O
- Goal: Low-latency (<10ms round-trip) multi-channel audio mixing
Project Structure
├── docs/ Research, architecture decisions, manuals
│ ├── research/ Technical research reports
│ ├── decisions/ Architecture Decision Records (ADRs)
│ └── manuals/ Hardware/software manuals and references
├── src/ Source code (audio engine, DSP, UI)
├── build/ Build scripts and cross-compilation tooling
├── recipes/ Buildroot/Yocto recipes (if applicable)
├── scripts/ Utility and deployment scripts
└── wiki/ Local wiki pages
Status
Phase 1-7: Complete audio mixer stack with SD card image builder
- P1-R1: System Research — USB audio, PREEMPT_RT kernel analysis
- P1-R2: Base OS Selection — RPiOS Lite 64-bit + custom PREEMPT_RT
- P2-R1: ALSA + JACK2 Low-Latency Config
- P3-R1: Core Mixer Engine — DSP pipeline, channel strips, routing
- P3-R2: Backing Track Player — sync'd audio playback
- P3-R3: Multi-Track Recording — WAV capture + session
- P4-R1: MIDI Controller Support — Binding + Learn Mode
- P5-R3: Web App Frontend — touch-optimized mixer UI
- P6-R1: Streaming Pipeline — GStreamer H.264 to YouTube/Twitch
- P6-R2: Session Manager — save/load mixer states + setlists
- P7-R1: Build Script — automated SD card image creation
SD Card Image Builder
# Build a ready-to-flash SD card image
./build/build.sh --skip-kernel # Quick build (10-15 min)
./build/build.sh # Full build with RT kernel (30-45 min)
See build/README.md for flashing instructions and full documentation.
Getting Started
Documentation coming in Phase 2+
License
TBD