Текущая версия от 22:28, 2 октября 2026

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

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

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

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

Подключение

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

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

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

Передача владельцу

Рекомендуемый вариант: интегратор включает HomeKit, загружает проект в PLC и дожидается статуса Готов, но не добавляет мост в свой «Дом». В редакторе нажмите Скачать памятку владельцу и передайте полученный файл владельцу по защищённому каналу. В файле будут QR-код, PIN-код и пошаговая инструкция.

QR-код и PIN-код следует считать конфиденциальными: с их помощью можно добавить мост в Apple «Дом», пока он не сопряжён.

Если интегратор уже привязал мост

Для проверки на своём iPhone интегратор может временно добавить мост. Перед передачей владельцу:

На iPhone интегратора откройте Apple «Дом», перейдите в настройки моста XIOT и удалите его из «Дома».
В редакторе XIOT откройте Драйверы → HomeKit и дождитесь статуса Готов. При обычном удалении Apple «Дом» сам сообщает PLC об отвязке.
Если статус остался Подключен или доступа к старому «Дому» нет, нажмите Сбросить сопряжение. PLC удалит все сохранённые ключи.
Дождитесь статуса Готов. Мост снова можно добавить.
Скачайте памятку и передайте её владельцу.

Если не удалить мост из «Дома» интегратора до сброса, на его телефоне может остаться нерабочая старая запись.

Мост должен быть сопряжён с «Домом» владельца. После этого владелец может приглашать других пользователей через настройки Apple «Дом». Повторно сканировать QR-код на каждом телефоне не нужно.

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

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

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

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

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

Климатические устройства

Кондиционер добавляется как устройство нагрева и охлаждения. Из Apple «Дом» можно менять питание, температуру, скорость вентилятора и выбирать автоматический режим, нагрев или охлаждение.
Режимы вентиляции и осушения не имеют отдельных стандартных режимов для такого типа устройства в Apple «Дом», поэтому они остаются доступны только в XIOT.
Радиатор и тёплый пол добавляются как термостаты только с режимом нагрева. Режимы охлаждения и автоматического переключения для них не предлагаются.
Диапазон заданной температуры для этих устройств — от 16 до 26 °C с шагом 0,5 °C.

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

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

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

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

Статусы

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

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

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

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

@@ Строка 1: / Строка 1: @@
+{{DISPLAYTITLE:Интеграция с Apple HomeKit}}
 __NOTOC__
 = Интеграция XIOT с Apple HomeKit =
@@ Строка 18: / Строка 19: @@
 # В приложении Apple «Дом» выберите добавление аксессуара и отсканируйте QR-код. Если камера не распознаёт код, введите показанный PIN-код вручную.
-После сопряжения все поддерживаемые устройства проекта добавляются через один мост XIOT. Названия устройств передаются из проекта XIOT.
+После сопряжения статус изменится на '''Подключен''', а QR-код будет скрыт. Все поддерживаемые устройства проекта добавляются через один мост XIOT. Названия устройств передаются из проекта XIOT.
-'''Важно:''' комнаты Apple «Дом» принадлежат конфигурации конкретного дома Apple и не назначаются мостом по протоколу HAP. Поэтому при первом добавлении приложение может попросить выбрать комнату отдельно для каждого аксессуара. Этажи и комнаты проекта XIOT автоматически не переносятся.
+'''Важно:''' комнаты Apple «Дом» принадлежат конфигурации конкретного дома Apple и не назначаются мостом по протоколу HomeKit. Поэтому при первом добавлении приложение может попросить выбрать комнату отдельно для каждого аксессуара. Этажи и комнаты проекта XIOT автоматически не переносятся.
+== Передача владельцу ==
+Рекомендуемый вариант: интегратор включает HomeKit, загружает проект в PLC и дожидается статуса '''Готов''', но не добавляет мост в свой «Дом». В редакторе нажмите '''Скачать памятку владельцу''' и передайте полученный файл владельцу по защищённому каналу. В файле будут QR-код, PIN-код и пошаговая инструкция.
+'''QR-код и PIN-код следует считать конфиденциальными:''' с их помощью можно добавить мост в Apple «Дом», пока он не сопряжён.
+=== Если интегратор уже привязал мост ===
+Для проверки на своём iPhone интегратор может временно добавить мост. Перед передачей владельцу:
+# На iPhone интегратора откройте Apple «Дом», перейдите в настройки моста XIOT и удалите его из «Дома».
+# В редакторе XIOT откройте '''Драйверы → HomeKit''' и дождитесь статуса '''Готов'''. При обычном удалении Apple «Дом» сам сообщает PLC об отвязке.
+# Если статус остался '''Подключен''' или доступа к старому «Дому» нет, нажмите '''Сбросить сопряжение'''. PLC удалит все сохранённые ключи.
+# Дождитесь статуса '''Готов'''. Мост снова можно добавить.
+# Скачайте памятку и передайте её владельцу.
+Если не удалить мост из «Дома» интегратора до сброса, на его телефоне может остаться нерабочая старая запись.
+Мост должен быть сопряжён с «Домом» владельца. После этого владелец может приглашать других пользователей через настройки Apple «Дом». Повторно сканировать QR-код на каждом телефоне не нужно.
 == Доступные устройства ==
