• Basics
  • Top 5 Mistakes
  • Compatibility
  • Installation
  • Tutorials
  • FAQs
  • Effects
  • Segments
  • Settings
  • Multi-strip Support
  • Basics
  • Features
Welcome to EzloPi Addressable LED!

The EzloPi smart IoT platform is an innovative solution designed to empower users to create and manage smart home and IoT (Internet of Things) projects with ease. It combines hardware, software, and cloud services to provide a comprehensive platform for building connected devices and automation systems.

Welcome to the fast and exciting world of controlling addressable LEDs with your ESP32-based EzloPi device!

With the integration of the WS2812FX library with around 45 effects and over 60 palettes, opens up a world of dynamic lighting possibilities allowing you to create stunning combinations of lighting effects and displays.

The modern UI provides simple and intuitive controls for color, effects, and segment configurations, allowing you to customize lighting to your preferences. Segments enable setting different effects and colors to various parts of the LEDs, enhancing versatility and ensuring seamless integration cycling through the addressable LED setup with the EzloPi smart IoT platform.

Features
  • Modern user interface.
  • Controlled wirelessly without the need for physical switches/connections.
  • Segments to set different effects and colors to parts of the LEDs.
  • Support for RGB strips.
  • Suitable for DIY projects.
Supported light control interfaces:
  • MiOS Web Application
  • MiOS Smart Application for Android and iOS
Getting Started
Set-up guide:
What You'll Need:
  1. EzloPi device (ESP32-based controller board)
  2. Addressable LED strips (WS2812B, WS2811, SK6812, etc)
  3. Level shifter module (BSS138)
  4. 12V to 5V DC-DC Buck Converter (LM2596, etc)
  5. Power supply for the LED strip (5V/12V)
  6. Resistor (62 Ohms) (optional)
  7. Jumper wires
  8. Breadboard for prototyping (Optional)
Note:
  • Ensure that stable output voltages (5V/12V) for both the ESP32 and LED are available.
  • When using a level shifter, including a resistor is optional. Additionally, it's worth noting that some LED strips come with an onboard resistor, making its inclusion optional for effective voltage level conversion.
Default GPIO Usage

Connect your RGB LED(whether 5V or 12V) strip’s data pin (Din) to RX2 pin (GPIO16) on ESP32 board.

Addressable LED strip ESP32
LED Data (Din) RX2 (GPIO16)
Circuit Interfacing & Connections

●   Connections for 5V LEDs (such as WS2812B):

Following interconnections as shown below are made for interfacing the addressable LED to the EzloPi device:

●   Connections for 12V LEDs (such as WS2811,WS2815 or SK6812):

For LEDs with a 12V power source, a step-down/buck converter is used for converting the 12V to 5V. Make sure that the step-down converter 5V output is stable otherwise try adjusting it using the potentiometer if available.

Setting Up MiOS Account:

1. First setup your MiOS account by visiting https://www.ezlopi.com/set-up-mios-account and set up your device/hardware by visiting config.ezlopi.com.

2. Log in using the credentials which you just set earlier while signing up.

3. Under ezloPi on the top left corner, open the drop down menu.

4. Click on EzloPi Addressable LED.

5. Now, click on Connect Device and a pop-up window will appear.

6. Now, select COM Port to which your ESP32 device is connected. In our case, the COM3 port is used. Click Connect.

7. If you are new to this and it’s your first time configuring, select Create new Device ID. Enter Wifi SSID and Wifi password and then click on Flash Device.

8. A window will appear on the bottom left side of the screen displaying “Please press BOOT button while flashing begins.”

9. Hold the BOOT button down until the next window appears on the bottom left side of the screen which says “Installation prepared. Please release the boot button now.”

10. After some time, a popup will appear on the bottom right hand side of your screen saying Device Flashed Successfully!

This means that your EzloPi smart device has been set up successfully.

Top 5 mistakes
Asking for help

Before asking for help on other platforms, check the following top 5 most common mistakes while setting up the EzloPi Addressable LEDs. If you still have trouble and are going to ask for help, provide as much information as possible: describe your setup, take photos, and provide screenshots of your settings.

