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

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

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

Самохостируемые DIY-платформы (Home Assistant, Node-RED, InfluxDB OSS) — см. 07 · DIY integrations.

Облако Транспорт Аутентификация CPython MicroPython
AWS IoT Core MQTT/TLS X.509 сертификат paho-mqtt + ssl umqtt.simple(ssl=True)
Azure IoT Hub MQTT/TLS SAS-токен paho-mqtt + ssl umqtt.simple(ssl=True)
Google Cloud IoT (устарел в 2023) MQTT/TLS JWT (миграция — см. ниже) то же
InfluxDB Cloud HTTPS line-protocol API-токен requests urequests
Generic webhook / REST HTTPS POST API-ключ requests urequests
Безопасность

⚠ Стоимость TLS на MicroPython. Рукопожатие TLS требует около 30 кБ кучи на ESP32. На малых целях (ESP32-C2) может возникнуть нехватка памяти, если Wi-Fi и буферы работают параллельно. На CPython это практически не проблема (у Pi 3+/4+ 1+ ГБ ОЗУ).

Для целей с малым объёмом памяти рекомендуем локальный мост Mosquitto на Pi/SBC: устройство MicroPython публикует в mqtts://local-broker (с минимальным TLS или вообще без TLS внутри LAN), а мост пересылает данные облачному брокеру по TLS.

Сертификаты TLS — два подхода

CPython — пути к файлам

CPython поставляется с системным ca-certificates (Debian/Ubuntu: /etc/ssl/certs/). Для дополнительных сертификатов устройства положите файлы рядом со скриптом и передайте пути в ssl.SSLContext:

Python
import ssl

ctx = ssl.create_default_context(cafile="/etc/ssl/certs/ca-certificates.crt")
# For mutual TLS (AWS IoT) — add the device cert + key:
ctx.load_cert_chain(certfile="device.cert.pem", keyfile="device.private.key")

MicroPython — встроенные в байты или файловая система

В MicroPython нет полноценного файлового хранилища TLS. Два варианта:

  1. Встроенные байты — файлы сертификатов как объекты Python в скрипте:
Python
AWS_ROOT_CA = b"""-----BEGIN CERTIFICATE-----
MIIDQTCC...
-----END CERTIFICATE-----
"""

import ssl
ctx = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
ctx.load_verify_locations(cadata=AWS_ROOT_CA)
  1. Через файловую систему флеша — положите файлы сертификатов в /lib/certs/ на устройстве (через mpremote cp) и читайте их стандартным open():
Python
with open("/lib/certs/ca.pem", "rb") as f:
    ca_bytes = f.read()
ctx.load_verify_locations(cadata=ca_bytes)
Примечание

На некоторых портах MicroPython (особенно ESP8266) отсутствует ssl.SSLContext — вместо него используется упрощённый ussl.wrap_socket(...) с ограниченной проверкой. Для промышленного развёртывания выберите цель семейства ESP32 с полным стеком TLS.


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. Запишите адрес конечной точки AWS IoT: xxxxxx-ats.iot..amazonaws.com:8883.

CPython, версия (AWS IoT)

Python
import json, ssl, time
from smbus2 import SMBus
import paho.mqtt.client as mqtt_client
from rbamp import RbAmp, RbAmpSensorClass, RbAmpStaleError

AWS_ENDPOINT  = "xxxxxx-ats.iot.eu-west-1.amazonaws.com"
AWS_CLIENT_ID = "rbamp-main"

ctx = ssl.create_default_context(cafile="AmazonRootCA1.pem")
ctx.load_cert_chain(certfile="device.cert.pem",
                    keyfile="device.private.key")

mqtt = mqtt_client.Client(AWS_CLIENT_ID, protocol=mqtt_client.MQTTv311)
mqtt.tls_set_context(ctx)
mqtt.connect(AWS_ENDPOINT, 8883, keepalive=60)
mqtt.loop_start()

with SMBus(1) as bus, RbAmp(bus, 0x50) as dev:
    dev.set_sensor_class(RbAmpSensorClass.SCT_013)
    dev.set_ct_model(3)

    while True:
        time.sleep(60)
        try:
            snap = dev.read_period_snapshot()
        except RbAmpStaleError:
            continue

        payload = {
            "voltage":  round(dev.voltage, 1),
            "power":    round(snap.avg_p[0], 1),
            "energy":   round(dev.energy.wh(0), 3),
            "freq":     round(dev.frequency, 1),
        }
        mqtt.publish("rbamp/main/state", json.dumps(payload), qos=1)

MicroPython, версия (AWS IoT)

