Common/Topics - История изменений

Voznemozhno: /* td - to device */

2025-08-06T16:48:04Z

td - to device

← Предыдущая версия		Версия от 16:48, 6 августа 2025
Строка 52:		Строка 52:
	Топики публикуются ''без'' флага '''retain'''.		Топики публикуются ''без'' флага '''retain'''.

	=== td - ''to device'' ===		=== td ''- to device'' ===
	{{#tag:pre\|<nowiki>{prefix}/td/{service}[/instance]/{deviceId}[/endpointId]</nowiki>}}		{{#tag:pre\|<nowiki>{prefix}/td/{service}[/instance]/{deviceId}[/endpointId]</nowiki>}}
	Топики, из которых сервисы ''HOMEd'', работающие с устройствами, получают данные для управления устройствами. Эти данные публикуются, например, сервисом [[Automation\|автоматизаций]].		Топики, из которых сервисы ''HOMEd'', работающие с устройствами, получают данные для управления устройствами. Эти данные публикуются, например, сервисом [[Automation\|автоматизаций]].

Voznemozhno: /* fd - from device */

2025-08-06T16:47:50Z

fd - from device

← Предыдущая версия		Версия от 16:47, 6 августа 2025
Строка 46:		Строка 46:
	Топики публикуются с флагом '''retain'''.		Топики публикуются с флагом '''retain'''.

	=== fd - ''from device'' ===		=== fd ''- from device'' ===
	{{#tag:pre\|<nowiki>{prefix}/fd/{service}[/instance]/{deviceId}[/endpointId]</nowiki>}}		{{#tag:pre\|<nowiki>{prefix}/fd/{service}[/instance]/{deviceId}[/endpointId]</nowiki>}}
	Топики, в которые сервисы ''HOMEd'', работающие с устройствами, публикуют данные, полученные от устройств. Помимо прочего, сервис [[ZigBee\|ZigBee]] публикует в эти топики параметр <code>"linkQuality"</code>, указывающий на качество связи с устройством (с ближайшим к координатору роутером, в случае, когда устройство работает через роутер).		Топики, в которые сервисы ''HOMEd'', работающие с устройствами, публикуют данные, полученные от устройств. Помимо прочего, сервис [[ZigBee\|ZigBee]] публикует в эти топики параметр <code>"linkQuality"</code>, указывающий на качество связи с устройством (с ближайшим к координатору роутером, в случае, когда устройство работает через роутер).

Voznemozhno: /* service */

2025-08-06T16:47:01Z

service

← Предыдущая версия		Версия от 16:47, 6 августа 2025
Строка 16:		Строка 16:
	=== service ===		=== service ===
	{{#tag:pre\|<nowiki>{prefix}/service/{service}[/instance]</nowiki>}}		{{#tag:pre\|<nowiki>{prefix}/service/{service}[/instance]</nowiki>}}
	Топики, в которые сервисы ''HOMEd'' публикуют состояние своей доступности. Данные топики являются LWT-топиками, это значит, что при потере соединения между каким-либо сервисом и MQTT-брокером (по причине плохой связи или некорректного завершения работы сервиса), брокер самостоятельно опубликует в ~~соответсвующий~~ топик сообщение с содержимым <code>{"status":"offline"}</code>.		Топики, в которые сервисы ''HOMEd'' публикуют состояние своей доступности. Данные топики являются LWT-топиками, это значит, что при потере соединения между каким-либо сервисом и MQTT-брокером (по причине плохой связи или некорректного завершения работы сервиса), брокер самостоятельно опубликует в соответствующий топик сообщение с содержимым <code>{"status":"offline"}</code>.

	Топики публикуются с флагом '''retain'''.		Топики публикуются с флагом '''retain'''.

Voznemozhno: /* service */

2025-08-06T16:46:48Z

service

← Предыдущая версия		Версия от 16:46, 6 августа 2025
Строка 16:		Строка 16:
	=== service ===		=== service ===
	{{#tag:pre\|<nowiki>{prefix}/service/{service}[/instance]</nowiki>}}		{{#tag:pre\|<nowiki>{prefix}/service/{service}[/instance]</nowiki>}}
	Топики, в которые сервисы ''HOMEd'' публикуют состояние своей доступности. Данные топики являются LWT-топиками, это значит, что при потере соединения между каким-либо сервисом и брокером (по причине плохой связи или некорректного завершения работы сервиса), брокер ~~сам~~ опубликует в соответсвующий топик сообщение с содержимым <code>{"status":"offline"}</code>.		Топики, в которые сервисы ''HOMEd'' публикуют состояние своей доступности. Данные топики являются LWT-топиками, это значит, что при потере соединения между каким-либо сервисом и MQTT-брокером (по причине плохой связи или некорректного завершения работы сервиса), брокер самостоятельно опубликует в соответсвующий топик сообщение с содержимым <code>{"status":"offline"}</code>.

	Топики публикуются с флагом '''retain'''.		Топики публикуются с флагом '''retain'''.

Voznemozhno: /* fd - from device */

2025-08-06T16:41:20Z

fd - from device

← Предыдущая версия		Версия от 16:41, 6 августа 2025
Строка 48:		Строка 48:
	=== fd - ''from device'' ===		=== fd - ''from device'' ===
	{{#tag:pre\|<nowiki>{prefix}/fd/{service}[/instance]/{deviceId}[/endpointId]</nowiki>}}		{{#tag:pre\|<nowiki>{prefix}/fd/{service}[/instance]/{deviceId}[/endpointId]</nowiki>}}
	Топики, в которые сервисы ''HOMEd'', работающие с устройствами, публикуют данные, полученные от устройств. Помимо прочего, сервис [[ZigBee\|ZigBee]] публикует в эти топики параметр <code>"~~lastSeen~~"</code>, указывающий на качество связи с устройством (с ближайшим к координатору роутером, в случае, когда устройство работает через роутер).		Топики, в которые сервисы ''HOMEd'', работающие с устройствами, публикуют данные, полученные от устройств. Помимо прочего, сервис [[ZigBee\|ZigBee]] публикует в эти топики параметр <code>"linkQuality"</code>, указывающий на качество связи с устройством (с ближайшим к координатору роутером, в случае, когда устройство работает через роутер).

	Топики публикуются ''без'' флага '''retain'''.		Топики публикуются ''без'' флага '''retain'''.

Voznemozhno: /* command */

2025-08-06T16:40:06Z

command

← Предыдущая версия		Версия от 16:40, 6 августа 2025
Строка 28:		Строка 28:
	=== command ===		=== command ===
	{{#tag:pre\|<nowiki>{prefix}/command/{service}[/instance]</nowiki>}}		{{#tag:pre\|<nowiki>{prefix}/command/{service}[/instance]</nowiki>}}
	Топики, в которые сервисы ''HOMEd'' публикуют сообщения для общения с другими сервисами, например, для запроса состояний или управления настройками устройств.		Топики, в которые сервисы ''HOMEd'' публикуют сообщения для общения с другими сервисами, например, для запроса актуальных состояний или управления настройками устройств.

	Топики публикуются ''без'' флага '''retain'''.		Топики публикуются ''без'' флага '''retain'''.

Voznemozhno: /* command */

2025-08-06T16:39:51Z

command

← Предыдущая версия		Версия от 16:39, 6 августа 2025
Строка 28:		Строка 28:
	=== command ===		=== command ===
	{{#tag:pre\|<nowiki>{prefix}/command/{service}[/instance]</nowiki>}}		{{#tag:pre\|<nowiki>{prefix}/command/{service}[/instance]</nowiki>}}
	Топики, в которые сервисы ''HOMEd'' публикуют сообщения для общения с другими сервисами, например, для ~~запросы~~ состояний или управления настройками устройств.		Топики, в которые сервисы ''HOMEd'' публикуют сообщения для общения с другими сервисами, например, для запроса состояний или управления настройками устройств.

	Топики публикуются ''без'' флага '''retain'''.		Топики публикуются ''без'' флага '''retain'''.

Voznemozhno: /* Общие сведения */

2025-08-06T16:38:30Z

Общие сведения

← Предыдущая версия		Версия от 16:38, 6 августа 2025
Строка 10:		Строка 10:
	* <code class="value">{deviceId}</code> - идентификатор устройства или его имя (в зависимости от конфигурации соответствующего сервиса)		* <code class="value">{deviceId}</code> - идентификатор устройства или его имя (в зависимости от конфигурации соответствующего сервиса)
	* <code class="value">[/instance]</code> - название инстанса, в случае, если оно указано в файле конфигурации (для сервисов, поддерживающих кластеризацию)		* <code class="value">[/instance]</code> - название инстанса, в случае, если оно указано в файле конфигурации (для сервисов, поддерживающих кластеризацию)
	* <code class="value">[/endpointId]</code> - номер конечной точки ~~устройства~~ для устройств с несколькими однотипными конечными точками, таких как многоканальные реле или выключатели		* <code class="value">[/endpointId]</code> - номер конечной точки для устройств с несколькими однотипными конечными точками, таких как многоканальные реле или выключатели

	== Топики сервисов ==		== Топики сервисов ==

Voznemozhno: /* Общие сведения */

2025-08-06T16:37:04Z

Общие сведения

← Предыдущая версия		Версия от 16:37, 6 августа 2025
Строка 3:		Строка 3:

	== Общие сведения ==		== Общие сведения ==
	Статья содержит обобщенные данные о структуре MQTT-топиков, посредством которых сервисы ''HOMEd'' общаются друг с другом, и не включает в себя описание данных, которые содержат эти топики. Для ознакомления со структурой данных можно почитать соответствующие статьи на страницах сервисов в этой вики или воспользоваться приложением [http://mqtt-explorer.com MQTT Explorer] для самостоятельного изучения (на мой взгляд - ''там нет ничего сложного'').		Статья содержит обобщенные данные о структуре MQTT-топиков, посредством которых сервисы ''HOMEd'' общаются друг с другом, и не включает в себя описание данных, которые содержат эти топики. Для ознакомления со структурой данных можно почитать соответствующие статьи на страницах сервисов в этой вики или воспользоваться приложением [http://mqtt-explorer.com MQTT Explorer] для самостоятельного изучения (на мой взгляд, ''там нет ничего сложного'').

	В описании топиков используются следующие элементы:		В описании топиков используются следующие элементы:

Voznemozhno: /* recorder */

2025-08-06T16:35:35Z

recorder

← Предыдущая версия		Версия от 16:35, 6 августа 2025
Строка 62:		Строка 62:
	=== recorder ===		=== recorder ===
	{{#tag:pre\|<nowiki>{prefix}/recorder</nowiki>}}		{{#tag:pre\|<nowiki>{prefix}/recorder</nowiki>}}
	~~Специальный топик~~, в который [[Recorder\|рекордер]] публикует данные для построения графиков. Топик публикуется ''без'' флага '''retain'''.		Топик, в который [[Recorder\|рекордер]] публикует данные для построения графиков. Топик публикуется ''без'' флага '''retain'''.

	[[Category:Common]]		[[Category:Common]]