Перейти к содержанию

Kavlev IoT — документация

Платформа домашней автоматизации на ESP8266/ESP32: плата работает автономно, облако опционально, расширяется plug-and-play плагинами.

Это документация для двух репозиториев:

  • ctrl-board — прошивка платы. Веб-интерфейс, REST API, расписания, mesh, OTA.
  • cloud-service — облачный сервис на cloud.kavlev.ru. Удалённый доступ, проекты, OTA, голосовые ассистенты.

С чего начать

  • Быстрый старт
    Прошить плату, подключить к Wi-Fi, открыть UI и привязать к облаку — за 10 минут.

  • Концепции
    Как устроены устройства, задачи, плагины и mesh. Что куда сохраняется.

  • Поддерживаемые платы
    ESP8266 (NodeMCU v1.0) и ESP32 (WROOM-32 DevKit V1) — отличия и пин-карты.

  • Плагины
    Архитектура plug-and-play и пошаговый гайд по созданию своего плагина.

  • Облачный сервис
    Проекты, роли, OTA, интеграции с голосовыми ассистентами.

  • Сценарии
    Готовые проверенные конфигурации для частых задач: свет, тёплый пол, полив.

Главные особенности

  • Автономность. Плата работает без интернета и без облака.
  • 5 Wi-Fi сетей с failover + собственный AP как последняя инстанция.
  • Mesh на UDP multicast с подписью HMAC-SHA256.
  • 4 категории плагинов: датчики, триггеры, условия, действия. Plug-and-play через *.enabled.json.
  • OTA прошивки и файловой системы с сохранением onboarding-данных.
  • Голосовые ассистенты: Яндекс Алиса, Маруся, Сбер Салют.

Полезные ссылки