tasmota

Tasmota is an alternative firmware for ESP8266 and ESP32 based devices. It is written for PlatformIO and is licensed under GPL-3.0-only. Key capabilities described in the README: - Easy configuration through a web-based UI. - Over-the-air (OTA) firmware updates. - Automation using timers or rules. - Expandability. - Entirely local control over MQTT, HTTP, Serial or KNX. Installation and updates: - Initial installation can be done with the Tasmota WebInstaller. - Released firmware binaries are available from the project's OTA download locations for ESP8266 and ESP32. - Development builds are posted after commits that compile successfully and can also be used for OTA updates. - The README warns that OTA upgrades can fail and that serial flashing may be required; it advises testing and backing up configuration before updating. Configuration and migration: - Compile-time changes are made through a user_config_override.h file, copied from a provided sample, so custom settings persist across new versions. - The README lists a migration path for major version upgrades and notes that upgrading from a minimal to a minimal version is likely to fail and require serial flashing. - It notes version breaks due to changes in parameter storage layout and internal GPIO function representation. Device support: - A database of supported devices is maintained in the Tasmota Device Templates Repository. - The README asks users not to request new device additions unless new features require additional code, and suggests using Templates first. Documentation and support: - Documentation, FAQ/troubleshooting, and command references are hosted on the project's documentation site. - Community support is available through GitHub Discussions, a Discord users chat, GitHub issues, and an unofficial German-language Telegram group. Safety: - The README includes a warning about electrocution risk when devices connect to mains electricity and advises against flashing while connected to AC power. Contributing: - Contributions are welcomed in the form of pull requests, testing new features and reporting issues, hardware donations, and documentation. The README also credits numerous individual contributors for drivers, tooling, support, and other work.