Различия

Показаны различия между двумя версиями страницы.

--- работа_с_mqtt [2019/05/05 21:10]
admin создано
+++ работа_с_mqtt [2019/11/11 01:05]
admin
@@ Строка 27: / Строка 27: @@
 В данном примере:
-* Командные топики: myhome/in/<имя item> и myhome/LHexample03/<имя item>
+**Командные топики (широковещательные):**
-* Статусный топик: myhome/s_out/<имя item>
+* myhome/in/<имя item>
+* myhome/in/<имя item>/set
+* myhome/in/<имя item>/cmd
+**Командные топики (индивидуальные):**
+* myhome/LHexample03/<имя item>
+* myhome/LHexample03/<имя item>/set
+* myhome/LHexample03/<имя item>/cmd
+**Статусные топики:**
+* myhome/s_out/<имя item>
+* myhome/s_out/<имя item>/set
+* myhome/s_out/<имя item>/cmd
 (Именно это соответствует настройкам по-умолчанию)
-Зачем два командных топика:
+Зачем два типа командных топиков:
-Через индивидуальный, можно управлять каждым контроллером домена в отдельности. Через общий широковещательный - выдавать команды сразу всем котнроллерам домена
+Через индивидуальный, можно управлять каждым контроллером домена в отдельности. Через общий широковещательный - выдавать команды сразу всем контроллерам домена
+В старой версии контроллера, имя топика завершалось именем item для управления
+В данный //совмещенный// топик можно отправлять как команды ON OFF HALT REST и прочие (см. ниже), так и установки канала (яркость и пр)
+Отличительная особенность - запись в такой совмещенный топик ненулевого значения включает канал, запись нулевого - выключает канал;
+Топики данного типа используются для интеграции с системой OpenHab
+В последних версиях, дополнительно к ним, организованы топики с окончанием /set и /cmd
+Это позволяет полностью разнести логику подачи команд каналу и логику установки параметров канала
+Например, если канал диммера выключен, запись в топик с окончанием /set значения 60 не включит его, а задаст значение яркости 60%. Если следом отправить ON в топик с окончанием /cmd, диммер включится на заранее установленное значение 60% яркости. Данные топики крайне полезны для интеграции LightHub системами HomeAssistant, HomeBridge.
+Кроме окончаний /cmd и /set возможны окончания, специфичные для того или иного типа устройства:
+например, окончания
+/fan (значения HIGH, MEDIUM, LOW)
+/mode
+/lock (ON,OFF)
+/swing (ON,OFF)
+/quiet  (ON,OFF)
+для канала управления кондиционером
 LightHub (во многом) руководствуется конвенцией [[https://homieiot.github.io/|homie]] для формирования структуры топиков MQTT. (Пока еще не полная поддержка, но основные моменты соблюдены)
@@ Строка 48: / Строка 98: @@
 Базовый набор команд (совместим с OpenHab):
-* ON - Turn channel ON. If some previous channel state is stored (Color, Volume) - it will be restored back. Else channel will be turned on with default values (White colour/100% volume in most cases)
+* ON - Turn channel ON. If some previous channel state is stored (Color, Volume) - it will be restored back. Else channel will be turned on with default values (White colour/100% volume/20 degrees Celsius in most cases)
 * OFF - just turn channel off
 * <Numeric value 0..100> - Volume for Dimmer/PWM/FM/Thermostate etc. channels
@@ Строка 54: / Строка 104: @@
-Расширенный набор комманд:
+Расширенный набор комманд (также, данные команды работают для групп каналов):
+* HALT - выключить канал(группу)
+* REST - включить канал(группу), канал будет включен только если он был успешно выключен перед этим командой HALT (крайне удобно для Master выключателей. Контроллер умеет включать только то, что было выключено при уходе)
+* XON - включить канал (группу)
+* XOFF - выключить (но только при условии что канал был включен командой XON) - идеально для использования совместно с детекторами движения
+* TOGGLE: Переключать из состояния ON в OFF. Если применяется для группы - то принимается что если хоть один канал, входящий в группу включен - она активна и при получении TOGGLE произойдет выключение того, что включено. Последующая команда TOGGLE включит все каналы, входящие в группу.
+* #AABBCC: Color notation in RGB - Home Remote app color picker compatible
+Команды, применимые для кондиционера и термостата:
+* AUTO
+* HEAT
+* COOL
+* FAN_ONLY
+* DRY
-* HALT - turn channel off
-* REST - turn channel ON only if it was turned off by HALT command before
-* XON - включить канал
-* XOFF - выключить (но только при условии что включен он был командой XON) - идеально для использования совместно с детекторами движения
-* TOGGLE: Toggle ON and OFF state. For group channels - considering the Group Channel in ON state if at least one member of group is active
-* #AABBCC: Color notation in RGB - Home Remote color picker compatible

LightHub

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы