Apple-homekit-integration
Интеграция 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 и не назначаются мостом по протоколу HAP. Поэтому при первом добавлении приложение может попросить выбрать комнату отдельно для каждого аксессуара. Этажи и комнаты проекта XIOT автоматически не переносятся.
Доступные устройства
В версии 14.1-3 мост передаёт следующие типы виртуальных устройств XIOT:
| Устройство XIOT | Представление в Apple «Дом» | Передаваемые функции |
|---|---|---|
| Lightbulb | Лампа | включение и выключение, яркость |
| Switch | Выключатель | включение и выключение |
| Outlet | Розетка | включение и выключение, состояние использования |
| Fan | Вентилятор | включение и выключение, скорость, направление вращения |
| WindowCovering | Шторы/жалюзи | целевое и текущее положение, состояние движения, горизонтальный наклон при наличии характеристик |
| TemperatureSensor | Датчик температуры | текущая температура |
| HumiditySensor | Датчик влажности | текущая относительная влажность |
| MotionSensor | Датчик движения | обнаружение движения |
| ContactSensor | Датчик открытия | состояние контакта |
| LeakSensor | Датчик протечки | обнаружение протечки |
| SmokeSensor | Датчик дыма | обнаружение дыма |
| LightSensor | Датчик освещённости | текущая освещённость |
| AirQualitySensor | Датчик качества воздуха | индекс качества воздуха, плотность VOC |
| CarbonDioxideSensor | Датчик CO₂ | обнаружение повышенного уровня и текущая концентрация CO₂ |
Внутренние совместимые типы Curtains, DayСurtains и Jalousie передаются как WindowCovering.
Если отдельная необязательная характеристика устройства отключена в проекте, она не добавляется в 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.
Сущности Home, Floor и Room описывают структуру проекта и самостоятельными аксессуарами HomeKit не являются.
Статусы
- Выключен — мост отключён в проекте.
- Запуск — служба HomeKit запускается на PLC.
- Готов — мост работает; можно сканировать QR-код или управлять уже добавленными устройствами.
- Ошибка — мост не запущен; текст причины передаётся редактору с PLC.
- Нет связи — редактор не получает актуальное состояние от PLC. Этот статус сам по себе не означает, что уже сопряжённый мост HomeKit остановлен.
Изменение PIN-кода и повторное сопряжение
PIN-код должен иметь формат XXX-XX-XXX. После его изменения сохраните и повторно загрузите проект в PLC.
Данные сопряжения сохраняются на контроллере между перезапусками. Если мост уже был добавлен в Apple «Дом», обычная перезагрузка PLC не требует повторного добавления аксессуара. Для полного повторного сопряжения сначала удалите мост из приложения Apple «Дом», затем сбросьте сохранённое состояние HomeKit на контроллере и добавьте мост заново.