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:
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. Два варианта:
- Встроенные байты — файлы сертификатов как объекты 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)
- Через файловую систему флеша — положите файлы сертификатов в
/lib/certs/на устройстве (черезmpremote cp) и читайте их стандартнымopen():
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
- Консоль AWS → IoT Core → Manage → Things → Create things → Single thing [AWS Console → IoT Core → Manage → Things → Create things → Single thing].
-
Сгенерируйте сертификат и ключи; скачайте
device.cert.pem,device.private.key,AmazonRootCA1.pem. -
Прикрепите политику, разрешающую
iot:Connect,iot:Publishдляarn:aws:iot:.: :topic/rbamp/+/state -
Запишите адрес конечной точки AWS IoT:
xxxxxx-ats.iot...amazonaws.com:8883
CPython, версия (AWS IoT)
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)
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():
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
-
Azure Portal → IoT Hub → Devices → New → ID устройства
rbamp-main, аутентификация = Symmetric key. -
Сохраните строку подключения:
HostName=foo.azure-devices.net;DeviceId=rbamp-main;SharedAccessKey=…. -
Сгенерировать SAS-токен. На CPython через SDK
azure-iot-deviceили ручной HMAC:
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=")
- На MicroPython — либо
ucryptolib+ ручной HMAC (медленно), либо просто зашить SAS-токен на 1 год, сгенерированный на машине сборки.
CPython, версия (Azure IoT Hub)
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)
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-ключ сервисного аккаунта:
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)
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)
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
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
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 (ротируемый файл + ежечасная синхронизация)
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 (дописывание в файл + повтор при подключении)
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)