DOMRAEM ESP32 WLED Digital Music Controller User Manual

1. Product Overview

The DOMRAEM ESP32 WLED Digital Music Controller (DOM-WLE-AM) is an advanced, open-source based controller designed for smart LED strip lighting. It features a built-in microphone for music synchronization, supports a wide range of addressable LED chips, and offers versatile control options via a mobile app, voice assistants like Alexa, and integration with smart home platforms like MQTT and Home Assistant.

Key Features:

• Wide Voltage Input & High Power Output: Supports 5-24V DC input with 12A per channel and 16A total output capacity. Includes a USB-C 5V/5A direct power supply interface.
• Smart WiFi Connectivity & Open-Source Control: Utilizes ESP32 WLED wireless control technology, allowing direct WiFi connection and easy management via the WLED app. Open-source code supports developer customization and continuous upgrades.
• Sound-Activated & Music Sync: Built-in microphone enables sound-reactive lighting effects that automatically synchronize with music rhythm.
• Multi-Smart Control: Compatible with mainstream voice assistants (Alexa/Google Assistant) and supports dual control modes: remote (sold separately) and mobile app.
• 100+ Lighting Effects: Features a built-in professional-grade lighting effects library, fully supporting DIMMER/RGB/RGBW/RGBCCT light strips for personalized lighting scenes.
• Energy-Efficient Eco-Design: Standby power consumption of approximately 0.5W, ensuring long-term stable operation.
• Extensive Hardware Compatibility: Compatible with mainstream LED chips including WS2811, SK6812, WS2812B, WS2813, WS2814, WS2815, TM1814, and WS2805.

Product Highlights:

• Industrial-grade circuit protection design.
• Professional open-source lighting control system.
• One-touch smart scene switching.
• Minimalist aesthetic exterior design.

2. Package Contents

Please check the package for the following items:

• 1x DOMRAEM ESP32 WLED Digital Music Controller (DOM-WLE-AM)

Note: LED strips, power supply, and remote control are sold separately and are not included in this package.

3. Specifications

4. Setup Guide

4.1 Powering the Controller

The DOMRAEM WLED controller offers flexible power options:

• DC 5-24V Input: Connect a compatible DC power supply to the 'INPUT DC5V-24V' terminal. Ensure the voltage matches your LED strip requirements.
• USB-C 5V/5A Input: For 5V LED strips, you can use a USB-C power adapter connected to the 'INPUT USB-C DC5V/5A' port. Do not exceed 5A when using USB-C.
• V+, V- Power Interface: An additional V+, V- power interface is available for direct power connection.

4.2 Wiring LED Strips

The controller features quick connect port design for convenient wiring. Follow these steps:

1. Open the connector: Gently open the connector upwards.
2. Insert the wire: Insert the stripped wire into the appropriate terminal.
3. Press down: Press down on the connector to secure the wire.

Wiring Instructions:

• The group of D for GPIO16 is the default output. Please use this group first.
• The other group of D is GPIO2, which can be used after configuration on the APP.
• Ensure correct polarity: V=VCC, D=DATA, G=GND.

4.3 App Installation

The WLED app is essential for controlling your LED strips. Download it using the following methods:

• iOS: Search for "WLED" or "WLED Native" in the Apple App Store.
• Android: Download from the official GitHub repository: github.com/Aircoookie/WLED-App/releases

4.4 Initial App Configuration (WiFi Setup)

Follow these steps to connect your controller to your WiFi network and the WLED app:

1. Step One: Power on the WLED controller. Open the phone settings and connect to the WLED-AP WiFi network (password: wled1234).
2. Step Two: After successful connection, it will automatically redirect to the WLED page. If not, open a browser and enter the WLED page. Click on "WIFI SETTINGS".
3. Step Three: Click "Scan" to display the account. NOTE: Be sure to choose a 2.4GHz WiFi network, otherwise it will not work.
4. Step Four: Enter the password, then click "save" at the top of the screen after entering the password.
5. Step Five: Connect your phone and WLED controller to the same WiFi.
6. Step Six: Enter the WLED page for configuration.
7. Step Seven: Click on "Blank space" to enter the WLED page.
8. Step Eight: After successful application, open WLED app.

5. Operating Instructions

5.1 Basic App Control (Colors and Effects)

Once connected to the WLED app, you can easily control your LED strips:

• Colors: Use the color wheel to select static colors or choose from predefined color palettes.
• Effects: Browse through over 100 dynamic effects. Adjust speed, intensity, and other parameters for each effect.
• Segments: Divide your LED strip into multiple sections and apply unique colors and effects to each segment independently.

5.2 Music Mode

The built-in sensitive microphone allows the ESP32 WLED controller to follow music dynamic mode. After resetting, the microphone parameters need to be configured for the first time, and the device needs to be restarted.

Configuration Information:

1. Microphone type: Generic I2S
2. I2S SD pin: 26
3. I2S WS pin: 5
4. I2S SCK pin: 21

5.3 Voice Assistant Integration (Alexa)

To connect your WLED controller with Alexa, follow these steps:

