Supported Hardware

This is the official list of supported hardware for the ESPurna firmware. The hardware configuration for each of these boards can be selected by supplying the build flag (see Firmware section).

CAUTION:

Never ever connect any of these devices to your computer and to mains at the same time.

Never ever manipulate them while connected to mains. Seriously, it can be FATAL! I don't want you to die.

I hold no responsibility for any damage to you, your family, your house,... for any action or results derived from flashing or using these devices.

CAUTION:

Different devices may be flashed at different voltages (3.3v, 5v). Make sure your USB-to-UART device is set to the correct one or you risk destroying your device.

Generic hardware

Set up the device for flashing
Check out the configuration guide
Make sure to search for hardware configuration in the hardware.h!
https://github.com/xoseperez/espurna/blob/dev/code/espurna/config/hardware.h
If something is missing from here and / or from the hardware header, please try to search the device at the http://blakadder.github.io/templates/. Refer to the Configuration guide's Templates description for more info.

ITEAD Sonoff Modules

Board	Build flag	Description
ITEAD Sonoff Basic	`ITEAD_SONOFF_BASIC`	Switch. R2 and R3 are also supported.
ITEAD Sonoff RF	`ITEAD_SONOFF_RF`	Switch with RF Receiver. Same board as Sonoff Basic, additional MCU module presses the button when RF signal is received. R2 and R3 are also supported.
ITEAD Sonoff Dual	`ITEAD_SONOFF_DUAL` `ITEAD_SONOFF_DUAL_R2`	2 Switches
ITEAD Sonoff POW	`ITEAD_SONOFF_POW`	Switch with Power Consumption Measurement
ITEAD Sonoff POW R2	`ITEAD_SONOFF_POW_R2`	Switch with Power Consumption Measurement
ITEAD Sonoff TH10/16	`ITEAD_SONOFF_TH`	Switch with Temperature and Humidity Monitoring
ITEAD Sonoff 4CH	`ITEAD_SONOFF_4CH`	4 Switches with din rail mounting
ITEAD Sonoff 4CH Pro / Pro R2	`ITEAD_SONOFF_4CH_PRO`	4 Switches with din rail mounting and RF Receiver
ITEAD Sonoff Touch	`ITEAD_SONOFF_TOUCH`	Touch Wall Switch
ITEAD Sonoff B1	`ITEAD_SONOFF_B1`	Dimmable E27 LED Lamp RGB Color Light Bulb
ITEAD Sonoff T1	`ITEAD_SONOFF_T1_1CH` `ITEAD_SONOFF_T1_2CH` `ITEAD_SONOFF_T1_3CH`	1-3 Gang Touch Wall Switch. T0 and TX are also supported.
ITEAD Sonoff LED	`ITEAD_SONOFF_LED`	Adjustable LED strip
ITEAD Sonoff RF Bridge	`ITEAD_SONOFF_RFBRIDGE`	Bridge between 433MHz RF and WiFi
ITEAD Slampher ITEAD Slampher 2.0	`ITEAD_SLAMPHER`	433MHz RF & WiFi Smart Light Bulb Holder
ITEAD S20	`ITEAD_S20`	Outlet
ITEAD S26	`ITEAD_S20`	Outlet (same image as S20)
ITEAD S55	`ITEAD_S20`	Wall outlet (same image as S20)
ITEAD S31	`ITEAD_SONOFF_S31`	Outlet w/ power metering
ITEAD S31 Lite	`ITEAD_SONOFF_S31_LITE`	Outlet
ITEAD 1CH Inching	`ITEAD_1CH_INCHING`	Inching/Self-Locking Switch
ITEAD Motor Clockwise/Anticlockwise	`ITEAD_MOTOR`	Controls 7-32V DC or 125-250V AC motor
ITEAD Sonoff SV	`ITEAD_SONOFF_SV`	5-24V low voltage Switch
ITEAD BN-SZ01	`ITEAD_BNSZ01`	LED Ceiling Light

Lights / LED Controllers