-В версии 14.1-3 мост передаёт следующие типы виртуальных устройств XIOT:
+Мост передаёт следующие виртуальные устройства XIOT:
 {| class="wikitable"
-! Устройство XIOT !! Представление в Apple «Дом» !! Передаваемые функции
+! Устройство !! Доступные функции в Apple «Дом»
+|-
+| '''Свет''' || Включение и выключение, изменение яркости. Для цветных светильников также передаются оттенок и насыщенность.
+|-
+| '''Выключатель''' || Включение и выключение.
+|-
+| '''Розетка''' || Включение и выключение, состояние использования.
+|-
+| '''Вентилятор''' || Включение и выключение, скорость и направление вращения.
+|-
+| '''Шторы''' || Целевое и текущее положение, состояние движения и горизонтальный наклон, если соответствующие характеристики используются в проекте.
+|-
+| '''Экран кинотеатра''' || Открытие, закрытие, целевое и текущее положение.
+|-
+| '''Реле''' || Включение и выключение.
+|-
+| '''Насос''' || Включение и выключение.
+|-
+| '''Сирена''' || Включение и выключение.
+|-
+| '''Зуммер''' || Включение и выключение.
+|-
+| '''Кран''' || Открытие и закрытие.
+|-
+| '''Сервопривод''' || Открытие и закрытие.
+|-
+| '''Клапан вентиляции''' || Открытие и закрытие.
+|-
+| '''Кондиционер''' || Включение и выключение, текущая и заданная температура, автоматический режим, нагрев, охлаждение, текущее состояние работы и скорость вентилятора.
+|-
+| '''Тёплый пол''' || Включение и выключение, текущая и заданная температура, состояние нагрева.
 |-
-| '''Lightbulb''' || Лампа || включение и выключение, яркость
+| '''Радиатор''' || Включение и выключение, текущая и заданная температура, состояние нагрева.
 |-
-| '''Switch''' || Выключатель || включение и выключение
+| '''Конвектор''' || Включение и выключение, текущая и заданная температура, состояние нагрева.
 |-
-| '''Outlet''' || Розетка || включение и выключение, состояние использования
+| '''Увлажнитель''' || Включение и выключение, текущая и заданная влажность, состояние увлажнения.
 |-
-| '''Fan''' || Вентилятор || включение и выключение, скорость, направление вращения
+| '''Приточная вентиляция''' || Включение и выключение, скорость вентилятора.
 |-
-| '''WindowCovering''' || Шторы/жалюзи || целевое и текущее положение, состояние движения, горизонтальный наклон при наличии характеристик
+| '''Кнопка''' || Одиночное, двойное и долгое нажатие. Эти события можно использовать в автоматизациях Apple «Дом».
 |-
-| '''TemperatureSensor''' || Датчик температуры || текущая температура
+| '''Датчик температуры''' || Текущая температура.
 |-
-| '''HumiditySensor''' || Датчик влажности || текущая относительная влажность
+| '''Датчик влажности''' || Текущая относительная влажность.
 |-
-| '''MotionSensor''' || Датчик движения || обнаружение движения
+| '''Датчик движения''' || Обнаружение движения.
 |-
-| '''ContactSensor''' || Датчик открытия || состояние контакта
+| '''Геркон''' || Открытое или закрытое состояние двери либо окна.
 |-
-| '''LeakSensor''' || Датчик протечки || обнаружение протечки
+| '''Датчик протечки''' || Обнаружение протечки.
 |-
-| '''SmokeSensor''' || Датчик дыма || обнаружение дыма
+| '''Датчик дыма''' || Обнаружение дыма.
 |-
-| '''LightSensor''' || Датчик освещённости || текущая освещённость
+| '''Датчик освещённости''' || Текущая освещённость.
 |-
-| '''AirQualitySensor''' || Датчик качества воздуха || индекс качества воздуха, плотность VOC
+| '''Датчик качества воздуха''' || Уровень качества воздуха и плотность летучих органических соединений.
 |-
-| '''CarbonDioxideSensor''' || Датчик CO₂ || обнаружение повышенного уровня и текущая концентрация CO₂
+| '''Датчик углекислого газа''' || Обнаружение повышенного уровня и текущая концентрация углекислого газа.
 |}
