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

Устройства в облаке

Откройте https://cloud.kavlev.ru/devices.html?project=<id>. На этой странице настраивается регистрация плат проекта. Плата и отдельное реле/датчик — разные сущности: группа содержит выбранные реле/датчики, а не всю плату целиком.

Добавить плату

Администратор или владелец нажимает «Добавить», задаёт UUID с физической платы, имя и тип. UUID можно получить в её настройках или через GET /api/v1/system/info. После создания облако показывает API key этой платы. Сохраните его в настройках облачного подключения именно этой платы вместе с адресом http://cloud.kavlev.ru:8081.

Ключ не является пользовательским токеном входа. При утрате или компрометации его можно ротировать; новый ключ нужно записать на плате. Регистрация сама по себе не подключает плату к Wi-Fi и не перепрошивает её.

Состояние и редактирование

Список показывает имя, UUID, тип и доступное состояние платы. Имя записи в облаке редактируется в облачном интерфейсе. Флаг отключения позволяет явно отметить плату как отключённую/на обслуживании. Информация о версии, IP и значениях приходит через heartbeat. Возраст heartbeat и свежесть отдельного сенсора различаются.

Откройте редактирование платы для просмотра устройств, задач, истории команд и OTA. Доступность действий определяется правами проекта и групп. Доступ к одному реле не разрешает перезагрузку всей платы или управление чужими сущностями. Назначение в группы выполняется через состав групп.

Команды и подтверждение

Переключение реле создаёт set_relay. Административные команды включают reboot, обновление и включение/выключение задач. Команда сначала находится в очереди, затем отдаётся плате через heartbeat. Отправка HTTP-запроса не доказывает физическое выполнение: проверяйте подтверждение, следующий state и фактическую нагрузку. Историю и отзыв команд также ограничивают права на соответствующие сущности.

У текущего механизма есть открытая проблема доставки при потерянном ответе heartbeat. Подробнее: команды и границы гарантий. Автоматическая безопасная повторная доставка пока не гарантируется. Критическое отключение по локальному датчику должно выполняться локальной автоматизацией.

OTA

Выберите прошивку подходящей платформы и следуйте стадиям обновления в интерфейсе. Облако ставит команды для файловой системы и приложения; плата загружает образы и проверяет размер/SHA256. Нужен согласованный комплект с совместимыми лимитами и плагинами. После обновления проверьте версию, задачи и свежие показания.

ESP-01S не предлагается как обычная firmware-OTA цель. Для первой установки, смены разметки и ESP-01S используйте USB/программатор. Удаление записи платы из облака не стирает её локальную файловую систему.