Устройства в облаке¶
Откройте 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/программатор. Удаление записи платы из облака не стирает её локальную файловую систему.