TOP 5 mistakes:
  1. LED strip is connected from the back side: Addressable LED strips have a direction indicated by small arrows on the strip. The data line must be connected from the side where the arrow begins.
  1. Wrong number of LEDs is set: The correct numbers of LEDs and the correct color sequence (RGB, BGR, etc.) or effect must be used. Effect should be set according to the number of LEDs connected. As seen below, we have applied the desired effect to 10 LEDs on the LED strip.
  1. Check effect by applying: To choose the desired LED effect, you can either apply the pre-defined effects or make a customized effect of your choosing using RGB colors.
  1. Wiring is bad: Wiring must be done thoroughly. Loose contacts and interconnections between different hardware components must be avoided. You also need to be careful about the correct sizing of the cables: too thin wires can not only cause high voltage drop but also lead to overheating and short circuit.
  2. If many power sources are used (for example separate one for ESP and separate one for the LED strip), then all their grounds (GND, V-) must be connected together (but do not connect their V+ together!).
Compatibility
LED Strips:

EzloPi supports various types of LED Strip types which can be utilized to implement various interactive effects as per the user’s mood.

Addressable LED Strips

Addressable LED Strips allow control of individual LEDs separately. This enables you to use many effects. The supported types are listed below.

Type Voltage
SK6812 5V / 12V
WS2812B 5V
UCS8903 12V
WS2811 12V
WS2815 12V
GS8208 12V
TM1814 12V
Controllers

Microcontrollers from Espressif, ESP32 (with dual core) with various ESP-32 based MCUs (such as Wemos D1, Arduino Nano ESP32, etc) are fully supported.

To try out EzloPi Addressable LEDs with 5V addressable strip, a simple microcontroller board like ESP32D1 mini is sufficient. The simplest setup should be like:

However, there are a few other things to keep in mind for a proper setup:

  1. A level shifter is required for reliable data transmission from the controller to the LED strip (this is mandatory, especially with 12V or 24V LED strips). Then you have to solder something together or you can buy a ready-made EzloPi controller right away.
  2. For safety reasons, the correct cabling (length, contacts) and the fuses or safety circuitry to be integrated must be considered. Especially with LED strips, it gets more complicated because you need the so-called intermediate feeds. These must be planned and implemented correctly.
  3. LED strips can get quite warm during operation and even overheat in the event of a fault. Again, for safety reasons, you have to protect the area around it: you shouldn't just lay LED strips like that, ideally you should integrate them into aluminum profiles or something similar. In normal operation, these act like a heat sink and thus extend the service life of the LEDs. In the event of a fault, they can protect the surroundings.
  4. To save energy while LEDs are off, you might integrate relays that switch the voltage of LEDs off completely.

Controllers Addressable LEDs can be installed to:

Input may be added by the hardware/embedded team.

Other Hardware

Useful boards and addons

You can find many more exciting projects

HC-SR501 PIR sensor with adjustable sensitivity
DHT11 Temperature and humidity sensor
MG966R MG996R servo motor
FC-28 Soil Moisture Sensor Module
TTP223B Capacitive Touch Sensor module
DS18B20 Digital temperature sensor
Display shield Various configurations. Compatible with the ESP32 dev board also can be used with ESP32 mini dev boards.
MPU6050 Gyro and Accelerometer module
5V relay Relay module
B366 motor Mini DC motor

Here are some sensors supported with the EzloPi device platform other than the Addressable LEDs. You can find more exciting projects on our website:

https://www.ezlopi.com/new-projects/

Software
MiOS Home Assistant:

Versatile and feature rich smart home assistant application. Easy to configure with a user-friendly graphical interface.

EzloPi Web Flasher:

To configure the Addressable LED strips according to desired colors and effects.

Installation
Setting Up MiOS Account:
  1. First setup your MiOS account by visiting https://www.ezlopi.com/set-up-mios-account and set up your device/hardware by visiting config.ezlopi.com.

  2. Log in using the credentials which you just set earlier while signing up.

  3. Under ezloPi on the top left corner, open the drop down menu.

  4. Click on EzloPi Addressable LED.

  5. Now, click on Connect Device and a pop-up window will appear.

  6. Now, select COM Port to which your ESP32 device is connected. In our case, the COM3 port is used. Click Connect.

  7. If you are new to this and it’s your first time configuring, select Create new Device ID. Enter Wifi SSID and Wifi password and then click on Flash Device.

  8. A window will appear on the bottom left side of the screen displaying “Please press BOOT button while flashing begins.”

  9. Hold the BOOT button down until the next window appears on the bottom left side of the screen which says “Installation prepared. Please release the boot button now.”

  10. After some time, a popup will appear on the bottom right hand side of your screen saying Device Flashed Successfully!