Python
import time, ujson, ssl
from machine import I2C, Pin
from umqtt.simple import MQTTClient
from rbamp import RbAmp, RbAmpSensorClass, RbAmpStaleError

AWS_ENDPOINT  = b"xxxxxx-ats.iot.eu-west-1.amazonaws.com"

# Cert files in `/lib/certs/` (copied over via mpremote cp)
with open("/lib/certs/AmazonRootCA1.pem", "rb") as f:
    AWS_ROOT_CA = f.read()
with open("/lib/certs/device.cert.pem", "rb") as f:
    DEV_CERT = f.read()
with open("/lib/certs/device.private.key", "rb") as f:
    DEV_KEY = f.read()

ctx = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
ctx.load_verify_locations(cadata=AWS_ROOT_CA)
ctx.load_cert_chain(certfile="/lib/certs/device.cert.pem",
                    keyfile="/lib/certs/device.private.key")

mqtt = MQTTClient(b"rbamp-main", AWS_ENDPOINT, port=8883,
                  keepalive=60, ssl=ctx)
mqtt.connect()

i2c = I2C(0, scl=Pin(22), sda=Pin(21), freq=50_000)
with RbAmp(i2c, 0x50) as dev:
    dev.set_sensor_class(RbAmpSensorClass.SCT_013)
    dev.set_ct_model(3)

    while True:
        time.sleep(60)
        try:
            snap = dev.read_period_snapshot()
        except RbAmpStaleError:
            continue

        payload = ujson.dumps({
            "voltage":  round(dev.voltage, 1),
            "power":    round(snap.avg_p[0], 1),
            "energy":   round(dev.energy.wh(0), 3),
            "freq":     round(dev.frequency, 1),
        })
        mqtt.publish(b"rbamp/main/state", payload.encode(), qos=1)
        mqtt.ping()   # keepalive

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

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

Альтернатива на CPython — boto3 через REST API

Для редких публикаций (раз в час и реже) можно обойтись без MQTT и использовать boto3.client('iot-data').publish():

Python
import boto3, json
iot = boto3.client("iot-data", region_name="eu-west-1")
iot.publish(topic="rbamp/main/state",
            qos=1, payload=json.dumps(payload))

Авторизация через стандартную цепочку учётных данных AWS (переменные окружения / ~/.aws/credentials / роль IAM). Удобно для пакетной публикации по cron с Pi. На MicroPython boto3 отсутствует.

О стоимости

При публикации раз в минуту на устройство AWS IoT даёт ~525 тыс. сообщений в год → ~$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-токен. На CPython через SDK azure-iot-device или ручной HMAC:

Python
import time, hmac, hashlib, urllib.parse, base64

def generate_sas(uri, key, expiry_seconds=3600 * 24 * 365):
    expiry = int(time.time()) + expiry_seconds
    string_to_sign = urllib.parse.quote_plus(uri) + "\n" + str(expiry)
    sig = base64.b64encode(hmac.new(
        base64.b64decode(key),
        string_to_sign.encode(),
        hashlib.sha256
    ).digest())
    return ("SharedAccessSignature "
            f"sr={urllib.parse.quote_plus(uri)}"
            f"&sig={urllib.parse.quote_plus(sig.decode())}"
            f"&se={expiry}")

sas = generate_sas("foo.azure-devices.net/devices/rbamp-main", "BASE64KEY=")
  1. На MicroPython — либо ucryptolib + ручной HMAC (медленно), либо просто зашить SAS-токен на 1 год, сгенерированный на машине сборки.

CPython, версия (Azure IoT Hub)

Python
import json, ssl, time
import paho.mqtt.client as mqtt_client

AZ_HOST      = "foo.azure-devices.net"
AZ_DEVICE    = "rbamp-main"
AZ_USERNAME  = f"{AZ_HOST}/{AZ_DEVICE}/?api-version=2021-04-12"
AZ_SAS       = "SharedAccessSignature sr=...&sig=...&se=..."   # see above

ctx = ssl.create_default_context()   # Uses the system CAs

mqtt = mqtt_client.Client(AZ_DEVICE, protocol=mqtt_client.MQTTv311)
mqtt.username_pw_set(AZ_USERNAME, password=AZ_SAS)
mqtt.tls_set_context(ctx)
mqtt.connect(AZ_HOST, 8883, keepalive=60)
mqtt.loop_start()

# Inside your 60-second loop:
mqtt.publish(f"devices/{AZ_DEVICE}/messages/events/",
             json.dumps(payload), qos=1)

MicroPython, версия (Azure IoT Hub)

Python
from umqtt.simple import MQTTClient
import ssl

