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 parts of the platform:

  • 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
    Available sensors, triggers, conditions and actions. Choose features in the builder.

  • 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.
  • Up to 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. Select them in the firmware builder.
  • OTA of firmware and filesystem with onboarding-data preservation.
  • Voice assistants: Yandex Alice and Marusya.