Pin Maps Belong in the Bring-Up Evidence
One wrong GPIO can imitate a codec, driver or clocking failure.
I2S
Clocked Playout Beats Packet-Driven Audio
Network packets arrive when the network allows; speakers need samples when the audio clock demands them.
Why UDP Arrival Should Not Be the Speaker Clock
RTP arrived in bursts even when packet sequence was mostly healthy, so directly pacing I2S from receive callbacks made network jitter audible.
Separate Codec Bring-Up from Acoustic Tuning
Prove clocks, framing, routing and gain before judging microphones, speakers or enclosure acoustics.
AEC Reference Is the Far-End Signal, Not Another Microphone
Echo cancellation only has a useful reference when the reference represents what the loudspeaker actually played.
V126 to V127: What 68.201 ms to 0.457 ms Actually Proved
A large first callback-to-speaker delay suggested work was accumulating between RTP reception and physical output.
I2S Clocking Is the Backbone of the LOUP Audio Path
MCLK, BCLK and LRCK have to agree before higher-level audio debugging means anything.
I2S Auto-Clear Prevented Old Samples from Becoming New Noise
DMA behavior after underrun can shape what a user hears during gaps.
I2S Audio Made Timing Bugs Audible
Digital audio bugs are often scheduling and buffer bugs that happen to come out of a speaker.
The ESP32-S3 Voice Pipeline Was Really Several Clocks Sharing One Device
Microphone sampling, RTP packetization, network arrival and speaker playout each have their own timing domain.
When UART Logging Became a Real-Time Audio Bug
The firmware sounded worse while producing the very diagnostics intended to explain it.
Speaker Writes Over 20 ms Became My Local Deadline Signal
Crackle and cutouts needed a device-side timing metric that was closer to the DAC than packet arrival.
Eliminating the Downlink Stall Was More Important Than Tuning Tone
A clean frequency response is irrelevant if the playback path periodically stops feeding samples.
Long-Call Drift Is Different from Short-Call Sound Quality
A call can sound excellent for thirty seconds while two media clocks slowly walk apart.
Why More Jitter Buffer Was Not Automatically Better
Increasing jitter tolerance seemed like the obvious response to bursty packet arrival.
AEC Debugging Started with Channel Mapping, Not DSP Tuning
Before tuning echo cancellation I verified that the algorithm was receiving the microphone and far-end reference channels I thought it was.