Версия от 20:15, 22 июля 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-код вручную.

После сопряжения все поддерживаемые устройства проекта добавляются через один мост 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 на контроллере и добавьте мост заново.

@@ Строка 20: / Строка 20: @@
 После сопряжения все поддерживаемые устройства проекта добавляются через один мост XIOT. Названия устройств передаются из проекта XIOT.
-'''Важно:''' комнаты Apple «Дом» принадлежат конфигурации конкретного дома Apple и не назначаются мостом по протоколу HAP. Поэтому при первом добавлении приложение может попросить выбрать комнату отдельно для каждого аксессуара. Этажи и комнаты проекта XIOT автоматически не переносятся.
+'''Важно:''' комнаты Apple «Дом» принадлежат конфигурации конкретного дома Apple и не назначаются мостом по протоколу HomeKit. Поэтому при первом добавлении приложение может попросить выбрать комнату отдельно для каждого аксессуара. Этажи и комнаты проекта XIOT автоматически не переносятся.
 == Доступные устройства ==
-В версии 14.1-3 мост передаёт следующие типы виртуальных устройств XIOT:
+Мост передаёт следующие виртуальные устройства XIOT:
 {| class="wikitable"
-! Устройство XIOT !! Представление в Apple «Дом» !! Передаваемые функции
+! Устройство !! Доступные функции в Apple «Дом»
 |-
-| '''Lightbulb''' || Лампа || включение и выключение, яркость
+| '''Свет''' || Включение и выключение, изменение яркости. Для цветных светильников также передаются оттенок и насыщенность.
 |-
-| '''Switch''' || Выключатель || включение и выключение
+| '''Выключатель''' || Включение и выключение.
 |-
-| '''Outlet''' || Розетка || включение и выключение, состояние использования
+| '''Розетка''' || Включение и выключение, состояние использования.
 |-
-| '''Fan''' || Вентилятор || включение и выключение, скорость, направление вращения
+| '''Вентилятор''' || Включение и выключение, скорость и направление вращения.
 |-
-| '''WindowCovering''' || Шторы/жалюзи || целевое и текущее положение, состояние движения, горизонтальный наклон при наличии характеристик
+| '''Шторы''' || Целевое и текущее положение, состояние движения и горизонтальный наклон, если соответствующие характеристики используются в проекте.
 |-
-| '''TemperatureSensor''' || Датчик температуры || текущая температура
+| '''Экран кинотеатра''' || Открытие, закрытие, целевое и текущее положение.
 |-
-| '''HumiditySensor''' || Датчик влажности || текущая относительная влажность
+| '''Реле''' || Включение и выключение.
 |-
-| '''MotionSensor''' || Датчик движения || обнаружение движения
+| '''Насос''' || Включение и выключение.
 |-
-| '''ContactSensor''' || Датчик открытия || состояние контакта
+| '''Сирена''' || Включение и выключение.
 |-
-| '''LeakSensor''' || Датчик протечки || обнаружение протечки
+| '''Зуммер''' || Включение и выключение.
 |-
-| '''SmokeSensor''' || Датчик дыма || обнаружение дыма
+| '''Кран''' || Открытие и закрытие.
 |-
-| '''LightSensor''' || Датчик освещённости || текущая освещённость
+| '''Сервопривод''' || Открытие и закрытие.
 |-
-| '''AirQualitySensor''' || Датчик качества воздуха || индекс качества воздуха, плотность VOC
+| '''Клапан вентиляции''' || Открытие и закрытие.
 |-
-| '''CarbonDioxideSensor''' || Датчик CO₂ || обнаружение повышенного уровня и текущая концентрация CO₂
+| '''Тёплый пол''' || Включение и выключение, текущая и заданная температура, состояние нагрева.
+|-
+| '''Радиатор''' || Включение и выключение, текущая и заданная температура, состояние нагрева.
+|-
+| '''Конвектор''' || Включение и выключение, текущая и заданная температура, состояние нагрева.
+|-
+| '''Увлажнитель''' || Включение и выключение, текущая и заданная влажность, состояние увлажнения.
+|-
+| '''Приточная вентиляция''' || Включение и выключение, скорость вентилятора.
+|-
+| '''Кнопка''' || Одиночное, двойное и долгое нажатие. Эти события можно использовать в автоматизациях Apple «Дом».
+|-
+| '''Датчик температуры''' || Текущая температура.
+|-
+| '''Датчик влажности''' || Текущая относительная влажность.
+|-
+| '''Датчик движения''' || Обнаружение движения.
+|-
+| '''Геркон''' || Открытое или закрытое состояние двери либо окна.
+|-
+| '''Датчик протечки''' || Обнаружение протечки.
+|-
+| '''Датчик дыма''' || Обнаружение дыма.
+|-
+| '''Датчик освещённости''' || Текущая освещённость.
+|-
+| '''Датчик качества воздуха''' || Уровень качества воздуха и плотность летучих органических соединений.
+|-
+| '''Датчик углекислого газа''' || Обнаружение повышенного уровня и текущая концентрация углекислого газа.
 |}
-Внутренние совместимые типы '''Curtains''', '''DayСurtains''' и '''Jalousie''' передаются как '''WindowCovering'''.
+Если отдельная необязательная характеристика устройства отключена в проекте, она не добавляется в HomeKit.
-Если отдельная необязательная характеристика устройства отключена в проекте, она не добавляется в HomeKit.
+Тройное нажатие кнопки пока не передаётся: стандартная кнопка HomeKit поддерживает одиночное, двойное и долгое нажатие.
 == Какие устройства пока не передаются ==
-Проверка набора виртуальных устройств 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 не являются.
 == Статусы ==

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

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