Hardware Matrix

Is DFPlayer Mini MP3 Audio Player Compatible with Home Assistant (ESPHome)?

Verdict Badge
VERDICT: [ NATIVELY SUPPORTED ]
Protocol: UART Serial / 3.3V
Bridge Needed: NO

Hardware Safety & Verification Specs

Electrical parameters & logic voltage safety limits before powering ICs

๐ŸŸข 3.3V Native Direct Hookup ๐Ÿงช Verified in Lab
Logic Voltage 3.3V Low-Power CMOS
Voltage Rating 3.0V - 3.3V DC Rail
Current Profile Peak Tx Current: ~180mA to ~250mA @ 3.3V
Environment Rating IP20 Indoor Climate Control

## Compatibility Overview

Hardware MP3/WAV audio player module for custom smart home voice chimes doorbells and alarm announcements from MicroSD storage.

Interactive Pinout & Wiring Diagram

Hover over any pin to view voltage limits and pull-up specifications

VCC
5V Power Supply
GND
Ground Common
SDA / TX
Data Line (GPIO 21)
SCL / RX
Clock Line (GPIO 22)
CS / INT
Chip Select (GPIO 19)

## Technical Specification Matrix

Feature / Attribute Specification / Status
Hardware Protocol UART Serial / 3.3V
Bridge Required NO
Border Router Needed None
Exposed Entities
Audio Track Selection Playback State Volume Level Speaker Switch
Pairing Complexity Intermediate
Factory Reset Instruction Hold BOOT button for 3s.

## Step-by-Step Pairing Guide

1

Factory Reset Device

Hold BOOT button for 3s.

2

Initialize Pairing Mode on Home Assistant (ESPHome)

Open Home Assistant (ESPHome) administration console, navigate to Integrations / Add Device, and start pairing scanner.

3

Confirm Entity Binding & State Verification

Verify that primary entities (Audio Track Selection, Playback State, Volume Level, Speaker Switch) report live state changes inside Home Assistant (ESPHome).

Production Code Generator & Preset Toolkit

Pre-configured pinouts & drivers for DFPlayer Mini MP3 Audio Player

Test in Wokwi Simulator โ†—
   
๐Ÿ‘ฅ Community Verified Database Continuous hardware testing updates

Report a Pinout Error or Submit Tested Code Snippets

Found a pin mapping quirk or built a custom ESPHome YAML driver for DFPlayer Mini MP3 Audio Player? Help us keep this matrix 100% accurate.

## Frequently Asked Questions

Does this device operate in Offline Mode?
100% local audio playback execution.
What is the expected Battery Life & Power specification?
5V VCC for speaker power UART TX=GPIO16 RX=GPIO17 (1k ohm resistor on RX pin recommended).
How does Signal Mesh & Range Extension function?
Wi-Fi 2.4GHz.

Related Compatibility Matrix Guides