Skip to main content

Audio Module Configuration

The audio module config options are: Codec2 Enabled, PTT GPIO, Audio Bitrate/Codec Mode, I2S Word Select, I2S Data IN, I2S Data OUT and I2S Clock. Audio Module config uses an admin message sending a ConfigModule.Audio protobuf.

With this experimental module, you can add a digital I2S microphone and speaker to any ESP32 device that has a SX128x radio and operates on the 2.4 GHz ISM Band. The Sub-1GHz bands are not wide enough to support continuous audio packets on the mesh, even in the Short and Fast modes. Right now, the only device supported is the LilyGo TLora 2.1-1.8 board.

Audio Module Config Valuesโ€‹

Codec2 Enabledโ€‹

Enables the audio module.


The GPIO to use for the Push-To-Talk button. The default is GPIO 39 on the ESP32.

Audio Bitrate/Codec Modeโ€‹

The bitrate to use for audio. The default is CODEC2_700B. The available options are:

  • CODEC2_3200
  • CODEC2_2400
  • CODEC2_1600
  • CODEC2_1400
  • CODEC2_1300
  • CODEC2_1200
  • CODEC2_700B
  • CODEC2_700

I2S Word Selectโ€‹

The GPIO to use for the WS signal in the I2S interface.

I2S Data INโ€‹

The GPIO to use for the SD signal in the I2S interface.

I2S Data OUTโ€‹

The GPIO to use for the DIN signal in the I2S interface.

I2S Clockโ€‹

The GPIO to use for the SCK signal in the I2S interface.

What is this?

These Pins comprise an I2S digital audio interface. Meshtastic uses it in monoaural mode. The software will use the logical 'LEFT' Stereo channel for the microphone and the logical 'RIGHT' Stereo channel for the speaker, so configure your breakouts accordingly. Audio is Half-Duplex, so we can re-use part of the pins for a bi-directional configuration. There's no default pin assigment, setting these is mandatory.

Audio Module Config Client Availabilityโ€‹


Audio module config is not available on iOS, iPadOS and macOS.


GPIO access is fundamentally dangerous because invalid options can physically damage or destroy your hardware. Ensure that you fully understand the schematic for your particular device before trying this as we do not offer a warranty. Use at your own risk.

This module requires attaching a peripheral accessory to your device. It will not work without one.