Passa al contenuto

ACRouter – Note di rilascio

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

Integrazione MQTT e supporto Home Assistant

What's New

Integrazione MQTT

  • Client MQTT completo con riconnessione automatica e Last Will & Testament
  • Struttura gerarchica dei topic: acrouter/{device_id}/category/name
  • Pubblicazione delle metriche in tempo reale (intervallo configurabile)
  • Controllo remoto tramite comandi MQTT
  • Configurazione tramite topic MQTT

Scoperta automatica di Home Assistant

  • Creazione automatica delle entità in Home Assistant
  • Tutti i sensori: tensione, potenza (rete/solare/carico), correnti, livello del dimmer
  • Controlli: selettore di modalità, dimmer manuale, arresto di emergenza, riavvio
  • Raggruppamento dispositivi con informazioni sulla versione del firmware

Impostazioni MQTT dell'interfaccia web

  • Nuova pagina di configurazione MQTT in /mqtt
  • Interruttore di attivazione/disattivazione
  • Configurazione URL del broker e credenziali
  • Impostazioni di ID e nome del dispositivo
  • Regolazione dell'intervallo di pubblicazione
  • Indicatore di stato della connessione

Comandi console (13 nuovi)

  • mqtt-status, mqtt-config – Visualizzare stato e configurazione
  • mqtt-broker, mqtt-user, mqtt-pass – Impostazioni di connessione
  • mqtt-device-id, mqtt-device-name – Identificazione del dispositivo
  • mqtt-interval, mqtt-ha-discovery – Opzioni di pubblicazione
  • mqtt-enable, mqtt-disable, mqtt-reconnect, mqtt-publish – Controllo

Documentazione

  • Guida MQTT completa (inglese e russo)
  • Guida all'integrazione con Home Assistant con esempi
  • Esempi di dashboard e automazione per HA

[1.1.0] – 2025-12-23

Aggiornamenti OTA da GitHub e calibrazione ACS712

What's New

Aggiornamenti OTA da GitHub

  • Verifica degli aggiornamenti direttamente da GitHub Releases
  • Aggiornamento firmware con un clic dall'interfaccia web
  • Comandi console: ota-check, ota-update-github, ota-rollback
  • Confronto delle versioni con visualizzazione del registro modifiche

Calibrazione del sensore ACS712

  • Profili calibrati per ACS712-10A, ACS712-30A, ACS712-50A
  • Applicazione automatica del moltiplicatore all'avvio
  • Precisione migliorata (±2 % nel range lineare)

Miglioramenti dell'interfaccia web

  • Versione del firmware nell'intestazione
  • Piè di pagina con uptime, heap e link
  • Miglioramenti visivi della dashboard
  • Migliore adattamento a dispositivi mobili/tablet

[1.0.0] – 2025-12-18

Prima versione stabile – Fase 1 completata

What's New

Controllo del router solare

  • 6 modalità operative: OFF, AUTO, ECO, OFFGRID, MANUAL, BOOST
  • Instradamento automatico della potenza solare verso i carichi
  • Controllo di fase AC per la dimmerizzazione (0–100 %)
  • Misurazione e controllo della potenza in tempo reale

Supporto sensori

  • Sensori di tensione: ZMPT101B, AC230V
  • Sensori di corrente:
  • Serie SCT-013: 5A, 10A, 20A, 30A, 50A, 60A, 80A, 100A
  • Serie ACS712: 5A, 20A, 30A
  • Calibrazione per canale (moltiplicatore + offset)

Connettività

  • Supporto WiFi (modalità AP + Station)
  • Interfaccia web con REST API
  • Aggiornamenti in tempo reale via WebSocket
  • Console seriale (oltre 20 comandi)
  • Aggiornamenti firmware OTA
  • Sincronizzazione oraria NTP

Configurazione

  • Configurazione persistente (archiviazione NVS)
  • Gestore della configurazione hardware
  • Profili driver dei sensori
  • Interfaccia di configurazione web

Documentazione

  • Versioni in inglese e russo
  • Guida al collegamento hardware
  • Riferimento dei comandi
  • Documentazione API
  • Guida alla calibrazione dei sensori
  • Spiegazione delle modalità del router

Requisiti di sistema

  • ESP32 (dual-core, 240 MHz)
  • ESP-IDF v5.x
  • Minimo 4 MB di Flash

Limitazioni note

  • Nessuna integrazione MQTT / Home Assistant
  • Nessuna archiviazione di dati storici
  • Nessun sensore di temperatura
  • Interfaccia web di base (senza grafici)
  • Nessuna programmazione oraria

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):

  • Programmazione oraria
  • Sensori di temperatura (DS18B20)
  • Dati storici e analisi
  • Prioritizzazione multi-carico

Progetto: ACRouter su GitHub
Documentazione: Vedi cartella docs/
Supporto: GitHub Issues

[2.0.0] - 2026-07-16 [1.2.0] – 2025-12-24 [1.1.0] – 2025-12-23 [1.0.0] – 2025-12-18 Upcoming Features