Board	Build flag	Description
AI-Thinker AI Light / Noduino OpenLight	`AITHINKER_AI_LIGHT`	E27 LED Lamp
Magic Home LED Controller	`MAGICHOME_LED_CONTROLLER` `MAGICHOME_LED_CONTROLLER_23` `MAGICHOME_LED_CONTROLLER_20` `MAGICHOME_ZJ_WFMN_A_11` `MAGICHOME_ZJ_WFMN_B_11` `MAGICHOME_ZJ_WFMN_C_11`
Magic Home Light bulbs	`MAGICHOME_ZJ_LB_RGBWW_L` etc.
Huacanxing H801/H802	`HUACANXING_H801` `HUACANXING_H802`
Arilux AL-LC01 Arilux AL-LC02 Arilux AL-LC11	`ARILUX_AL_LC01` `ARILUX_AL_LC02` `ARILUX_AL_LC11`
Arilux AL-LC06	`ARILUX_AL_LC06`
Arilux E27	`ARILUX_E27`
InterMitTech QuinLED	`INTERMITTECH_QUINLED`
Autohometion LYT8266	`AUTHOMETION_LYT8266`
Generic AG-L4	`GENERIC_AG_L4`
Generic GU10	`GENERIC_GU10`
Generic E14	`GENERIC_E14`
iWoole Smart Table Lamp	`IWOOLE_LED_TABLE_LAMP`	RGBW Table Lamp
Lombex Lux Nova	`LOMBEX_LUX_NOVA2_TUNABLE_WHITE` `LOMBEX_LUX_NOVA2_WHITE_COLOR`	Smart bulb
Muvit IO miobulb001	`MUVIT_IO_MIOBULB001`	Smart bulb
LOHAS BR30	`LOHAS_E27_9W`	Smart bulb
LOHAS A19	`LOHAS_E26_A19`	Smart bulb
LSC Smart LED Light Strip	`LSC_SMART_LED_LIGHT_STRIP`	LED strip with IR remote
Deltaco SH	`DELTACO_SH_LEXRGB` `DELTACO_SH_LEXXW`
GBLIFE RGBW	`GBLIFE_RGBW_SOCKET`
Lyasi LED	`LYASI_LIGHT`
Nexete A19 LED	`NEXETE_A19`	4 channels (RGBW)
Phyx ESP12 RGB	`PHYX_ESP12_RGB`
PSH RGBW Controller	`PSH_RGBW_CONTROLLER`
Teckin SB53 and Bakibo 9W E27 RGB CCT bulb	`TECKIN_SB53`
Xiaomi Smart Desk Lamp	`XIAOMI_SMART_DESK_LAMP`
Lampi RGBWW Battery Powered Smart Light	`LAMPI_RGBWW`	5 channels (RGBWW)

Power Plugs