ctx = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
# Azure root CA (Baltimore CyberTrust or DigiCert Global G2):
with open("/lib/certs/azure_ca.pem", "rb") as f:
    ctx.load_verify_locations(cadata=f.read())

mqtt = MQTTClient(b"rbamp-main", b"foo.azure-devices.net", port=8883,
                  user=AZ_USERNAME.encode(),
                  password=AZ_SAS.encode(),
                  keepalive=60, ssl=ctx)
mqtt.connect()

# In the loop:
mqtt.publish(b"devices/rbamp-main/messages/events/",
             ujson.dumps(payload).encode(), qos=1)

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

SAS-токены содержат утверждение expiry — типичный срок жизни от 1 часа до 1 года. Для развёртывания на CPython используйте SDK azure-iot-device: он сам обновляет токен. Для MicroPython сгенерируйте токен на 1 год на машине сборки и зашейте его в скрипт; либо реализуйте ротацию HMAC через ucryptolib.

Облачная обработка (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 · DIY integrations, но с публичным IP вашей VM.

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

  • Pub/Sub по HTTPS — публикация напрямую в топик Pub/Sub через REST API. На CPython проще через SDK google-cloud-pubsub и JSON-ключ сервисного аккаунта:

Python
from google.cloud import pubsub_v1
import json

publisher = pubsub_v1.PublisherClient.from_service_account_json("key.json")
topic_path = publisher.topic_path("my-project", "rbamp")
publisher.publish(topic_path, json.dumps(payload).encode())

Для Pub/Sub MicroPython по HTTPS — см. раздел «Общий webhook / REST» ниже, подставив конечную точку публикации Pub/Sub и токен OAuth bearer.


InfluxDB Cloud (TLSv1.3 + line-protocol)

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

CPython, версия (InfluxDB Cloud)

Python
import requests, time
from smbus2 import SMBus
from rbamp import RbAmp, RbAmpSensorClass, RbAmpStaleError

INFLUX_URL   = "https://us-east-1-1.aws.cloud2.influxdata.com/api/v2/write?org=MyOrg&bucket=energy&precision=s"
INFLUX_TOKEN = "your-rw-token"

def push_influx(u, p, e_wh):
    body = f"rbamp,device=main voltage={u:.1f},power={p:.1f},energy={e_wh:.3f}"
    try:
        r = requests.post(INFLUX_URL, data=body,
                          headers={
                              "Authorization": f"Token {INFLUX_TOKEN}",
                              "Content-Type":  "text/plain",
                          },
                          timeout=10)   # TLS handshake can take up to 3 s
        if r.status_code != 204:
            print(f"influx HTTP {r.status_code}: {r.text}")
    except requests.RequestException as e:
        print("influx request failed:", e)

with SMBus(1) as bus, RbAmp(bus, 0x50) as dev:
    dev.set_sensor_class(RbAmpSensorClass.SCT_013)
    dev.set_ct_model(3)

    while True:
        time.sleep(60)
        try:
            snap = dev.read_period_snapshot()
        except RbAmpStaleError:
            continue
        push_influx(dev.voltage, snap.avg_p[0], dev.energy.wh(0))

requests использует системный набор CA — на стандартной установке CPython Debian/Ubuntu это «просто работает».

MicroPython, версия (InfluxDB Cloud)

Python
import urequests as requests, ujson, ssl, time
from machine import I2C, Pin
from rbamp import RbAmp, RbAmpSensorClass, RbAmpStaleError

INFLUX_URL   = "https://us-east-1-1.aws.cloud2.influxdata.com/api/v2/write?org=MyOrg&bucket=energy&precision=s"
INFLUX_TOKEN = "your-rw-token"

# Custom SSL context with embedded CA (DigiCert Global G2)
ctx = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
with open("/lib/certs/digicert_g2.pem", "rb") as f:
    ctx.load_verify_locations(cadata=f.read())

def push_influx(u, p, e_wh):
    body = "rbamp,device=main voltage={:.1f},power={:.1f},energy={:.3f}".format(u, p, e_wh)
    try:
        r = requests.post(INFLUX_URL, data=body,
                          headers={
                              "Authorization": "Token " + INFLUX_TOKEN,
                              "Content-Type":  "text/plain",
                          })
        if r.status_code != 204:
            print("influx HTTP", r.status_code)
        r.close()   # MicroPython socket cleanup
    except OSError as e:
        print("influx request failed:", e)
Примечание

На большинстве портов MicroPython urequests использует встроенный пакет CA без проверки или системный. Для строгой проверки используйте urequests.post(..., verify=True), если ваш порт это поддерживает; иначе работайте через ssl.SSLContext + низкоуровневый usocket.

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


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

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

CPython

Python
import requests, time, json

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

def push_webhook(u, p, e_wh):
    body = {
        "ts":      time.time(),
        "voltage": u,
        "power":   p,
        "energy":  e_wh,
    }
    try:
        r = requests.post(WEBHOOK_URL, json=body, headers={
            "Authorization": API_KEY,
        }, timeout=10)
        if not (200 <= r.status_code < 300):
            print(f"webhook HTTP {r.status_code}: {r.text}")
    except requests.RequestException as e:
        print("webhook failed:", e)

MicroPython

Python
import urequests as requests, ujson, time

def push_webhook(u, p, e_wh):
    body = ujson.dumps({
        "ts":      time.time(),
        "voltage": u,
        "power":   p,
        "energy":  e_wh,
    })
    try:
        r = requests.post(WEBHOOK_URL, data=body, headers={
            "Authorization": API_KEY,
            "Content-Type":  "application/json",
        })
        if not (200 <= r.status_code < 300):
            print("webhook HTTP", r.status_code)
        r.close()
    except OSError as e:
        print("webhook failed:", e)

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


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

Для устойчивости к обрывам связи: логируйте локально раз в минуту и отправляйте в облако раз в час. Так переживаются обрывы Wi-Fi и сбои облака без потери данных.

CPython (ротируемый файл + ежечасная синхронизация)

Python
import logging, time, csv, requests
from logging.handlers import RotatingFileHandler
from smbus2 import SMBus
from rbamp import RbAmp, RbAmpSensorClass, RbAmpStaleError

log = logging.getLogger("rbamp.csv")
log.setLevel(logging.INFO)
handler = RotatingFileHandler("rbamp.csv", maxBytes=1_000_000, backupCount=5)
handler.setFormatter(logging.Formatter("%(asctime)s,%(message)s",
                                       datefmt="%Y-%m-%dT%H:%M:%S"))
log.addHandler(handler)

def sync_to_cloud_if_due():
    """Once an hour: read rbamp.csv, push the new rows to InfluxDB Cloud."""
    # ...uses push_influx from the section above + a state file for the offset...

with SMBus(1) as bus, RbAmp(bus, 0x50) as dev:
    dev.set_sensor_class(RbAmpSensorClass.SCT_013)
    dev.set_ct_model(3)

    last_sync = 0
    while True:
        time.sleep(60)
        try:
            snap = dev.read_period_snapshot()
        except RbAmpStaleError:
            log.warning("stale")
            continue
        log.info(f"{snap.avg_p[0]:.1f},{dev.energy.wh(0):.4f},"
                 f"{snap.master_dt_ms}")

        if time.time() - last_sync > 3600:
            sync_to_cloud_if_due()
            last_sync = time.time()

MicroPython (дописывание в файл + повтор при подключении)

Python
import time, ujson

def append_local(snap, dev):
    with open("/lib/log.csv", "a") as f:
        f.write("{:.0f},{:.1f},{:.4f},{}\n".format(
            time.time(), snap.avg_p[0], dev.energy.wh(0),
            snap.master_dt_ms))

def sync_if_due():
    """Once an hour: read the accumulated log, push it to the cloud."""
    try:
        with open("/lib/log.csv") as f:
            for line in f:
                # ...push_webhook(line) with retry on failure...
                pass
        # archive successful upload
        import os
        os.rename("/lib/log.csv", "/lib/log_pushed.csv")
    except OSError:
        pass   # offline / no file yet

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


Бюджет энергии (для батарейных развёртываний на MicroPython)

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

  • Переиспользуйте TLS-сессию между пробуждениями через возобновление TLS-сессии — umqtt.simple поддерживает постоянную сессию через clean_session=False, и брокер помнит ваши подписки.

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

  • MQTT keepalive не нужно поддерживать вне глубокого сна — устройство спит между пробуждениями, а рукопожатие TLS выполняется при каждом пробуждении (если не возобновляется).

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

CPython на Raspberry Pi обычно работает 24/7 от блока питания, поэтому бюджет энергии TLS не критичен. Для промышленного развёртывания с оптимизацией потребления Pi см. 10 · Устранение неполадок, раздел «Скрипт зависает / падает по таймауту» (цикл с обработкой сигналов для systemctl suspend).


  • 06 · Примеры — базовые проекты, на которых строятся облачные интеграции (особенно сценарий 9 «регистратор с глубоким сном» и сценарий 10 «асинхронная потоковая передача»)

  • 07 · DIY integrations — самохостируемые альтернативы

  • 10 · Troubleshooting — рукопожатие TLS / бюджет кучи / обработка сигналов


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