I²S Audio Speaker

The i2s_audio speaker platform allows you to receive audio via the the I²S Audio Component.

This platform only works on ESP32 based chips.

Warning

Audio and voice components consume a significant amount of resources (RAM, CPU) on the device.

Crashes are likely to occur if you include too many additional components in your device’s configuration. In particular, Bluetooth/BLE components are known to cause issues when used in combination with Voice Assistant and/or other audio components.

# Example configuration entry
speaker:
  - platform: i2s_audio
    dac_type: external
    i2s_dout_pin: GPIOXX
    mode: mono

Configuration variables:

  • dac_type (Required, enum):

    • external: Use an external DAC, for example the NS4168, or UDA1334A.

    • internal: Use the internal DAC

External DAC

  • i2s_dout_pin (Required, Pin Schema): The GPIO pin to use for the I²S DOUT (Data Out) signal.

  • mode (Optional, string): The mode of the I²S bus. Can be mono or stereo. Defaults to mono.

  • i2s_audio_id (Optional, ID): The ID of the I²S Audio you wish to use for this speaker.

For best results, keep the wires as short as possible.

Internal DAC

  • mode (Required, enum): The channel mode of the internal DAC.

    • left

    • right

    • stereo

See also