progl
e69665273c
- MQTT.md: реальные имена полей (wEC, wpH, wLevel, Light, mcp/gpio) - Добавлены топики OTA, status/full, status/actuators - Полный список preferences с полями прошивки (60+ параметров) - Актуальная схема status/sensors и status/mixer - Pump ID расхождение задокументировано (сервер 1-8 vs прошивка 0-7) - DEVICE_BEHAVIOR.md: FSM, exponential backoff, HA интеграция
ponics-protocol
Единый источник истины для коммуникации между ponics.online (сервер) и WegaBox (ESP32 устройство).
Репозитории
| Репо | Описание |
|---|---|
| web-calc | Django backend + frontend (ponics.online) |
| wega-box | Прошивка ESP32 |
| ponics-protocol (этот репо) | Спецификация протокола |
Документация
- MQTT.md — Топики, payload схемы, flow диаграммы
- REST_API.md — HTTP API эндпоинты
- DEVICE_BEHAVIOR.md — Конечный автомат устройства
- SENSORS.md — Поля датчиков, маппинг имён
Быстрый старт
Device UID = token устройства (UUID формат)
MQTT Broker = ponics.online:1883
Аутентификация = username/password (в настройках устройства)
Ключевые топики
{UID}/data-timescale/{METRIC} ← устройство шлёт данные датчиков
{UID}/status ← устройство шлёт "connected"
{UID}/cmd/reboot → сервер перезагружает устройство
{UID}/set/pump/{id}/run → сервер запускает помпу (мс)
{UID}/set/pump/{id}/dispense → сервер наливает граммы
{UID}/set/preferences/all → сервер синхронизирует настройки