Просмотр кода страницы Настройка виртуальных устройств

'''В этой инструкции описывается настройка виртуальных устройств на всех контроллерах линеек Home и Uni (кроме Swiitch Home Controller) с версией прошивки не ниже 3.836. В качестве виртуальных могут выступать внешние устройства других производителей, устройства DIY, а также внутренние группы устройств Swiitch.'''<br>
  
Настройка делается в Web-интерфейсе контроллера: Личный кабинет > Контроллеры > Нужный контроллер > Кнопка «Информация», в открывшемся окне нажать на ссылку IP, чтобы перейти в Web-интерфейс.<br> 
[[Файл:Виртуальные_устройства.png |700px|Карточки виртуальных устройств в разделе «Виртуальные» в Web-интерфейсе|center]]
Выберите раздел «Виртуальные» в основном меню. Далее заполните нужные параметры в карточке виртуального устройства:<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>

== Протокол 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>
''Пример: «Данные/Яркость» = 2''<br>
<br>
'''ВНИМАНИЕ!''' В виртуальном датчике будут отображаться данные с последнего датчика, отправившего свои данные.<br>
== Протокол Noolite и Noolite F ==
Для работы по этому протоколу необходим модуль расширения Home Ext Noolite.<br>
Для управления устройством Noolite или получения данных от датчика Noolite необходимо в поле «Данные/Яркость» прописать номер Noolite канала 1-31<br>
''Пример: «Данные/Яркость» = 3''<br>

Для привязки датчика необходимо в Web-интерфейсе в карточке виртуального устройства нажать кнопку «Связать», потом нажать кнопку привязки на датчике (см. инструкцию на датчик).<br>
<br>
Для привязки исполнительного устройства необходимо на устройстве Noolite нажать кнопку привязки, после чего в web-интерфейсе нажать кнопку «Связать» и далее подтвердить привязку на устройстве Noolite (см. инструкцию на устройство).<br>
<br>
Для очистки канала в web-интерфейсе необходимо нажать кнопку «Отвязать».<br>