WF-1G1T-P и RealIoT: руководство по эксплуатации

WF-1G1T-P — это Wi-Fi устройство семейства WF1G1T с одним дискретным входом и температурным каналом. Ниже описана подтвержденная часть интеграции, которая уже отражена в текущем черновике руководства.

1. Что делает устройство

отслеживает состояние одного входа;
может просыпаться по изменению состояния входа;
передает данные в систему RealIoT по Wi-Fi через MQTT.

2. Входы и кнопка

Назначение	GPIO	Смысл
Дискретный вход	`GPIO26`	Контроль логического состояния контакта.
Кнопка BLE	`GPIO25`	Длинное нажатие запускает BLE-настройку, короткое используется для локальных действий устройства.

3. Что задается через BLE

При настройке устройства по BLE обычно передаются:

идентификация устройства;
SSID и пароль Wi-Fi;
адрес MQTT-сервера;
режим сна и период отправки;
подтверждение сохранения и перезапуск.

После подключения устройство сообщает готовность:

{"v":1,"messageType":"bleReady","status":"ok"}

Настройка питания и отправки

sleepMode — режим сна устройства: deep или none;
reportPeriodSec — как часто устройство должно отправлять периодический отчет.

Для WF-1G1T-P подтверждена работа дискретного входа. Блок по температурному каналу можно будет дополнить дальше через админку, не меняя шаблон страницы.

4. Что устройство передает по Wi-Fi

Сообщение meta

После настройки и подключения устройство публикует описание себя и стартовое состояние.

deviceSN, deviceType, deviceModel;
firmwareVersion, wifiAP, serverName;
sleepMode, sigEnabled, reportPeriodSec;
contact, rssi, batteryVoltage.

Рабочие данные

contact — текущее состояние входа: true или false;
rssi — уровень Wi-Fi сигнала;
batteryVoltage — напряжение батареи.

5. Как понимать поле contact

Поле contact показывает итоговое подтвержденное состояние входа. Если вход замкнут и устройство считает это активным состоянием, в пакете будет true. Если вход разомкнут — false.

6. Что происходит после изменения контакта

Устройство фиксирует изменение входа.
При подтвержденном изменении просыпается или запускает отправку.
Передает новое состояние contact.

7. MQTT топики

Назначение	Топик
Состояние	`wifi/<SN>`
Метаданные	`wifi/<SN>/meta`

8. Пример применения

контроль открытия двери или люка;
контроль состояния геркона;
передача сигнала от сухого контакта внешнего датчика.

9. Типичные ошибки

Ожидание счетных полей от этой модели. У семейства WF1G1T их нет.
Неверное подключение сухого контакта без учета требуемой логики уровня.
Ожидание мгновенной отправки при слишком длинном периоде отчета в режиме без событий.

10. Итог

WF-1G1T-P — это Wi-Fi устройство семейства WF1G1T. Пользователь настраивает подключение по BLE, а затем получает по Wi-Fi состояние входа в виде поля contact. Тепловой канал будет дополнен в дальнейшей редакции руководства.

WF-1G1T-P и система RealIoT