ACRouter – Versionshinweise

Public changelog for stable releases. For detailed development history, see CHANGELOG.md.

---

[2.0.0] - 2026-07-16

Smart-Module Architecture & Compile Tiering

The v2.0 firmware moves sensing and dimming to smart I2C modules and adds a low-cost second target — complete and hardware-validated on both ESP32 and ESP32-C2.

What's New

Smart sensing & dimming (I2C modules)

• rbAmp current/voltage modules with per-channel roles (grid / solar / load / voltage) — replaces on-device ADC sensing; modules are factory-calibrated (select the CT model to match your clamp)
• DimmerLink I2C smart dimmers — dimming is now driven over DimmerLink (role=dimmer auto-binds the primary output)
• ESP-NOW remote sensing / dimmer nodes (ESP32-tier) — the control loop is source-agnostic

New target & compile profiles

• ESP32-C2 (ESP8684) target alongside ESP32
• Three compile profiles — C2-HTTP, headless C2-MQTT, and ESP32 (full); a build reports its capabilities at /api/info → features, and the web app gates features accordingly

External web app & config-over-MQTT

• The device now redirects to an external web app (configurable CORS origin)
• config-over-MQTT (config/set, retained config/state, config/get) — provision and control a headless C2-MQTT device entirely over the broker
• Unified device registry (/api/modules) with per-channel roles and names

New mode

• GRID_LIMIT — a seventh operating mode that caps grid draw by current

Changed

• The control loop runs in a dedicated high-priority RTOS task (dual-core split on ESP32), so the web layer can never stall regulation
• Sensor-loss failsafe — AUTO/ECO/GRID_LIMIT (and OFFGRID) now fail toward off: on a lost regulating reading or total sensor silence, the dimmer decays to 0 instead of holding the last level
• Emergency Stop / OFF now de-energize the whole cascade — all dimmers and all relays

Removed

• Built-in dashboard pages (Dashboard, Dimmers, Hardware Config, OTA) — the main UI is now the external web app (the device redirects to it). Minimal on-device config pages for WiFi, MQTT, and Relays remain.
• On-device ADC current/voltage sensing, including the ZMPT101B / ACS712 driver profiles (superseded by rbAmp / ESP-NOW)
• Legacy GPIO / direct-TRIAC dimming and the per-GPIO dimmer routes — dimming is DimmerLink-only

Known Limitations (2.0.0)

