07 · DIY-интеграции
Как передавать показания RbAmp в популярные самохостируемые системы домашней автоматизации. Для каждой платформы вы получаете минимальный рабочий скетч ESP32 и соответствующую конфигурацию на стороне платформы.
Облачные / коммерческие интеграции (AWS IoT, Azure, GCP, InfluxDB Cloud) — 08 · Облачные интеграции.
| Платформа | Транспорт | Автообнаружение | Мастер |
|---|---|---|---|
| Home Assistant | MQTT | да (HA MQTT Discovery) | ESP32 |
| ESPHome | Нативный API + MQTT | да (конфигурация YAML) | Только ESP32 |
| Node-RED | MQTT (или HTTP) | ручной поток | любой хост |
| OpenHAB | MQTT (или REST) | ручной .things |
любой хост |
| Domoticz | MQTT (авто) или HTTP | Да (плагин MQTT) | любой хост |
| InfluxDB OSS + Grafana | HTTP line-protocol | нет | любой хост |
Home Assistant — MQTT Auto-discovery
HA MQTT Discovery автоматически создаёт устройство и его датчики, как только ESP32 публикует топики конфигурации. Правок YAML в HA не требуется.
Скетч ESP32 (RbAmp + WiFi + MQTT Discovery)
#include
#include
#include
#include
#define RBAMP_ADDR 0x50
static const char* DEVICE_ID = "rbamp_main";
static const char* DEVICE_NAME = "Mains rbAmp";
static RbAmp dev(Wire, RBAMP_ADDR);
static WiFiClient espClient;
static PubSubClient mqtt(espClient);
void publish_discovery_sensor(const char* key, const char* friendly,
const char* unit, const char* device_class,
const char* state_class) {
char topic[128], payload[512];
snprintf(topic, sizeof(topic),
"homeassistant/sensor/%s/%s/config", DEVICE_ID, key);
int n = snprintf(payload, sizeof(payload),
"{"
"\"name\":\"%s %s\","
"\"unique_id\":\"%s_%s\","
"\"state_topic\":\"rbamp/%s/state\","
"\"value_template\":\"{{ value_json.%s }}\","
"\"state_class\":\"%s\","
"\"device\":{"
"\"identifiers\":[\"%s\"],"
"\"name\":\"%s\","
"\"manufacturer\":\"rbAmp\","
"\"model\":\"UI*\""
"}",
DEVICE_NAME, friendly,
DEVICE_ID, key,
DEVICE_ID, key, state_class,
DEVICE_ID, DEVICE_NAME);
if (unit) n += snprintf(payload+n, sizeof(payload)-n,
",\"unit_of_measurement\":\"%s\"", unit);
if (device_class) n += snprintf(payload+n, sizeof(payload)-n,
",\"device_class\":\"%s\"", device_class);
snprintf(payload+n, sizeof(payload)-n, "}");
mqtt.publish(topic, payload, true);
}
void publish_discovery_all() {
publish_discovery_sensor("voltage", "Voltage", "V", "voltage", "measurement");
publish_discovery_sensor("current", "Current", "A", "current", "measurement");
publish_discovery_sensor("power", "Power", "W", "power", "measurement");
publish_discovery_sensor("energy", "Energy", "Wh", "energy", "total_increasing");
publish_discovery_sensor("frequency", "Frequency", "Hz", "frequency", "measurement");
publish_discovery_sensor("power_factor", "Power Factor", NULL, "power_factor", "measurement");
}
void setup() {
Serial.begin(115200);
WiFi.begin("ssid", "pass");
while (WiFi.status() != WL_CONNECTED) delay(500);
mqtt.setServer("192.168.1.10", 1883);
mqtt.setKeepAlive(60);
mqtt.setBufferSize(1024); // enough for one discovery payload
mqtt.connect(DEVICE_ID);
publish_discovery_all();
Wire.begin();
Wire.setClock(50000); // ESP32 baseline mitigation — see 10 · Troubleshooting
dev.setLogStream(&Serial);
while (!dev.begin()) { delay(500); }
}
void loop() {
if (!mqtt.connected()) mqtt.connect(DEVICE_ID);
mqtt.loop();
static uint32_t last = 0;
if (last == 0) last = millis();
if (millis() - last < 60000) { delay(50); return; }
last = millis();
RbAmpPeriodSnapshot snap;
if (!dev.readPeriodSnapshot(snap)) return;
char state[384];
snprintf(state, sizeof(state),
"{\"voltage\":%.1f,\"current\":%.3f,\"power\":%.1f,"
"\"energy\":%.3f,\"frequency\":%.1f,\"power_factor\":%.3f}",
dev.readVoltage(), dev.readCurrent(0), snap.avg_p[0],
dev.energy().wh(0), dev.readFrequency(), dev.readPowerFactor(0));
char topic[64];
snprintf(topic, sizeof(topic), "rbamp/%s/state", DEVICE_ID);
mqtt.publish(topic, state, false);
}
Результат в HA
Через несколько секунд после первой публикации HA автоматически создаёт устройство «Mains rbAmp» с 6 датчиками (напряжение, ток, мощность, энергия, частота, коэффициент мощности). Датчик энергии несёт state_class: total_increasing и правильный device_class — панель энергии HA принимает его как источник потребления.
Чтобы позже удалить устройство из HA, опубликуйте пустую полезную нагрузку в homeassistant/sensor/.../config (флаг retained очищает запись).
Многоканальный UI3
Повторите вызовы publish_discovery_sensor() с суффиксированными ключами для каналов 1 и 2:
publish_discovery_sensor("current_1", "Current 1", "A", "current", "measurement");
publish_discovery_sensor("power_1", "Power 1", "W", "power", "measurement");
publish_discovery_sensor("energy_1", "Energy 1", "Wh", "energy", "total_increasing");
// ...same for _2
Затем дополните JSON состояния полями "current_1", "power_1", "energy_1", заполненными из dev.readCurrent(1) / snap.avg_p[1] / dev.energy().wh(1).
ESPHome через внешний компонент
Если ваш ESP32 уже работает под ESPHome (а не на голом ESP-IDF / arduino-esp32), есть отдельный внешний компонент rbamp:
external_components:
- source: github://rb-amp/rbamp-esphome
components: [rbamp]
refresh: 0s
i2c:
sda: 21
scl: 22
frequency: 50kHz # see 10 · Troubleshooting on baseline mitigation
sensor:
- platform: rbamp
address: 0x50
update_interval: 60s
voltage:
name: "rbAmp Voltage"
current:
name: "rbAmp Current"
power:
name: "rbAmp Power"
energy:
name: "rbAmp Energy"
frequency:
name: "rbAmp Frequency"
power_factor:
name: "rbAmp Power Factor"
Это полностью заменяет весь скетч Arduino выше. ESPHome интегрируется с HA нативно через ESPHome API (не MQTT) — устройство появляется в HA автоматически после прошивки.
Компонент rbamp-esphome живёт в отдельном репозитории — ссылки см. в главном индексе rbAmp.
Node-RED
Подпишитесь на MQTT-топик ESP32 в потоке:
[
{
"id": "rbamp_in",
"type": "mqtt in",
"topic": "rbamp/main/state",
"qos": "0",
"datatype": "json"
},
{
"id": "rbamp_chart",
"type": "ui_chart",
"label": "Mains Power",
"chartType": "line",
"ymin": "0",
"ymax": "5000"
},
{
"id": "extract_power",
"type": "function",
"func": "msg.payload = msg.payload.power; return msg;"
}
]
Подключите rbamp_in → extract_power → rbamp_chart — и получите график мощности в реальном времени. То же самое — для энергии / напряжения / PF.
Если Node-RED работает на том же Pi, что и брокер MQTT, укажите хост localhost. Для удалённых брокеров используйте 192.168.X.Y:1883 и учётные данные, если брокер требует аутентификацию.
OpenHAB
OpenHAB 4.x + MQTT binding:
# things/rbamp.things
Bridge mqtt:broker:local "MQTT Broker" [ host="192.168.1.10", port=1883 ] {
Thing topic rbamp_main "rbAmp Main" {
Channels:
Type number : voltage "Voltage" [ stateTopic="rbamp/main/state", transformationPattern="JSONPATH:$.voltage" ]
Type number : current "Current" [ stateTopic="rbamp/main/state", transformationPattern="JSONPATH:$.current" ]
Type number : power "Power" [ stateTopic="rbamp/main/state", transformationPattern="JSONPATH:$.power" ]
Type number : energy "Energy" [ stateTopic="rbamp/main/state", transformationPattern="JSONPATH:$.energy" ]
}
}
# items/rbamp.items
Number:ElectricPotential rbAmp_Voltage "Voltage [%.1f V]" { channel="mqtt:topic:local:rbamp_main:voltage" }
Number:ElectricCurrent rbAmp_Current "Current [%.3f A]" { channel="mqtt:topic:local:rbamp_main:current" }
Number:Power rbAmp_Power "Power [%.1f W]" { channel="mqtt:topic:local:rbamp_main:power" }
Number:Energy rbAmp_Energy "Energy [%.3f Wh]" { channel="mqtt:topic:local:rbamp_main:energy" }
Скетч Arduino тот же, что в разделе Home Assistant выше. Полезная нагрузка JSON общая; различается только потребитель.
Domoticz
Плагин MQTT Auto-discovery в Domoticz понимает те же топики обнаружения homeassistant/.... Включите плагин в настройках Domoticz — и скетч ESP32 из раздела HA выше автоматически зарегистрирует устройство в Domoticz так же, как в HA.
Альтернатива — нативный HTTP API Domoticz:
#include
void publish_to_domoticz(int idx, float power, double e_wh) {
char url[256];
// Energy in Wh, Power in W — Domoticz format: "POWER;ENERGY_WH"
snprintf(url, sizeof(url),
"http://192.168.1.20:8080/json.htm?type=command¶m=udevice&idx=%d&svalue=%.1f;%.0f",
idx, power, e_wh);
HTTPClient http;
http.begin(url);
int code = http.GET();
http.end();
if (code != 200) Serial.printf("domoticz HTTP %d\n", code);
}
// In your 60-second loop:
publish_to_domoticz(123 /* your idx */, snap.avg_p[0], dev.energy().wh(0));
Создайте устройство в интерфейсе Domoticz типа General → kWh (General → kWh — инкрементальный счётчик) [General → kWh (incremental counter)], получите его idx и пропишите в скетч.
InfluxDB OSS + Grafana
Пишите точки line-protocol в InfluxDB прямо с ESP32:
#include
#define INFLUX_HOST "192.168.1.30:8086"
#define INFLUX_ORG "homelab"
#define INFLUX_BKT "energy"
#define INFLUX_TOKEN "your-token-here"
void push_influx(float u, float p, double e_wh) {
char url[256], body[256];
snprintf(url, sizeof(url),
"http://" INFLUX_HOST "/api/v2/write?org=%s&bucket=%s&precision=s",
INFLUX_ORG, INFLUX_BKT);
snprintf(body, sizeof(body),
"rbamp,device=main voltage=%.1f,power=%.1f,energy=%.3f",
u, p, e_wh);
HTTPClient http;
http.begin(url);
http.addHeader("Authorization", "Token " INFLUX_TOKEN);
http.addHeader("Content-Type", "text/plain");
int code = http.POST(body);
http.end();
if (code != 204) Serial.printf("influx HTTP %d\n", code);
}
// In your 60-second loop:
RbAmpPeriodSnapshot snap;
if (dev.readPeriodSnapshot(snap)) {
push_influx(dev.readVoltage(), snap.avg_p[0], dev.energy().wh(0));
}
В Grafana добавьте источник данных InfluxDB, затем панель с запросом Flux:
from(bucket: "energy")
|> range(start: -24h)
|> filter(fn: (r) => r._measurement == "rbamp" and r.device == "main")
|> filter(fn: (r) => r._field == "power")
Для длительного испытания на выносливость также выводите диагностические счётчики:
snprintf(body, sizeof(body),
"rbamp_diag,device=main retry_exhaust=%lu,sanity_reject=%lu",
dev.retryExhaustionCount(), dev.sanityRejectCount());
// ...push to InfluxDB...
— и вы получаете график состояния шины рядом с данными об энергии.
Несколько платформ — раздача с одного ESP32
Если нужны одновременно автообнаружение HA, InfluxDB и Node-RED, опубликуйте JSON состояния один раз в MQTT, а каждый потребитель подпишется на rbamp/+/state. ESP32 общается только с брокером MQTT — брокер сам раздаёт данные подписчикам. Не отправляйте с ESP32 напрямую на N HTTP-адресов: это привязывает устройство к конкретным потребителям.
Для потока очень высокой частоты (RT 10 Гц) запустите вспомогательный скрипт Python на Pi, где работает брокер: подпишитесь на быстрый топик, прорядите данные и переопубликуйте в медленные топики. Цикл I²C на ESP32 должен оставаться сосредоточен на вызовах dev.read*() без накладных расходов HTTP.
Ссылки
-
06 · Примеры — базовые скетчи, на которых строятся эти интеграции
-
08 · Облачные интеграции — AWS / Azure / GCP / внешние сервисы
-
10 · Устранение неполадок — шаблоны: разрыв MQTT, WDT WiFi, переполнение кучи TLS и т. п.
Исходный код и задачи: rb-amp/rbamp-arduino · эта страница в репозитории: docs/07_diy_integrations.md (v1.6.2)