rbAmp
RU
Магазин
Документация

08 · Облачные интеграции

Как отправлять показания RbAmp в облачные платформы — AWS IoT Core, Azure IoT Hub, Google Cloud и бессерверные или управляемые конвейеры наблюдаемости. Для каждой платформы: скетч ESP32 и то, что нужно настроить на стороне облака.

Самостоятельно размещаемые платформы DIY (Home Assistant, Node-RED, InfluxDB OSS) — см. 07 · DIY-интеграции.

Облако Транспорт Аутентификация Задержка Стоимость
AWS IoT Core MQTT/TLS X.509 сертификат низкий $5/М сообщений
Azure IoT Hub MQTT/TLS или AMQP SAS-токен низкий $0.40-2/М сообщений
Google Cloud IoT (устарел в 2023) MQTT/TLS JWT — n/a
InfluxDB Cloud HTTPS line-protocol API-токен средний $250/mo+
Generic webhook / REST HTTPS POST API-ключ высокий зависит
Безопасность

⚠ TLS на ESP32. Любой облачный транспорт поверх TLS добавляет ~30 кБ кода + ~30 кБ кучи на рукопожатие. У AVR / ESP8266 нет памяти для TLS — для этих платформ нужен локальный брокер MQTT, который проксирует в облако (Mosquitto → мост → AWS IoT).


AWS IoT Core

AWS IoT Core использует взаимный TLS с X.509-сертификатом устройства.

Provisioning

  1. Консоль AWS → IoT Core → Manage → Things → Create things → Single thing [AWS Console → IoT Core → Manage → Things → Create things → Single thing].
  2. Сгенерируйте сертификат и ключи; скачайте device.cert.pem, device.private.key, AmazonRootCA1.pem.

  3. Прикрепите политику, разрешающую iot:Connect, iot:Publish для arn:aws:iot:::topic/rbamp/+/state.

  4. Обратите внимание на endpoint AWS IoT: xxxxxx-ats.iot..amazonaws.com:8883.

Скетч ESP32

C++
#include 
#include 
#include 
#include 
#include 

static const char AWS_ENDPOINT[]  = "xxxxxx-ats.iot.eu-west-1.amazonaws.com";
static const char AWS_CLIENT_ID[] = "rbamp-main";

// Contents of AmazonRootCA1.pem, device.cert.pem, device.private.key
// in PROGMEM strings (saves RAM, places them in flash).
static const char AWS_ROOT_CA[] PROGMEM = R"EOF(
-----BEGIN CERTIFICATE-----
MIIDQTCC...
-----END CERTIFICATE-----
)EOF";
static const char DEV_CERT[] PROGMEM = R"EOF(
-----BEGIN CERTIFICATE-----
MIIDWjCC...
-----END CERTIFICATE-----
)EOF";
static const char DEV_KEY[] PROGMEM = R"EOF(
-----BEGIN RSA PRIVATE KEY-----
MIIEowIB...
-----END RSA PRIVATE KEY-----
)EOF";

static RbAmp dev(Wire, 0x50);
static WiFiClientSecure tls;
static PubSubClient     mqtt(tls);

void setup() {
    Serial.begin(115200);
    WiFi.begin("ssid", "pass");
    while (WiFi.status() != WL_CONNECTED) delay(500);

    tls.setCACert(AWS_ROOT_CA);
    tls.setCertificate(DEV_CERT);
    tls.setPrivateKey(DEV_KEY);

    mqtt.setServer(AWS_ENDPOINT, 8883);
    mqtt.setKeepAlive(60);
    mqtt.connect(AWS_CLIENT_ID);

    Wire.begin();
    Wire.setClock(50000);
    while (!dev.begin()) delay(500);
}

