ehRadio Hardware Choices¶

There are many considerations to make when building a radio. Here are listed all of the supported hardware, some with more detail than others.

When in doubt, also consult the myoptions Generator which also contains tips about the hardware.

ESP Board¶

It is strongly recommended to use an ESP32-S3 board with at least 2MB of PSRAM and 8MB of flash.

It may be possible to use a board with 4MB of flash but will require special partitioning.

This code may still run on an ESP32 but without PSRAM will have serious issues that may be unfixable.

It is also possible to build with an ESP32-C3 but since that is not a dual-core CPU, it would be prudent to avoid larger and/or SPI displays.

External Antenna¶

Depending on your wi-fi and purpose, you may choose a board which has the option of an external antenna. Don't forget to set the jumper correctly.

Picture from and more info here.

Important Notes (Power & Wires)¶

Although some modules can be powered by 3V3, use the 5V pin or direct USB power wherever possible to avoid overloading the ESP's weak 3V3 power regulator. Most modules have onboard regulators anyway.

It is recommended to use a minimum of 470µF 10V capacitor somewhere in your circuit across the 5V and GND (attach negative to GND). It helps to stablize the system during boot and smooth out the sudden power draw during operations like initializing the decoder, screen, wi-fi, etc. The capacitor should be as near as possible to the ESP's 5V and G pins, so it's easiest to just solder the capaciitor directly to the dev board. If that's a problem, it's not catastrophic to put elsewhere on the 5V rail. The SD Card Reader and display's 5V pins may be used. You may size up either number, but µF is the only number that matters. To be extra safe, use a 1000 µF capacitor. There is no benefit to using a higher volt rating like 16V or 25V or 250V. So, use what's convenient.

This capacitor can help mitigate power-supply problems but if you do encounter issues, you may find that using a better supply (preferably one that provides 2A or more) will solve many types of problems that can occur due to a weak power-supply.

An additional note here about wires. Although you may experience some success with thin wires, AWG24-22 is the "sweet spot" which you can generally use for all wires, provided the length does not exceed 30-50cm.

If you really wish to use different gauges of wire, signal wires should be thinner. AWG 28-30 is ideal for signal wires and will function at extreme lengths. Power lines should be thicker AWG20-22 but the longer they are, the more voltage can drop (but too thick also adds resistance).

Breadboards may be fun but take note of wire gauges. duPont jumper wires are typically AWG28-26 and AWG28 is not suitable for the voltage current needed in ESP32 projects. If you must prototype with breadboards, be sure that your power wires at least are AWG26 or better.

Display¶

Building with a display is not strictly necessary.

Too many displays are supported to show pictures of them all here.

TFT / IPS Color Displays¶

