MQTT і Home Assistant
Для кого:Монтажник
MiRCA кожні 5 секунд публікує дані кожного активного порту в MQTT-брокер у форматі JSON. Звідти їх беруть Home Assistant, Node-RED, Grafana (через базу даних) та інші системи.
Налаштування
Section titled “Налаштування”-
Config → MQTT → увімкніть Publish to MQTT.
-
Заповніть поля:
- Broker address — адреса брокера: ім’я (
mqtt.example.com) або IP (192.168.1.10). Лише латинські літери, цифри,.і-; - Port — зазвичай
1883; - Username, Password — якщо брокер вимагає логін. Інакше залиште порожніми;
- Send via — через який інтерфейс підключатися: Auto (Ethernet, якщо він підключений і має адресу, інакше Wi-Fi), Ethernet або Wi-Fi.
- Broker address — адреса брокера: ім’я (
-
Натисніть Save. Перезавантаження не потрібне, MiRCA підключиться до брокера одразу.
-
Перевірте на головній, у картці Status: рядок MQTT має показати Connected via Ethernet або Connected via Wi-Fi.

Якщо підключитися не вдалося, рядок MQTT покаже причину: broker unreachable (брокер недоступний), wrong username or password (неправильний логін або пароль), not authorized (немає дозволу), timeout, connection lost тощо.
| Тема | Що в ній |
|---|---|
<назва>/p1 |
Дані пристрою на Port 1 |
<назва>/p2 |
Дані пристрою на Port 2 |
<назва>/pN/b<адреса> |
Окрема батарея паралельної групи JK, наприклад AKB2/p1/b0 |
<назва> — Device name з розділу Device на сторінці Config. Публікуються лише порти, на яких вибрано протокол.
Повний формат повідомлень — у довіднику MQTT.
Home Assistant
Section titled “Home Assistant”Приклад сенсорів для батареї на Port 1 MiRCA з назвою AKB2. Додайте в configuration.yaml (інтеграцію MQTT у Home Assistant має бути налаштовано на той самий брокер):
mqtt: sensor: - name: "AKB2 SOC" state_topic: "AKB2/p1" value_template: "{{ value_json.data.soc }}" unit_of_measurement: "%" device_class: battery - name: "AKB2 voltage" state_topic: "AKB2/p1" value_template: "{{ value_json.data.voltage }}" unit_of_measurement: "V" device_class: voltage - name: "AKB2 current" state_topic: "AKB2/p1" value_template: "{{ value_json.data.current }}" unit_of_measurement: "A" device_class: current binary_sensor: - name: "AKB2 BMS online" state_topic: "AKB2/p1" value_template: "{{ 'ON' if value_json.online else 'OFF' }}" device_class: connectivityДля інвертора Deye значення лежать у data.metrics, наприклад {{ value_json.data.metrics.pv_power }} або {{ value_json.data.metrics.grid_power }}. Ключі всіх показників — у довіднику SNMP (колонка «Ключ»).