Hardware - xoseperez/espurna GitHub Wiki

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

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 SlampherITEAD 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-LC01Arilux AL-LC02Arilux 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