void loop() {
    if (!mqtt.connected()) mqtt.connect(AWS_CLIENT_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 payload[256];
    snprintf(payload, sizeof(payload),
        "{\"voltage\":%.1f,\"power\":%.1f,\"energy\":%.3f,\"freq\":%.1f}",
        dev.readVoltage(), snap.avg_p[0],
        dev.energy().wh(0), dev.readFrequency());
    mqtt.publish("rbamp/main/state", payload, false);
}

Обработка в облаке

  • Создайте IoT Rule: SELECT *, topic(2) AS device FROM 'rbamp/+/state' → Kinesis Data Firehose или Lambda для хранения.

  • Для дашбордов — AWS IoT SiteWise (промышленный историк) или Timestream (БД временных рядов) → QuickSight.

  • Если Home Assistant работает на Pi и получает данные из AWS, настройте локальный мост Mosquitto (дешевле и быстрее, чем HA → AWS напрямую).

О стоимости

При публикации раз в минуту на устройство AWS IoT даёт около 525k сообщений в год → примерно $2.60 в год на устройство по тарифу «Connectivity» + «Messaging» (2026, us-east-1). Стоимость Timestream / Lambda считается отдельно.


Azure IoT Hub

Azure IoT Hub поддерживает MQTT 3.1.1 поверх TLS с аутентификацией SAS-токеном (проще, чем X.509, для домашнего использования).

Provisioning

  1. Azure Portal → IoT Hub → Devices → New → ID устройства rbamp-main, аутентификация = Symmetric key.

  2. Сохраните строку подключения: HostName=foo.azure-devices.net;DeviceId=rbamp-main;SharedAccessKey=….

  3. Сгенерируйте SAS-токен (например, через az iot hub generate-sas-token или любой Azure SDK).

Скетч ESP32 (долгоживущий SAS-токен)

C++
#include 
#include 
#include 
#include 

static const char AZ_HOST[]      = "foo.azure-devices.net";
static const char AZ_USER[]      = "foo.azure-devices.net/rbamp-main/?api-version=2021-04-12";
static const char AZ_SAS[]       = "SharedAccessSignature sr=foo.azure-devices.net%2Fdevices%2Frbamp-main&sig=…&se=…";
static const char AZ_DEVICE_ID[] = "rbamp-main";

// Root CA for Azure IoT Hub (Baltimore CyberTrust Root or DigiCert Global Root)
static const char AZ_ROOT_CA[] PROGMEM = R"EOF(
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
)EOF";

static RbAmp dev(Wire, 0x50);
static WiFiClientSecure tls;
static PubSubClient     mqtt(tls);

void setup() {
    // ...WiFi up...
    tls.setCACert(AZ_ROOT_CA);
    mqtt.setServer(AZ_HOST, 8883);
    mqtt.setKeepAlive(60);
    mqtt.connect(AZ_DEVICE_ID, AZ_USER, AZ_SAS);

    Wire.begin(); Wire.setClock(50000);
    while (!dev.begin()) delay(500);
}

void loop() {
    if (!mqtt.connected()) mqtt.connect(AZ_DEVICE_ID, AZ_USER, AZ_SAS);
    mqtt.loop();

    static uint32_t last = 0;
    if (millis() - last < 60000) { delay(50); return; }
    last = millis();

    RbAmpPeriodSnapshot snap;
    if (!dev.readPeriodSnapshot(snap)) return;

    char payload[256];
    snprintf(payload, sizeof(payload),
        "{\"voltage\":%.1f,\"power\":%.1f,\"energy\":%.3f}",
        dev.readVoltage(), snap.avg_p[0], dev.energy().wh(0));

    // Azure D2C topic format:
    char topic[128];
    snprintf(topic, sizeof(topic), "devices/%s/messages/events/", AZ_DEVICE_ID);
    mqtt.publish(topic, payload, false);
}

Истечение срока токена SAS

В токенах SAS есть утверждение expiry — типичный срок жизни от 1 часа до 1 года. Для развёртывания на ESP32 сгенерируйте токен на 1 год на сборочной машине и запишите его в прошивку. Для автоматической ротации без участия человека периодически обновляйте его через Azure IoT Hub Device Provisioning Service (DPS); это выходит за рамки библиотеки.

Облачная обработка (Azure)

  • Направляйте сообщения в Event Hubs для высокопроизводительного приёма → Stream Analytics → панели Power BI.

  • Более дешёвая альтернатива: сообщения → Storage Account (blob) → Synapse Serverless SQL для ad-hoc запросов.


Google Cloud IoT (УСТАРЕЛ в 2023)

Google закрыла Cloud IoT Core в 2023 году. Пути миграции:

  • Брокер MQTT на Compute Engine (Mosquitto разворачиваете в виртуальной машине сами) — тот же шаблон скетча, что в 07 · DIY-интеграциях, раздел Home Assistant, но с публичным IP вашей VM.

  • HiveMQ Cloud / EMQX Cloud — управляемые брокеры MQTT, ~$10-20/мес. на любительских тарифах.

  • Pub/Sub по HTTPS — публикация напрямую в тему Pub/Sub через REST API (аутентификация по ключу сервисного аккаунта, записанному в ESP32).

Для Pub/Sub по HTTPS см. раздел «Generic webhook / REST» ниже, подставив endpoint публикации Pub/Sub.


InfluxDB Cloud (TLSv1.3 + line-protocol)

InfluxDB Cloud (уровень Serverless) принимает line-protocol по HTTPS — та же форма, что путь OSS в 07 · DIY-интеграции, раздел InfluxDB OSS, но с хостом cloud2.influxdata.com и API-токеном для аутентификации.

C++
#include 
#include 

#define INFLUX_URL   "https://us-east-1-1.aws.cloud2.influxdata.com/api/v2/write?org=MyOrg&bucket=energy&precision=s"
#define INFLUX_TOKEN "your-rw-token"
// CA for cloud2.influxdata.com (DigiCert Global Root G2 or similar)
static const char INFLUX_CA[] PROGMEM = R"EOF(
-----BEGIN CERTIFICATE-----
...
-----END CERTIFICATE-----
)EOF";

