← Руководство MQTT | Содержание
12. Интеграция с Home Assistant
Version: 1.2.0
Date: 2025-12-24
Полное руководство по интеграции ACRouter с Home Assistant через MQTT Auto-Discovery.
Содержание
- Обзор
- Предварительные требования
- Настройка
- Автообнаруживаемые объекты
- Пример панели управления
- Автоматизации
- Панель энергопотребления
- Устранение неполадок
Обзор
ACRouter поддерживает MQTT Auto-Discovery — Home Assistant автоматически создаёт все объекты при подключении устройства. Ручная настройка YAML не требуется!
Возможности
- Автоматическое создание устройства и объектов
- Датчики мониторинга мощности в реальном времени
- Управление выбором режима
- Настройка параметров (усиление, порог)
- Кнопка аварийного отключения
- Отслеживание доступности (онлайн/офлайн)
- Группировка устройств с информацией о производителе
Предварительные требования
- Home Assistant — установлен и запущен
- MQTT-брокер (рекомендуется Mosquitto):
- можно использовать дополнение Mosquitto для Home Assistant
- или внешний брокер
- Интеграция MQTT — настроена в Home Assistant
- ACRouter — с включённым MQTT
Настройка
Шаг 1: Установка MQTT-брокера
Вариант А: Дополнение Home Assistant (рекомендуется)
- Перейдите в Настройки > Дополнения > Магазин дополнений
- Search for "Mosquitto broker"
- Нажмите «Установить»
- Запустите дополнение
- Задайте учётные данные в конфигурации дополнения
Вариант Б: Внешний брокер
Смотрите 11_MQTT_GUIDE_RU.md для настройки Mosquitto. Шаг 2: Настройка интеграции MQTT Перейдите в Настройки > Устройства и службы
Нажмите «Добавить интеграцию»
- Найдите «MQTT»
- Click "Add Integration"
- Search for "MQTT"
- Порт:
1883 - Логин/пароль (если настроены)
- Шаг 3: Настройка ACRouter
- Через Serial-консоль:
bash
📋 Copy
# Set broker URL
mqtt-broker mqtt://192.168.1.10:1883
# Set credentials (if required)
mqtt-user homeassistant
mqtt-pass your_password
# Set friendly device name
mqtt-device-name "Solar Router"
# Ensure HA Discovery is enabled
mqtt-ha-discovery 1
# Enable MQTT
mqtt-enable
Найдите устройство «ACRouter Solar»
- Все объекты должны создаться автоматически
- Look for "ACRouter Solar" device
- Датчики
Автообнаруживаемые объекты
Описание
| Единица | Класс устройства | sensor.acrouter_grid_power |
Мощность импорта/экспорта из сети |
|---|---|---|---|
| Вт | power | sensor.acrouter_solar_power |
Мощность генерации солнечных панелей |
| Вт | power | sensor.acrouter_solar_power |
Мощность генерации солнечных панелей |
| Вт | power | sensor.acrouter_solar_power |
Мощность генерации солнечных панелей |
| В | voltage | sensor.acrouter_dimmer |
Уровень диммера |
| % | — | sensor.acrouter_wifi_signal |
Уровень сигнала WiFi |
| дБм | signal_strength | Выбор (Select) | Объект |
Описание
| Единица | Класс устройства | Режим работы роутера |
|---|---|---|
| off, auto, eco, offgrid, manual, boost | Числовые параметры (Number) | Объект |
Описание
| Единица | Класс устройства | Коэффициент усиления P-регулятора |
|---|---|---|
| 10–1000 | number.acrouter_balance_threshold |
Зона нечувствительности баланса |
| 0–1000 Вт | number.acrouter_manual_level |
Уровень диммера в ручном режиме |
| 0–100% | Кнопки | Объект |
Описание
| Единица | Класс устройства |
|---|---|
button.acrouter_reboot |
Перезагрузить устройство |
button.acrouter_refresh |
Принудительное обновление данных |
| Информация об устройстве | Все объекты сгруппированы под одним устройством: |
Имя: ACRouter Solar (или пользовательское имя)
Производитель: RBdimmer
- Модель: ACRouter
- Версия ПО: 1.2.0
- URL конфигурации: http://ip_устройства
- Пример панели управления
- YAML карточки Lovelace
Пример панели управления
📋 Copy
type: entities
title: ACRouter Home Assistant Integration Guide — MQTT
entities:
- entity: select.acrouter_router_mode
name: Mode
- entity: sensor.acrouter_dimmer
name: Dimmer Level
- type: divider
- entity: sensor.acrouter_grid_power
name: Grid Power
- entity: sensor.acrouter_solar_power
name: Solar Power
- entity: sensor.acrouter_load_power
name: Load Power
- type: divider
- entity: sensor.acrouter_voltage
name: Voltage
- entity: sensor.acrouter_wifi_signal
name: WiFi Signal
📋 Copy
type: gauge
entity: sensor.acrouter_grid_power
name: Grid Power
min: -3000
max: 3000
severity:
green: -3000
yellow: 0
red: 500
📋 Copy
type: horizontal-stack
cards:
- type: button
entity: button.acrouter_emergency_stop
name: STOP
icon: mdi:stop
tap_action:
action: call-service
service: button.press
target:
entity_id: button.acrouter_emergency_stop
show_state: false
- type: button
entity: button.acrouter_reboot
name: Reboot
icon: mdi:restart
tap_action:
action: call-service
service: button.press
target:
entity_id: button.acrouter_reboot
show_state: false
📋 Copy
title: ACRouter Home Assistant Integration Guide — MQTT
views:
- title: Overview
cards:
- type: vertical-stack
cards:
- type: entities
title: Status
entities:
- entity: select.acrouter_router_mode
- entity: sensor.acrouter_dimmer
- entity: sensor.acrouter_voltage
- type: glance
title: Power
entities:
- entity: sensor.acrouter_grid_power
name: Grid
- entity: sensor.acrouter_solar_power
name: Solar
- entity: sensor.acrouter_load_power
name: Load
- type: entities
title: Settings
entities:
- entity: number.acrouter_control_gain
- entity: number.acrouter_balance_threshold
- entity: number.acrouter_manual_level
- type: horizontal-stack
cards:
- type: button
entity: button.acrouter_emergency_stop
name: Emergency Stop
icon: mdi:stop-circle
- type: button
entity: button.acrouter_refresh
name: Refresh
icon: mdi:refresh
Автоматизации
📋 Copy
alias: "Solar Router - Night Boost"
description: Integrate ACRouter solar power router with Home Assistant via MQTT. Covers MQTT discovery, energy dashboard, automations, and Lovelace dashboard cards.
trigger:
- platform: time
at: "23:00:00"
action:
- service: select.select_option
target:
entity_id: select.acrouter_router_mode
data:
option: "boost"
mode: single
📋 Copy
alias: "Solar Router - Morning Auto"
description: Integrate ACRouter solar power router with Home Assistant via MQTT. Covers MQTT discovery, energy dashboard, automations, and Lovelace dashboard cards.
trigger:
- platform: time
at: "07:00:00"
action:
- service: select.select_option
target:
entity_id: select.acrouter_router_mode
data:
option: "auto"
mode: single
📋 Copy
alias: "Solar Router - Emergency High Power"
description: Integrate ACRouter solar power router with Home Assistant via MQTT. Covers MQTT discovery, energy dashboard, automations, and Lovelace dashboard cards.
trigger:
- platform: numeric_state
entity_id: sensor.acrouter_load_power
above: 3000
for:
seconds: 10
action:
- service: button.press
target:
entity_id: button.acrouter_emergency_stop
- service: notify.mobile_app
data:
message: "ACRouter emergency stop triggered - load exceeded 3000W"
mode: single
📋 Copy
alias: "Solar Router - Offline Alert"
description: Integrate ACRouter solar power router with Home Assistant via MQTT. Covers MQTT discovery, energy dashboard, automations, and Lovelace dashboard cards.
trigger:
- platform: state
entity_id: select.acrouter_router_mode
to: "unavailable"
for:
minutes: 5
action:
- service: notify.mobile_app
data:
message: "ACRouter is offline!"
title: "Solar Router Alert"
mode: single
📋 Copy
alias: "Solar Router - Auto Enable on Surplus"
description: Integrate ACRouter solar power router with Home Assistant via MQTT. Covers MQTT discovery, energy dashboard, automations, and Lovelace dashboard cards.
trigger:
- platform: numeric_state
entity_id: sensor.acrouter_grid_power
below: -100
for:
minutes: 1
condition:
- condition: state
entity_id: select.acrouter_router_mode
state: "off"
action:
- service: select.select_option
target:
entity_id: select.acrouter_router_mode
data:
option: "auto"
mode: single
Панель энергопотребления
Перейдите в Настройки > Панели управления > Энергия
Добавьте потребление из сети: sensor.acrouter_grid_power (при положительном значении)
- Добавьте выработку солнечной электростанции:
sensor.acrouter_solar_power - Примечание: Панель энергопотребления требует датчики энергии (кВт·ч), а не мощности (Вт). Возможно, потребуется создать шаблонные датчики или использовать вспомогательные интеграции.
- Шаблонный датчик энергии (необязательно)
yaml
📋 Copy
# configuration.yaml
template:
- sensor:
- name: "ACRouter Grid Import Energy"
unit_of_measurement: "kWh"
device_class: energy
state_class: total_increasing
state: >
{% set power = states('sensor.acrouter_grid_power') | float(0) %}
{% if power > 0 %}
{{ (power / 1000) | round(3) }}
{% else %}
0
{% endif %}
Устранение неполадок
Проверьте HA Discovery:
bash
mqtt-ha-discovery 1
mqtt-publish
-
Check MQTT connection:
bash mqtt-status
Should showState: Connected -
Check HA Discovery enabled:
bash mqtt-ha-discovery 1 mqtt-publish -
Нажмите «Настроить» > Проверьте настройки брокера
- Перезапустите обнаружение:
bash mqtt-reconnect -
Click "Configure" > Check broker settings
-
Restart discovery:
bash mqtt-reconnect
Entities Show "Unavailable"
- Должно быть
online - Проверьте WiFi-подключение:
bash wifi-status -
Проверьте подключение к брокеру:
-
Check WiFi connection:
bash wifi-status -
Проверьте через mosquitto_sub
- Значения не обновляются
- Проверьте интервал публикации:
bash mqtt-interval 5000
Принудительное обновление:
bash
mqtt-publish
-
Check publish interval:
bash mqtt-interval 5000 -
Force refresh:
bash mqtt-publish -
Check MQTT messages are being received:
bash mosquitto_sub -h broker_ip -t "acrouter/#" -v
В журнале устройства должна быть запись: MQTT: Command: mode = auto
- Убедитесь в корректности режима:
-
Допустимые значения:
off,auto,eco,offgrid,manual,boost -
Проверьте совместимость режима:
-
Некоторые режимы требуют наличия настроенных датчиков
-
Смотрите также
- 11_MQTT_GUIDE_RU.md — настройка MQTT и справочник топиков
04_ROUTER_MODES_RU.md — описание режимов роутера
- Шаг 2: Настройка интеграции MQTT Последнее обновление: 2025-12-24
- ← Руководство MQTT
- |
Содержание