Интеграция XIOT с Apple HomeKit

Интеграция позволяет добавить устройства проекта XIOT в приложение Apple «Дом» через один программный мост HomeKit, работающий на контроллере XIOT-PLC.

Доступно начиная с версии редактора XIOT 14.1-3.

На иллюстрации показаны демонстрационные данные сопряжения. Используйте PIN-код и QR-код, отображаемые в вашем проекте.

Подключение

Откройте раздел Драйверы → HomeKit.
Включите HomeKit. При необходимости нажмите Изменить и задайте новый PIN-код.
Сохраните проект и загрузите его в PLC.
Дождитесь статуса Готов. PLC и iPhone или iPad должны находиться в одной локальной сети.
В приложении Apple «Дом» выберите добавление аксессуара и отсканируйте QR-код. Если камера не распознаёт код, введите показанный PIN-код вручную.

После сопряжения все поддерживаемые устройства проекта добавляются через один мост XIOT. Названия устройств передаются из проекта XIOT.

Важно: комнаты Apple «Дом» принадлежат конфигурации конкретного дома Apple и не назначаются мостом по протоколу HomeKit. Поэтому при первом добавлении приложение может попросить выбрать комнату отдельно для каждого аксессуара. Этажи и комнаты проекта XIOT автоматически не переносятся.

Доступные устройства

Мост передаёт следующие виртуальные устройства XIOT:

Устройство	Доступные функции в Apple «Дом»
Свет	Включение и выключение, изменение яркости. Для цветных светильников также передаются оттенок и насыщенность.
Выключатель	Включение и выключение.
Розетка	Включение и выключение, состояние использования.
Вентилятор	Включение и выключение, скорость и направление вращения.
Шторы	Целевое и текущее положение, состояние движения и горизонтальный наклон, если соответствующие характеристики используются в проекте.
Экран кинотеатра	Открытие, закрытие, целевое и текущее положение.
Реле	Включение и выключение.
Насос	Включение и выключение.
Сирена	Включение и выключение.
Зуммер	Включение и выключение.
Кран	Открытие и закрытие.
Сервопривод	Открытие и закрытие.
Клапан вентиляции	Открытие и закрытие.
Тёплый пол	Включение и выключение, текущая и заданная температура, состояние нагрева.
Радиатор	Включение и выключение, текущая и заданная температура, состояние нагрева.
Конвектор	Включение и выключение, текущая и заданная температура, состояние нагрева.
Увлажнитель	Включение и выключение, текущая и заданная влажность, состояние увлажнения.
Приточная вентиляция	Включение и выключение, скорость вентилятора.
Кнопка	Одиночное, двойное и долгое нажатие. Эти события можно использовать в автоматизациях Apple «Дом».
Датчик температуры	Текущая температура.
Датчик влажности	Текущая относительная влажность.
Датчик движения	Обнаружение движения.
Геркон	Открытое или закрытое состояние двери либо окна.
Датчик протечки	Обнаружение протечки.
Датчик дыма	Обнаружение дыма.
Датчик освещённости	Текущая освещённость.
Датчик качества воздуха	Уровень качества воздуха и плотность летучих органических соединений.
Датчик углекислого газа	Обнаружение повышенного уровня и текущая концентрация углекислого газа.

Если отдельная необязательная характеристика устройства отключена в проекте, она не добавляется в HomeKit.

Тройное нажатие кнопки пока не передаётся: стандартная кнопка HomeKit поддерживает одиночное, двойное и долгое нажатие.

Какие устройства пока не передаются

В текущей реализации ещё не добавлены:

кондиционер и климат-контроль — требуется корректно объединить режимы включения, нагрева, охлаждения и вентиляции с режимами Apple «Дом»;
видеокамера — требуется отдельная передача видеопотока;
пульт и плеер — требуется отдельная реализация мультимедийного управления;
датчик шума, датчик давления, датчик дождя, датчик ветра и датчик конденсата — в Apple «Дом» нет прямого стандартного аналога для всех этих показаний;
счётчик воды, счётчик электроэнергии, вольтметр, амперметр и ваттметр — стандартное приложение Apple «Дом» не отображает такие измерения как обычные аксессуары.

Дом, часть дома и комната описывают структуру проекта XIOT и самостоятельными аксессуарами HomeKit не являются.

Статусы

Выключен — мост отключён в проекте.
Запуск — служба HomeKit запускается на PLC.
Готов — мост работает; можно сканировать QR-код или управлять уже добавленными устройствами.
Ошибка — мост не запущен; текст причины передаётся редактору с PLC.
Нет связи — редактор не получает актуальное состояние от PLC. Этот статус сам по себе не означает, что уже сопряжённый мост HomeKit остановлен.

Изменение PIN-кода и повторное сопряжение

PIN-код должен иметь формат XXX-XX-XXX. После его изменения сохраните и повторно загрузите проект в PLC.

Данные сопряжения сохраняются на контроллере между перезапусками. Если мост уже был добавлен в Apple «Дом», обычная перезагрузка PLC не требует повторного добавления аксессуара. Для полного повторного сопряжения сначала удалите мост из приложения Apple «Дом», затем сбросьте сохранённое состояние HomeKit на контроллере и добавьте мост заново.