This means that your EzloPi smart device has been set up successfully.

Software

New to the world of Electronics, Automation and IoT? Don't know yet how to make projects for your needs? Unsure how to connect your LEDs safely? How to connect your power supply?

No worries, we have collected a few helpful links for you to learn more about these and more topics while implementing them.

Project Links
Video Tutorials
ezloPi addressable LED Blink effect
ezloPi addressable LED add two segments
Android Effect using Addressable LED
Bicolor Chase effect using Addressable LED
ezloPi addressable LED Effect using specific colors
ezloPi addressable LED Temperature Color Palette
ezloPi Addressable LED Chase Blackout Rainbow Effect
ezloPi addressable LED Blink Rainbow effect
ezloPi Addressable LED Chase Blackout Rainbow effect with reverse function
ezloPi Addressable LED Chase Color Effect
ezloPi addressable LED Breath effect
Addressable LED speed control of effect
ezloPi Addressable LED Chase Flash effect
ezloPi Addressable LED Chase Flash Random Effect
ezloPi addressable LED Chase Rainbow White Effect
ezloPi Addressable LED Circus Combustus Effect
ezloPi Addressable LED Fade effect
ezloPi Addressable LED Halloween Effect
Fire Flicker Effect using Addressable LED
Dual Scan Effect using Addressable LED
Flash Sparkle Effect using Addressable LED
EzloPi Addressable LED Color Sweep Random effect
EzloPi Addressable LED Merry Christmas effect
EzloPi Addressable LED Hyper Sparkle Effect
EzloPi Addressable LED Fire Flicker Intense Effect
ezloPi Addressable LED Running Color effect
EzloPi Addressable LED Rainbow Cycle effect
FAQs

If you have any queries or questions and want to know more about Ezlo and the EzloPi platform, head over to our community forum.

https://community.ezlo.com/

Effects
Various effects can be implemented using EzloPi Addressable LEDs.
Effects Description
Solid Solid primary color on all LEDs
Android Section of varying length running
Bicolor Case 2 LEDs in primary color running on secondary
Blink Blinks between primary and secondary color
Blink Rainbow Same as blink, cycles through the rainbow
Breath Fades between primary and secondary color
Chase Blackout Rainbow LEDs flash in Rainbow color after blackout
Chase Color 2 LEDs in primary color running on secondary
Chase Flash 2 LEDs flash in secondary color while the rest is lit in primary
Chase Flash Random Like Chase Flash, but the 2 LEDs flash in random colors and leaves a random color behind
Chase Rainbow Like Chase but leaves trail of rainbow
Segments

This feature allows you to set different zones on the LED strip, each running a different effect or color.

A segment is selected if the checkmark next to the segment number is checked. Changes you make to color or effects will apply to all selected segments. The color/effect that is shown in the web UI is that of the first selected segment.

Tip: If you divide your strip into two segments, reverse the second one and select both, you can achieve very nice symmetrical effects!

Segment 0 has a Start LED of 0 and a Stop LED equal to the LED Count you defined in Configuration. Reverse direction can also be achieved using the Reverse direction check button.

Settings

Web-configurable settings are split in multiple sub-pages. This page is meant to clarify the purpose of each setting.

WiFi Settings:

This sub-page offers options to connect the ESP to different WiFi/WLAN devices.

Setting name Description
WiFi Name The name (SSID) of your WiFi
WiFi Password The password of your home WiFi
Client IP The current IP of the ESP in the home network
Multi-strip Support

Users are able to use multiple LED outputs from one ESP board! Pins and LED numbers can be easily configured in LED settings, you don't need to re-compile code for your specific setup. Custom binaries for multiple pins are now also a thing of the past!

There are a few tips and recommendations to keep in mind when designing your setup:

General:
  • It is highly recommended to use an ESP32 when using more than 1 output
  • You may freely choose the LEDs type, pin numbers, length and color order of your LED strips at runtime in the LED settings page.
  • Highly recommended to size the power supply correctly according to your setup.
  • Most strip types have yet to be tested. Add confirmed working below:
  • Confirmed working: WS281x, SK6812, etc