Board	Build flag	Description
KMC 70011	`70011`	Power plug w/ power metering
OBI / Euromate Wifi Plug	`EUROMATE_WIFI_STECKER_SCHUKO`	Power plug from OBI
OBI / Euromate Wifi Plug v2	`EUROMATE_WIFI_STECKER_SCHUKO_V2`	Power plug from OBI v2
HAMA WiFi Steckdose 00176533	`HAMA_WIFI_STECKDOSE_00176533`
WiOn 50055	`WION_50055`
Xenon SM PW 702U	`XENON_SM_PW702U`
HEYGO HY02	`HEYGO_HY02`
Maxcio W-US002S	`MAXCIO_WUS002S`
Maxcio W-DE004	`MAXCIO_WDE004`
YiDian XS-SSA05	`YIDIAN_XSSSA05`
Tonbux XS-SSA06	`TONBUX_XSSSA06`
Tonbux Powerstrip02	`TONBUX_POWERSTRIP02`	4 AC Outlets + 4 USB Charging Ports
Teckin SP10	`TECKIN_S21`	Power plug
Teckin SP20	`TECKIN_SP20`	Power plug w/ power metering
Teckin SP21	`TECKIN_S21`	Power plug, newer versions do not have a ESP8266 thus they are not compatible with ESPurna
Teckin SP22 (v1.4)	`TECKIN_SP22_V14`	Power plug w/ power metering
Teckin SP23 (v1.3)	`TECKIN_SP23_V13`	Power plug w/ power metering
Gosund WS1	`GOSUND_WS1`	Power plug
Gosund WP3	`GOSUND_WP3`	Power plug
Gosund SP111	`GOSUND_SP111`	Power plug
Zhilde ZLD-44EU-W	`ZHILDE_EU44_W`	4 AC Outlets + 4 USB power supply ports
Zhilde ZLD-64EU-W	`ZHILDE_EU64_W`	6 AC Outlets + 4 USB power supply ports
LINGAN SWA1	`LINGAN_SWA1`	Power plug
TONBUX/MXQ SP04	`LINGAN_SWA1`	Power plug
NEO COOLCAM NAS WR01W	`NEO_COOLCAM_NAS_WR01W`	Power plug
BLITZWOLF BW-SHP2	`BLITZWOLF_BWSHPX`	Power plug w/ power metering
BLITZWOLF BW-SHP2	`BLITZWOLF_BWSHPX_V23`	Power plug w/ power metering
BLITZWOLF BW-SHP5	`BLITZWOLF_BWSHP5`	Power plug w/ power metering
Bestek MRJ1011	`BESTEK_MRJ1011`	Power plug w/ 2 USB ports
Orvibo B25 EU/UK	`ORVIBO_B25`	Power plug
Delock 11862	`NEO_COOLCAM_NAS_WR01W`	Power plug
Hykker Smart Plug	`HYKKER_SMART_HOME_POWER_PLUG`	Power plug w/ power metering
Twakie Smart Plug	`ITEAD_SONOFF_S31`	Power plug w/ power metering and USB
AVATTO NAS WR01W	`AVATTO_NAS_WR01W`	Power plug w/ power metering
Deltaco SH Smart Power Plug	`DELTACO_SH_P01` `DELTACO_SH_P03USB`	Power plug or Power plug /w USB port
DIGOO NX SP202	`DIGOO_NX_SP202`	Power plug w/ power metering
Etekcity ESW01 (USA)	`ETEKCITY_ESW01_USA`	Power plug w/ power metering
Fornorm ZLD 34 (EU)	`ESTINK_WIFI_POWER_STRIP`	Power outlet
ISELECTOR SM PW702	`ISELECTOR_SM_PW702`	Power plug
Kogan Smarter Home	`KOGAN_SMARTER_HOME_PLUG_W_POW`	Power plug w/ power metering
Litesun LA WF3	`LITESUN_LA_WF3`	Power plug
Litesun LQ-2-W3	`LITESUN_LA_WF3`	Power plug
Litesun LA WF7	`BLITZWOLF_BWSHPX_V23`	Power plug w/ power metering (see #2281)
Oukitel Power Plug	`OUKITEL_P1`
PSH Plug	`PSH_WIFI_PLUG` `PSH_WIFI_SENSOR`	Power plug
Smartlife Mini Smart Socket	`SMARTLIFE_MINI_SMART_SOCKET`	Power plug w/ power metering
TFlag NX SMX00	`TFLAG_NX_SMX00`	Power plug w/ power metering
Vanzavanzu Smart WiFi Plug	`VANZAVANZU_SMART_WIFI_PLUG_MINI`	Power plug w/ power metering
YT-E002 Smart Wifi Double Plug	`YT-E002`	Double Power plug

Development Boards

Board	Build flag	Description
Wemos D1 Mini	`WEMOS_D1_MINI`
Wemos D1 Mini Relay Shield	`WEMOS_D1_MINI_RELAYSHIELD`
NodeMCU Lolin	`NODEMCU_LOLIN`	Actually any NodeMCU clone should work
Witty Cloud	`WITTY_CLOUD`	Simple Board /w RGB Led & LDR

Other

Board	Build flag	Description
STM Relay	`STM_RELAY`
YJZK wall switch	`YJZK_SWITCH_1CH` `YJZK_SWITCH_2CH` `YJZK_SWITCH_3CH`	1-3 Gang Touch Wall Switch
Tonbux Mosquito Killer	`TONBUX_MOSQUITO_KILLER`	UV Lamp + Fan for suction
EXS WiFi relay	`EXS_WIFI_RELAY_V31` `EXS_WIFI_RELAY_V50`	Relay switch
Jinvoo SM-AW713	`JINVOO_VALVE_SM_AW713`	Motorized valve
Shelly 1	`ALLTERCO_SHELLY1`	Relay Switch
Shelly 2	`ALLTERCO_SHELLY2`	Relay Switch
Shelly 1PM	`ALLTERCO_SHELLY1PM`	Relay Switch w/ power metering and temperature sensor
Shelly 2.5	`ALLTERCO_SHELLY25`	Relay Switch

Custom Boards

Board	Build flag	Description
Tinkerman's ESPurna H	`TINKERMAN_ESPURNA_H06` `TINKERMAN_ESPURNA_H08`
Tinkerman's ESPurna Switch	`TINKERMAN_ESPURNA_SWITCH`
Tinkerman's RFM69 Gateway	`TINKERMAN_RFM69GW`
ManCaveMade ESPLive	`MANCAVEMADE_ESPLIVE`
Electrodragon ESP Relay Board	`ELECTRODRAGON_WIFI_IOT`
WorkChoice EcoPlug	`WORKCHOICE_ECOPLUG`
Jan Goedeke Wifi Relay Board (NC/NO)	`JANGOE_WIFI_RELAY_NC` `JANGOE_WIFI_RELAY_NO`
OpenEnergyMonitor Wifi MQTT Relay / Thermostat	`OPENENERGYMONITOR_MQTT_RELAY`
Jorge García Wifi + Relay Board Kit	`JORGEGARCIA_WIFI_RELAYS`
EXS WiFi Relay v3.1	`EXS_WIFI_RELAY_V31`
IKE ESPike	`IKE_ESPIKE`
ESP DIN Relay	`PILOTAK_ESP_DIN_V1`	https://github.com/pilotak/esp_din
Arniex Swifitch	`ARNIEX_SWIFITCH`
Luani HVIO (original in german) google translation (english)	`LUANI_HVIO`
Hörmann Torantrieb mit UAP 1 (original in german) google translation (english)	`FS_UAP1`	ESP8266 based smarthome solution for Hörmann door drive with UAP 1
Linksprite Linknode R4	`LINKSPRITE_LINKNODE_R4`	Arduino-compatible WiFi relay controller
eHomeDIY Boards	`EHOMEDIY_WT02` `EHOMEDIY_WT03`	https://github.com/eHomeDIY/WT02-hardware
BH OnOfre	`BH_ONOFRE`	https://github.com/brunohorta82/BH_OnOfre/

Generic boards

Board	Build flag	Description
Generic 8 Channel board	`GENERIC_8CH`
Generic ECH1560	`GENERIC_ECH1560`
Generic V9261F	`GENERIC_V9261F`
Green ESP8266 Relay	`GREEN_ESP8266RELAY`
Generic Relay v4.0	`GENERIC_ESP01S_RELAY_V40`
Generic RGBLed v1.0	`GENERIC_ESP01S_RGBLED_V10`
Generic DHT11 v1.0	`GENERIC_ESP01S_DHT11_V10`
Generic DS18B20 v1.0	`GENERIC_ESP01S_DS18B20_V10`
Heltec Touch Relay	`HELTEC_TOUCHRELAY`
Generic TUYA dimmer	`TUYA_GENERIC_DIMMER`	For TUYA devices using a secondary MCU
ALLNET 4duino IoT WLAN Relais Unterputz ESP8266-UP-Relais	`ALLNET_4DUINO_IOT_WLAN_RELAIS`

Beta Testing

Board	Build flag	Description
Gosund/Homecube SP1
Gosund P1	`GOSUND_P1`	Power strip

Community boards

Board	Build flag	Description
Let us know	about devices	you've built

Home
Change log

Getting started

Backup the stock firmware
Flash a pre-built binary image
Flash a virgin Itead Sonoff device without opening
Flash TUYA-based device without opening
Flash Shelly device without opening
Using PlatformIO
- from Visual Studio Code
Using Arduino IDE
Build the Web Interface
Over-the-air updates
Two-step updates
ESPurna OTA Manager
NoFUSS
Troubleshooting

Supported hardware and options

Configuration

Integrations

Network

WiFi
mDNS
SSDP
LLMNR
NetBios
NTP

Developers

More around ESPurna

Support

If you're looking for support:

Issues: this is the most dynamic channel at the moment, you might find an answer to your question by searching open or closed issues.
Wiki pages: might not be as up-to-date as we all would like (hey, you can also contribute in the documentation!).
Gitter channel: you have better chances to get fast answers from project contributors or other ESPurna users. (also available with any Matrix client!)
Issue a question: as a last resort, you can open new question issue on GitHub. Just remember: the more info you provide the more chances you'll have to get an accurate answer.