-Внутренние совместимые типы '''Curtains''', '''DayСurtains''' и '''Jalousie''' передаются как '''WindowCovering'''.
+Если отдельная необязательная характеристика устройства отключена в проекте, она не добавляется в HomeKit.
+Тройное нажатие кнопки пока не передаётся: стандартная кнопка HomeKit поддерживает одиночное, двойное и долгое нажатие.
-Если отдельная необязательная характеристика устройства отключена в проекте, она не добавляется в HomeKit.
+=== Климатические устройства ===
+* '''Кондиционер''' добавляется как устройство нагрева и охлаждения. Из Apple «Дом» можно менять питание, температуру, скорость вентилятора и выбирать автоматический режим, нагрев или охлаждение.
+* '''Режимы вентиляции и осушения''' не имеют отдельных стандартных режимов для такого типа устройства в Apple «Дом», поэтому они остаются доступны только в XIOT.
+* '''Радиатор''' и '''тёплый пол''' добавляются как термостаты только с режимом нагрева. Режимы охлаждения и автоматического переключения для них не предлагаются.
+* Диапазон заданной температуры для этих устройств — от 16 до 26 °C с шагом 0,5 °C.
 == Какие устройства пока не передаются ==
-Проверка набора виртуальных устройств XIOT показала, что в версии 14.1-3 в мост ещё не добавлены:
+В текущей реализации ещё не добавлены:
-* климатическое оборудование: '''Conditioner''', '''FloorHeat''', '''ClimateControl''', '''Radiator''', '''Convector''', '''Humidifier''', '''Breezer''';
-* исполнительные устройства: '''WaterFaucet''', '''Relay''', '''Pump''', '''Servo''', '''VentilationValve''', '''Siren''', '''Buzzer''', '''MovieScreen''';
-* органы управления и мультимедиа: '''PushButton''', '''RemoteControl''', '''Player''', '''VideoCam''';
-* дополнительные датчики: '''NoiseSensor''', '''PressureSensor''', '''RainSensor''', '''WindSensor''', '''CondensateSensor''';
-* счётчики и измерители: '''WaterMeter''', '''EnergyMeter''', '''VoltMeter''', '''Ammeter''', '''Wattmeter'''.
-Для климата, клапанов, кнопок и части исполнительных устройств в HomeKit существуют стандартные сервисы, поэтому их можно добавить в следующих версиях моста. Для камер, мультимедиа, нестандартных датчиков и счётчиков требуется отдельная реализация или согласованное представление, поскольку приложение Apple «Дом» не имеет прямого стандартного аналога для каждой характеристики XIOT.
+* '''климат-контроль''' — это сценарий координации нескольких устройств, а не отдельный стандартный аксессуар Apple «Дом»;
+* '''видеокамера''' — требуется отдельная передача видеопотока;
+* '''пульт''' и '''плеер''' — требуется отдельная реализация мультимедийного управления;
+* '''датчик шума''', '''датчик давления''', '''датчик дождя''', '''датчик ветра''' и '''датчик конденсата''' — в Apple «Дом» нет прямого стандартного аналога для всех этих показаний;
+* '''счётчик воды''', '''счётчик электроэнергии''', '''вольтметр''', '''амперметр''' и '''ваттметр''' — стандартное приложение Apple «Дом» не отображает такие измерения как обычные аксессуары.
-Сущности '''Home''', '''Floor''' и '''Room''' описывают структуру проекта и самостоятельными аксессуарами HomeKit не являются.
+Дом, часть дома и комната описывают структуру проекта XIOT и самостоятельными аксессуарами HomeKit не являются.
 == Статусы ==
@@ Строка 80: / Строка 136: @@
 * '''Выключен''' — мост отключён в проекте.
 * '''Запуск''' — служба HomeKit запускается на PLC.
-* '''Готов''' — мост работает; можно сканировать QR-код или управлять уже добавленными устройствами.
+* '''Готов''' — мост работает, но ещё не сопряжён; можно сканировать QR-код.
+* '''Подключен''' — мост уже добавлен в Apple «Дом»; QR-код скрыт, а для новой привязки нужен сброс сопряжения.
 * '''Ошибка''' — мост не запущен; текст причины передаётся редактору с PLC.
 * '''Нет связи''' — редактор не получает актуальное состояние от PLC. Этот статус сам по себе не означает, что уже сопряжённый мост HomeKit остановлен.
@@ Строка 88: / Строка 145: @@
 PIN-код должен иметь формат <code>XXX-XX-XXX</code>. После его изменения сохраните и повторно загрузите проект в PLC.
-Данные сопряжения сохраняются на контроллере между перезапусками. Если мост уже был добавлен в Apple «Дом», обычная перезагрузка PLC не требует повторного добавления аксессуара. Для полного повторного сопряжения сначала удалите мост из приложения Apple «Дом», затем сбросьте сохранённое состояние HomeKit на контроллере и добавьте мост заново.
+Данные сопряжения сохраняются на контроллере между перезапусками. Если мост уже был добавлен в Apple «Дом», обычная перезагрузка PLC не требует повторного добавления аксессуара. Для полного повторного сопряжения используйте кнопку '''Сбросить сопряжение''' в разделе HomeKit.
 [[Category:XIOT-PLC]]
 [[Category:Драйверы]]
 [[Category:Интеграции]]
+{{DEFAULTSORT:Интеграция с Apple HomeKit}}

Apple-homekit-integration: различия между версиями

Admin (обсуждение | вклад)