Изисквания към хардуера и мрежата

Системата е три неща: машина, която стои в мрежата ви и мисли; екран, който показва; и мрежа, която ги свързва. Ето какво реално се иска от всяко.

Сървърът

Bridge-ът е Node процес в локалната мрежа — обикновена машина (мини ПК или клас Raspberry Pi), не облак. Говори HTTP и SSE на порт 8787 (променлива PORT) и слуша всички интерфейси. Няма външни зависимости днес и няма база данни: правилата, сценариите, помещенията, профилите и интеграциите са JSON файлове, а историята е JSONL в HISTORY_DIR (по подразбиране bridge/history).

Мястото на диска се определя от честотата на пробите: 60 s (HISTORY_SAMPLE_MS) са 1440 реда на ден, с retention 7 дни сурови проби · 31 дни журнал · 13 месеца агрегации. При много уредби hourly.jsonl расте — това е известният остатък, за който е отворено решението за собствена база данни.

Екранът

Таблет със съвременен браузър, добавен към началния екран като standalone приложение: manifest с икони и display: standalone, service worker, който пази черупката. Киоск режим се пуска като четвърта задача на браузъра (chrome --kiosk … или msedge --kiosk --edge-kiosk-type=fullscreen --no-first-run https://<адрес-на-киоска>). Autostart и watchdog са описани за Windows Task Scheduler, Linux systemd (две услуги с Restart=always) и Android — рецептите са описани, но не са изпълнявани на реално устройство.

Важно: без HTTPS service worker-ът и PWA инсталацията съществуват само на localhost или зад собствен TLS терминатор. За офлайн черупка на таблет в LAN и двете са нужни.

Мрежата

• Клиентска изолация (AP isolation) в рутера — изключена, иначе киоскът не достига сървъра.
• Адресът на сървъра — постоянен IP или вътрешно DNS име; автоматично откриване на уредби и сървъри в LAN-а няма.
• Точките за достъп (Wi-Fi) и уредбите на една L2 мрежа; при зает канал SSE връзката пада и статус чипът показва retrying.
• За Matter — IPv6 в LAN-а и свободен UDP порт 5540 за контролера; без IPv6 контролерът стартира, но не вижда възела.
• За 2.4 GHz радио — Zigbee канал, различен от този на точките за достъп (например 15/20/25 срещу 1/6/11), и антена на координатора на разстояние от USB 3.0 портове, които шумят в същата лента.

Променливи, които решават поведението

На сървъра: PORT, BASE_TOPIC, MQTT_URL (зададена → реален broker, липсваща → симулатор), MQTT_USER/MQTT_PASS, BRIDGE_TOKEN, CORS_ORIGIN, SIMULATE, HISTORY_DIR, HISTORY_SAMPLE_MS, HISTORY_RAW_DAYS, HISTORY_EVENT_DAYS, HISTORY_ROLLUP_MONTHS, AUTOMATIONS_FILE, SCENES_FILE, ROOMS_FILE, INTEGRATIONS_FILE, USERS_FILE, MATTER, MATTER_DEVICES_FILE, MATTER_STORAGE_DIR, MATTER_PORT, MATTER_SAMPLE_MS, KIOSK_ADMIN_PIN, KIOSK_USER_PIN, KIOSK_GUEST_PIN (последните три се използват само при създаването на файла с профили).

На киоска: VITE_HOME_DRIVER (mock или bridge), VITE_HOME_BRIDGE_URL, VITE_HOME_BRIDGE_TOKEN, VITE_KIOSK_SW. Тези са build-time: смяната на IP-то на сървъра изисква rebuild — изграждането им в runtime е точка от пътна карта, не готова функция.

Какво не обещаем

• Конкретни модели уредби. Не публикуваме списък със съвместими модели, който не сме проверили; моделите на инвертора, термопомпата, камерите и KNX интерфейса се потвърждават при оглед на обекта.
• Собствен radio стек. Платформата няма радио и не планира такъв — 2.4 GHz, Z-Wave, 433 MHz, KNX, RS485/CAN влизат само през шлюз, а шлюз още няма (протоколи).
• Гласов асистент, план на дома в 3D, тъмна тема, известия извън дома.

За нагледно: как се пуска всичко това на обект, е описано стъпка по стъпка в Ръководството за инсталатора.