HubAudio/docs/architecture/HubAudio-Clock-Architecture.md

# HubAudio Clock Architecture

- Status: Draft
- Date: 2026-08-01
- Document Type: Architecture Specification


# 1. Overview

The HubAudio architecture defines a centralized audio timing domain.

The Audio Processor is the master of the audio clock system.

The purpose of this architecture is to provide a single timing reference for
all digital audio devices, avoiding independent clock domains and minimizing
sample synchronization problems.

The audio clock domain is composed of:

- Master oscillator
- Audio Processor PLL and clock generation
- Clock distribution stage
- Audio peripheral clock inputs


---

# 2. Audio Clock Master

The Audio Processor is responsible for generating the audio timing reference.

The Audio Processor provides:

- DSP processing clock
- Serial audio clock generation
- I2S synchronization


Conceptually:

          Reference Clock

                |
                |

           Audio Processor

      DSP + Audio Clock Master

                |

         MCLK / BCLK / LRCLK

The Audio Processor is the timing authority of the Audio Domain.


---

# 3. Reference Frequency

The preferred audio clock family is based on 48 kHz.

The standard relationship is:


48 kHz × 256 = 12.288 MHz


The reference oscillator is therefore selected around:


12.288 MHz


This frequency is suitable for:

- streaming audio
- DAB/DAB+
- Bluetooth audio
- consumer digital audio systems


Future support for 44.1 kHz family may require:

- alternate oscillator
- PLL reconfiguration
- ASRC usage


---

# 4. Clock Distribution

The Audio Processor clock output is distributed through a dedicated clock buffer.

The Clock Buffer is used as clock distribution element.

Its role is:

- fan-out of the clock signal
- reduction of clock loading
- improved signal integrity


It does not generate the audio clock.


Architecture:

                Audio Processor

             Audio Clock Master

                   |

                  MCLK

                   |

            Clock Buffer

          Clock Distribution

      +------------+------------+
      |            |            |
      |            |            |

   Radio Receiver       BT Modules    CODEC

---

# 5. Clock Domain Devices

All digital audio peripherals belong to the same clock domain.

Expected clock relationships:

             Audio Processor

                |

    +-----------+-----------+
    |
 MCLK/BCLK/LRCLK

    |

+------+------+------+------+
| | | |
ESP32 Radio Receiver BT RX CODEC



Each device must support operation as:

- I2S slave
- external MCLK
- externally provided BCLK/LRCLK


---

# 6. Clock and Audio Data Relationship

The audio data flow is independent from control communication.

Control:


System Controller

|
|

SPI

|

Audio Processor / Radio Receiver



Audio:


Source Device

  |
  |
 I2S

  |
  |

Audio Processor


Timing:


Audio Processor

  |
  |

Clock Signals

  |
  |

Audio Peripherals



---

# 7. Design Rules

The following rules apply to the PCB:

## Clock Routing

- Clock lines must be short
- Clock return path must be continuous
- Avoid routing near RF sections
- Avoid unnecessary vias


## Power Integrity

The clock generator and buffer require:

- clean supply rails
- adequate decoupling
- low noise power domains


## Grounding

Clock signals must always reference a continuous ground plane.


---

# 8. Architectural Consequences

## Advantages

- Single audio timing reference
- No asynchronous sample drift
- Simplified DSP routing
- Professional audio architecture


## Limitations

- All peripherals must support external clocking
- Clock tree becomes a critical design element
- PCB layout quality directly affects audio performance


---

# 9. Design Philosophy

The HubAudio clock architecture follows the same principle as a musical
orchestra:

The Audio Processor is the conductor.

The Clock Buffer distributes the beat.

All audio devices perform synchronized to the same timing reference.