Настройка модуля
Настройка модуля Xiaomi miIO заключается в указании базовых настроек самого модуля, проверке запуска цикла модуля и индивидуальной настройке каждого из устройств.
Базовые настройки модуля
Окно настроек модуля
Необходимо указать для корректной работы на сервере с двумя и более сетевыми интерфейсами. Если интерфейс один, то указывать ничего не требуется.
Период (в секундах) поиска устройств в сети с помощью широковещательного запроса. Механизм предназначен для поиска новых устройств, определения доступности (онлайн/оффлайн) уже имеющихся устройств и обновления их IP-адресов. По умолчанию установлен в 2 минуты (120 секунд). При необходимости допускается изменять его в сторону увеличения или уменьшения. Но крайне не желательно выставлять меньше, чем значение по умолчанию. Укажите 0, чтобы выключить данный механизм. Для вступления изменений в силу требуется перезапустить цикл.
Отладка DebMes
Запись обмена сообщениями между сервером и устройствами в отдельный лог-файл YYYY-mm-dd_xiaomimiio.log. Для вступления изменений в силу требуется перезапустить цикл.
Отладка miIO-Lib
Запись отладочных сообщений библиотеки miIO-Lib в отдельный лог-файл цикла log_YYYY-mm-dd-cycle_xiaomimiio.php.txt. Для вступления изменений в силу требуется перезапустить цикл. Не следует включать этот вид лога на продолжительное время, т. к. он генерирует очень большой объем отладочных сообщений!
Отладка Cycle
Запись отладочных сообщений цикла в отдельный лог-файл log_YYYY-mm-dd-cycle_xiaomimiio.php.txt. Для вступления изменений в силу требуется перезапустить цикл.
Состояние цикла
Состояние цикла модуля отображается в виде индикатора в интерфейсе модуля.
Цикл модуля запущен
Цикл модуля остановлен
Для корректной работы модуля цикл должен быть всегда запущен. Если после установки модуля цикл не запустился автоматически, то его запуск можно инициировать сохранением настроек модуля (клик по кнопке Обновить в настройках) или через штатный механизм управления циклами MajorDoMo в модуле XRay на вкладке Services (клик по кнопке Start в строке с названием cycle_xiaomimiio).
Управление циклами MajorDoMo
Запуск цикла модуля Xiaomi miIO
Расширенные настройки модуля
Таймаут чтения из сокета
Время (в секундах) ожидания ответа от устройства на отправленную ему команду. Минимальное значение - 1 сек., максимальное - 10 сек, значение по умолчанию - 2 сек. Менять только при крайней необходимости и с пониманием возможных последствий! Это актуально для тех, у кого есть "тормозные" устройства (например, пылесос), которые не могут ответить на отправленный им запрос за 2 секунды, в связи с чем возникает ошибка Device not answered. Данной опцией можно увеличить это время. Но следует понимать, что если выставить, к примеру 5 сек, и опрашивать при этом оффлайн устройства, то цикл модуля будет блокироваться на 5 секунд при ожидании ответа от каждого устройства в оффлайне! При нормально работающей сети время ответа живых (онлайн) устройств гораздо меньше 1 секунды.
Индивидуальные настройки устройств
Настройка каждого устройства в отдельности выполняется через редактирование его свойств.
Редактирование настроек устройства
На вкладке Общее есть три параметра, которые требуется настроить перед началом работы.
Индивидуальные настройки устройства
Токен
Неотъемлемая часть устройства. Без токена модуль не сможет взаимодействовать с устройством. В некоторых редких случаях модуль может автоматически получить токен устройств, во всех остальных случаях выяснять его необходимо вручную. Подробнее о токенах и способах их получения читаем здесь.
Тип
Тип (модель) устройства выбирается из выпадающего списка. Тип устройства определяет набор API-команд и метрик (свойств, состояний) каждой конкретной модели устройства. Если нужного устройства нет в выпадающем списке, то можно попробовать указать родственное устройство из той же линейки. Особенно это актуально для лампочек и светильников, т. к. у большинства из них одинаковые API-команды и метрики.
Период опроса
Период опроса задается в секундах. По умолчанию периодический опрос выключен (0 сек). Периодический опрос (поллинг, polling) устройств со стороны модуля требуется для получения их актуального состояния. Это вынужденная мера, т. к. сами устройства не шлют изменения своих состояний в локальную сеть (на сервер УД) по протоколу miIO. Значение величины периодического опроса следует выбирать из принципа минимальной достаточности и здравой логики. Не следует выставлять его слишком маленьким, и тем самым DDoS-ить устройства, нагружать сервер УД и локальную сеть. Значения меньше 10 секунд не рекомендуются.
IP адрес устройства определяется и заполняется модулем автоматически во время процедуры поиска устройств в локальной сети.
Название устройства изначально формируется автоматически. Его рекомендуется изменить на что-то осмысленное и понятное.