Устройства (облако)¶

https://cloud.kavlev.ru/devices.html?project=<id> — все платы проекта, с фильтрами и групповыми действиями.

Список¶

Таблица:

Колонка	Что
UUID	Короткая форма (первые 8 символов). Полная — в tooltip.
Имя	Из device_config платы. Меняется на самой плате (плата на следующем heartbeat'е принесёт обновление).
Группа	Группа устройств. Можно менять прямо здесь.
Статус	🟢 online (heartbeat ≤ 2× interval) / 🟡 idle (≤ 5×) / 🔴 offline (> 5×)
fw_version	Версия прошивки из последнего heartbeat'а
IP	Локальный IP платы (для понимания где она находится)
Last seen	Давность последнего heartbeat'а
Действия	Открыть детальную / удалить из проекта

Фильтры¶

По группе — dropdown сверху.
По статусу — three-state checkbox (online/idle/offline).
Поиск по имени / UUID — текстовое поле, частичное совпадение.

Детальная страница¶

Клик по строке устройства → device.html?id=<N>. Что показывает:

Текущее состояние¶

Из последнего heartbeat'а:

Все реле с текущим положением
Все датчики со значением и единицей
Краткие саммари задач (имя, последнее срабатывание)
Возраст данных (updated 3s ago)

Команды¶

Очередь команд для этой платы:

Статус	Что значит
`pending`	Создана, ждёт следующего heartbeat'а
`sent`	Отдана плате, ждём `applied_command_ids`
`applied`	Плата подтвердила выполнение
`expired`	TTL истёк (1 час) до доставки — отвалилась
`revoked`	Отозвана вручную

Кнопка + Новая команда — типы:

set_relay — установить состояние реле
reboot — перезагрузка платы
ota_update — обновить firmware (открывает picker прошивок)
ota_fs_update — обновить FS-image

Heartbeat-таймлайн¶

Последние ~50 heartbeat'ов с временными метками. Полезно понять: «была ли плата онлайн в момент X?», «какой состояние реле было в момент Y?».

Полная история ограничена 24 часами — после этого старые записи чистятся cron-job'ом cleanup_heartbeats.py.

OTA¶

Список доступных прошивок для платформы платы (определяется по fw_version):

Колонка	Что
Версия	`v0.4.7-esp8266`, `v0.5.0-esp32`
Канал	`stable` / `beta` / `dev`
Дата	Когда сборка добавлена
Размер	МБ
Release notes	Из RELEASES.md прошивки

Кнопка 🚀 Применить — создаёт команды ota_update (firmware) и опционально ota_fs_update (filesystem). На следующем heartbeat'е плата получит их и начнёт скачивать.

Заметки¶

Текстовое поле, привязанное к этой плате. Изменения уходят email-нотификацией другим участникам проекта.

Удалить плату из проекта¶

Не путать с factory-reset платы. Удаление из облака значит: плата перестаёт быть видна в этом проекте, история чистится, но сама плата как работала так и работает (просто её heartbeat'ы теперь будут возвращать 404).

Чтобы плата ушла окончательно и не возвращалась — после удаления из проекта очистить project_api_key на самой плате через её UI → Облако.

API за этой страницей¶

См. API → Devices.