Refactor HubAudio architecture domains and add documentation tooling

This commit is contained in:
2026-08-01 23:34:38 +02:00
parent 30f2656c85
commit 145a651e2a
15 changed files with 1537 additions and 201 deletions
@@ -1,4 +1,4 @@
# ADR-001: ADAU1467 as Audio Domain Master
# ADR-001: Audio Processor as Audio Domain Master
- Status: Accepted
- Date: 2026-08-01
@@ -9,8 +9,8 @@
HubAudio is designed as a modular digital audio platform integrating several
audio sources and destinations:
- ESP32-S3 streaming subsystem
- Si4684 radio receiver
- System Controller streaming subsystem
- Radio Receiver radio receiver
- Bluetooth RX/TX modules
- Digital audio converters
- Analog CODEC/DAC stages
@@ -22,13 +22,13 @@ The system requires a central component responsible for:
- timing synchronization
- audio stream management
The ADAU1467 has been selected as the central audio processor.
The Audio Processor has been selected as the central audio processor.
## Decision
The ADAU1467 is the master component of the HubAudio Audio Domain.
The Audio Processor is the master component of the HubAudio Audio Domain.
The ADAU1467 is responsible for:
The Audio Processor is responsible for:
- DSP processing
- audio routing
@@ -37,10 +37,10 @@ The ADAU1467 is responsible for:
- audio clock generation
- synchronization of external audio peripherals
The ADAU1467 is considered the audio domain master.
The Audio Processor is considered the audio domain master.
The ESP32-S3 participates in the Audio Domain as a digital audio source. It does not act as the audio timing master or routing controller. Its role inside the audio domain is equivalent to other digital audio sources.
The ESP32-S3 has a dual role:
The System Controller participates in the Audio Domain as a digital audio source. It does not act as the audio timing master or routing controller. Its role inside the audio domain is equivalent to other digital audio sources.
The System Controller has a dual role:
- audio source inside the Audio Domain
system supervisor inside the Control Domain
@@ -71,7 +71,7 @@ It operates as system supervisor and is responsible for:
## Rationale
The ADAU1467 is selected not only as a DSP processor but as the central
The Audio Processor is selected not only as a DSP processor but as the central
controller of the digital audio domain.
This decision defines the HubAudio architecture.