Skip to content

Kavlev IoT — Documentation

Home automation platform for ESP8266/ESP32: the board runs autonomously, the cloud is optional, and the system is extended through plug-and-play plugins.

This site documents two repositories:

  • ctrl-board — board firmware. Web UI, REST API, schedules, mesh, OTA.
  • cloud-service — cloud service at cloud.kavlev.ru. Remote access, projects, OTA, voice assistants.

Where to start

  • Quick start
    Flash the board, connect it to Wi-Fi, open the UI and link it to the cloud — in 10 minutes.

  • Concepts
    How devices, tasks, plugins and mesh fit together. Where state is persisted.

  • Supported hardware
    ESP8266 (NodeMCU v1.0) and ESP32 (WROOM-32 DevKit V1) — differences and pinouts.

  • Plugins
    Plug-and-play architecture and a step-by-step guide to building your own plugin.

  • Cloud service
    Projects, roles, OTA, voice assistant integrations.

  • Scenarios
    Tested configurations for common tasks: lighting, underfloor heating, irrigation.

Key capabilities

  • Autonomous. The board runs without internet and without the cloud.
  • 5 Wi-Fi networks with failover + a built-in AP as last resort.
  • Mesh over UDP multicast signed with HMAC-SHA256.
  • 4 plugin categories: sensors, triggers, conditions, actions. Plug-and-play via *.enabled.json.
  • OTA of firmware and filesystem with onboarding-data preservation.
  • Voice assistants: Yandex Alice, Marusya, Sber Salut.