ESP32 Audio Docks and Louder ESP

ESP32 Audio Docks is a range of extension boards (i.e. docks) that allow you to develop Audio solutions based on ESP32 chips. These were created to make Audio development entry as easy and inexpensive as possible.

ESP32 Audio Docks and Louder ESP

Motivation

I spent the last few years developing different solutions based on ESP devices. It all started with ESP8266, where CPU power is not really sufficient to do real-time decoding, so you're limited to a rather simple ding-dong business. Then ESP32 came, bringing two much more capable cores, so you have a powerhouse to handle communication and decoding at the same time. Perhaps most importantly it also came with SPIRAM, so you can do decent buffering (essential for streamed content).

Now new ESP32 C-Series and S-Series chips are entering the market, and their potential is mostly unrealized as of today.

I created those docks, to be able to quickly prototype for the whole range of ESP8266 and ESP32 chips, starting with the simplest finger-sized toys and going all the way up to full-sized speakers.

Features

	ESP Audio Solo	ESP Audio Duo	Hifi ESP	Louder ESP	Louder ESP (Rev H)	Louder ESP32-S3 (Rev J)
Image
Docks with	ESP8266, ESP32C3, ESP32S2 Mini modules	ESP32 Mini Module	ESP32 Mini Module	ESP32 Mini Module	ESP32-WROVER-N16R8 onboard	ESP32-S3-WROOM-N16R8 onboard
DAC	Single I2S DAC (MAX98357) with built in D-Class amp	Dual I2S DAC (MAX98357) with built in D-Class amp	PCM5100A 32bit Stereo DAC -100 dB typical noise level	Stereo I2S DAC (TAS5805M) with built in D-Class amp	Stereo I2S DAC (TAS5805M) with built in D-Class amp	Stereo I2S DAC (TAS5805M) with built in D-Class amp
Output (4Ω)	3W	2x 3W	Non-amplified stereo output	2x 32W (4Ω, 1% THD+N)	2x 32W (4Ω, 1% THD+N)	2x 32W (4Ω, 1% THD+N)
Output (8Ω)	1.5W	2x 1.5W	Non-amplified stereo output	2x 22W (8Ω, 1% THD+N)	2x 22W (8Ω, 1% THD+N)	2x 22W (8Ω, 1% THD+N)
Adds		8MB PSRAM (4MB usable)	8MB PSRAM (4MB usable)	8MB PSRAM (4MB usable)	8MB PSRAM (4MB usable)	8MB PSRAM (all usable, and use faster interface)
Connectivity	WiFi (ESP8266, ESP32S2) WiFi + BT5.0 (ESP32C3)	WiFi + BT4.2 + BLE	WiFi + BT4.2 + BLE	WiFi + BT4.2 + BLE Ethernet	WiFi + BT4.2 + BLE Ethernet	WiFi + BT4.2 + BLE Ethernet

Onboard PSRAM

Audio streaming requires proper buffering to work, even with ESP32 500K of RAM it is a challenging task. For that reason, most of the projects will require WROVER modules that have onboard PSRAM chips.

All ESP32 Docks have an 8MB PSRAM chip onboard, connected via a high-speed SDIO interface. This effectively turns your regular WROOM module into WROVER module with no effort required. Any code using PSRAM with just work out-of-the box.

Boards Pinout

ESP Audio Solo

	I2S CLK	I2S DATA	I2S WS
ESP8266	15	3	2
ESP32-C3	5	20	6
ESP32-S2	12	37	16

ESP Audio Duo

	I2S CLK	I2S DATA	I2S WS	PSRAM CE	PSRAM CLK
ESP32	26	22	25	16	17

HiFi-ESP

	I2S CLK	I2S DATA	I2S WS	PSRAM CE	PSRAM CLK
ESP32	26	22	25	16	17

Louder ESP

	I2S CLK	I2S DATA	I2S WS	PSRAM CE	PSRAM CLK	TAS5805 SDA	TAS5805 SCL	TAS5805 PWDN	TAS5805 FAULT
ESP32	26	22	25	16	17	21	27	33	34
ESP32-S3	14	16	15	-	-	8	9	17	18

