-
Notifications
You must be signed in to change notification settings - Fork 638
Hardware
HamedTa edited this page Feb 7, 2023
·
101 revisions
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.
-
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.
| 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 |
| 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) |
| 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 |
| 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 |
| 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 |
| 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/ |
| 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 |
| Board | Build flag | Description |
|---|---|---|
| Gosund/Homecube SP1 | ||
| Gosund P1 | GOSUND_P1 |
Power strip |
| Board | Build flag | Description |
|---|---|---|
| Let us know | about devices | you've built |
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.
- 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
- MQTT
- REST API
- Domoticz
- Home Assistant
- InfluxDB
- Prometheus metrics
- Thingspeak
- Alexa
- Google Home
- Architecture
- 3rd Party Plugins
- Coding style
- Pull Requests