SPI color TFT displays all look pretty good (IPS versions will always look better even if they don't photograph well).

Display	Default Resolution	Other Resolutions Supported	Note
GC9A01A	240x240 round	No
GC9106	160x80	No
ILI9225	220x176	Yes
ILI9341	320x240	No
ILI9488	480x320	Yes	uses a 24-bit bus so can be slow to update (choose the ST7796 if you want a display that updates faster)
ILI9486	480x320	Yes	not fully tested - see notes inside the library regarding gamma correction
ST7735	160x128	* see below *	works well, cheap
ST7789	320x240	Yes
ST7796	480x320	Yes

If the display is listed as supporting other resolutions, then the following resolutions are available: 480x320, 320x240, 284x76, 240x240, 220x176, 160x128, 160x80, and 128x128. Non-default width or height must be specified in myoptions.h.

The ST7735 has several subtypes in the Adafruit driver, as specified by DTYPE, which also sets the resolution.

ST7735 Subtype	Resolution	Note
BLACKTAB	160x128	default unless DYTPE is specified
GREENTAB	160x128
REDTAB	160x128
144GREENTAB	128x128
MINI160x80	160x80

If you have a 160x128 and the default BLACKTAB doesn't work, try GREENTAB and REDTAB.

OLED Monoochrome Displays¶

OLEDs are cheap, beautiful (in a retro way) and just as functional.

Display	Interface	Default Resolution
SH1106	SPI or I2C	128x64
SH1107	SPI or I2C	128x64
SSD1305	SPI or I2C	128x64
SSD1306	SPI or I2C	128x64
SSD1322	SPI only	256x64
SSD1327	SPI or I2C	128x64

All OLED displays support various resolutions: 256x64, 128x128, 128x64, and 128x32. Non-default width or height must be specified in myoptions.h.

LCD Displays¶

Not recommended but supported anyways, thanks to inheriting ёRadio display architecture. LCD displays like the 1602, 2004, and Nokia 5110 may work but will not be as good-looking as the others.

Display	Interface	Default Resolution
1602	Parallel or I2C	16x2 characters
2004	Parallel or I2C	20x4 characters
NOKIA5110	SPI	84x48 dot-matrix
ST7920	SPI	128x64 dot-matrix

Audio Decoder¶

I2S / PCM Decoder¶

I2S/PCM decoders are cheap and easy-to-find but must be used with an amplifier.

I2S uses the CPU to decode data so it can be used with many types of streams. The data is then sent to a PCM decoder which turns the data into sound. It does put pressure on the CPU so it does have trouble running with large SPI displays.

A good I2S Decoder is the PCM5102A but be sure to set the jumpers as in this picture, including the 4 on the bottom and SCK=GND jumper on the other side.

H1L / FLT: low latency (instead of high latency)
H2L / DEMP: de-emphasize control for 44.1KHz sample rate off (instead of on)
H3L / XMST: soft un-mute control (instead of soft mute control)
H4L / FMT: Audio format I2S (instead of Left justified)

Picture and info from here.

The UDA1334 should work and there are likely others.

You will need an amplifer when building with a DAC like these. Read more below.

The ES8311 is a mono I2S decoder/amp included on some dev + display boards like the es3c28p. It's not terrible.

VS1053¶

The VS1053 is well-supported and may make for an easy first-build (with no amp).

The idea of the VS1053 is fantastic. It decodes streams directly and relieves pressure from the CPU. It has an acceptable built-in amplifier that has decent audio isolation already built-in. Whereas I2S decodes streams using the CPU, the VS1053 can decode most popular codecs directly on the board, relieving the CPU to handle other functions...

But the technology behind the VS1053 (2009) pre-dates the ESP8266 (2013) and the libraries have not received the same attention from developers as the I2S decoding routines.

There are many additional issues as well so it is probably best to reserve building using the VS1053 when using very slow displays like the ILI9488.

For the VU Meter to function, the patch MUST be enabled. Even with the patch, though, it struggles to decode FLAC streams and some other "unusual" stream types.

The so-called "Green Board" is the cheapest and easiest to find but don't assume it is a genuine VS1053. Some are sold as "VS1003/1053" which are almost certainly a VS1003. This can be verified by checking the LDO power-regulators. If the board has a 2.5V LDO instead of a 1.8V LDO, it's a VS1003. Genuine VS1053 is usually $10 minimum. Shop carefully and don't buy the cheapest one.

If you end up with a VS1003, it will still be functional for MP3 stations (but nothing else). It cannot use the patch and there will be no audio if you use #define VS_PATCH_ENABLE true in myoptions.h.

There are some "fixes" that should be applied to the green board to ensure it functions as expected. Your board may function without modification but the mods are relatively easy and worth doing to improve audio quality.

First, easiest, and most essential, it is recommended to remove the resistor marked R2. This resistor actually pulls down GPIO0 of the VS1053B chip into MIDI mode at boot. Usually the internal pull-up resistor succeeds in pulling it up in time for the patch to be applied. Removing it leaves it floating so the internal pull-up always succeeds.
Second, a bit more difficult but can improve actual audio is to place 33Ω damping resistors placed right next to the ESP32 pins used for SCK, MOSI, XCS, and XDCS before wiring to the VS1053 board. ESP32-S3 GPIO pins have an incredibly fast transition time (slew rate), which is around 1-2ns. Even with short wires around 10-15 cm, these sharp edges cause severe signal reflections ("ringing"). Damping resistors provide source impedance matching and damps the reflected wave, preventing data micro-glitches. Acceptable alternatives to 33Ω are in the range of 22Ω to 47Ω. No higher or lower. If a sharp edge causes ringing or cross-talk from the adjacent SCK wire on these strobe lines, the noise amplitude can falsely cross the logic threshold. As a result, the decoder might assume the communication session was interrupted right in the middle of a data frame transfer. This may manifest in the logs with excessive slow stream, dropouts are possible messages as well as with audio artifacts like pops and clicks.
Finally, add 100Ω resistors on the DREQ and XRST lines (middle of wire is OK) for passive filtering of pulse noise and port protection during initialization.
Additionally, a board that identifies as VS0 during boot (check the serial logs) may be fixable. There are various fixes available and it's up to you to see which one works for you.
Some people report that reflowing the connections on the VS1053B chip fix their issues.
Here is a fix that worked for Trip5 (I did not attempt the reflow):

Attach 100KΩ resistors from the 3.3V LDO to XCS and XDCS to pull them up. If the error persists, restore R2 with a solder bridge. It seems likely there is a parasitic drain on them that interferes with boot... You could try 500KΩ or 1MΩ or probe and remove the onboard resistors if 100KΩ isn't enough.
Google search for other fixes...
And this may be why dealing with VS1053 is problematic. If you've read all of this and decided to use a VS1053 anyways, good luck!

For more detailed information on why these fixes are applied, the VS1053 Datasheet may prove useful reading.

Special Warning¶

Do not connect an amplifier directly in-circuit to the VS1053.

If you connect the VS1053's audio jack directly to an amplifier (where the audio (-) input is tied to the power supply ground), you will short the GBUF (+1.23V) directly to GND (0V). This will cause:

Immediate overheating of the VS1053B output stage
Severe distortion, screeching, or the chip shutting down due to protection
Permanent damage to the VS1053B

So, either do not connect an amplifier directly to the VS1053 or be sure to add isolation using EI14 600:600Ω transformers.

Audio Amplification¶

When using a PCM decoder, it is absolutely essential to add an amplifier. Most VS1053 boards includes a usable but weak amplifier.

The subject of audio amplifiers is a huge topic. This is just a summary of what is known to work. You may do further research if you like.

Amplifiers¶

It is generally recommended to use Class-AB amplifiers because:

no switching noise which is especially noticeable at high frequencies and with sensitive speakers
reasonable power efficiency (but use power even when idle)
no complicated output filters needed
may introduce low-frequency humming

Class-D amplifiers may be used as well. They run cooler due to higher power-efficiency (due to switching) but may have a buzz or whine and the switching may introduce noise.

PAM8406¶

The PAM8406 is a stereo Class-D/Class-AB hybrid amplifier that offers flexibility in output mode and wide community support.

One variation has trim pots onboard, useful for balancing stereo speakers, setting a maximum volume limit, attenuate line volume to prevent clipping and distortion, and reduce gain to minimize amplification of background hiss or noise.

To verify the PAM8406 board's Class mode, check pin 9. If it is tied to Ground, it's in Class-AB mode. If it is tied to VCC, it is in Class-D mode.

LTK5128¶

The LTK5128 is a mono Class-D/Class-AB hybrid amplifier and is also a good choioce.

When looking for LTK5128, get the red PCBs which are factory-configured for Class AB. The blue ones are Class D, which may or may not include jumpers to set to class AB.

To verify the LTK5128 board's Class mode, check pin 3. If it is tied to Ground, it's in Class-AB mode. If it is tied to VCC, it is in Class-D mode.

Note Regarding Amp-Speaker Pairing¶

Speaker wattage is a maximum handling rating, not a minimum requirement. A 3W amp can drive 300W speakers — they'll just be quiet.

What actually matters for amp compatibility is impedance (Ω):

Amp	Rated Impedance	Notes
PAM8406	4Ω (3W x 2)	Works at 8Ω (~1.5W per channel). Filterless Class-D, no output capacitors needed
PAM8403	4Ω (3W x 2)	Similar to PAM8406, lower power
PAM8610	4–8Ω (10W x 2)	Requires 7–15V supply (not USB). Overkill for desktop use
LTK5128	4–8Ω (3W)	Mono Class-AB. Use two for stereo
MAX98357A	4–8Ω (3W)	I2S input — no DAC needed. Filterless Class-D

For a desktop internet radio, efficient 3–10W speakers (4–8Ω) are ideal. They'll produce more volume at low power than massive high-wattage speakers whose heavy cones need serious current to move. Small bookshelf or full-range drivers work best with these amps.

Trip5's Lazy PCM/Amp Combo¶

If you don't care about audio or power isolation, you can solder the PCM5102A to a PAM8406 stereo amp. The PCM5102 output pins line up pretty nicely to the PAM8406's input pins. Use the trim pots on the amplifier to attenuate/reduce input to match the speakers and minimize noise.

Audio Isolation¶

Audio isolation transformers EI14 600:600Ω use galvanic isolation to physically separate the input and output circuits using magnetic induction. This breaks the conductive path for DC voltage and ground loop currents, effectively stopping the 50/60Hz hum caused by potential differences between devices.

While the EI14 transformer breaks the ground loop and removes hum from the source, the amplifier itself can reintroduce noise if it generates high-frequency switching interference (common in Class-D amps) or if its power supply is noisy. For the cleanest result, pair the isolation transformer with a Class-AB amplifier or a well-filtered Class-D module.

Or even better, separate the audio and digital sides of your circuit.

Audio/Power Noise¶

If you find that your amplifier is buzzing, there are a few things to blame for this.

One suspect is usually backlight control. Typically these use PWM (Pulse Width Management) to achieve dimming. That adds interference. The easy fix is to disable dimming and tie the BL pin to 3V3.

Full Schematics for Full Audio/Power Isolation by Kle7rx (This design has not been real-world tested yet)¶

Complete wiring diagrams with parts lists are available as PDFs:

PCM5102 Build Schematic: I2S DAC + LTK5128 amplifiers
VS1053 Build Schematic: VS1053 decoder + LTK5128 amplifiers

Both builds share a common power architecture: a MORNSUN F0505S-3WR2 isolated DC-DC converter separates the digital side (ESP32, DAC, display) from the analog/amplifier side, eliminating ground-loop noise. Each functional block (POWER, AUDIO, DIGITAL, DISPLAY) uses a PLY17BN9612R0B2B common-mode choke for additional noise filtering.

Common Parts (Both Builds)¶

Part	Qty	Purpose	Alternatives
ESP32-S3-DevKitC-1 N16R8	1	Main microcontroller with 16MB flash and 8MB PSRAM	Any ESP32-S3 with minimum 8MB flash and 2MB PSRAM
RS-15-5 (MEAN WELL)	1	5V 15W AC-DC power supply	USB-C PD trigger board (5V), any regulated 5V 3A+ supply
F0505S-3WR2 (MORNSUN)	1	Isolated 5V→5V DC-DC (3W, 600mA); ultra-low 20pF isolation capacitance for clean analog/digital separation	Requires ≥3W for ESP32-S3; cheaper converters lack both power and low isolation capacitance
PLY17BN9612R0B2B (discontinued)	5	Murata hybrid CM+DM choke (0.96mH CM, 47μH DM); filters common-mode and differential noise	Würth 7446122001 (1mH, 2A, best direct replacement); KEMET SC-02-10GS (1mH, 2A, toroidal); standard CM choke ≥2A, 0.5–2mH
LTK5128	2	Class AB 3W audio amplifier (Left + Right)	PAM8406 (Class D, 5W), PAM8403 (3W), MAX98357A (I2S, 3W)
LD06AJSA	1	LED constant-current driver; supports LED filaments for encoder illumination	220Ω resistor + LED (simpler), any 20mA LED driver
RCH664NP-100M	1	100μH shielded power inductor for DC-DC filtering	Any 100μH 1A+ shielded inductor; toroidal core inductor (100μH, 1A+)
EI14 600:600Ω	1	1:1 audio isolation transformer (line-level)	Any 600:600Ω audio transformer, 10μF DC blocking caps
EC11	1	Rotary encoder (15 pulse/30 detent) with push switch	KY-040, PEC11, any quadrature encoder with switch
VS1838B	1	38kHz IR receiver	TSOP38238, TSOP4838, TSOP31238
SD Card module	1	SPI microSD card reader for offline playback	Built-in display SD slot (check for proper resistors!)
XRR6H-6*10-3T	7	6-hole ferrite bead (6×10mm, 3-turn); EMI suppression on signal/power lines	Any 6-hole ferrite bead (6×10mm), clip-on ferrite choke, toroidal ferrite core

Capacitors & Resistors¶

Component	PCM5102	VS1053	Where Used	Notes
2200 μF 25V electrolytic	1	1	Audio rail bulk decoupling	Must use Low ESR
1000 μF 16V electrolytic	2	2	Amp L+R power, PSU input	Must use Low ESR
470 μF 16V electrolytic	3	3	Digital rail, Display, LED power	Should use Low ESR
100 μF 16V electrolytic	2	2	LED driver, SD card
47 μF 10V electrolytic	2	2	Digital rail, IR receiver
10 μF 10V electrolytic	1	1	DC-DC output filtering
4.7 μF 10V electrolytic	1	1	DC-DC output filtering
0.1 μF ceramic (MLCC)	~12	~12	Decoupling on all ICs and rails	X7R dielectric
33 Ω resistor (1/4W)	6	6	SPI bus damping resistors	On MOSI, SCLK, MISO, CS, DC lines
100 Ω resistor (1/4W)	2	5	IR receiver, VS1053 control lines

Kle7rx recommends using Low ESR for all electrolytic capacitors. It is also recommended to use metal film resistors but carbon film resistors are acceptable.

PCM5102 Build: Additional Parts¶

Part	Qty	Purpose	Alternatives
GY-PCM5102	1	I2S DAC module (PCM5102A chip)	PCM5102A breakout, MAX98357A (amp+DAC combo)

VS1053 Build: Additional Parts¶

Part	Qty	Purpose	Alternatives
VS1053B module	1	SPI MP3/AAC/FLAC/OGG decoder + DAC	VS1003 (MP3 only), WM8960 (I2S codec)
10 kΩ resistor	1	Pull-up on XDCS line	Any 10kΩ 1/4W

Audio Isolation on a Budget (This design has not been real-world tested yet)¶

A simplified approach that keeps the F0505S-3WR2 isolation core but uses commodity parts for the filtering. This costs much less than the full Kle7rx "no compromises" build, while still providing clean isolated power to the digital side and an LC-filtered rail for the amplifier.

You may use any I2S decoder and amplifier you like for this build.

Budget Isolation Schematic

Parts List¶

Part	Qty	Purpose	Notes
F0505S-3WR2	1	Isolated 5V→5V DC-DC (3W, ~20pF isolation); traps ESP32 noise on digital side	Alt: B0505S-3WR2 (budget, ~50-100pF isolation so try to avoid); same 3W/600mA
100μF 10V+ electrolytic	1	Input smoothing for F0505S-3WR2; cleans USB charger noise	Standard electrolytic is fine
10μH axial inductor (0.5W)	1	Inrush limiter on F0505S-3WR2 output; protects converter from 1000μF load	*See Below Note*
100μH toroidal inductor (≥2A)	1	LC filter inductor for audio rail; replaces PLY17	PAM8406 draws ~1.3A peak; search "100μH toroidal inductor 3A"
2200μF 10V+ electrolytic (Low ESR)	1	Audio rail filter capacitor	Green "high frequency low ESR" type
1000μF 10V+ electrolytic	1	Digital rail reservoir; handles WiFi/SD current spikes	470μF at a minimum (but bigger is OK too)
0.1μF ceramic (MLCC)	3	High-frequency decoupling: audio rail, F0505S input, F0505S output	X7R dielectric, marked "104"
EI14 600:600Ω audio transformer	1	Galvanic isolation on audio signal lines; breaks ground loops	Any 600:600Ω or 1:1 audio transformer
5V USB power supply ≥2A	1	Power supply

Note about Inrush Limiter: The output of the F0505S-3WR2 is 600mA but the 0.5W rating of a single axial inductor may actually only be 500mA. Problems will manifest as such:

After 10 min of streaming + display on, touch the inductor. Warm = fine. Too hot to hold = overloaded.
Startup failure: F0505S-3WR2 won't start or cycles on/off so the inductor is saturated, cap looks like a short.
Brownouts: ESP32 resets under load - inductor's DCR climbed from overheating, voltage sagged too low.

A few solutions to these problems may be possible:

1 10μH 1A toroidal inductor (best, but more expensive)
2x 20μH axial inductors in parallel = 10μH / 1A
2x 10μH axial inductors in parallel = 5μH / 1A

What's cut vs the full Kle7rx build: No PLY17 chokes, no XRR6H ferrite beads, no LD06AJSA LED driver, no Mean Well PSU. PAM8406 stereo module replaces two LTK5128 mono amps. The F0505S-3WR2 isolation is preserved. It's the foundation that makes the approach work.

Controls¶

ehRadio can be built with various control methods, including rotary encoders, buttons, an IR receiver, touchscreen, WebUI, Home Assistant, MQTT, Telnet, and HTTP.

The most basic physical control is a rotary encoder. All functions can be accomplished with just one encoder.

Buttons may also be used. Touch is swipe and tap motions only.

Information on how the controls function detailed are here.

Wake from Deep Sleep¶

Wake from deep sleep is only possible on RTC-capable pins. On the ESP32, these are RTC GPIOs: 0, 2, 4, 12-15, 25-27, 32-39. ESP32-S3/C3 RTC GPIOs are: 0-21.

All inputs assigned to these pins will automatically be used for wake. If no inputs are available on these pins, deep sleep will be disabled. Deep sleep may be explicitly disabled with #define DEEP_SLEEP_DISABLE in myoptions.h.

Rotary Encoders¶

The KY-040 module is very easy to setup. It includes the correct resistors onboard.

Other rotary encoders like the EC11 may also be used but may require 10KΩ resistors to tie CLK and DT to Ground.

Buttons¶

Momentary switches should not require any special resistors but may require attention in myoptions.h since they are usually pulled-up by default.

You can also use a joystick instead of connecting five buttons.

IR Receiver¶

IR receivers like the VS1838 are cheap and work well. You may need a pullup resistor. The KY-022 module or TSOP38238 may work as well.

SD Card Reader¶

An SD card reader may be added to the build. It is recommended to be wary of SD readers built onto displays. Although some may work, it is well-known that some may be lacking proper resistors or will interfere with display because it is forced onto the same SPI bus.

SD reader modules like this are cheap and work well. Some come with a power regulator but this may not be necessary.

The SD Offline mode should be considered as a "fallback because wi-fi is not available" mode, not a primary playback mode.

It is recommended to encode files on SD card using MP3 at a constant bit rate of 256kbps or less to avoid system stress and get maximum compatibility with the decoders. Errors/bugs could happen if you use other codecs or too-high bitrates or other codecs.

RTC¶

An I2C RTC module may be added to the build as well. This should keep the time when network connectivity is unavailable.

Supported RTC modules include DS3231 and DS1307.