Apple-homekit-integration - История изменений

Admin: Английские адреса Wiki: обновление ссылок с сохранением русских подписей

2026-10-02T22:28:45Z

Английские адреса Wiki: обновление ссылок с сохранением русских подписей

← Предыдущая версия		Версия от 22:28, 2 октября 2026
Строка 150:		Строка 150:
	[[Category:Драйверы]]		[[Category:Драйверы]]
	[[Category:Интеграции]]		[[Category:Интеграции]]
			{{DEFAULTSORT:Интеграция с Apple HomeKit}}

Admin: Admin переименовал страницу Интеграция с Apple HomeKit в Apple-homekit-integration: Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

2026-10-02T20:45:46Z

Admin переименовал страницу Интеграция с Apple HomeKit в Интеграция с Apple HomeKit: Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

← Предыдущая версия	Версия от 20:45, 2 октября 2026
(нет различий)

Admin: Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

2026-10-02T20:45:44Z

Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

← Предыдущая версия		Версия от 20:45, 2 октября 2026
Строка 1:		Строка 1:
			{{DISPLAYTITLE:Интеграция с Apple HomeKit}}
	__NOTOC__		__NOTOC__
	= Интеграция XIOT с Apple HomeKit =		= Интеграция XIOT с Apple HomeKit =

Admin: Исправлено описание управления кондиционером

2026-07-22T21:02:40Z

Исправлено описание управления кондиционером

← Предыдущая версия		Версия от 21:02, 22 июля 2026
Строка 114:		Строка 114:
	=== Климатические устройства ===		=== Климатические устройства ===

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

Admin: Добавлена поддержка кондиционера, радиатора и тёплого пола

2026-07-22T21:01:25Z

Добавлена поддержка кондиционера, радиатора и тёплого пола

← Предыдущая версия		Версия от 21:01, 22 июля 2026
Строка 74:		Строка 74:
	\|-		\|-
	\| '''Клапан вентиляции''' \|\| Открытие и закрытие.		\| '''Клапан вентиляции''' \|\| Открытие и закрытие.
			\|-
			\| '''Кондиционер''' \|\| Включение и выключение, текущая и заданная температура, автоматический режим, нагрев, охлаждение, текущее состояние работы и скорость вентилятора.
	\|-		\|-
	\| '''Тёплый пол''' \|\| Включение и выключение, текущая и заданная температура, состояние нагрева.		\| '''Тёплый пол''' \|\| Включение и выключение, текущая и заданная температура, состояние нагрева.
Строка 109:		Строка 111:

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

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

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

	== Какие устройства пока не передаются ==		== Какие устройства пока не передаются ==
Строка 114:		Строка 123:
	В текущей реализации ещё не добавлены:		В текущей реализации ещё не добавлены:

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

Admin: Уточнён порядок отвязки и передачи моста владельцу

2026-07-22T20:52:50Z

Уточнён порядок отвязки и передачи моста владельцу

← Предыдущая версия		Версия от 20:52, 22 июля 2026
Строка 33:		Строка 33:

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

Admin: Добавлены статусы сопряжения и передача HomeKit владельцу

2026-07-22T20:51:22Z

Добавлены статусы сопряжения и передача HomeKit владельцу

← Предыдущая версия		Версия от 20:51, 22 июля 2026
Строка 18:		Строка 18:
	# В приложении Apple «Дом» выберите добавление аксессуара и отсканируйте QR-код. Если камера не распознаёт код, введите показанный PIN-код вручную.		# В приложении Apple «Дом» выберите добавление аксессуара и отсканируйте QR-код. Если камера не распознаёт код, введите показанный PIN-код вручную.

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

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

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

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

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

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

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

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

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

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

	== Доступные устройства ==		== Доступные устройства ==
Строка 106:		Строка 126:
	* '''Выключен''' — мост отключён в проекте.		* '''Выключен''' — мост отключён в проекте.
	* '''Запуск''' — служба HomeKit запускается на PLC.		* '''Запуск''' — служба HomeKit запускается на PLC.
	* '''Готов''' — мост работает; можно сканировать QR-код ~~или управлять~~ уже ~~добавленными устройствами~~.		* '''Готов''' — мост работает, но ещё не сопряжён; можно сканировать QR-код.
			* '''Подключен''' — мост уже добавлен в Apple «Дом»; QR-код скрыт, а для новой привязки нужен сброс сопряжения.
	* '''Ошибка''' — мост не запущен; текст причины передаётся редактору с PLC.		* '''Ошибка''' — мост не запущен; текст причины передаётся редактору с PLC.
	* '''Нет связи''' — редактор не получает актуальное состояние от PLC. Этот статус сам по себе не означает, что уже сопряжённый мост HomeKit остановлен.		* '''Нет связи''' — редактор не получает актуальное состояние от PLC. Этот статус сам по себе не означает, что уже сопряжённый мост HomeKit остановлен.
Строка 114:		Строка 135:
	PIN-код должен иметь формат <code>XXX-XX-XXX</code>. После его изменения сохраните и повторно загрузите проект в PLC.		PIN-код должен иметь формат <code>XXX-XX-XXX</code>. После его изменения сохраните и повторно загрузите проект в PLC.

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

	[[Category:XIOT-PLC]]		[[Category:XIOT-PLC]]
	[[Category:Драйверы]]		[[Category:Драйверы]]
	[[Category:Интеграции]]		[[Category:Интеграции]]

Admin: Расширен список устройств HomeKit и заменены системные имена русскими названиями XIOT

2026-07-22T20:15:10Z

Расширен список устройств HomeKit и заменены системные имена русскими названиями XIOT

Внесённые изменения

Admin: Добавлена инструкция по интеграции XIOT с Apple HomeKit (редактор 14.1-3)

2026-07-22T20:06:43Z

Добавлена инструкция по интеграции XIOT с Apple HomeKit (редактор 14.1-3)

Новая страница

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

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

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

[[File:XIOT HomeKit — настройка моста.png|1000px|frameless|Настройка моста HomeKit в редакторе XIOT]]

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

== Подключение ==

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

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

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

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

В версии 14.1-3 мост передаёт следующие типы виртуальных устройств XIOT:

{| class="wikitable"
! Устройство 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-код должен иметь формат <code>XXX-XX-XXX</code>. После его изменения сохраните и повторно загрузите проект в PLC.

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

[[Category:XIOT-PLC]]
[[Category:Драйверы]]
[[Category:Интеграции]]