• OTA is ESP32-only. On the ESP32-C2 the OTA routes are absent — flash the C2 over serial.
• Auth is compiled off this release — write endpoints are open on the LAN; the bearer-token layer is disabled (a token can't be set). (returns in a later release)
• Per-dimmer control over MQTT / Home Assistant is not exposed yet — DimmerLink dimmers register no HA light entity, and the per-dimmer MQTT topics don't reach id 4+. Drive them via the router mode or the serial dimmer <id> command. (fix in progress)
• POST /api/hardware/validate and POST /api/calibrate are stubs; CT models above 50 A are not yet preset-backed.

---

[1.2.0] – 2025-12-24

MQTT-Integration & Home Assistant Unterstützung

What's New

MQTT-Integration

• Vollständiger MQTT-Client mit automatischer Wiederverbindung und Last Will & Testament
• Hierarchische Topic-Struktur: acrouter/{device_id}/category/name
• Echtzeit-Veröffentlichung von Messwerten (konfigurierbares Intervall)
• Fernsteuerung über MQTT-Befehle
• Konfiguration über MQTT-Topics

Home Assistant Auto-Discovery

• Automatische Entitätserstellung in Home Assistant
• Alle Sensoren: Spannung, Leistung (Netz/Solar/Last), Ströme, Dimmer-Stufe
• Steuerungen: Modusauswahl, manueller Dimmer, Notstopp, Neustart
• Gerätegruppierung mit Firmware-Versionsinformationen

Web-UI MQTT-Einstellungen

• Neue MQTT-Konfigurationsseite unter /mqtt
• Aktivieren/Deaktivieren-Schalter
• Broker-URL, Zugangsdaten-Konfiguration
• Geräte-ID und Namenseinstellungen
• Anpassung des Veröffentlichungsintervalls
• Verbindungsstatusanzeige

Konsolenbefehle (13 neue)

• mqtt-status, mqtt-config – Status und Konfiguration anzeigen
• mqtt-broker, mqtt-user, mqtt-pass – Verbindungseinstellungen
• mqtt-device-id, mqtt-device-name – Geräteidentifikation
• mqtt-interval, mqtt-ha-discovery – Veröffentlichungsoptionen
• mqtt-enable, mqtt-disable, mqtt-reconnect, mqtt-publish – Steuerung

Dokumentation

• Vollständige MQTT-Anleitung (Englisch und Russisch)
• Home Assistant Integrationsanleitung mit Beispielen
• Dashboard- und Automatisierungsbeispiele für HA

---

[1.1.0] – 2025-12-23

GitHub OTA-Updates & ACS712-Kalibrierung

What's New

OTA-Updates von GitHub

• Direkte Updateprüfung über GitHub Releases
• Firmware-Update per Mausklick über die Weboberfläche
• Konsolenbefehle: ota-check, ota-update-github, ota-rollback
• Versionsvergleich mit Änderungsprotokoll-Anzeige

ACS712-Sensor-Kalibrierung

• Kalibrierte Profile für ACS712-10A, ACS712-30A, ACS712-50A
• Automatische Multiplikator-Anwendung beim Start
• Verbesserte Genauigkeit (±2 % im linearen Bereich)

Web-UI-Verbesserungen

• Firmware-Version in der Kopfzeile
• Fußzeile mit Betriebszeit, Heap und Links
• Visuelle Verbesserungen des Dashboards
• Bessere Responsivität für Mobilgeräte/Tablets

---

[1.0.0] – 2025-12-18

Erstes stabiles Release – Phase 1 abgeschlossen

What's New

Solar-Router-Steuerung

• 6 Betriebsmodi: OFF, AUTO, ECO, OFFGRID, MANUAL, BOOST
• Automatische Leistungsweiterleitung von Solar zu Lasten
• AC-Phasenanschnitt-Dimmsteuerung (0–100 %)
• Echtzeit-Leistungsmessung und -steuerung

Sensorunterstützung

• Spannungssensoren: ZMPT101B, AC230V
• Stromsensoren:
• SCT-013-Serie: 5A, 10A, 20A, 30A, 50A, 60A, 80A, 100A
• ACS712-Serie: 5A, 20A, 30A
• Kalibrierung pro Kanal (Multiplikator + Offset)

Konnektivität

• WiFi-Unterstützung (AP- + Station-Modus)
• Weboberfläche mit REST API
• WebSocket-Echtzeit-Updates
• Serielle Konsole (20+ Befehle)
• OTA-Firmware-Updates
• NTP-Zeitsynchronisation

Konfiguration

• Persistente Konfiguration (NVS-Speicher)
• Hardware-Konfigurationsmanager
• Sensor-Treiberprofile
• Webbasierte Konfigurationsoberfläche

Dokumentation

• Englische und russische Version
• Anleitung zur Hardware-Einrichtung
• Befehlsreferenz
• API-Dokumentation
• Anleitung zur Sensor-Kalibrierung
• Erklärung der Router-Modi

Systemanforderungen

• ESP32 (Dual-Core, 240 MHz)
• ESP-IDF v5.x
• Mindestens 4 MB Flash

Bekannte Einschränkungen

• Keine MQTT-/Home Assistant-Integration
• Keine historische Datenspeicherung
• Keine Temperatursensoren
• Einfache Web-UI (keine Diagramme)
• Keine zeitbasierte Planung

---

Upcoming Features

Planned for future releases — see the Roadmap for the current phases and status (the roadmap is the single source of truth for what's planned when):

• Zeitbasierte Planung
• Temperatursensoren (DS18B20)
• Historische Daten und Analysen
• Multi-Last-Priorisierung

---

Projekt: ACRouter auf GitHub
Dokumentation: Siehe Ordner docs/
Support: GitHub Issues