Skip to Content

ACRouter - Release Notes

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 Support

What's New

MQTT Integration

  • Full MQTT client with auto-reconnect and Last Will & Testament
  • Hierarchical topic structure: acrouter/{device_id}/category/name
  • Real-time metrics publishing (configurable interval)
  • Remote control via MQTT commands
  • Configuration via MQTT topics

Home Assistant Auto-Discovery

  • Automatic entity creation in Home Assistant
  • All sensors: voltage, power (grid/solar/load), currents, dimmer level
  • Controls: mode selector, manual dimmer, emergency stop, reboot
  • Device grouping with firmware version info

Web UI MQTT Settings

  • New MQTT configuration page at /mqtt
  • Enable/disable toggle
  • Broker URL, credentials configuration
  • Device ID and name settings
  • Publish interval adjustment
  • Connection status indicator

Console Commands (13 new)

  • mqtt-status, mqtt-config - View status and configuration
  • mqtt-broker, mqtt-user, mqtt-pass - Connection settings
  • mqtt-device-id, mqtt-device-name - Device identification
  • mqtt-interval, mqtt-ha-discovery - Publishing options
  • mqtt-enable, mqtt-disable, mqtt-reconnect, mqtt-publish - Control

Documentation

  • Complete MQTT guide (English and Russian)
  • Home Assistant integration guide with examples
  • Dashboard and automation examples for HA

[1.1.0] - 2025-12-23

GitHub OTA Updates & ACS712 Calibration

What's New

OTA Updates from GitHub

  • Check for updates directly from GitHub Releases
  • One-click firmware update from web interface
  • Console commands: ota-check, ota-update-github, ota-rollback
  • Version comparison with changelog display

ACS712 Sensor Calibration

  • Calibrated ACS712-10A, ACS712-30A, ACS712-50A profiles
  • Automatic multiplier application at startup
  • Improved accuracy (±2% in linear range)

Web UI Enhancements

  • Firmware version in header
  • Footer with uptime, heap, and links
  • Dashboard visual improvements
  • Better mobile/tablet responsiveness

[1.0.0] - 2025-12-18

First stable release - Phase 1 complete

What's New

Solar Router Control

  • 6 operating modes: OFF, AUTO, ECO, OFFGRID, MANUAL, BOOST
  • Automatic power routing from solar to loads
  • Phase-angle AC dimming control (0-100%)
  • Real-time power measurement and control

Sensor Support

  • Voltage sensors: ZMPT101B, AC230V
  • Current sensors:
  • SCT-013 series: 5A, 10A, 20A, 30A, 50A, 60A, 80A, 100A
  • ACS712 series: 5A, 20A, 30A
  • Per-channel calibration (multiplier + offset)

Connectivity

  • WiFi support (AP + Station modes)
  • Web interface with REST API
  • WebSocket real-time updates
  • Serial console (20+ commands)
  • OTA firmware updates
  • NTP time synchronization

Configuration

  • Persistent configuration (NVS storage)
  • Hardware configuration manager
  • Sensor driver profiles
  • Web-based configuration interface

Documentation

  • English and Russian versions
  • Hardware setup guide
  • Command reference
  • API documentation
  • Sensor calibration guide
  • Router modes explained

System Requirements

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

Known Limitations

  • No MQTT/Home Assistant integration
  • No historical data storage
  • No temperature sensors
  • Basic web UI (no charts)
  • No time-based scheduling

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

  • Time-based scheduling
  • Temperature sensors (DS18B20)
  • Historical data and analytics
  • Multi-load prioritization

Project: ACRouter on GitHub Documentation: See docs/ folder Support: 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