Сеть и mesh

http://<ip-платы>/network.html — admin-only. Параметры UDP-стека для общения с соседними платами.

Блок «Self»

Read-only информация о текущей плате.

Поле	Назначение
UUID	Идентификатор платы (тот же что в Настройках → Устройство).
Имя	Из тех же настроек.
Mode	Текущий режим Wi-Fi: STA (подключена) или AP (поднимает свой AP). В AP-режиме mesh между другими платами не работает (нет broadcast'а в локалку).
IP	Текущий IP в STA-режиме.

Блок «Соседи»

Таблица плат, от которых пришёл валидный mesh-пакет за последние ~60 секунд:

Колонка	Что
UUID	Кто прислал
Имя	Имя платы (поле name из его device_config)
IP	С какого IP пришёл
Last seen	Секунд назад был последний валидный пакет

Невалидные пакеты (с неверной подписью) отбрасываются молча — UI их не показывает. Это значит ваш network_secret не совпадает с тем, что у соседа.

Параметры UDP

Поле	Назначение
Mode	multicast (по умолчанию) или broadcast
Multicast group	IP мультикаст-группы. Дефолт 224.0.13.31. Менять только если совпадает с другим продуктом в вашей сети.
Port	UDP-порт. Дефолт 13031. Должен совпадать на всех платах в одной mesh-группе.

Multicast vs broadcast:

• multicast (224.x.x.x) — современный способ. Большинство роутеров его пропускают, в Wi-Fi сегменте работает из коробки.
• broadcast (255.255.255.255 или broadcast_ip из device_config) — fallback. Иногда лучше работает в гостевых сетях / сегментированных VLAN.

Если соседи не видят друг друга при multicast — попробуйте broadcast.

Network secret

Главный секрет mesh-группы. Без правильного network_secret плата отбросит чужой пакет.

Поле	Назначение
Текущий ключ	Read-only, можно скопировать кнопкой 📋
Новый ключ	Поле ввода + кнопка «Применить»

Формат: 64-символьная hex-строка (32 байта).

Генерация нового

Если ничего не задано — на первом запуске плата генерирует случайные 32 байта. Чтобы объединить несколько плат в одну mesh-группу: возьмите ключ одной (📋), вставьте в другую.

Можно сгенерировать с компьютера:

openssl rand -hex 32

Что меняется при смене ключа

После применения нового network_secret:

• Плата начнёт подписывать свои пакеты новым ключом.
• Старые соседи перестанут понимать её, она перестанет понимать их (пока они не получат новый ключ).
• Применение мгновенное (не нужен ребут).

Зачем мне это меняить

Сценарий	Что делать
Развернул первую плату	Ничего — она сама сгенерировала ключ.
Добавил вторую плату	Скопировать ключ с первой во вторую — обе войдут в одну группу.
Сосед/гость должен подключиться к моей mesh-группе	Скопировать ваш ключ ему.
Хочу разделить сеть на две группы	На одной части плат сгенерировать новый ключ, не делиться им с другой частью.
Подозреваю утечку ключа	Сгенерировать новый и обновить везде.

Что передаётся по mesh

Точно: события задач (udp_send action и udp_event trigger). Каждое — JSON-пакет вида:

{
  "from": "<uuid>",
  "ts": 1778080000,
  "event": "motion_outside",
  "payload": "..."
}

Подписывается HMAC-SHA256(payload, network_secret) и шлётся по UDP. Без правильной подписи — отброс.

Размер пакета — ограничен MTU UDP (обычно 1472 байт). На практике события короткие, лимит не упирается.

Диагностика

• Сосед не видится. Проверьте: одна Wi-Fi сеть (один сегмент)? одинаковый port, multicast_group, network_secret? Не отрезает ли роутер multicast (некоторые гостевые/firewall-режимы делают это)?
• Видится, но триггер не срабатывает. Проверьте имя события (event) — оно должно совпадать в udp_send (отправитель) и udp_event (получатель).
• Самотест. На отправителе — нажмите «▶ Запустить сейчас» в задаче с udp_send. На получателе — смотрите RAM-лог; там будет видно прилёт пакета.

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

См. API → Mesh / Network.