Files
buryan-infra/ops/home/HOUSE3D-PROTOTYPE.md
T

6.9 KiB
Raw Blame History

3D-карта в Home Assistant — прототип (31.10.2026)

Что сделано

Компонент Где
three.min.js (r160) /config/www/house3d/three.min.js (в HA)
Карта house3d-card.js /config/www/house3d/house3d-card.js
Ресурс Lovelace /local/house3d/house3d-card.js (тип js)
Дашборд Дом 3D, url_path house-3d, страница /house-3d/home

Что умеет прототип

  • настоящая 3D-сцена (three.js) внутри HA: комната, стены, окно, мебель, светильник;
  • вращение мышью/пальцем, зум колесом;
  • клик по светильнику → вызов hass.callService(domain, service, {entity_id});
  • цвет и яркость светильника меняются по hass.states (обратная связь из HA);
  • карта параметризована: entity, domain, service, title.

Важная находка: устройства Яндекса в HA — только для чтения

light.svet_v_tambure... имеет supported_features = 0, команды light.turn_off не меняют состояние; switch.uvlazhnitel... — то же. То есть текущие Яндекс-устройства не управляются из HA, только отображаются.

Следствие: для дашборда с реальной обратной связью нужны управляемые устройства — Zigbee-реле/розетки из плана закупки (или отдельная задача по интеграции Яндекс-устройств на запись).

Для демонстрации цикла выбрана безопасная управляемая сущность switch.qbittorrent_alternative_speed (проверено: переключение работает).

Следующие шаги

  1. Исправить геометрию дома в Blender и экспортировать GLB (low-poly).
  2. Карта: загрузка GLB, комнаты как отдельные меши, подсветка при наведении.
  3. Привязки комнат и сущностей (areas/entities), панель комнаты с устройствами.
  4. Живые эффекты: цвет комнаты по температуре/влажности, день/ночь.
  5. Решить вопрос управляемости Яндекс-устройств (или ждать Zigbee-реле).

v6 — исправление ощущения «долго применяется» (31.10.2026)

Проблема: чип «применяется…» держался до подтверждения устройства (AdGuard ≈1 с, qBittorrent 3–10 с) — интерфейс выглядел медленным, хотя сцена перерисовывалась за 0 мс.

Решение: чип гаснет сразу после принятия команды HA (≤0.1 с) и показывает «применено»; сверка с фактическим состоянием идёт в фоне (до 8 с) и при расхождении тихо откатывает сцену. Замеры в карте: «сцена N мс · отклик M мс».

Замеры латентности (проверено curl по REST API HA):

Сущность Вызов сервиса Обновление состояния
qBittorrent switch 0.00 с 3–10 с (опрос)
AdGuard switch 0.00 с ≈1 с
Zigbee-реле (план) — ожидается 0.3–1 с
Яндекс-устройства команды не применяются supported_features=0

v7 — реальная модель дома в карте (31.10.2026)

Сделано:

Компонент Файл / место
Blender-сцена (солидные стены + булевы проёмы) ops/home/plans/house_scene4.py
Модель для веба (GLB, 270 КБ) /config/www/house3d/house.glb
three.js r140 + GLTFLoader (UMD) /config/www/house3d/three.min.js, GLTFLoader.js
Карта v7 (грузит GLB, клик по дому) /config/www/house3d/house3d-card.js?v=7
Рендеры ops/home/plans/render-front.png, render-terrace.png

Ловушки:

  • в Debian-сборке Blender нет OpenImageDenoise → денойз отключён, шум гасится числом сэмплов;
  • экспорт GLB требует numpy — поставили python3-numpy и запускаем Blender с PYTHONPATH=/usr/lib/python3/dist-packages;
  • UMD-сборка GLTFLoader есть только до three r0.147 — взяли r0.140 (examples/js/loaders/GLTFLoader.js), иначе 404;
  • Plane/path из GLB в карте удаляются — земля и сетка создаются в сцене.

Геометрия: блок 12,1 × 8,5 м, терраса 2,4 м с запада, крыльцо с юга, тех.пом. с севера, сваи, двускатная кровля с коньком вдоль длинной оси.

Что осталось отполировать: фактура металла «шумит» (bump слишком резкий), крыльцо и ограждение террасы — черновые, окна без рам.

v8 — модель пересобрана по фотографиям (31.10.2026)

Владелец прислал 9 фото фасадов; выяснилось, что в первых версиях было неверно:

Было Стало (по фото)
терраса вдоль длинной стороны терраса на западном торце, под продолжением ската
бетонные сваи-цилиндры крупные ЖБ сваи 150×150 (34 шт), цоколь не зашит
вход на торце вход с козырьком и ступенями на южной стороне
пристройка сбоку тех.пом. с восточного торца, своя кровля
фасад «шумный» серый тёмный графит с вертикальной полосой (RAL 7024)

Главная ловушка: primitive_cube_add(size=1) + scale = полуразмер даёт куб ВДВОЕ меньше — из-за этого вся модель «разваливалась» на плиты. Правильно: size=2 (тогда scale — полуразмер).

Файлы: house_scene6.py, house.glb (244 КБ), карта /local/house3d/house3d-card.js?v=8. Фото фасадов: ops/home/plans/photos/facade-*.jpg.