rbAmp
RU
Магазин
Документация
Обновлено · Правка на GitHub (Edit on GitHub)

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

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

Платформы DIY с собственным хостингом (Home Assistant, Node-RED, InfluxDB OSS) — см. 07 · Интеграции DIY.

Флот → поканальные темы MQTT модулей

В каноничной схеме (сеть + N поднагрузок на одной шине) мастер публикует показания в отдельную тему для каждого модуля. Удобный шаблон — перебирать флот по адресу модуля или его пользовательской метке LABEL:

C
char topic[64];
for (size_t i = 0; i < rbamp_fleet_count(fleet); ++i) {
    rbamp_handle_t dev = rbamp_fleet_get(fleet, i);
    char label[9]; rbamp_read_label(dev, label);
    snprintf(topic, sizeof topic, "rbamp/%s/snapshot",
             label[0] ? label : "unlabeled");
    /* publish snaps[i] as JSON to topic */
}

Дополнительные темы: rbamp/ (управляется rbamp_has_error), rbamp/fleet/total_power, rbamp/fleet/total_energy_wh, rbamp/fleet/balance (сеть − Σ(поднагрузки) в каноничном сценарии 80%). Полный пример с сохраняемыми полезными нагрузками и автообнаружением Home Assistant — в главе 06 · Примеры, сценарий 1.

Облако Транспорт Аутентификация Задержка Стоимость
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 кБ кучи на каждое рукопожатие. На очень маленьких платформах с ограниченной памятью (особенно ESP32-C2, особенно при включённом Bluetooth) куча TLS может стать проблемой — см. 10 · Устранение неполадок, раздел «Сбой рукопожатия TLS».

Сертификаты TLS — файловый шаблон через SPIFFS

В отличие от библиотеки Arduino, где сертификаты обычно встраиваются в прошивку строками PROGMEM, ESP-IDF предпочитает файловый подход: файлы сертификатов размещаются в выделенном разделе SPIFFS, а в конфигурацию передаётся URI вида file:///certs/aws_root_ca.pem.

Таблица разделов

Добавьте запись для раздела сертификатов в partitions.csv вашего проекта:

Text
# Name,     Type, SubType, Offset,  Size,    Flags
nvs,        data, nvs,     0x9000,  0x6000,
phy_init,   data, phy,     0xf000,  0x1000,
factory,    app,  factory, 0x10000, 0x100000,
certs,      data, spiffs,  ,        0x20000,

В sdkconfig.defaults:

Text
CONFIG_PARTITION_TABLE_CUSTOM=y
CONFIG_PARTITION_TABLE_CUSTOM_FILENAME="partitions.csv"

Образ SPIFFS с сертификатами

Положите файлы сертификатов в каталог spiffs_image/ рядом с main/ и включите генерацию образа в main/CMakeLists.txt:

CMake
idf_component_register(
    SRCS "main.c"
    INCLUDE_DIRS "."
    REQUIRES rbamp mqtt esp_http_client nvs_flash esp_wifi esp_event esp_netif
)

# SPIFFS image with certificates — built at build-time and flashed into
# the "certs" partition by one of the `idf.py spiffs-certs-flash` commands.
spiffs_create_partition_image(certs
    ${CMAKE_SOURCE_DIR}/spiffs_image
    FLASH_IN_PROJECT
)

После idf.py build flash файлы из spiffs_image/* находятся в разделе certs и доступны через VFS по пути /certs/.

Монтаж во время работы

C
esp_vfs_spiffs_conf_t spiffs_cfg = {
    .base_path = "/certs",
    .partition_label = "certs",
    .max_files = 4,
    .format_if_mount_failed = false,
};
ESP_ERROR_CHECK(esp_vfs_spiffs_register(&spiffs_cfg));

После этого URI "file:///certs/ca.pem" можно передать в esp_mqtt_client_config_t.broker.verification.certificate_uri и подобные поля.


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.

Файлы сертификатов в SPIFFS

Поместите в spiffs_image/:

Text
spiffs_image/
  ca.pem          # AmazonRootCA1.pem
  client.crt      # device.cert.pem
  client.key      # device.private.key

Проект ESP-IDF

C
#include "freertos/FreeRTOS.h"
#include "esp_event.h"
#include "esp_log.h"
#include "esp_spiffs.h"
#include "esp_wifi.h"
#include "mqtt_client.h"
#include "nvs_flash.h"
#include "rbamp.h"

#define AWS_URI       "mqtts://xxxxxx-ats.iot.eu-west-1.amazonaws.com:8883"
#define AWS_CLIENT_ID "rbamp-main"

static const char *TAG = "aws_iot";
static esp_mqtt_client_handle_t mqtt;

void app_main(void) {
    /* ...nvs + netif + wifi STA until IP_EVENT_STA_GOT_IP is received... */
    /* ...mount SPIFFS at /certs (see the TLS certificates section above)... */
    /* ...I²C bus + rbamp_new + rbamp_begin + set_sensor_class + set_ct_model... */
    rbamp_handle_t dev = NULL;

    const esp_mqtt_client_config_t cfg = {
        .broker.address.uri = AWS_URI,
        .broker.verification.certificate_uri = "file:///certs/ca.pem",
        .credentials.client_id = AWS_CLIENT_ID,
        .credentials.authentication.certificate_uri = "file:///certs/client.crt",
        .credentials.authentication.key_uri         = "file:///certs/client.key",
        .session.keepalive = 60,
    };
    mqtt = esp_mqtt_client_init(&cfg);
    ESP_ERROR_CHECK(esp_mqtt_client_start(mqtt));

    while (1) {
        vTaskDelay(pdMS_TO_TICKS(60000));

        rbamp_period_snapshot_t snap;
        if (rbamp_read_period_snapshot(dev, &snap, 50, false) != ESP_OK ||
            !snap.valid) continue;

        float u, freq;
        rbamp_read_voltage(dev, 0, &u);
        rbamp_read_frequency(dev, &freq);

        char payload[256];
        snprintf(payload, sizeof(payload),
            "{\"voltage\":%.1f,\"power\":%.1f,\"energy\":%.3f,\"freq\":%.1f}",
            (double)u, (double)snap.avg_p[0],
            rbamp_energy_wh(dev, 0), (double)freq);
        esp_mqtt_client_publish(mqtt, "rbamp/main/state",
                                payload, 0, /*qos*/0, /*retain*/0);
    }
}