1. Go to the control page of the WLED controller, click on the "Config" button in the top right corner to enter the settings, and then click on "Sync Interfaces".
2. Scroll up to find "Alexa Voice Assistant", check the box next to "Emulate Alexa device", and then save.
3. After successfully saving, power cycle the WLED controller once by turning it off and on.
4. Open "Amazon Alexa" app, click on the "Devices" page at the top right corner on the "+" Sign, and then click "Add Device".
5. Then, scroll up and click on "Other" to enter, select "Wi-Fi", and then click "Discover Devices" to search for lights.

5.4 Button Functions

The controller has two buttons: Reset and Opt.

• Reset Button: Pressing this button will put the controller module in a powered-off state, making the WLED controller unusable. Releasing the button will power the module back on, then you can use WLED controller normally. This button is useful for powering the controller on and off when it's inconvenient.
• Opt Button:
  1. Short press: Power on/off.
  2. Long press for 1 second: Switch colors.
  3. Long press for more than 10 seconds: The WLED device will be reset to factory settings and the WLED-AP hotspot will be activated. Do not use unless it is an emergency! If the factory settings have been restored, please refer to the instruction manual to configure the device correctly.

5.5 Relay Configuration

The controller supports relay configuration. When the power is turned off, there is no current passing through the LED strip, thus reducing power consumption. This can be configured within the WLED app settings.

5.6 WLED Remote Control (Optional)

The controller supports WLED remote control for long transmission distance and stable signal. Please note that the WLED remote control is sold separately and is not included with the controller.

5.7 Supported LED Strip Types

The controller supports most addressable LED strip types, including:

• WS2811
• WS2812
• WS2814
• WS2815
• SK6812
• SM16703
• SM16703P3
• FL1903B

5.8 Product Demonstration Video

6. Maintenance

To ensure the longevity and optimal performance of your DOMRAEM WLED Digital Music Controller, please follow these maintenance guidelines:

• Cleaning: Use a soft, dry cloth to clean the exterior of the controller. Avoid using liquid cleaners or solvents, as they may damage the device.
• Environment: Operate the controller within the specified operating temperature range of -20 to 45°C. Avoid exposing it to extreme temperatures, high humidity, or direct sunlight.
• Connections: Periodically check all wiring connections to ensure they are secure and free from corrosion. Loose connections can lead to intermittent operation or damage.
• Storage: If storing the controller for an extended period, disconnect it from power and store it in a cool, dry place.

7. Troubleshooting

If you encounter issues with your DOMRAEM WLED Digital Music Controller, refer to the following troubleshooting tips:

7.1 LEDs Not Responding After Reset/Update

Important: After any reset or OTA update, you MUST configure GPIO12, then briefly press Reset or power cycle the controller. Refer to the manual for detailed configuration.

• Check GPIO12 Configuration: Ensure GPIO12 is correctly configured in the WLED app settings. If abnormal, reconfigure and reboot the controller.
• Inspect Power Supply: If GPIO12 configuration is normal, check the power supply circuit for any issues. Ensure the power supply is providing the correct voltage and sufficient current for your LED strips.

7.2 Connectivity Issues (WiFi)

• Verify WiFi Network: Ensure your phone and the WLED controller are connected to the same 2.4GHz WiFi network. The controller does not support 5GHz networks.
• Check Password: Double-check that the WiFi password entered during setup is correct.
• Restart Router/Controller: Try restarting your WiFi router and the WLED controller.
• Reset to Factory Settings: If all else fails, perform a factory reset by long-pressing the 'Opt' button for more than 10 seconds. Then, repeat the initial app configuration steps.

7.3 Microphone Not Responding

• Initial Configuration: After resetting the device, the microphone parameters (I2S SD pin, WS pin, SCK pin) must be configured in the WLED app settings. Refer to section 5.2.
• Restart Device: After configuring microphone parameters, restart the controller for changes to take effect.

8. User Tips

• For optimal performance, ensure your power supply is adequately rated for the length and density of your LED strips.
• Experiment with different effects and segments in the WLED app to discover unique lighting combinations.
• Regularly check for WLED firmware updates to access new features and improvements.
• When using voice control, ensure clear pronunciation and that your voice assistant is properly linked to the WLED controller.

9. Warranty and Support

The DOMRAEM ESP32 WLED Digital Music Controller comes with a 2-year warranty from the date of purchase, covering manufacturing defects. Please retain your proof of purchase for warranty claims.

For technical support, troubleshooting assistance, or warranty inquiries, please contact your retailer or visit the official DOMRAEM support website.

10. Safety Information

• Always ensure the input voltage (DC 5-24V) matches the requirements of your LED strips and power supply. Exceeding the maximum voltage or current can damage the controller and LED strips.
• When using the USB-C input, ensure the power supply does not exceed 5V/5A.
• Ensure all wiring is correctly connected with proper polarity (VCC, Data, GND) to prevent damage.
• Do not expose the controller to water, moisture, or extreme temperatures.
• Keep the device away from children.
• Do not attempt to open or modify the controller, as this will void the warranty and may pose a safety risk.