# 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-4: Core audio stack + MIDI controller support (in progress)**
- [x] P1-R1: System Research — USB audio, PREEMPT_RT kernel analysis
- [x] P1-R2: Base OS Selection — RPiOS Lite 64-bit + custom PREEMPT_RT
- [x] P2-R1: ALSA + JACK2 Low-Latency Config
- [x] P4-R1: MIDI Controller Support — Binding + Learn Mode
- [ ] P3: Audio Engine — DSP pipeline, mixing engine
- [ ] P4: Hardware Integration — GPIO control surface

## Getting Started

*Documentation coming in Phase 2+*

## License

TBD