/ESPEasy

Easy MultiSensor device based on ESP8266

Primary LanguageC++OtherNOASSERTION

Latest Nightly Build Status Downloads Docs Patreon Ko-Fi PayPal
GitHub version Build status Downloads Documentation Status donate donate donate

For ways to support us, see this announcement on the forum, or have a look at the Patreon, Ko-Fi or PayPal links above.

ESPEasy (development branch)

Introduction https://espeasy.readthedocs.io/en/latest/ (and, mostly outdated, wiki: https://www.letscontrolit.com/wiki/index.php/ESPEasy#Introduction)

MEGA This is the development branch of ESPEasy. All new features go into this branch, and it has become the current stable branch. If you want to do a bugfix, do it on this branch.

Check here to learn how to use this branch and help us improving ESPEasy: http://www.letscontrolit.com/wiki/index.php/ESPEasy#Source_code_development

Web based flasher (experimental)

To make it easier to get started, one may flash a build directly to the ESP from your browser. Currently only Chrome and Edge are supported.

See this flash page to try the new web flash feature.

The web flasher is using ESP Web Tools made by the people behind ESPHome and Home Assistant.

Binary releases

On demand, controlled by the repo owner, our build-bot will build a new binary release: https://github.com/letscontrolit/ESPEasy/releases

The releases are named something like 'mega-20220626' (last number is the build date)

Depending on your needs, we release different types of files:

The name is built up from a few key parts:

ESPEasy_mega_[releasedate]_[build-type]_[opt-arduino-library]_[hardware-type]_[flash-size][filesystem-size]_[opt-build-features].bin

[build-type] can be any of:

Build type Description included plugins
custom Custom predefined set/Defined in Custom.h Specific
normal Standard plugins Stable
collection_A Normal + plugin collection A Stable + Collection base + set A
collection_B Normal + plugin collection B Stable + Collection base + set B
collection_C Normal + plugin collection C Stable + Collection base + set C
collection_D Normal + plugin collection D Stable + Collection base + set D
collection_E Normal + plugin collection E Stable + Collection base + set E
collection_F Normal + plugin collection F Stable + Collection base + set F
max All available plugins All available
energy All plugins related to energy measurement Stable + Energy measurement
display All plugins related to displays Stable + Displays
neopixel All plugins related to neopixel Stable + Neopixel
hard hardware specific builds Minimal
minimal minimal plugins for specific use-cases Switch and Controller
spec_* specialized technical builds Not intended for regular use
IRext Infra-red hardware specific Sending and receiving IR cmd

[opt-arduino-library] (optional) can be any of:

Arduino library Description
alt_wifi Alternative WiFi configuration
beta Arduino Beta release
sdk3 Arduino SDK v.3
core_274 Arduino Core 2.7.4 release
core_302 Arduino Core 3.0.2 release
core_274_sdk3 Arduino Core 2.7.4 SDK v.3 release

[hardware-type] can be any of:

Hardware type Description
ESP8266 Espressif ESP8266/ESP8285 generic boards
WROOM02 Espressif ESP8266 WRoom02 boards
ESP32 Espressif ESP32 generic boards
ESP32s2 Espressif ESP32-S2 generic boards
ESP32-wrover-kit Espressif ESP32 wrover-kit boards
SONOFF Sonoff hardware specific
other_POW Switch with power measurement
Shelly_1 Shelly 1 switch
Shelly_PLUG_S Shelly plug S switch with power measurement
Ventus Ventus W266 weather station
LCtech_relay LC-tech serial switch

N.B. Starting 2022/07/23, 1M ESP8266 builds can also be used on ESP8285 units and thus there is no longer a specific ESP8285 build anymore.

[flash-size] can be any of:

Flash size Description
1M 1 MB with 128 kB filesystem
2M 2 MB with 128 kB filesystem
2M256 2 MB with 256 kB filesystem
4M1M 4 MB with 1 MB filesystem
4M2M 4 MB with 2 MB filesystem
16M 16 MB with 14 MB filesystem
4M316k 4 MB with 316 kB filesystem
16M1M 16 MB with 1 MB filesystem
16M8M 16 MB with 8 MB filesystem

[opt-build-features] can be any of:

Build features Description
LittleFS Use LittleFS instead of SPIFFS filesystem (SPIFFS is unstable > 2 MB)
VCC Analog input configured to measure VCC voltage (ESP8266 only)
OTA Arduino OTA (Over The Air) update feature enabled
Domoticz Only Domoticz controllers (HTTP+MQTT) and plugins included
FHEM_HA Only FHEM/OpenHAB/Home Assistant (MQTT) controllers and plugins included
ETH Ethernet interface enabled (ESP32 only)

Some example firmware names:

Firmware name Hardware Included plugins
ESPEasy_mega-20220626_normal_ESP8266_1M.bin ESP8266/ESP8285 with 1MB flash Stable
ESPEasy_mega-20220626_normal_ESP8266_4M1M.bin ESP8266 with 4MB flash Stable
ESPEasy_mega-20220626_collection_A_ESP8266_4M1M.bin ESP8266 with 4MB flash Stable + Collection base + set A
ESPEasy_mega-20220626_normal_ESP32_4M316k.bin ESP32 with 4MB flash Stable
ESPEasy_mega-20220626_collection_A_ESP32_4M316k.bin ESP32 with 4MB flash Stable + Collection base + set A
ESPEasy_mega-20220626_collection_B_ESP32_4M316k.bin ESP32 with 4MB flash Stable + Collection base + set B
ESPEasy_mega-20220626_max_ESP32_16M1M.bin ESP32 with 16MB flash All available plugins
ESPEasy_mega-20220626_max_ESP32_16M8M_LittleFS.bin ESP32 with 16MB flash All available plugins

To see what plugins are included in which collection set, you can find that on the ESPEasy Plugin overview page

Documentation & more info

Our new, in-depth documentation can be found at ESPEasy.readthedocs.io. Automatically built, so always up-to-date according to the contributed contents. The old Wiki documentation can be found at letscontrolit.com/wiki.

Additional details and discussion are on the "Experimental" section of the forum: https://www.letscontrolit.com/forum/viewforum.php?f=18

Gitpod Ready-to-Code

Icons used

Icons on courtesy of ICONS8.