1. Introduction
This manual provides detailed instructions for the DIYables Mini MP3 Player Module (Model DIY-MINI-MP3-PLAYER-2). This compact module is designed for easy integration into various DIY electronics projects, enabling MP3 audio playback. It is compatible with popular microcontrollers such as Arduino, ESP32, ESP8266, and Raspberry Pi, making it ideal for embedded audio applications, robotics, and IoT projects.
2. Product Overview
The DIYables Mini MP3 Player Module offers a straightforward solution for adding audio capabilities to your projects. Key features include:
- Compact MP3 Playback: Effortlessly plays MP3 files, perfect for embedded audio.
- Easy Integration: Utilizes simple UART serial communication for beginner-friendly setup.
- Flexible Control: Supports onboard button, serial, and AD key control modes.
- TF Card Support: Compatible with microSD/TF cards up to 32GB for audio file storage.

Image 2.1: Top view of the Mini MP3 Player Module, showing the microSD card slot. This compact module is designed for easy integration into various DIY electronics projects.

Image 2.2: Bottom view of the Mini MP3 Player Module, revealing the integrated circuits and solder points. This side contains the main processing components for MP3 decoding and control.
3. Specifications
| Feature | Specification |
|---|---|
| Model Number | DIY-MINI-MP3-PLAYER-2 |
| Processor Count | 1 |
| Storage Support | microSD/TF card up to 32GB |
| Communication Interface | UART Serial |
| Control Modes | Onboard button, Serial, AD key |
| Compatibility | Arduino, ESP32, ESP8266, Raspberry Pi |
4. Setup and Installation
4.1 Pinout Diagram
Understanding the pinout is crucial for correct wiring. Refer to the diagram below for pin assignments.

Image 4.1: Pinout diagram for the DIYables Mini MP3 Player Module. This diagram labels each pin, including VCC, RX, TX, DAC_R, DAC_L, SPK_1, GND, SPK_2, BUSY, USB-, USB+, ADKEY_2, ADKEY_1, IO_2, GND, and IO_1, essential for proper connection to a microcontroller.
- VCC: Power supply input.
- GND: Ground connection.
- RX/TX: UART serial communication pins for connecting to your microcontroller's TX/RX.
- DAC_R/DAC_L: Digital-to-Analog Converter outputs for right and left audio channels.
- SPK_1/SPK_2: Speaker outputs.
- BUSY: Indicates if the module is currently playing audio.
- ADKEY_1/ADKEY_2: Analog-to-Digital key inputs for external button control.
- IO_1/IO_2: General purpose input/output pins.
4.2 Wiring Examples
Below are common wiring configurations for integrating the MP3 module with various development boards. Always ensure power is disconnected before making any wiring changes.

Image 4.2: Multiple wiring diagrams illustrating how to connect the Mini MP3 Player Module to different microcontrollers, including Arduino, ESP32, ESP8266, and Raspberry Pi. Each diagram shows connections for power, ground, serial communication (RX/TX), and speaker outputs, often including a 1KΩ resistor for signal integrity.
General Wiring Steps:
- Connect the module's VCC pin to the 3.3V or 5V power supply of your microcontroller (check module's voltage tolerance).
- Connect the module's GND pin to the ground of your microcontroller.
- Connect the module's RX pin to your microcontroller's TX pin.
- Connect the module's TX pin to your microcontroller's RX pin.
- Connect speakers to the SPK_1 and SPK_2 pins, or use the DAC outputs with an external amplifier if needed.
- Insert a microSD/TF card (formatted as FAT32) containing MP3 files into the card slot. Ensure MP3 files are named according to the library's requirements (e.g., 0001.mp3, 0002.mp3).
5. Operating Instructions
5.1 Software Library Installation
To control the MP3 module via serial communication, a compatible software library is recommended. For Arduino, ESP32, ESP8266, and Raspberry Pi (MicroPython), search for "DIYables Mini Mp3 Player" in your IDE's library manager.

Image 5.1: Screenshot demonstrating how to search for and install the "DIYables Mini Mp3 Player" library within the Arduino IDE and Thonny for MicroPython. This step is crucial for enabling software control of the MP3 module.
After installing the library, refer to the examples provided with the library for basic playback, volume control, and track selection.
5.2 Control Modes
- Serial Control (UART): This is the primary method for controlling the module from a microcontroller. Commands are sent via the RX/TX pins to play, pause, adjust volume, and select tracks.
- Onboard Button Control: Some versions or configurations may support basic playback control directly via onboard buttons (if present).
- AD Key Control: External buttons can be connected to the ADKEY pins, allowing for analog input-based control (e.g., a single analog pin reading different resistor values for multiple button functions).
6. Troubleshooting
- No Sound:
- Check speaker connections and ensure they are correctly wired to SPK_1/SPK_2.
- Verify the microSD/TF card is properly inserted and formatted as FAT32.
- Ensure MP3 files are correctly named (e.g., 0001.mp3, 0002.mp3) and located in the root directory or specified folders as per library requirements.
- Confirm the volume is not set to zero in your code.
- Check power supply to the module.
- Module Not Responding to Serial Commands:
- Double-check RX/TX connections (RX to TX, TX to RX).
- Verify the baud rate configured in your code matches the module's default baud rate (typically 9600 or 115200, refer to library documentation).
- Ensure the correct library is installed and initialized.
- Check for any short circuits or loose connections.
- Card Read Error:
- Re-insert the microSD/TF card.
- Try a different microSD/TF card (up to 32GB, FAT32 format).
- Ensure the card is not corrupted.
7. Maintenance
The DIYables Mini MP3 Player Module requires minimal maintenance. Keep the module clean and dry. Avoid exposing it to extreme temperatures, humidity, or static electricity. Ensure proper ventilation if enclosed in a project casing.
8. Warranty and Support
For technical support, troubleshooting assistance, or warranty inquiries, please contact DIYables customer support through their official website or the platform where the product was purchased. Refer to your purchase documentation for specific warranty terms and conditions.
You can visit the DIYables Store for more information and resources: DIYables Store