void push_influx_cloud(float u, float p, double e_wh) {
    WiFiClientSecure client;
    client.setCACert(INFLUX_CA);

    HTTPClient http;
    http.begin(client, INFLUX_URL);
    http.addHeader("Authorization", "Token " INFLUX_TOKEN);
    http.addHeader("Content-Type", "text/plain");

    char body[256];
    snprintf(body, sizeof(body),
        "rbamp,device=main voltage=%.1f,power=%.1f,energy=%.3f",
        u, p, e_wh);
    int code = http.POST(body);
    http.end();
    if (code != 204) Serial.printf("influx HTTP %d\n", code);
}

// In your 60-second loop, after readPeriodSnapshot():
push_influx_cloud(dev.readVoltage(), snap.avg_p[0], dev.energy().wh(0));

Бесплатный тариф InfluxDB Cloud (5 ГБ / хранение 30 дней) покрывает около 5000 точек при частоте раз в минуту в сутки — с запасом для домашнего использования.


Универсальный webhook / REST

Публикация на любой HTTPS-endpoint с API-ключом — работает с вебхуками IFTTT, собственными сервисами Flask / FastAPI или любой облачной функцией (AWS Lambda / Azure Functions / GCP Cloud Run), доступной по HTTPS.

C++
#include 
#include 

#define WEBHOOK_URL "https://your-api.example.com/ingest"
#define API_KEY     "Bearer your-token-here"

// Attach the server CA for TLS, or use setInsecure()
// for prototyping only. NEVER ship setInsecure()
// to production — it disables certificate validation.
static const char SERVER_CA[] PROGMEM = "...";

void push_webhook(float u, float p, double e_wh) {
    WiFiClientSecure client;
    client.setCACert(SERVER_CA);

    HTTPClient http;
    http.begin(client, WEBHOOK_URL);
    http.addHeader("Authorization", API_KEY);
    http.addHeader("Content-Type", "application/json");

    char body[256];
    snprintf(body, sizeof(body),
        "{\"ts\":%lu,\"voltage\":%.1f,\"power\":%.1f,\"energy\":%.3f}",
        (unsigned long)(millis() / 1000), u, p, e_wh);
    int code = http.POST(body);
    http.end();
    if (code < 200 || code >= 300) {
        Serial.printf("webhook HTTP %d\n", code);
    }
}

При низкой частоте (≤ раз в минуту) накладные расходы приемлемы. При более высокой частоте копите данные на стороне ESP32 (10 минут в кольцевом буфере, публикация одним пакетным JSON), чтобы не платить за рукопожатие TLS на каждый запрос.


Гибрид: локальное хранение + синхронизация с облаком

Для развёртываний, устойчивых к обрывам связи: записывайте в SPIFFS или на SD-карту раз в минуту и отправляйте в облако раз в час. Это переживает обрывы WiFi без потери данных.

C++
#include 

void log_to_sd(RbAmpPeriodSnapshot& snap) {
    File f = SD.open("/log.csv", FILE_APPEND);
    if (!f) return;
    f.printf("%lu,%.1f,%.1f,%.3f\n",
             (unsigned long)(millis() / 1000),
             dev.readVoltage(),
             snap.avg_p[0],
             dev.energy().wh(0));
    f.close();
}

void sync_to_cloud_if_due() {
    static uint32_t last_sync = 0;
    if (millis() - last_sync < 3600000UL) return;   // once an hour
    last_sync = millis();

    File f = SD.open("/log.csv", FILE_READ);
    if (!f) return;
    while (f.available()) {
        String line = f.readStringUntil('\n');
        push_webhook_line(line.c_str());
    }
    f.close();
    // Optional: archive to /log_pushed.csv + truncate /log.csv
}

Накопитель библиотеки dev.energy().wh(0) продолжает считать всё время, пока длится автономный интервал — данные не теряются, пока ESP32 остаётся под питанием.


Бюджет энергии

Установка TLS-соединения — дорогая операция: ~3 с и ~30 kB heap на соединение. Для регистраторов с глубоким сном (см. сценарий регистратора от батареи с глубоким сном в 06 · Примеры):

  • Переиспользуйте сессию TLS, если интервал сна < 24 ч (большинство управляемых брокеров поддерживают возобновление сессии).

  • Пакетная запись нескольких измерений на локальную SD-карту и одна массовая отправка POST при каждом пробуждении.

  • Используйте MQTT поверх TLS с постоянной сессией (cleansession=0), чтобы не переотправлять конфигурацию обнаружения при каждом пробуждении.

При интервале пробуждения 10 минут на Li-ion 2000 мАч ожидайте около 3 месяцев работы на WiFi + TLS против примерно 6 месяцев на WiFi + обычный MQTT.



Исходный код и задачи: rb-amp/rbamp-arduino · эта страница в репозитории: docs/08_cloud_integrations.md (v1.6.2)