ACRouter – Notas de la versión

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

Integración MQTT y soporte de Home Assistant

What's New

Integración MQTT

• Cliente MQTT completo con reconexión automática y Last Will & Testament
• Estructura jerárquica de topics: acrouter/{device_id}/category/name
• Publicación de métricas en tiempo real (intervalo configurable)
• Control remoto mediante comandos MQTT
• Configuración a través de topics MQTT

Descubrimiento automático de Home Assistant

• Creación automática de entidades en Home Assistant
• Todos los sensores: voltaje, potencia (red/solar/carga), corrientes, nivel del dimmer
• Controles: selector de modo, dimmer manual, parada de emergencia, reinicio
• Agrupación de dispositivos con información de versión del firmware

Configuración MQTT en la interfaz web

• Nueva página de configuración MQTT en /mqtt
• Interruptor de activar/desactivar
• Configuración de URL del broker y credenciales
• Ajustes de ID y nombre del dispositivo
• Ajuste del intervalo de publicación
• Indicador de estado de conexión

Comandos de consola (13 nuevos)

• mqtt-status, mqtt-config – Ver estado y configuración
• mqtt-broker, mqtt-user, mqtt-pass – Ajustes de conexión
• mqtt-device-id, mqtt-device-name – Identificación del dispositivo
• mqtt-interval, mqtt-ha-discovery – Opciones de publicación
• mqtt-enable, mqtt-disable, mqtt-reconnect, mqtt-publish – Control

Documentación

• Guía completa de MQTT (inglés y ruso)
• Guía de integración con Home Assistant con ejemplos
• Ejemplos de panel de control y automatización para HA

---

[1.1.0] – 2025-12-23

Actualizaciones OTA desde GitHub y calibración ACS712

What's New

Actualizaciones OTA desde GitHub

• Verificación de actualizaciones directamente desde GitHub Releases
• Actualización del firmware con un clic desde la interfaz web
• Comandos de consola: ota-check, ota-update-github, ota-rollback
• Comparación de versiones con visualización del registro de cambios

Calibración del sensor ACS712

• Perfiles calibrados para ACS712-10A, ACS712-30A, ACS712-50A
• Aplicación automática del multiplicador al iniciar
• Precisión mejorada (±2 % en rango lineal)

Mejoras en la interfaz web

• Versión del firmware en el encabezado
• Pie de página con tiempo de actividad, heap y enlaces
• Mejoras visuales del panel de control
• Mejor adaptación a móviles/tablets

---

[1.0.0] – 2025-12-18

Primera versión estable – Fase 1 completada

What's New

Control del enrutador solar

• 6 modos de operación: OFF, AUTO, ECO, OFFGRID, MANUAL, BOOST
• Enrutamiento automático de potencia solar hacia las cargas
• Control de atenuación AC por ángulo de fase (0–100 %)
• Medición y control de potencia en tiempo real

Soporte de sensores

• Sensores de voltaje: ZMPT101B, AC230V
• Sensores de corriente:
• Serie SCT-013: 5A, 10A, 20A, 30A, 50A, 60A, 80A, 100A
• Serie ACS712: 5A, 20A, 30A
• Calibración por canal (multiplicador + offset)

Conectividad

• Soporte WiFi (modos AP + Station)
• Interfaz web con REST API
• Actualizaciones en tiempo real por WebSocket
• Consola serie (más de 20 comandos)
• Actualizaciones de firmware OTA
• Sincronización horaria NTP

Configuración

• Configuración persistente (almacenamiento NVS)
• Gestor de configuración de hardware
• Perfiles de controladores de sensores
• Interfaz de configuración web

Documentación

• Versiones en inglés y ruso
• Guía de conexión de hardware
• Referencia de comandos
• Documentación de API
• Guía de calibración de sensores
• Explicación de los modos del enrutador

Requisitos del sistema

• ESP32 (doble núcleo, 240 MHz)
• ESP-IDF v5.x
• 4 MB de Flash como mínimo

Limitaciones conocidas

• Sin integración MQTT / Home Assistant
• Sin almacenamiento de datos históricos
• Sin sensores de temperatura
• Interfaz web básica (sin gráficos)
• Sin programación horaria

---

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

• Programación horaria
• Sensores de temperatura (DS18B20)
• Datos históricos y análisis
• Priorización de múltiples cargas

---

Proyecto: ACRouter en GitHub
Documentación: Ver carpeta docs/
Soporte: GitHub Issues