Интеграция ZONT с Home Assistant MQTT - История изменений

Admin в 11:15, 24 сентября 2026

2026-09-24T11:15:44Z

← Предыдущая версия		Версия от 11:15, 24 сентября 2026
Строка 195:		Строка 195:
	При входе на <span style="background-color: #D3D3D3;"><nowiki>http://localhost:3097</nowiki></span> интерфейс по умолчанию на английском языке. Нажмите на кнопку '''en''', чтобы открыть меню выбора доступных языков		При входе на <span style="background-color: #D3D3D3;"><nowiki>http://localhost:3097</nowiki></span> интерфейс по умолчанию на английском языке. Нажмите на кнопку '''en''', чтобы открыть меню выбора доступных языков

	[[Файл:1 start.png\|~~877x877пкс~~]]		[[Файл:1 start.png\|972x972px]]

	Выберите из списка <span style="background-color: #D3D3D3;">Русский</span>.		Выберите из списка <span style="background-color: #D3D3D3;">Русский</span>.

	[[Файл:2 lang.png]]		[[Файл:2 lang.png\|972x972пкс]]

	Перейдите во вкладку <span style="background-color: #D3D3D3;">Устройства</span> и нажмите кнопку <span style="background-color: #D3D3D3;">Разрешить подключение</span>.		Перейдите во вкладку <span style="background-color: #D3D3D3;">Устройства</span> и нажмите кнопку <span style="background-color: #D3D3D3;">Разрешить подключение</span>.

	[[Файл:3 search.png]]		[[Файл:3 search.png\|971x971пкс]]

	Чтобы перевести Zigbee устройство в режим поиска следуйте инструкции производителя (возможные варианты: зажатие кнопки или её тройное нажатие, зажатие скрытого переключателя в отверстии для скрепки). После этого световой индикатор начнет мигать, и устройство появится в веб-интерфейсе Zigbee2MQTT. После этого можно вручную отключить присоединение устройств нажав на <span style="background-color: #D3D3D3;">Запретить присоединение</span>.		Чтобы перевести Zigbee устройство в режим поиска следуйте инструкции производителя (возможные варианты: зажатие кнопки или её тройное нажатие, зажатие скрытого переключателя в отверстии для скрепки). После этого световой индикатор начнет мигать, и устройство появится в веб-интерфейсе Zigbee2MQTT. После этого можно вручную отключить присоединение устройств нажав на <span style="background-color: #D3D3D3;">Запретить присоединение</span>.

	[[Файл:4 joined.png\|~~877x877пкс~~]]		[[Файл:4 joined.png\|972x972px]]

	Программа автоматически направит всю информацию о датчике на сервера ZONT. После обновления главного экрана дома с устройством Home Assistant, в приложении ZONT появятся доступные компоненты добавленного датчика.		Программа автоматически направит всю информацию о датчике на сервера ZONT. После обновления главного экрана дома с устройством Home Assistant, в приложении ZONT появятся доступные компоненты добавленного датчика.
Строка 232:		Строка 232:
	<hr>		<hr>

	==== Брокер ====		====Брокер====
	1. Поддерживаются протоколы MQTT 3.1.1 и 5.0.		1. Поддерживаются протоколы MQTT 3.1.1 и 5.0.

