Перейти к содержимому

ACRouter — Примечания к выпускам

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 и поддержка Home Assistant

What's New

Интеграция MQTT

  • Полноценный MQTT-клиент с автоматическим переподключением и Last Will & Testament
  • Иерархическая структура топиков: acrouter/{device_id}/категория/название
  • Публикация метрик в реальном времени (настраиваемый интервал)
  • Удалённое управление через MQTT-команды
  • Конфигурация через MQTT-топики

Автообнаружение в Home Assistant

  • Автоматическое создание сущностей в Home Assistant
  • Все датчики: напряжение, мощность (сеть/солнце/нагрузка), токи, уровень диммера
  • Управление: выбор режима, ручной диммер, аварийная остановка, перезагрузка
  • Группировка устройства с информацией о версии прошивки

Веб-интерфейс настроек MQTT

  • Новая страница конфигурации MQTT по адресу /mqtt
  • Переключатель включения/выключения
  • Настройка URL брокера и учётных данных
  • Настройка идентификатора и имени устройства
  • Регулировка интервала публикации
  • Индикатор статуса соединения

Консольные команды (13 новых)

  • mqtt-status, mqtt-config — просмотр статуса и конфигурации
  • mqtt-broker, mqtt-user, mqtt-pass — настройки соединения
  • mqtt-device-id, mqtt-device-name — идентификация устройства
  • mqtt-interval, mqtt-ha-discovery — параметры публикации
  • mqtt-enable, mqtt-disable, mqtt-reconnect, mqtt-publish — управление

Документация

  • Полное руководство по MQTT (на русском и английском)
  • Руководство по интеграции с Home Assistant с примерами
  • Примеры панели управления и автоматизаций для Home Assistant

[1.1.0] — 2025-12-23

OTA-обновления с GitHub и калибровка ACS712

What's New

OTA-обновления с GitHub

  • Проверка обновлений прямо из GitHub Releases
  • Обновление прошивки одним кликом из веб-интерфейса
  • Консольные команды: ota-check, ota-update-github, ota-rollback
  • Сравнение версий с отображением журнала изменений

Калибровка датчиков ACS712

  • Откалиброванные профили ACS712-10A, ACS712-30A, ACS712-50A
  • Автоматическое применение коэффициента при запуске
  • Улучшенная точность (±2% в линейном диапазоне)

Улучшения веб-интерфейса

  • Версия прошивки в заголовке
  • Нижний колонтитул со временем работы, объёмом кучи и ссылками
  • Визуальные улучшения панели управления
  • Улучшенная адаптивность для мобильных устройств и планшетов

[1.0.0] — 2025-12-18

Первый стабильный выпуск — Фаза 1 завершена

What's New

Управление солнечным роутером

  • 6 режимов работы: OFF, AUTO, ECO, OFFGRID, MANUAL, BOOST
  • Автоматическая маршрутизация мощности с солнечных панелей на нагрузки
  • Фазовое управление AC-диммером (0–100%)
  • Измерение и управление мощностью в реальном времени

Поддержка датчиков

  • Датчики напряжения: ZMPT101B, AC230V
  • Датчики тока:
  • Серия SCT-013: 5A, 10A, 20A, 30A, 50A, 60A, 80A, 100A
  • Серия ACS712: 5A, 20A, 30A
  • Калибровка по каждому каналу (коэффициент + смещение)

Связь

  • Поддержка WiFi (режимы AP + Station)
  • Веб-интерфейс с REST API
  • Обновления в реальном времени через WebSocket
  • Последовательная консоль (20+ команд)
  • OTA-обновления прошивки
  • Синхронизация времени по NTP

Конфигурация

  • Постоянное хранение настроек (NVS)
  • Менеджер конфигурации железа
  • Профили драйверов датчиков
  • Веб-интерфейс настройки

Документация

  • Версии на английском и русском языках
  • Руководство по подключению железа
  • Справочник команд
  • Документация API
  • Руководство по калибровке датчиков
  • Описание режимов роутера

Системные требования

  • ESP32 (двухъядерный, 240 МГц)
  • ESP-IDF v5.x
  • Минимум 4 МБ Flash

Известные ограничения

  • Нет интеграции с MQTT/Home Assistant
  • Нет хранения исторических данных
  • Нет датчиков температуры
  • Базовый веб-интерфейс (без графиков)
  • Нет планирования по времени

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

  • Планирование по времени
  • Датчики температуры (DS18B20)
  • Исторические данные и аналитика
  • Приоритизация нескольких нагрузок

Проект: ACRouter на GitHub
Документация: Папка docs/
Поддержка: 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