Starting from revision E, Louder ESP exposes an Ethernet header, compatible with the popular W5500 module

	SPI CLK	SPI MOSI	SPI MISO	SPI CS	SPI HOST/SPEED	ETH INT	ETH RST	IR IN	RGB OUT
ESP32	18	23	19	05	2/20MHz	35	14	-	-
ESP32-S3	12	11	13	10	SPI2/20MHz	6	5	7	36

Software samples

In the software section two firmware examples are provided.

esp32-i2s-bare is base I2S implementation based on ESP-IDF implementation directly.
esp32-i2s-esp8266audio is based on excellent ESP8266Audio library (it works with the whole ESP range, don't get fooled by the name), providing minimum code implementation.
esp32-i2s-web-radio is based on the same library, providing minimum web-readio stream player. It expects a playlist as an input in the 'data' folder.
Squeezelite-ESP32 - see more details below

Platformio IDE

All samples are provided as Plarformio IDE projects. After installing it, open the sample project. Select the proper environment based on your dock. Run the Build and Upload commands to install necessary tools and libraries, and build and upload the project to the board. Communication and proper upload method selection will be handled by IDE automatically.

Arduino IDE

Follow the ESP8266Audio library guide. Default settings will work out of the box with ESP8266 and ESP32 boards. For ESP32C3 and ESP32S2 board please adjust the pinout according to the above section

ESPHome and Home Assistant

Being an ESP32-based device, you can easily integrate it into your Home Assistant using ESPHome. Start with esphome web installer, which will give you ESPHome base install and WiFi configuration in minutes. Some S2/S3 boards have issues with we-installer, you may need to use Adafruit flasher instead with binaries pulled from the HA.

Next, navigate to your Home Assistant (assuming you have your ESPHome integration installed), and adopt the newly created node

ESPHome will give you ESPHome configs for Solo board running with ESP32-S2/S3, as well as Duo/HiFi-ESP and Louder ESP working with ESP32.

Few words of explanation.

media_player publishes the media player into the Home assistant, so you can use it together with the native player or Music Assistant. You have a volume knob in the HA as well.
Volume set up to 50% on player start. Especially for Louder-ESP32, this is helpful :)

Bonus - automation example

The true power of the native speaker in the eHA is the use of automation. One example that I find useful. This simple automation will be pronounced every hour between 8 AM and 9 PM. Another one is used to pronounce bedtime, you get the point...

Squeezelite-ESP32

Squeezelite-ESP32 is a multimedia software suite, that started as a renderer (or player) of LMS (Logitech Media Server). Now it is extended with

Spotify over-the-air player using SpotifyConnect (thanks to cspot)
AirPlay controller (iPhone, iTunes ...) and enjoy synchronization multiroom as well (although it's AirPlay 1 only)
Traditional Bluetooth device (iPhone, Android)

And LMS itself

Streams your local music and connects to all major online music providers (Spotify, Deezer, Tidal, Qobuz) using Logitech Media Server - a.k.a LMS with multi-room audio synchronization.
LMS can be extended by numerous plugins and can be controlled using a Web browser or dedicated applications (iPhone, Android).
It can also send audio to UPnP, Sonos, Chromecast, and AirPlay speakers/devices.

All ESP32-based boards are tested with Squeezelite-ESP32 software, which can be flashed using nothing but a web browser. You can use Squeezelite-ESP32 installer for that purpose.

How to flash and configure ("ESP Audio Duo", "HiFi-ESP" and "Louder ESP")

Use Installer for ESP Audio Dock to flash firmware first. It has been preconfigured to work with ESP Audio boards and will configure all hardware automatically.


Select the correct device first
Connect the device to the USB port and select it from the list
Press `Flash` and wait around 2 minutes
(Optional) You may enter the serial console to get more information
Device is in recovery mode. Connect to `squeezelite-299fac` wifi network with `squeezelite` password (your network name suffix will be different)
When redirected to the captive portal let the device scan wifi network and provide valid credentials
You can use provided IP address (http://192.168.1.99/ on the screenshot) to access settings page
(Optional) You may change device names to something close to your heart
Exit recovery

You can use it now	Bluetooth	Spotify Connect	AirPlay	LMS Renderer