Строка 249:		Строка 249:
	<hr>		<hr>

	==== Полезная нагрузка ====		====Полезная нагрузка====
	Формат соответствует [https://www.home-assistant.io/integrations/mqtt/ интеграциям Home Assistant MQTT]. На 19.08.2026 поддерживаются:		Формат соответствует [https://www.home-assistant.io/integrations/mqtt/ интеграциям Home Assistant MQTT]. На 19.08.2026 поддерживаются:
	{\| class="wikitable"		{\| class="wikitable"
Строка 286:		Строка 286:
	<hr>		<hr>

	==== MQTT Discovery ====		====MQTT Discovery====
	Сообщения MQTT Discovery сообщают серверу информацию об устройстве и правилах взаимодействия с ним. Топик должен начинаться с префикса <span style="background-color: #D3D3D3;">ZONT/<user_id>/<device_id>/</span> и заканчиваться суффиксом <span style="background-color: #D3D3D3;">/config</span> :		Сообщения MQTT Discovery сообщают серверу информацию об устройстве и правилах взаимодействия с ним. Топик должен начинаться с префикса <span style="background-color: #D3D3D3;">ZONT/<user_id>/<device_id>/</span> и заканчиваться суффиксом <span style="background-color: #D3D3D3;">/config</span> :

	<span style="background-color: #D3D3D3;">ZONT/102645/469742/sensor/9FF5B6BCEC40/8207/config</span>		<span style="background-color: #D3D3D3;">ZONT/102645/469742/sensor/9FF5B6BCEC40/8207/config</span>

	* поля <span style="background-color: #D3D3D3;">availability</span> игнорируются: устройство считается вышедшим на связь после успешной аутентификации клиента в брокере;		*поля <span style="background-color: #D3D3D3;">availability</span> игнорируются: устройство считается вышедшим на связь после успешной аутентификации клиента в брокере;
	* в <span style="background-color: #D3D3D3;">value_template</span> из соображений безопасности поддерживаются только простейшие значения — извлечение ключей JSON, например <span style="background-color: #D3D3D3;"><nowiki>{{value_json.temperature }}</nowiki></span>. Любые преобразования и сценарии недоступны;		*в <span style="background-color: #D3D3D3;">value_template</span> из соображений безопасности поддерживаются только простейшие значения — извлечение ключей JSON, например <span style="background-color: #D3D3D3;"><nowiki>{{value_json.temperature }}</nowiki></span>. Любые преобразования и сценарии недоступны;
	* <span style="background-color: #D3D3D3;">message_expiry_interval</span> игнорируется: все способы персистентного хранения сообщений в брокере отключены.		*<span style="background-color: #D3D3D3;">message_expiry_interval</span> игнорируется: все способы персистентного хранения сообщений в брокере отключены.

Admin в 11:06, 24 сентября 2026

2026-09-24T11:06:57Z

← Предыдущая версия		Версия от 11:06, 24 сентября 2026
Строка 131:		Строка 131:

	Прибор Home Assistant в личном кабинете ZONT удаление не затрагивает — если он больше не нужен, удалите его в приложении ZONT.		Прибор Home Assistant в личном кабинете ZONT удаление не затрагивает — если он больше не нужен, удалите его в приложении ZONT.

			<hr>

	===Если что-то пошло не так===		===Если что-то пошло не так===

Admin в 11:06, 24 сентября 2026

2026-09-24T11:06:24Z

← Предыдущая версия		Версия от 11:06, 24 сентября 2026
Строка 1:		Строка 1:
			<span>
			<span id="BackToTop"></span>
			<div class="noprint" style="background-color:#0a488b; text-decoration: #ffffff; border-radius: 10px; position:fixed; bottom:3%; left:2%; padding:2px 20px; margin:0;">
			[[#top\|<font color="white"><big>Наверх</big></font>]]
			</div>

	===Установка Zigbee2MQTT для ZONT===		===Установка Zigbee2MQTT для ZONT===
	Программа '''Zigbee2MQTT''' позволяет подключить '''Zigbee-устройства''' (датчики, розетки, лампы, реле) к личному кабинету '''ZONT'''.		Программа '''Zigbee2MQTT''' позволяет подключить '''Zigbee-устройства''' (датчики, розетки, лампы, реле) к личному кабинету '''ZONT'''.
Строка 216:		Строка 222:

	[[Файл:8 final.png]]		[[Файл:8 final.png]]

			<hr>

	===Техническим специалистам===		===Техническим специалистам===
	Раздел описывает обмен по протоколу MQTT в сервисе ZONT.		Раздел описывает обмен по протоколу MQTT в сервисе ZONT.

			<hr>

	==== Брокер ====		==== Брокер ====
Строка 234:		Строка 244:

	7. Retain-сообщения отключены — флаг игнорируется на уровне брокера. Само сообщение доставляется всем получателям, которые находятся на связи.		7. Retain-сообщения отключены — флаг игнорируется на уровне брокера. Само сообщение доставляется всем получателям, которые находятся на связи.

			<hr>

	==== Полезная нагрузка ====		==== Полезная нагрузка ====
Строка 269:		Строка 281:
	\|переключатели		\|переключатели
	\|}		\|}

			<hr>

	==== MQTT Discovery ====		==== MQTT Discovery ====

Admin в 11:05, 24 сентября 2026

2026-09-24T11:05:25Z

← Предыдущая версия		Версия от 11:05, 24 сентября 2026
Строка 276:		Строка 276:

	* поля <span style="background-color: #D3D3D3;">availability</span> игнорируются: устройство считается вышедшим на связь после успешной аутентификации клиента в брокере;		* поля <span style="background-color: #D3D3D3;">availability</span> игнорируются: устройство считается вышедшим на связь после успешной аутентификации клиента в брокере;
	* в <span style="background-color: #D3D3D3;">value_template</span> из соображений безопасности поддерживаются только простейшие значения — извлечение ключей JSON, например ~~<nowiki>~~<span style="background-color: #D3D3D3;">{{value_json.temperature }}</~~span~~></~~nowiki~~>. Любые преобразования и сценарии недоступны;		* в <span style="background-color: #D3D3D3;">value_template</span> из соображений безопасности поддерживаются только простейшие значения — извлечение ключей JSON, например <span style="background-color: #D3D3D3;"><nowiki>{{value_json.temperature }}</nowiki></span>. Любые преобразования и сценарии недоступны;
	* <span style="background-color: #D3D3D3;">message_expiry_interval</span> игнорируется: все способы персистентного хранения сообщений в брокере отключены.		* <span style="background-color: #D3D3D3;">message_expiry_interval</span> игнорируется: все способы персистентного хранения сообщений в брокере отключены.

Admin в 11:04, 24 сентября 2026

2026-09-24T11:04:53Z

← Предыдущая версия		Версия от 11:04, 24 сентября 2026
Строка 106:		Строка 106:

	====Как отключить фоновый режим====		====Как отключить фоновый режим====
	Щёлкните по файлу <span style="background-color: #D3D3D3;">Uninstall-Zigbee2MQTT-Service.bat</span> правой кнопкой мыши и выберите «'''Запуск от имени администратора'''». Программа ~~перестанетзапускаться~~ сама, а её настройки и список Zigbee-устройств останутся на месте.		Щёлкните по файлу <span style="background-color: #D3D3D3;">Uninstall-Zigbee2MQTT-Service.bat</span> правой кнопкой мыши и выберите «'''Запуск от имени администратора'''». Программа перестанет запускаться сама, а её настройки и список Zigbee-устройств останутся на месте.

	<hr>		<hr>
Строка 135:		Строка 135:
	Приложите нужный файл к обращению в техническую поддержку ZONT — по нему причина видна почти всегда.		Приложите нужный файл к обращению в техническую поддержку ZONT — по нему причина видна почти всегда.

	Если Zigbee2MQTT работает в фоне, поддержка может попросить ещё и журнал самой программы. Он лежит в папке '''%LOCALAPPDATA%\Zigbee2MQTT\logs''': ~~скопируйтеэтот~~ адрес в адресную строку проводника и нажмите Enter.		Если Zigbee2MQTT работает в фоне, поддержка может попросить ещё и журнал самой программы. Он лежит в папке '''%LOCALAPPDATA%\Zigbee2MQTT\logs''': скопируйте этот адрес в адресную строку проводника и нажмите Enter.

	'''Частые случаи и что делать:'''		'''Частые случаи и что делать:'''
Строка 143:		Строка 143:
	!Что это значит		!Что это значит
	\|-		\|-
	\|«'''Установка требует ~~правадминистратора~~'''»		\|«'''Установка требует прав администратора'''»
	\|Файл запущен обычным двойным щелчком.		\|Файл запущен обычным двойным щелчком.
	Закройте окно и запустите правой кнопкой мыши через «'''Запуск от имени администратора'''».		Закройте окно и запустите правой кнопкой мыши через «'''Запуск от имени администратора'''».
Строка 150:		Строка 150:
	\|Проверьте данные на сайте ZONT. После трёх неудачных попыток установка прервётся.		\|Проверьте данные на сайте ZONT. После трёх неудачных попыток установка прервётся.
	\|-		\|-
	\|«'''В аккаунте нет ни ~~одногоприбора~~ Home Assistant'''»		\|«'''В аккаунте нет ни одного прибора Home Assistant'''»
	\|Сначала добавьте прибор в приложении ZONT, затем запустите установку заново.		\|Сначала добавьте прибор в приложении ZONT, затем запустите установку заново.
	\|-		\|-
Строка 276:		Строка 276:

	* поля <span style="background-color: #D3D3D3;">availability</span> игнорируются: устройство считается вышедшим на связь после успешной аутентификации клиента в брокере;		* поля <span style="background-color: #D3D3D3;">availability</span> игнорируются: устройство считается вышедшим на связь после успешной аутентификации клиента в брокере;
	* в <span style="background-color: #D3D3D3;">value_template</span> из соображений безопасности поддерживаются ~~толькопростейшие~~ значения — извлечение ключей JSON, например Любые преобразования и сценарии недоступны;		* в <span style="background-color: #D3D3D3;">value_template</span> из соображений безопасности поддерживаются только простейшие значения — извлечение ключей JSON, например <nowiki><span style="background-color: #D3D3D3;">{{value_json.temperature }}</span></nowiki>. Любые преобразования и сценарии недоступны;
	* <span style="background-color: #D3D3D3;">message_expiry_interval</span> игнорируется: все способы персистентного ~~хранениясообщений~~ в брокере отключены.		* <span style="background-color: #D3D3D3;">message_expiry_interval</span> игнорируется: все способы персистентного хранения сообщений в брокере отключены.

Admin в 11:03, 24 сентября 2026

2026-09-24T11:03:21Z

@@ Строка 23: / Строка 23: @@
 *Компьютер с 64-разрядной Windows 10 или новее.
-*Zigbee-стик, вставленный в USB-порт (рекомендуем стик Zigbee 3.0 на базе TICC2652P).
+*Zigbee-стик*, вставленный в USB-порт (рекомендуем стик Zigbee 3.0 на базе TICC2652P).
 *Логин и пароль от личного кабинета ZONT.
 *Прибор типа «Home Assistant», заранее добавленный в приложении ZONT. Если такого прибора нет, установщик остановится и сообщит об этом.
@@ Строка 218: / Строка 218: @@
 ===Техническим специалистам===

Admin в 10:50, 24 сентября 2026

2026-09-24T10:50:36Z

← Предыдущая версия		Версия от 10:50, 24 сентября 2026
Строка 16:		Строка 16:
	[[Файл:Creds.png]]		[[Файл:Creds.png]]

	Дополнительная информация в разделе ~~«Техническим специалистам»~~.		Дополнительная информация в разделе «[[Интеграция ZONT с Home Assistant MQTT#Техническим специалистам\|Техническим специалистам]]».

	<hr>		<hr>
Строка 191:		Строка 191:
	Выберите из списка <span style="background-color: #D3D3D3;">Русский</span>.		Выберите из списка <span style="background-color: #D3D3D3;">Русский</span>.

	[[Файл:2 lang.png~~\|876.859x876.859пкс~~]]		[[Файл:2 lang.png]]

	Перейдите во вкладку <span style="background-color: #D3D3D3;">Устройства</span> и нажмите кнопку <span style="background-color: #D3D3D3;">Разрешить подключение</span>.		Перейдите во вкладку <span style="background-color: #D3D3D3;">Устройства</span> и нажмите кнопку <span style="background-color: #D3D3D3;">Разрешить подключение</span>.

	[[Файл:3 search.png~~\|876.859x876.859пкс~~]]		[[Файл:3 search.png]]

	Чтобы перевести Zigbee устройство в режим поиска следуйте инструкции производителя (возможные варианты: зажатие кнопки или её тройное нажатие, зажатие скрытого переключателя в отверстии для скрепки). После этого световой индикатор начнет мигать, и устройство появится в веб-интерфейсе Zigbee2MQTT. После этого можно вручную отключить присоединение устройств нажав на <span style="background-color: #D3D3D3;">Запретить присоединение</span>.		Чтобы перевести Zigbee устройство в режим поиска следуйте инструкции производителя (возможные варианты: зажатие кнопки или её тройное нажатие, зажатие скрытого переключателя в отверстии для скрепки). После этого световой индикатор начнет мигать, и устройство появится в веб-интерфейсе Zigbee2MQTT. После этого можно вручную отключить присоединение устройств нажав на <span style="background-color: #D3D3D3;">Запретить присоединение</span>.
Строка 217:		Строка 217:
	[[Файл:8 final.png]]		[[Файл:8 final.png]]

	=== Техническим специалистам ===		===Техническим специалистам===

Admin в 10:49, 24 сентября 2026

2026-09-24T10:49:28Z

← Предыдущая версия		Версия от 10:49, 24 сентября 2026
Строка 188:		Строка 188:

	[[Файл:1 start.png\|877x877пкс]]		[[Файл:1 start.png\|877x877пкс]]

			Выберите из списка <span style="background-color: #D3D3D3;">Русский</span>.

			[[Файл:2 lang.png\|876.859x876.859пкс]]

			Перейдите во вкладку <span style="background-color: #D3D3D3;">Устройства</span> и нажмите кнопку <span style="background-color: #D3D3D3;">Разрешить подключение</span>.

			[[Файл:3 search.png\|876.859x876.859пкс]]

			Чтобы перевести Zigbee устройство в режим поиска следуйте инструкции производителя (возможные варианты: зажатие кнопки или её тройное нажатие, зажатие скрытого переключателя в отверстии для скрепки). После этого световой индикатор начнет мигать, и устройство появится в веб-интерфейсе Zigbee2MQTT. После этого можно вручную отключить присоединение устройств нажав на <span style="background-color: #D3D3D3;">Запретить присоединение</span>.

			[[Файл:4 joined.png\|877x877пкс]]

			Программа автоматически направит всю информацию о датчике на сервера ZONT. После обновления главного экрана дома с устройством Home Assistant, в приложении ZONT появятся доступные компоненты добавленного датчика.

			[[Файл:5 result.png\|852x852пкс]]

			Имя плитки по умолчанию максимально наполняется данными, чтобы была понятна принадлежность компонента к устройству. Переименование доступно в настройках устройства Home Assistant, разделы <span style="background-color: #D3D3D3;">Управление</span>, <span style="background-color: #D3D3D3;">Оборудование</span>, <span style="background-color: #D3D3D3;">Отопление</span>.

			[[Файл:6 rename.png\|843x843пкс]]

			Ненужные плитки можно скрыть в настройках дома, раздел <span style="background-color: #D3D3D3;">Главный экран</span>.

			[[Файл:7 visible.png\|845x845пкс]]

			Итоговый вид на главном экране дома.

			[[Файл:8 final.png]]

			=== Техническим специалистам ===

Admin в 10:40, 24 сентября 2026

2026-09-24T10:40:01Z

← Предыдущая версия		Версия от 10:40, 24 сентября 2026
Строка 126:		Строка 126:
	Прибор Home Assistant в личном кабинете ZONT удаление не затрагивает — если он больше не нужен, удалите его в приложении ZONT.		Прибор Home Assistant в личном кабинете ZONT удаление не затрагивает — если он больше не нужен, удалите его в приложении ZONT.

	=== Если что-то пошло не так ===		===Если что-то пошло не так===
	В самом начале каждый файл показывает свою версию (например, версия 2026.9.1) — назовите её при обращении в поддержку, она же записана в журнале.		В самом начале каждый файл показывает свою версию (например, версия 2026.9.1) — назовите её при обращении в поддержку, она же записана в журнале.

Строка 171:		Строка 171:
	<hr>		<hr>

	==== Если адаптер занят ====		====Если адаптер занят====
	Zigbee-стик может использовать только одна программа за раз. Если в окне написано, что адаптер занят, выполняйте по порядку и после каждого шага запускайте файл заново (правой кнопкой мыши — «Запуск от имени администратора»):		Zigbee-стик может использовать только одна программа за раз. Если в окне написано, что адаптер занят, выполняйте по порядку и после каждого шага запускайте файл заново (правой кнопкой мыши — «Запуск от имени администратора»):

Строка 184:		Строка 184:
	<hr>		<hr>

	=== Базовая информация по добавлению устройств Zigbee ===		===Базовая информация по добавлению устройств Zigbee===
			При входе на <span style="background-color: #D3D3D3;"><nowiki>http://localhost:3097</nowiki></span> интерфейс по умолчанию на английском языке. Нажмите на кнопку '''en''', чтобы открыть меню выбора доступных языков

			[[Файл:1 start.png\|877x877пкс]]

Admin в 10:34, 24 сентября 2026

2026-09-24T10:34:19Z

← Предыдущая версия		Версия от 10:34, 24 сентября 2026
Строка 168:		Строка 168:
	Если не помогло — порядок действий в разделе «[[Интеграция ZONT с Home Assistant MQTT#Если адаптер занят\|Если адаптер занят]]» ниже.		Если не помогло — порядок действий в разделе «[[Интеграция ZONT с Home Assistant MQTT#Если адаптер занят\|Если адаптер занят]]» ниже.
	\|}		\|}

			<hr>

	==== Если адаптер занят ====		==== Если адаптер занят ====
Строка 179:		Строка 181:

	'''4. Перезагрузите компьютер'''.		'''4. Перезагрузите компьютер'''.

			<hr>

	=== Базовая информация по добавлению устройств Zigbee ===		=== Базовая информация по добавлению устройств Zigbee ===