github.com/ninharp/ninESP ↗

About ninharp/ninESP

ninESP is a modular firmware built for ESP8266 microcontrollers based on the Sming Framework. It allows users to connect various sensors and peripherals to the ESP8266 and expose their functionality through an MQTT client, making it easy to integrate into home automation setups. The firmware can handle tasks like reading sensor data, controlling relay switches, managing RC-compatible smart plugs, and controlling LED matrix displays.

The device features a web-based configuration interface accessible through a WiFi access point on first boot, where users can configure WiFi credentials, MQTT broker settings, and their connected peripherals without touching code. ninESP supports a variety of sensors and modules including status LEDs, relay switches, analog sensors, motion detectors, MAX7219 LED matrices with animation effects, RC switch plugs, and LCD displays. The firmware communicates via MQTT topics, allowing users to send commands and receive telemetry data from any MQTT client, and also supports serial console interaction for additional control and debugging.

The project targets makers and home automation enthusiasts working with common ESP8266 development boards like WeMos D1 mini and NodeMCU v0.9. It requires at least 1MB of flash memory and includes detailed documentation covering MQTT topic structures, peripheral configuration, serial commands, and flashing instructions. The codebase is available as source code for compilation or as pre-built binaries ready to flash.