Обработка на стороне облака

  • Создайте 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 напрямую).

О стоимости

Публикация раз в минуту на устройство даёт ~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).

Сертификат + конфигурация

Поместите корневой сертификат Azure (Baltimore CyberTrust Root или DigiCert Global Root G2) в spiffs_image/ca.pem.

C
#define AZ_URI        "mqtts://foo.azure-devices.net:8883"
#define AZ_USER       "foo.azure-devices.net/rbamp-main/?api-version=2021-04-12"
#define AZ_SAS        "SharedAccessSignature sr=foo.azure-devices.net%2Fdevices%2Frbamp-main&sig=…&se=…"
#define AZ_DEVICE_ID  "rbamp-main"

const esp_mqtt_client_config_t cfg = {
    .broker.address.uri = AZ_URI,
    .broker.verification.certificate_uri = "file:///certs/ca.pem",
    .credentials.client_id = AZ_DEVICE_ID,
    .credentials.username = AZ_USER,         /* SAS auth — no mTLS */
    .credentials.authentication.password = AZ_SAS,
    .session.keepalive = 60,
};

/* Publish to the Azure D2C topic: */
char topic[128];
snprintf(topic, sizeof(topic), "devices/%s/messages/events/", AZ_DEVICE_ID);
esp_mqtt_client_publish(mqtt, topic, payload, 0, /*qos*/0, /*retain*/0);

Истечение срока токена 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 разворачиваете в VM сами) — тот же шаблон, что в 07 · Самостоятельные интеграции, раздел Home Assistant, но с публичным IP вашей VM.

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

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

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


InfluxDB Cloud (TLSv1.3 + line-protocol)

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

Поместите CA для cloud2.influxdata.com (DigiCert Global Root G2 или аналогичный) в spiffs_image/influx_ca.pem.

C
#include "esp_http_client.h"
#include "esp_log.h"

#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"

static const char *TAG = "influx_cloud";

static esp_err_t read_ca(char *buf, size_t buflen, size_t *out_len) {
    FILE *f = fopen("/certs/influx_ca.pem", "rb");
    if (!f) return ESP_FAIL;
    *out_len = fread(buf, 1, buflen - 1, f);
    buf[*out_len] = '\0';
    fclose(f);
    return ESP_OK;
}

static void push_influx_cloud(float u, float p, double e_wh) {
    static char ca_buf[2048];
    static size_t ca_len = 0;
    if (ca_len == 0) {
        if (read_ca(ca_buf, sizeof(ca_buf), &ca_len) != ESP_OK) {
            ESP_LOGE(TAG, "CA read failed");
            return;
        }
    }

    char body[256];
    snprintf(body, sizeof(body),
        "rbamp,device=main voltage=%.1f,power=%.1f,energy=%.3f",
        (double)u, (double)p, e_wh);

    esp_http_client_config_t cfg = {
        .url        = INFLUX_URL,
        .method     = HTTP_METHOD_POST,
        .cert_pem   = ca_buf,
        .timeout_ms = 10000,    /* TLS handshake may take up to 3 s */
    };
    esp_http_client_handle_t client = esp_http_client_init(&cfg);
    esp_http_client_set_header(client, "Authorization", "Token " INFLUX_TOKEN);
    esp_http_client_set_header(client, "Content-Type", "text/plain");
    esp_http_client_set_post_field(client, body, strlen(body));

    esp_err_t err = esp_http_client_perform(client);
    int status = esp_http_client_get_status_code(client);
    esp_http_client_cleanup(client);

    if (err != ESP_OK || status != 204) {
        ESP_LOGW(TAG, "influx HTTP %d (err %s)", status, esp_err_to_name(err));
    }
}

