Изменения
Настройка виртуальных устройств (посмотреть исходный код)
Версия от 09:46, 5 мая 2022
, 09:46, 5 мая 2022нет описания правки
'''В этой инструкции описывается настройка виртуальных устройств на всех контроллерах линеек Home и Uni (кроме Swiitch Home Controller) с версией прошивки не ниже 3.836.''' В качестве виртуальных могут выступать внешние устройства других производителей, устройства DIY, а также внутренние группы устройств Swiitch.<br>
Настройка делается в Web-интерфейсе контроллера: Личный кабинет > Контроллеры > Нужный контроллер > Кнопка «Информация», в открывшемся окне нажать на ссылку IP, чтобы перейти в Web-интерфейс.<br>
Выберите раздел «Виртуальные» в основном меню. Далее заполните нужные параметры в карточке виртуального устройства:<br>
'''Протокол:''' выбираем нужный протокол для виртуального устройства (устройство должно поддерживать этот протокол)<br>
'''Тип:''' выбираем нужный тип для виртуального устройства<br>
== Типы устройств ==
«Реле» – Устройство с двумя состояниями (включено / выключено)<br>
«Диммер» – Устройство с возможностью регулировки яркости<br>
«Диммер и температура» – Устройство с возможностью регулировки яркости и изменения температуры свечения<br>
«RGB» – Устройство с возможностью изменения яркости и цвета свечения<br>
«RGB и температура» – Устройство с возможностью изменения яркости, цвета и температуры свечения<br>
«Датчик температуры» – Датчик температуры<br>
«Датчик темп и влажности» – Датчик температуры и влажности<br>
«Дискретный датчик» – Датчик с двумя состояниями (замкнуто / размокнуто)<br>
«Аналоговый датчик» – Датчик с аналоговым значением<br>
«Датчик давления» – Датчик давления<br>
«Датчик освещенности» – Датчик освещенности<br>
«Датчик CO2» – Датчик углекислого газа<br>
«Кнопка» – Датчик с событием «Нажатие кнопки»<br>
«Датчик протечки» – Датчик протечки, выдает событие «Протечка»<br>
«Датчик утечки газа» – Датчик утечки газа, выдает событие «Утечка газа»<br>
«Датчик движения» – Датчик движения, выдает событие «Есть движение / Нет движения»<br>
«Охранный датчик» – Датчик движения, выдает событие «Тревога проникновения»<br>
«Счетчик энергии» – Устройство, показывающее количество использованной энергии<br>
== Протокол HTTP GET ==
'''ВНИМАНИЕ!''': на данный момент этот протокол работает только с исполнительными устройствами («Реле», «Диммер», «Диммер и температура», «RGB»).<br><br>
Для включения / выключения устройства необходимо в разделе «Управление» прописать в поля «Включить» и «Выключить» строки http для включения / выключения (берем данные из инструкции на устройство).<br>
''Пример: «Включить» = http://192.168.1.55/?state=on''<br>
''Пример: «Выключить» = http://192.168.1.55/?state=off''<br><br>
'''ВНИМАНИЕ!''': у одного устройства можно управлять только одним параметром – либо цветом либо температурой свечения.<br><br>
Для управления яркостью устройства необходимо в поле «Данные/Яркость» прописать строку управления яркостью устройства, вместо значения прописать %value%<br>
''Пример: «Данные/Яркость» = http://192.168.1.55/?brightness=%value%''<br>
<br>
Для управления цветом или температурой свечения необходимо в поле «Данные/Цвет» прописать строку управления цветом или температурой свечения устройства, вместо значения прописать %value%<br>
''Пример: «Данные/Цвет» = http://192.168.1.55/?color=%value%''<br>
== Протокол MQTT ==
Для включения устройства необходимо прописать в поле «Включить» канал MQTT для включения устройства, а в параметр «Включить» – значение, отправляемое в выбранный канал MQTT.<br>
''Пример:''<br>
''В разделе «Управление»: «Включить» = /diy_device/set''<br>
''В разделе «Параметр»: «Включить» = on''<br>
<br>
Для выключения устройства необходимо прописать в поле «Выключить» канал MQTT для выключения устройства, а в параметр «Выключить» – значение, отправляемое в выбранный канал MQTT.<br>
''Пример:''<br>
''В разделе «Управление»: «Выключить» = /diy_device/set''<br>
''В разделе «Параметр»: «Выключить» = off''<br>
<br>
Для управления яркостью устройства необходимо прописать в поле «Данные/Яркость» канал MQTT для изменения яркости устройства, значение яркости будет отправляться в выбранный канал MQTT.<br>
''Пример: «Данные/Яркость» = /diy_device/brightness''<br>
<br>
Для управления цветом или температурой свечения необходимо прописать в поле «Данные/Цвет» канал MQTT для изменения цвета или температуры свечения. Значение цвета или температуры свечения будет отправляться в выбранный канал MQTT.<br>
''Пример: «Данные/Цвет» = /diy_device/color''<br>
<br>
Для работы с датчиками «Датчик температуры», «Датчик темп и влажности», «Аналоговый датчик», «Датчик давления», «Датчик освещенности», «Датчик CO2», «Счетчик энергии» необходимо прописать в поле «Данные/Яркость» канал MQTT, в котором будут получаться данные датчика. Для датчика типа «Датчик темп и влажности» также нужно указать в поле «Данные/Цвет» канал MQTT, в котором будут получаться данные влажности. В поле «Включить/Множитель» и «Выключить/Множитель» нужно прописать множитель для читаемых данных.<br>
''Пример: «Данные/Яркость» = /diy_device/temp''<br>
''В разделе «Параметр»: «Включить/Множитель» = 1''<br>
''«Выключить/Множитель» = 1''<br>
<br>
Для работы с датчиками «Дискретный датчик», «Кнопка», «Датчик протечки», «Датчик утечки газа», «Датчик движения», «Охранный датчик» необходимо прописать в поле «Данные/Яркость» канал MQTT, в котором будут получаться данные датчика, а в разделе «Параметр» в поле «Включить/Множитель» прописать значение, при котором будет считаться, что датчик включен/замкнут, остальные значения, прочитанные из выбранного канала MQTT будут восприниматься, как состояние датчика «выключен/разомкнут».<br>
''Пример:''<br>
''В разделе «Управление»: «Включить» = /diy_device/motion''<br>
''В разделе «Параметр»: «Включить/Множитель» = true''<br>
<br>
== Протокол Modbus RTU ==
Для работы по этому протоколу необходим модуль расширения Home Ext Modbus RTU.<br>
<br>
Для включения устройства необходимо прописать в поле «Включить» ячейку для включения устройства, а в параметр «Включить» – значение, записываемое в выбранную ячейку.<br>
Формат: x:y/z<br>
x - тип команды Modbus RTU: «r» - 0x06 Write register или «c» - 0x05 Write coil<br>
y - адрес устройства Modbus RTU: 1-255<br>
z - ячейка устройства Modbus RTU: 0-65535<br>
''Пример:''<br>
''В разделе «Управление»: «Включить» = r:3/1''<br>
''В разделе «Параметр»: «Включить/Множитель» = 255''<br>
<br>
Для выключения устройства необходимо прописать в поле «Выключить» ячейку для выключения устройства, а в параметр «Выключить» – значение, записываемое в выбранную ячейку<br>
Формат: x:y/z<br>
x - тип команды Modbus RTU: «r» - 0x06 Write register или «c» - 0x05 Write coil<br>
y - адрес устройства Modbus RTU: 1-255<br>
z - ячейка устройства Modbus RTU: 0-65535<br>
''Пример:''<br>
''В разделе «Управление»: «Выключить» = r:3/1''<br>
''В разделе «Параметр»: «Выключить/Множитель» = 0''<br>
<br>
'''ВНИМАНИЕ!'''Изменение цвета и температуры свечения на данный момент не поддерживается.<br>
<br>
Для работы с датчиками «Датчик температуры», «Датчик темп и влажности», «Аналоговый датчик», «Датчик давления», «Датчик освещенности», «Датчик CO2», «Счетчик энергии» необходимо прописать в поле «Данные/Яркость» ячейку устройства Modbus RTU, из которой будут читаться данные датчика. Для датчика «Датчик темп и влажности» также нужно указать в поле «Данные/Цвет» ячейку, из которой будут читаться данные влажности. В поле «Включить/Множитель» и «Выключить/Множитель» нужно прописать множитель для читаемых данных. Дополнительно для отправки уставки температуры на устройства Modbus RTU можно указать в поле «Включить» ячейку Modbus RTU, в которую будут записываться данные уставки температуры и параметр «Яркость/Множитель», на значение которого будет умножаться температура уставки.<br>
Формат: x:y/z<br>
x - тип команды Modbus RTU: «r» - 0x03 Read holding register register, «ri» - 0x04 Read input register, «c» - Read coil, «ci» - Read input coil<br>
y - адрес устройства Modbus RTU: 1-255<br>
z - ячейка устройства Modbus RTU: 0-65535<br>
''Пример:''<br>
''В разделе «Управление»: «Данные/Яркость» = ri:1/1''<br>
''В разделе «Управление»: «Данные/Цвет» = ri:1/2''<br>
''В разделе «Управление»: «Управление-Включить» = ri:1/20''<br>
''В разделе «Параметр»: «Включить» = 0.1''<br>
''В разделе «Параметр»: «Выключить» = 0.1''<br>
''В разделе «Параметр»: «Яркость/Множитель» = 1''<br>
<br>
Для работы с датчиками «Дискретный датчик», «Кнопка», «Датчик протечки», «Датчик утечки газа», «Датчик движения», «Охранный датчик» необходимо прописать в поле «Данные/Яркость» ячейку устройства Modbus RTU, из которой будут читаться данные датчика, а в разделе «Параметр» в поле «Включить» прописать значение, при котором будет считаться, что датчик включен/замкнут, остальные значения прочитанные из выбранной ячейки будут восприниматься, как состояние датчика «выключен/разомкнут». Дополнительно при команде «Поставить на охрану» будут записываться в ячейку «Управление» > «Включить» данные из поля «Параметр» > «Включить», а при команде «Снять с охраны» будут записываться в ячейку «Управление» > «Выключить» данные из поля «Параметр» > «Выключить»<br>
Формат: x:y/z<br>
x - тип команды Modbus RTU: «r» - 0x03 Read holding register register, «ri» - 0x04 Read input register, «c» - Read coil, «ci» - Read input coil<br>
y - адрес устройства Modbus RTU: 1-255<br>
z - ячейка устройства Modbus RTU: 0-65535<br>
''Пример:''<br>
''В разделе «Управление»: «Включить» = ri:1/1''<br>
''В разделе «Параметр»: «Включить» = 255''<br>
== Протокол Modbus TCP ==
На данный момент не поддерживается
== Протокол Yeelight ==
В поле "Данные/Яркость" необходимо прописать ip адрес светильника Yeelight<br>
Формат : ip[:port][/bg]:<br>
ip - IP адрес светильника<br>
[:port] - порт светильника (можно не указывать)<br>
[/bg] - для указания что это виртуальное устройство будет управлять подсветкой выбранного светильника<br>
Пример :
Пример: "Данные/Яркость" = 192.168.1.15/bg - управление подсветкой светильника с IP адресом 192.168.1.15<br>
<br>
Внимание, для корректной работы светильника Yeelight необходимо:<br>
В настройках роутера - прописать фиксированный адрес для каждого светильника Yeelight (см. инструкцию на роутер)<br>
В настройках штатного приложения Yeelight - вклчюить режим "Управление по LAN"<br>
https://sprut.ai/article/yeelight-rezhim-razrabotchika-dobavlenie-v-domoticz
== Протокол «Глобальная группа» ==
<br>
Внимание, для работы необходимо чтобы все устройства входящие в выбранную глобальную группу были подключены у облачному серверу Swiitch или были подключены к одному брокеру MQTT<br>
Для управления группами устройств Swiitch, необходимо в поле "Данные/Яркость" прописать выбранную глобальную группу, а также во все устройства Swiitch прописать эту же глобальную группу<br>
Пример: "Данные/Яркость" = 5<br>
Для работы с датчиками "Датчик температуры", "Датчик темп и влажности", "Аналоговый датчик", "Датчик давления", "Датчик освещенности", "Датчик CO2", "Счетчик энергии", необходимо прописать в поле "Данные/Яркость", прописать выбранную глобальную группу, а также во все датчики Swiitch прописать эту же глобальную группу, в поле "Включить/Множитель" и "Выключить/Множитель" нужно прописать множитель для читаемых данных<br>
Пример:<br>
"Данные/Яркость" = 5<br>
"Параметр" - "Включить" = 1<br>
"Параметр" - "Выключить" = 1<br>
Для работы с датчиками "Дискретный датчик", "Кнопка", "Датчик протечки", "Датчик утечки газа", "Датчик движения", "Охранный датчик", необходимо прописать в поле "Данные/Яркость", прописать выбранную глобальную группу, а также во все датчики Swiitch прописать эту же глобальную группу<br>
Пример:<br>
"Данные/Яркость" = 2<br>
<br>
Внимание, в виртуальный датчики будут отображаться данные с последнего датчика отправившего свои данные<br>
<br>
== Протокол Noolite и Noolite F ==
Для работы необходим модуль расширения Home Ext Noolite<br>
Для управления устройством Noolite или получения данных от датчика Noolite, необходимо в поле "Данные/Яркость" - прописать номер Noolite канала 1-31<br>
Пример: "Данные/Яркость" = 3<br>
Для привязки датчика, необходимо в веб интерфейсе нажать кнопку "Связать", потом нажать кнопку привязки на датчике (см. инструкцию на датчик)<br>
<br>
Для привязки исполнительного устройство, необходимо на устройстве Noolite нажать кнопку привязки (см. инструкцию на устройство), потом в веб интерфейсе нажать кнопку "Связать" и после подтвердить привязку на устройстве Noolite (см. инструкцию на устройство)<br>
<br>
Для очистки канала, в веб интерфейсе необходимо нажать кнопку "Отвязать"<br>