Waveshare 7B Examples
The repository includes two complete examples for the Waveshare ESP32-P4-WIFI6-Touch-LCD-7B. They contain the board’s tested codec, pin, TDM-slot, display, touch, and ESP32-C6 Wi-Fi configuration, so they are the quickest route from a new board to a working voice satellite.
Start with the audio test. Confirm the microphones, hardware playback reference, speaker, and AEC output before trying the voice assistant. A voice pipeline cannot compensate for an incorrect slot map or distorted audio.
Audio test
The Waveshare 7B audio-test example is the recommended first firmware for this board. Its touch interface lets you:
- listen to the enhanced DSP output or any of the four raw TDM slots;
- inspect RMS, peak levels, and a 32-bin spectrum;
- record and replay two seconds of captured audio; and
- play a bundled, repeatable test signal through the speaker.
Use it to prove that slots 0 and 2 contain the microphones, slot 1
contains the hardware playback reference, and playback continues cleanly while
the microphones are active.
Open the audio-test example and setup instructions
Voice assistant
After the audio test passes, use the Waveshare 7B voice-assistant example. It is a focused but complete Home Assistant voice satellite with:
- local “Alexa” wake-word detection;
- full-duplex AEC and rolling pre-buffer hand-off;
- one-request assistant sessions with TTS microphone suppression;
- listening, thinking, replying, ready, and error states;
- transcript and response text;
- manual start/stop and persistent volume control; and
- a deliberately minimal, voice-assistant-only touch interface.
It contains no dashboard, alarm, weather, relay, credential, or other installation-specific behavior.
Open the voice-assistant example and setup instructions
Using an example
Each example folder includes its YAML configuration, UI include, a README, and
secrets.yaml.example. Copy the example folder locally, rename
secrets.yaml.example to secrets.yaml, enter your Wi-Fi details, then compile
the main YAML file with ESPHome.
These configurations are specific to the 7B model. For another board or board revision, follow First-Time Board Setup and verify the schematic, pins, codecs, and TDM routing instead of copying the 7B values unchanged.