/* In the 60-second loop, after rbamp_read_period_snapshot(): */
float u;
rbamp_read_voltage(dev, 0, &u);
push_influx_cloud(u, snap.avg_p[0], rbamp_energy_wh(dev, 0));

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


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

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

C
#include "esp_http_client.h"
#include "esp_log.h"
#include "esp_timer.h"

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

static const char *TAG = "webhook";

/* CA for your HTTPS endpoint (read from /certs/webhook_ca.pem,
 * via snprintf+fopen as in push_influx_cloud). */
extern const char *get_server_ca(void);   /* implementation as in the InfluxDB section */

static void push_webhook(float u, float p, double e_wh) {
    char body[256];
    snprintf(body, sizeof(body),
        "{\"ts\":%lld,\"voltage\":%.1f,\"power\":%.1f,\"energy\":%.3f}",
        (long long)(esp_timer_get_time() / 1000000),
        (double)u, (double)p, e_wh);

    esp_http_client_config_t cfg = {
        .url        = WEBHOOK_URL,
        .method     = HTTP_METHOD_POST,
        .cert_pem   = get_server_ca(),
        .timeout_ms = 10000,
    };
    esp_http_client_handle_t client = esp_http_client_init(&cfg);
    esp_http_client_set_header(client, "Authorization", API_KEY);
    esp_http_client_set_header(client, "Content-Type", "application/json");
    esp_http_client_set_post_field(client, body, strlen(body));

    esp_err_t err = esp_http_client_perform(client);
    int status = esp_http_client_get_status_code(client);
    esp_http_client_cleanup(client);

    if (err != ESP_OK || status < 200 || status >= 300) {
        ESP_LOGW(TAG, "webhook HTTP %d (err %s)", status, esp_err_to_name(err));
    }
}
Безопасность

⚠ .skip_cert_common_name_check = false в производстве должно оставаться false. На этапе прототипирования можно использовать .use_global_ca_store = true (бинарный файл поставляется без конкретного CA, что снижает безопасность TLS) — но НИКОГДА не выпускайте это в производство без явного CA.

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


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

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

C
#include 
#include "esp_log.h"
#include "esp_timer.h"
#include "rbamp.h"

#define LOG_PATH "/storage/log.csv"
static const char *TAG = "hybrid";

static void log_to_spiffs(const rbamp_period_snapshot_t *snap,
                          float u, double e_wh) {
    FILE *f = fopen(LOG_PATH, "a");
    if (!f) {
        ESP_LOGE(TAG, "fopen failed");
        return;
    }
    fprintf(f, "%lld,%.1f,%.1f,%.3f\n",
            (long long)(esp_timer_get_time() / 1000),
            (double)u, (double)snap->avg_p[0], e_wh);
    fclose(f);
}

static void sync_to_cloud_if_due(void) {
    static int64_t last_sync_us = 0;
    const int64_t now_us = esp_timer_get_time();
    if ((now_us - last_sync_us) < 3600LL * 1000000LL) return;   /* once per hour */
    last_sync_us = now_us;

    FILE *f = fopen(LOG_PATH, "r");
    if (!f) return;
    char line[256];
    while (fgets(line, sizeof(line), f)) {
        push_webhook_line(line);   /* line → JSON → POST */
    }
    fclose(f);
    /* Optionally: rename(LOG_PATH, "/storage/log_pushed.csv") + truncate */
}

Накопитель компонента rbamp_energy_wh(dev, 0) продолжает считать на протяжении всего автономного окна — данные не теряются, пока ESP32 под питанием. Раздел SPIFFS storage показан в 06 · Примеры, Сценарий 8 (spiffs_logger).


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

Рукопожатие TLS — дорогая операция: ~3 с + ~30 кБ кучи на соединение. Для регистраторов в глубоком сне (см. 06 · Примеры, Сценарий 9):

  • Повторно используйте сессию TLS, если интервал сна < 24 ч — mbedtls из ESP-IDF поддерживает возобновление сессии через API mbedtls_ssl_get/set_session(). Это сокращает рукопожатие примерно до ~500 мс.

  • Пакетируйте несколько измерений в локальный SPIFFS и отправляйте одним массовым POST за пробуждение — шаблон из раздела «Гибрид» выше.

  • MQTT поверх TLS с постоянной сессией (session.disable_clean_session = true в esp_mqtt_client_config_t) — брокер помнит ваши подписки между пробуждениями, поэтому конфигурацию обнаружения заново публиковать не нужно.

При интервале пробуждения 10 минут на литий-ионном элементе 2000 мАч ожидайте ~3 месяца работы на WiFi + TLS против ~6 месяцев на WiFi + обычном MQTT (по бюджету сценария 9).


См. также


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