Skip to content

Ethernet (LAN) compatibility

Introduction

WLED controllers are usually integrated into local network wirelessly (via WiFi). But there is also possibility to integrate WLED Controller into your network via Ethernet (LAN). Currently only ESP32 based controllers support Ethernet (classic, NOT new types like -S2, -C3, -S3 etc.).

Preconditions and important notes

  • ESP32 based controller with integrated Ethernet or with Ethernet adapter is required.
  • The controller / adapter type must be supported by WLED. The list of supported controllers / adapters can be found below.
  • WLED Software must be compiled with Ethernet support included. Web-based WLED installer have special option for this. Be sure you use right WLED version with Ethernet support.
  • Ethernet requires many GPIOs (see table below). You cannot use them for other purposes at the same time.
  • If you switch from WiFi to Ethernet and you use dynamic (not static) IP addresses via DHCP (that is true in most cases), your WiFi/LAN Router will most likely grant new IP address to the WLED Controller. If you don’t delete WiFi credentials, your Controller will be accessible via WiFi and Ethernet at the same time by two different IP addresses.
  • Ethernet standard requires that the ethernet lines including shield are isolated form the electronics and for EMC reason ceramic capacitor (rated for 2 kV) is connected between Ethernet shield and electronics ground. Unfortunately, many simple/cheap ethernet adapters do not fulfill these requirements. Be careful using them.
  • Most of Ethernet based controllers/ adapters are based on LAN87xx IC. It requires proper reset line. Unfortunately, some simple/cheap adapters do not implement this line correctly that might lead to instabilities especially during boot up.
  • If you connect Ethernet adapter via wires, keep them as short as possible. The communication between ESP32 controller and the adapter is on high speed of 50 MHz that requires proper connection to avoid instabilities.

Ethernet setup

Go to "Config" and then to "WiFi Setup". At the bottom of this page select the Ethernet type you use. Then click on "Save & Connect". Ready!

Ethernet controllers and adapters supported by WLED (as of v0.15)

Note: all controllers use GPIOs 19, 21, 22, 25, 26, 27 as they are required for ethernet and can not be changed. GPIOs additionally used are given in the table.

Name Features additional GPIOs used
ABC! WLED V43 & compatible Isolated shield in accordance with IEEE 802.3 standard; LAN8720 based with proper reset line; adapter developed as Plug& Play solution for ABC! WLED Controller V43 but also might be used with other ESP32 boards 5, 17, 23, 33
ESP32-POE General purpose controller with integrated Ethernet 12, 17, 18, 23
ESP32-POE-WROVER ethernet clock connected to a different IO than the ESP32-WROOM module version 0, 12, 18, 23
ESP32Deux / RGB2Go Tetra 17, 18, 23
KIT-VE Board from Espressif (ESP microcontroller manufacture company) 0, 5, 18, 23
LILYGO T-POE Pro PoE IEEE802.3 af/at, Input Voltage: 44-57V, Outputs 5V up to 4A 0, 5, 18, 23
QuinLED-Dig-Octa & T-ETH-POE 17, 18, 23
QuinLED-ESP32 5, 17, 18, 23
Serg74-ETH32 5, 17, 18, 23
TwilightLord-ESP32 5, 17, 18, 23
WESP32 0, 16, 17
WT32-ETH01 0, 16, 18, 23