Разница между страницами «Мобильный интерфейс» и «Настройка виртуальных устройств»

Материал из Система Swiitch
(Различия между страницами)
Перейти к навигации Перейти к поиску
imported>Maria Tumilovich
 
imported>Maria Tumilovich
 
Строка 1: Строка 1:
== Главный экран ==
+
'''В этой инструкции описывается РУЧНАЯ настройка виртуальных устройств на всех контроллерах линеек Home и Uni (кроме Swiitch Home Controller) с версией прошивки не ниже 3.836. Ручная настройка может помочь в случае, если по каким-то причинам [[Мастер_добавления_виртуальных_устройств |автоматическая настройка]] вам не подходит. В качестве виртуальных могут выступать внешние устройства других производителей, устройства DIY, а также внутренние группы устройств Swiitch.'''<br>
<center>
+
 
[[Файл: IOS_port_mode_button_new_device.png |200px | Главный экран с кнопкой добавления нового устройства]]
+
Настройка делается в Web-интерфейсе контроллера: Личный кабинет > Контроллеры > Нужный контроллер > Кнопка «Информация», в открывшемся окне нажать на ссылку IP, чтобы перейти в Web-интерфейс.<br>  
[[Файл: IOS_port_mode.png |200px | Главный экран]]
+
[[Файл:Виртуальные_устройства.png |700px|Карточки виртуальных устройств в разделе «Виртуальные» в Web-интерфейсе|center]]
[[Файл: IOS_port_mode_sensor.png |200px | Главный экран с датчиками]]
+
Выберите раздел «Виртуальные» в основном меню. Далее заполните нужные параметры в карточке виртуального устройства:<br>
[[Файл: IOS_group_select.png |200px | Выбор отображаемых устройств]]
+
'''Протокол:''' выбираем нужный протокол для виртуального устройства (устройство должно поддерживать этот протокол)<br>
</center >
+
'''Тип:''' выбираем нужный тип для виртуального устройства<br>
На главном экране виден список подключенных устройств (реле и датчики), которые можно контролировать через приложение. В нижней части списка находится кнопка добавления нового устройства. Какие устройства будут отображаться в этом списке можно выбрать, нажав на надпись «Все устройства» справа от значка «Глаз». При этом открывается диалог «Выбор группы».<br><br>
 
Верхнее меню<br>
 
При нажатии на логотип Swiitch в верхнем левом углу можно посмотреть все установленные модули (только для режима «Эксперт»).<br>
 
При нажатии на кнопку «Щит» открывается диалог «Сигнализация».<br>
 
При нажатии на кнопку «Волшебная палочка» открывается диалог «Сцены». <br>
 
При нажатии на кнопку «Шестеренка» открывается диалог «Настройки». Кроме изменения настроек системы здесь можно посмотреть и настроить разделы «События», «Группы», «Облако».<br>
 
<br>
 
Под верхним меню отображаются текущие значения температуры и влажности (если установлен датчик температуры и влажности). При нажатии на значок «Термометр» отобразится диалог «Климат».<br><br>
 
Каждая строка списка устройств содержит: изображение устройства, название устройства или датчика, данные этого устройства, если есть (температура, влажность, статус, обход датчика), справа отображается значок состояния: включено/выключено, для термостата – включено/выключено/нагревается/остывает/режим «прогрев», для датчиков климата – включен/выключен режим термостата, для охранных датчиков – включен/выключен режим охраны.
 
  
== Основные настройки ==
+
== Типы устройств ==
<center>
+
«Реле» – Устройство с двумя состояниями (включено / выключено)<br>
[[Файл: IOS_settings_top.png |200px|Основные настройки]]
+
«Диммер» – Устройство с возможностью регулировки яркости<br>
[[Файл: IOS_settings_bottom.png |200px |Основные настройки]]
+
«Диммер и температура» – Устройство с возможностью регулировки яркости и изменения температуры свечения<br>
</center>
+
«RGB» – Устройство с возможностью изменения яркости и цвета свечения<br>
В диалоге «Настройки» (он открывается при нажатии на кнопку «Шестеренка» в верхнем меню основного экрана) можно отрегулировать следующие параметры:<br><br>
+
«RGB и температура» – Устройство с возможностью изменения яркости, цвета и температуры свечения<br>
Режим «Эксперт»: включает показ в интерфейсе дополнительных опций настройки<br>
+
«Датчик температуры» – Датчик температуры<br>
Режим «На стене»: включает горизонтальную ориентацию интерфейса, для просмотра на планшете <br>
+
«Датчик темп и влажности» – Датчик температуры и влажности<br>
Основная комната: если здесь выбрана конкретная группа, то после изменения вручную группы отображаемых устройств, по прошествии некоторого времени без активности, основной экран возвращается к отображению списка устройств этой группы<br>
+
«Дискретный датчик» – Датчик с двумя состояниями (замкнуто / размокнуто)<br>
Тема экрана: включение дневной или ночной темы экрана или установка автоматической смены тем в зависимости от времени суток (конкретное время выбирается ниже)<br>
+
«Аналоговый датчик» – Датчик с аналоговым значением<br>
Яркость в ночном режиме: выставляется уровень подсветки экрана в ночном режиме<br>
+
«Датчик давления» – Датчик давления<br>
Дневной режим начинается: выставляется время начала дневного режима во всей системе <br>
+
«Датчик освещенности» – Датчик освещенности<br>
Ночной режим начинается: выставляется время начала ночного режима во всей системе <br>
+
«Датчик CO2» – Датчик углекислого газа<br>
Датчик на главном экране: выбор датчика, данные которого будут отображаться под верхним меню рядом с кнопкой выбора отображаемых устройств на основном экране <br>
+
«Кнопка» – Датчик с событием «Нажатие кнопки»<br>
Отправлять события на почту: при включении уведомления системы будут отправляться на ящик электронной почты, указанный при регистрации аккаунта<br>
+
«Датчик протечки» – Датчик протечки, выдает событие «Протечка»<br>
Отправлять события в telegram: при включении уведомления системы будут отправляться на telegram-аккаунт, который привязан к вашему контакту <br>
+
«Датчик утечки газа» – Датчик утечки газа, выдает событие «Утечка газа»<br>
Отправлять события в приложение: при включении уведомления системы будут отправляться на все мобильные устройства, на которых выполнен вход в ваш аккаунт<br>
+
«Датчик движения» – Датчик движения, выдает событие «Есть движение / Нет движения»<br>
Отправлять инфо-сообщения: отправлять информационные уведомления системы на те каналы, которые включены<br>
+
«Охранный датчик» – Датчик движения, выдает событие «Тревога проникновения»<br>
Оповещать о входе: отправлять уведомления о входе в аккаунт в личном кабинете на сервере www.swiitch.ru <br>
+
«Счетчик энергии» – Устройство, показывающее количество использованной энергии<br>
Оповещать о тревогах: отправлять уведомления о проникновениии при включенном режиме охраны на нужных датчиках <br>
 
Оповещать о пожарах: отправлять уведомления о пожарной тревоге при включенном режиме охраны на нужных пожарных датчиках <br>
 
Оповещать о включении датчика: отправлять уведомления обо всех изменениях состояния дискретных датчиков (кнопки, выключатели, датчики движения)<br>
 
Оповещать о включениях сигнализации: отправлять уведомления обо всех изменениях состояния охранных датчиков (датчики движения, датчики протечки, пожарные датчики) <br>
 
Оповещать о включениях реле: отправлять уведомления обо всех изменениях состояния исполняемых устройств (включение/выключение)<br>
 
Оповещать о картах доступа: отправлять уведомления обо всех предъявленных картах доступа<br>
 
Оповещать о запуске устройств: отправлять уведомления о запуске и перезагрузке устройств<br>
 
  
== Разделы «События», «Группы», «Облако» (диалог «Настройки») ==
+
== Протокол HTTP GET ==
<center>
+
[[Файл:ВиртуальныеHTTPGET.png |200px|Настройка виртуального устройства по протоколу HTTP GET в системе Swiitch|right]]
[[Файл: IOS_events.png |200px |События]]
+
'''ВНИМАНИЕ!''' На данный момент этот протокол работает только с исполнительными устройствами («Реле», «Диммер», «Диммер и температура», «RGB»).<br><br>
[[Файл: Ios_groups_edit.png |200px |Редактирование групп]]
+
Для включения / выключения устройства необходимо в разделе «Управление» прописать в поля «Включить» и «Выключить» строки http для включения / выключения (берем данные из инструкции на устройство).<br>
[[Файл: IOS_groups_edit_picture.png |200px |Выбор изображния для группы]]
+
''Пример: «Включить» = http://192.168.1.55/?state=on''<br>
[[Файл: IOS_cloud.png |200px | Облако]]
+
''«Выключить» = http://192.168.1.55/?state=off''<br><br>
[[Файл: IOS_cloud_registration.png |200px | Облако - регистрация]]
+
Для управления яркостью устройства необходимо в поле «Данные/Яркость» прописать строку управления яркостью устройства, вместо значения прописать %value%<br>
</center>
+
''Пример: «Данные/Яркость» = http://192.168.1.55/?brightness=%value%''<br>
В диалоге «Настройки» можно посмотреть и настроить разделы «События», «Группы», «Облако», нажав соответствующие кнопки.<br>
+
<br>
Раздел «События» служит для просмотра истории уведомлений за день. Для выбора другой даты нужно щелкнуть по текущей, либо использовать стрелки справа и слева от нее.<br>
+
Для управления цветом или температурой свечения необходимо в поле «Данные/Цвет» прописать строку управления цветом или температурой свечения устройства, вместо значения прописать %value%<br>
Раздел «Группы» позволяет редактировать группы устройств. Здесь можно задать название группы и выбрать для нее соответствующее изображение. Изменения сохраняются автоматически при закрытии диалога.<br>
+
''Пример: «Данные/Цвет» = http://192.168.1.55/?color=%value%''<br>
В разделе «Облако» открывается диалог для входа в облако или регистрации нового аккаунта.<br>
+
'''ВНИМАНИЕ!''' У одного устройства можно управлять только одним параметром либо цветом либо температурой свечения.<br>
Вход в облако: ввести данные от аккаунта и нажать кнопку «Вход», если аккаунта еще нет – нажать кнопку «Регистрация»<br>
 
Для регистрации в облаке необходимо ввести следующие данные: «Имя» произвольное имя для отображения в личном кабинете, EMail – адрес почты, на который будут приходить сообщения (будет использоваться для восстановления пароля), «Пароль» (вводится повторно в поле «Повтор») – пароль для аккаунта в личном кабинете Swiitch.
 
  
== Меню «Климат» ==
+
== Протокол MQTT ==
<center>
+
Для включения устройства необходимо прописать в поле «Включить» канал MQTT для включения устройства, а в параметр «Включить» – значение, отправляемое в выбранный канал MQTT.<br>
[[Файл: IOS_port_mode.png |200px | Главный экран]]
+
''Пример: В разделе «Управление»: «Включить» = /diy_device/set''<br>
[[Файл: IOS_climat.png |200px | Меню "Климат"]]
+
''В разделе «Параметр»: «Включить» = on''<br>
[[Файл: IOS_climat_menu.png |200px |Настройки в меню "Климат"]]
+
<br>
</center>
+
Для выключения устройства необходимо прописать в поле «Выключить» канал MQTT для выключения устройства, а в параметр «Выключить» – значение, отправляемое в выбранный канал MQTT.<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>
 +
''Пример: В разделе «Управление»: «Включить» = /diy_device/motion''<br>
 +
''В разделе «Параметр»: «Включить/Множитель» = true''<br>
 +
<br>
 +
Для работы с сторонними устройствами по протоколу MQTT, необходимо подключить контроллер к своему MQTT брокеру<br>
  
Если у вас установлен датчик температуры и влажности, под верхним меню на главном экране отображаются текущие значения температуры и влажности. При нажатии на значок «Термометр» появляется диалог «Климат». Здесь выводится список всех подключенных термостатов, отображаются их данные и состояние. Для быстрой настройки комфортной температуры нужно нажать на значок «Термометр» слева от названия термостата или на само название.
+
== Протокол Modbus RTU ==
 +
[[Файл:ВиртуальныеModbusRTU.png |200px|Настройка виртуального устройства по протоколу Modbus RTU в системе Swiitch|right]]
 +
Для работы по этому протоколу необходим модуль расширения Home Ext Modbus RTU.<br><br>
 +
Список устройств Modbus RTU, для которых в системе уже существуют готовые профили: http://wiki.swiitch.ru/index.php/Поддержка_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>
 +
''Пример: В разделе «Управление»: «Включить» = r:3/1''<br>
 +
''В разделе «Параметр»: «Включить/Множитель» = 256''<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>
 +
''Пример: В разделе «Управление»: «Выключить» = r:3/1''<br>
 +
''В разделе «Параметр»: «Выключить/Множитель» = 512''<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>
 +
''Пример: В разделе «Управление»: «Данные/Яркость» = 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>
 +
''Пример: В разделе «Управление»: «Включить» = ri:1/1''<br>
 +
''В разделе «Параметр»: «Включить» = 255''<br>
  
== Меню «Сигнализация» ==
+
== Протокол Modbus TCP ==
<center>
+
На данный момент не поддерживается.
[[Файл: IOS_security.png |200px |Меню "Сигнализация"]]
 
[[Файл: IOS_security_full.png |200px |Полный список в меню "Сигнализация"]]
 
</center>
 
  
При нажатии на кнопку «Щит» в верхнем меню на главном экране открывается диалог «Сигнализация». Здесь могут отображаться любые виды сигнализаций, в зависимости от типа датчиков, которые у вас установлены.
+
== Протокол Yeelight ==
 +
[[Файл:ВиртуальныеYeelight.png |200px|Настройка виртуального устройства по протоколу Yeelight в системе Swiitch|right]]
 +
В поле «Данные/Яркость» необходимо прописать 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>
  
== Меню "Сцены" ==
+
== Протокол «Глобальная группа» ==
<center>
+
С помощью создания глобальной группы можно настроить работу нескольких устройств как одного. К примеру, можно использовать такую группу в качестве мастер-выключателя либо объединить несколько источников света в одном помещении.<br><br>
[[Файл: IOS_scene.png |200px | Меню "Сцены"]]
+
[[Файл:ВиртуальныеGlobalGroup.png |400px|Настройка виртуальной глобальной группы в системе Swiitch: прописание группы в настройках окна и карточка глобальной группы «Все окна»|left]]
</center>
+
'''ВНИМАНИЕ!''' Для работы необходимо, чтобы все устройства, входящие в глобальную группу, были подключены к облачному серверу Swiitch или к одному брокеру MQTT.<br><br>
 +
Для управления группами устройств Swiitch необходимо в поле «Данные/Яркость» прописать выбранную глобальную группу, а также в настройках всех устройств Swiitch прописать эту же глобальную группу: Личный кабинет > Управление > Нужное устройство > Кнопка настроек (Шестеренка) > Группа > Глобальная группа.<br>
 +
''Пример: «Данные/Яркость» = 21''<br><br>
 +
Для работы с датчиками «Датчик температуры», «Датчик темп и влажности», «Аналоговый датчик», «Датчик давления», «Датчик освещенности», «Датчик CO2», «Счетчик энергии» необходимо прописать в поле «Данные/Яркость» выбранную глобальную группу, а также в настройках всех задействованных в группе датчиков Swiitch прописать эту же глобальную группу. В поле «Включить/Множитель» и «Выключить/Множитель» нужно прописать множитель для читаемых данных<br>
 +
''Пример: «Данные/Яркость» = 5''<br>
 +
''В разделе «Параметр»: «Включить» = 1''<br>
 +
''В разделе «Параметр»: «Выключить» = 1''<br><br>
 +
Для работы с датчиками «Дискретный датчик», «Кнопка», «Датчик протечки», «Датчик утечки газа», «Датчик движения», «Охранный датчик» необходимо прописать в поле «Данные/Яркость» выбранную глобальную группу, а также в настройках всех задействованных в группе датчиков Swiitch прописать эту же глобальную группу<br>
 +
''Пример: «Данные/Яркость» = 2''<br>
 +
<br>
 +
'''ВНИМАНИЕ!''' В виртуальном датчике будут отображаться данные с последнего датчика, отправившего свои данные.<br>
  
== Меню "Модули" ==
+
== Протокол Noolite и Noolite F ==
<center>
+
Для работы по этому протоколу необходим модуль расширения Home Ext Noolite.<br>
[[Файл: IOS_device_list.png |200px | Меню "Модули"]]
+
Для управления устройством Noolite или получения данных от датчика Noolite необходимо в поле «Данные/Яркость» прописать номер Noolite канала 1-31<br>
</center>
+
''Пример: «Данные/Яркость» = 3''<br><br>
 +
Для привязки датчика необходимо в Web-интерфейсе в карточке виртуального устройства нажать кнопку «Связать», потом нажать кнопку привязки на датчике (см. инструкцию на датчик).<br>
 +
<br>
 +
Для привязки исполнительного устройства необходимо на устройстве Noolite нажать кнопку привязки, после чего в web-интерфейсе нажать кнопку «Связать» и далее подтвердить привязку на устройстве Noolite (см. инструкцию на устройство).<br>
 +
<br>
 +
Для очистки канала в web-интерфейсе необходимо нажать кнопку «Отвязать».<br>
  
== Меню "Новое устройство" ==
+
== Протокол Zigbee ==
<center>
+
Для работы по этому протоколу необходим модуль расширения Home Ext Zigbee.<br><br>
[[Файл: IOS_new_device.png |200px | Меню "Новое устройство"]]
+
Подключение датчиков и устройств Zigbee состоит из двух этапов:<br>
[[Файл: IOS_new_device_connect.png |200px | Меню "Новое устройство" - подключение]]
+
1. Подключение датчиков и устройств Zigbee к контроллеру:<br>
[[Файл: IOS_new_device_sensor.png |200px | Меню "Новое устройство" - выбор датчика]]
+
Web-интерфейс > Беспроводные > Кнопка «Добавить» (включится режим добавления, кнопка изменит цвет), далее выполнить действия для перевода этого Zigbee устройства в режим добавления по инструкции на это устройство (или см. пункт «Подключение» на странице [[Поддержка Zigbee устройств]]), после этого обновить страницу «Беспроводные». Если всё сделано правильно, на странице появится новое устройство.<br>
</center>
+
<br>
 
+
2. Добавление виртуального устройства и связь его с новым устройством Zigbee:<br>
== Выбор группы ==
+
Web-интерфейс > Виртуальные, выбрать нужное виртуальное устройство в выпадающем меню, выбрать протокол - Zigbee, выбрать тип подключенного устройства и нажать кнопку «Связать», после этого инициировать отправку данных с добавляемого устройства Zigbee (например нажать кнопку или дать сработку по этому устройству), после этого обновить страницу. В полях «Данные/Яркость» и «Данные/Цвет» появятся данные добавленного устройства Zigbee.
<center>
 
[[Файл: IOS_group_select.png |200px | Выбор группы]]
 
</center>
 
 
 
== Меню исполнительного устройства с термостатом ==
 
<center>
 
[[Файл: IOS_thermostat_menu_off.png |200px | Термостат выключен]]
 
[[Файл: IOS_thermostat_menu.png |200px | Настройки термостата]]
 
[[Файл: IOS_thermostat_menu_temp.png |200px | Выбор желаемой температуры термостата]]
 
[[Файл: IOS_thermostat_menu_cool.png |200px | Охлаждение термостата]]
 
[[Файл: IOS_thermostat_menu_heat.png |200px | Режим термостата "Прогрев"]]
 
</center>
 
 
 
== Меню исполнительного устройства - с возможностью диммирования или изменения цвета ==
 
<center>
 
[[Файл: IOS_relay_dimmer.png |200px | Меню диммера и выбора цвета]]
 
[[Файл: IOS_relay_color_select.png |200px | Выбор цвета]]
 
[[Файл: IOS_relay_color_temp_select.png |200px | Выбор цветовой температуры]]
 
</center>
 
 
 
== Меню исполнительного устройства - общие параметры ==
 
<center>
 
[[Файл: IOS_relay_motion.png |200px | Блокировка датчика движения]]
 
[[Файл: IOS_thermostat_menu_timer.png |200px | Таймер]]
 
[[Файл: IOS_thermostat_menu_day_timer.png |200px | Расписание]]
 
[[Файл: IOS_thermostat_menu_day_timer_action_select.png |200px | Расписание - выбор команды]]
 
[[Файл: IOS_thermostat_menu_day_timer_time_select.png |200px | Расписание - выбор времени]]
 
</center>
 
 
 
== Меню датчика ==
 
<center>
 
[[Файл: IOS_sensor_security.png |200px | Меню охранного датчика]]
 
[[Файл: IOS_sensor_thermo.png |200px | Меню датчика климата]]
 
[[Файл: IOS_sensor_thermo_mode_select.png |200px | Выбор температуры датчика климата]]
 
</center>
 
 
 
== Информация о устройстве ==
 
<center>
 
[[Файл: IOS_hard_info.png |200px | Информация о устройстве]]
 
</center>
 
 
 
== Настройки устройства ==
 
<center>
 
[[Файл: IOS_hard_settings_top.png |200px | Настройки устройства]]
 
[[Файл: IOS_hard_settings_bottom.png |200px | Настройки устройства]]
 
</center>
 

Версия от 13:04, 6 февраля 2023

В этой инструкции описывается РУЧНАЯ настройка виртуальных устройств на всех контроллерах линеек Home и Uni (кроме Swiitch Home Controller) с версией прошивки не ниже 3.836. Ручная настройка может помочь в случае, если по каким-то причинам автоматическая настройка вам не подходит. В качестве виртуальных могут выступать внешние устройства других производителей, устройства DIY, а также внутренние группы устройств Swiitch.

Настройка делается в Web-интерфейсе контроллера: Личный кабинет > Контроллеры > Нужный контроллер > Кнопка «Информация», в открывшемся окне нажать на ссылку IP, чтобы перейти в Web-интерфейс.

Карточки виртуальных устройств в разделе «Виртуальные» в Web-интерфейсе

Выберите раздел «Виртуальные» в основном меню. Далее заполните нужные параметры в карточке виртуального устройства:
Протокол: выбираем нужный протокол для виртуального устройства (устройство должно поддерживать этот протокол)
Тип: выбираем нужный тип для виртуального устройства

Типы устройств

«Реле» – Устройство с двумя состояниями (включено / выключено)
«Диммер» – Устройство с возможностью регулировки яркости
«Диммер и температура» – Устройство с возможностью регулировки яркости и изменения температуры свечения
«RGB» – Устройство с возможностью изменения яркости и цвета свечения
«RGB и температура» – Устройство с возможностью изменения яркости, цвета и температуры свечения
«Датчик температуры» – Датчик температуры
«Датчик темп и влажности» – Датчик температуры и влажности
«Дискретный датчик» – Датчик с двумя состояниями (замкнуто / размокнуто)
«Аналоговый датчик» – Датчик с аналоговым значением
«Датчик давления» – Датчик давления
«Датчик освещенности» – Датчик освещенности
«Датчик CO2» – Датчик углекислого газа
«Кнопка» – Датчик с событием «Нажатие кнопки»
«Датчик протечки» – Датчик протечки, выдает событие «Протечка»
«Датчик утечки газа» – Датчик утечки газа, выдает событие «Утечка газа»
«Датчик движения» – Датчик движения, выдает событие «Есть движение / Нет движения»
«Охранный датчик» – Датчик движения, выдает событие «Тревога проникновения»
«Счетчик энергии» – Устройство, показывающее количество использованной энергии

Протокол HTTP GET

Настройка виртуального устройства по протоколу HTTP GET в системе Swiitch

ВНИМАНИЕ! На данный момент этот протокол работает только с исполнительными устройствами («Реле», «Диммер», «Диммер и температура», «RGB»).

Для включения / выключения устройства необходимо в разделе «Управление» прописать в поля «Включить» и «Выключить» строки http для включения / выключения (берем данные из инструкции на устройство).
Пример: «Включить» = http://192.168.1.55/?state=on
«Выключить» = http://192.168.1.55/?state=off

Для управления яркостью устройства необходимо в поле «Данные/Яркость» прописать строку управления яркостью устройства, вместо значения прописать %value%
Пример: «Данные/Яркость» = http://192.168.1.55/?brightness=%value%

Для управления цветом или температурой свечения необходимо в поле «Данные/Цвет» прописать строку управления цветом или температурой свечения устройства, вместо значения прописать %value%
Пример: «Данные/Цвет» = http://192.168.1.55/?color=%value%
ВНИМАНИЕ! У одного устройства можно управлять только одним параметром – либо цветом либо температурой свечения.

Протокол MQTT

Для включения устройства необходимо прописать в поле «Включить» канал MQTT для включения устройства, а в параметр «Включить» – значение, отправляемое в выбранный канал MQTT.
Пример: В разделе «Управление»: «Включить» = /diy_device/set
В разделе «Параметр»: «Включить» = on

Для выключения устройства необходимо прописать в поле «Выключить» канал MQTT для выключения устройства, а в параметр «Выключить» – значение, отправляемое в выбранный канал MQTT.
Пример: В разделе «Управление»: «Выключить» = /diy_device/set
В разделе «Параметр»: «Выключить» = off

Для управления яркостью устройства необходимо прописать в поле «Данные/Яркость» канал MQTT для изменения яркости устройства. Значение яркости будет отправляться в выбранный канал MQTT.
Пример: «Данные/Яркость» = /diy_device/brightness

Для управления цветом или температурой свечения необходимо прописать в поле «Данные/Цвет» канал MQTT для изменения цвета или температуры свечения. Значение цвета или температуры свечения будет отправляться в выбранный канал MQTT.
Пример: «Данные/Цвет» = /diy_device/color

Для работы с датчиками «Датчик температуры», «Датчик темп и влажности», «Аналоговый датчик», «Датчик давления», «Датчик освещенности», «Датчик CO2», «Счетчик энергии» необходимо прописать в поле «Данные/Яркость» канал MQTT, в котором будут получаться данные датчика. Для датчика типа «Датчик темп и влажности» также нужно указать в поле «Данные/Цвет» канал MQTT, в котором будут получаться данные влажности. В поле «Включить/Множитель» и «Выключить/Множитель» нужно прописать множитель для читаемых данных.
Пример: «Данные/Яркость» = /diy_device/temp
В разделе «Параметр»: «Включить/Множитель» = 1
«Выключить/Множитель» = 1

Для работы с датчиками «Дискретный датчик», «Кнопка», «Датчик протечки», «Датчик утечки газа», «Датчик движения», «Охранный датчик» необходимо прописать в поле «Данные/Яркость» канал MQTT, в котором будут получаться данные датчика, а в разделе «Параметр» в поле «Включить/Множитель» прописать значение, при котором будет считаться, что датчик включен/замкнут. Остальные значения, прочитанные из выбранного канала MQTT будут восприниматься, как состояние датчика «выключен/разомкнут».
Пример: В разделе «Управление»: «Включить» = /diy_device/motion
В разделе «Параметр»: «Включить/Множитель» = true

Для работы с сторонними устройствами по протоколу MQTT, необходимо подключить контроллер к своему MQTT брокеру

Протокол Modbus RTU

Настройка виртуального устройства по протоколу Modbus RTU в системе Swiitch

Для работы по этому протоколу необходим модуль расширения Home Ext Modbus RTU.

Список устройств Modbus RTU, для которых в системе уже существуют готовые профили: http://wiki.swiitch.ru/index.php/Поддержка_Modbus_RTU_устройств.

Для включения устройства необходимо прописать в поле «Включить» ячейку для включения устройства, а в параметр «Включить» – значение, записываемое в выбранную ячейку.
Формат: x:y/z
x – тип команды Modbus RTU: «r» – 0x06 Write register или «c» – 0x05 Write coil
y – адрес устройства Modbus RTU: 1-255
z – ячейка устройства Modbus RTU: 0-65535
Пример: В разделе «Управление»: «Включить» = r:3/1
В разделе «Параметр»: «Включить/Множитель» = 256

Для выключения устройства необходимо прописать в поле «Выключить» ячейку для выключения устройства, а в параметр «Выключить» – значение, записываемое в выбранную ячейку.
Формат: x:y/z
x – тип команды Modbus RTU: «r» – 0x06 Write register или «c» – 0x05 Write coil
y – адрес устройства Modbus RTU: 1-255
z – ячейка устройства Modbus RTU: 0-65535
Пример: В разделе «Управление»: «Выключить» = r:3/1
В разделе «Параметр»: «Выключить/Множитель» = 512

ВНИМАНИЕ! Изменение цвета и температуры свечения на данный момент не поддерживается.

Для работы с датчиками «Датчик температуры», «Датчик темп и влажности», «Аналоговый датчик», «Датчик давления», «Датчик освещенности», «Датчик CO2», «Счетчик энергии» необходимо прописать в поле «Данные/Яркость» ячейку устройства Modbus RTU, из которой будут читаться данные датчика. Для датчика «Датчик темп и влажности» также нужно указать в поле «Данные/Цвет» ячейку, из которой будут читаться данные влажности. В поле «Включить/Множитель» и «Выключить/Множитель» нужно прописать множитель для читаемых данных. Дополнительно для отправки уставки температуры на устройства Modbus RTU можно указать в поле «Включить» ячейку Modbus RTU, в которую будут записываться данные уставки температуры и параметр «Яркость/Множитель», на значение которого будет умножаться температура уставки.
Формат: x:y/z
x – тип команды Modbus RTU: «r» – 0x03 Read holding register register, «ri» – 0x04 Read input register, «c» – Read coil, «ci» – Read input coil
y – адрес устройства Modbus RTU: 1-255
z – ячейка устройства Modbus RTU: 0-65535
Пример: В разделе «Управление»: «Данные/Яркость» = ri:1/1
В разделе «Управление»: «Данные/Цвет» = ri:1/2
В разделе «Управление»: «Управление-Включить» = ri:1/20
В разделе «Параметр»: «Включить» = 0.1
В разделе «Параметр»: «Выключить» = 0.1
В разделе «Параметр»: «Яркость/Множитель» = 1

Для работы с датчиками «Дискретный датчик», «Кнопка», «Датчик протечки», «Датчик утечки газа», «Датчик движения», «Охранный датчик» необходимо прописать в поле «Данные/Яркость» ячейку устройства Modbus RTU, из которой будут читаться данные датчика, а в разделе «Параметр» в поле «Включить» прописать значение, при котором будет считаться, что датчик включен/замкнут, остальные значения прочитанные из выбранной ячейки будут восприниматься, как состояние датчика «выключен/разомкнут». Дополнительно при команде «Поставить на охрану» будут записываться в ячейку «Управление» > «Включить» данные из поля «Параметр» > «Включить», а при команде «Снять с охраны» будут записываться в ячейку «Управление» > «Выключить» данные из поля «Параметр» > «Выключить».
Формат: x:y/z
x – тип команды Modbus RTU: «r» – 0x03 Read holding register register, «ri» – 0x04 Read input register, «c» – Read coil, «ci» – Read input coil
y – адрес устройства Modbus RTU: 1-255
z – ячейка устройства Modbus RTU: 0-65535
Пример: В разделе «Управление»: «Включить» = ri:1/1
В разделе «Параметр»: «Включить» = 255

Протокол Modbus TCP

На данный момент не поддерживается.

Протокол Yeelight

Настройка виртуального устройства по протоколу Yeelight в системе Swiitch

В поле «Данные/Яркость» необходимо прописать Ip-адрес светильника Yeelight.
Формат: ip[:port][/bg]:
ip – Ip-адрес светильника
[:port] – порт светильника (можно не указывать)
[/bg] – параметр используется для указания, что это виртуальное устройство будет управлять подсветкой выбранного светильника. Если этот параметр не использовать, то управление будет осуществляться основным светом светильника.
Пример: «Данные/Яркость» = 192.168.1.15/bg (управление подсветкой светильника с IP-адресом 192.168.1.15)

ВНИМАНИЕ! Для корректной работы светильника Yeelight необходимо выполнить следующее:
В настройках роутера прописать фиксированный адрес для каждого светильника Yeelight (см. инструкцию на роутер).
В настройках штатного приложения Yeelight включить режим «Управление по LAN».
Дополнительная информация по теме: https://sprut.ai/article/yeelight-rezhim-razrabotchika-dobavlenie-v-domoticz

Протокол «Глобальная группа»

С помощью создания глобальной группы можно настроить работу нескольких устройств как одного. К примеру, можно использовать такую группу в качестве мастер-выключателя либо объединить несколько источников света в одном помещении.

Настройка виртуальной глобальной группы в системе Swiitch: прописание группы в настройках окна и карточка глобальной группы «Все окна»

ВНИМАНИЕ! Для работы необходимо, чтобы все устройства, входящие в глобальную группу, были подключены к облачному серверу Swiitch или к одному брокеру MQTT.

Для управления группами устройств Swiitch необходимо в поле «Данные/Яркость» прописать выбранную глобальную группу, а также в настройках всех устройств Swiitch прописать эту же глобальную группу: Личный кабинет > Управление > Нужное устройство > Кнопка настроек (Шестеренка) > Группа > Глобальная группа.
Пример: «Данные/Яркость» = 21

Для работы с датчиками «Датчик температуры», «Датчик темп и влажности», «Аналоговый датчик», «Датчик давления», «Датчик освещенности», «Датчик CO2», «Счетчик энергии» необходимо прописать в поле «Данные/Яркость» выбранную глобальную группу, а также в настройках всех задействованных в группе датчиков Swiitch прописать эту же глобальную группу. В поле «Включить/Множитель» и «Выключить/Множитель» нужно прописать множитель для читаемых данных
Пример: «Данные/Яркость» = 5
В разделе «Параметр»: «Включить» = 1
В разделе «Параметр»: «Выключить» = 1

Для работы с датчиками «Дискретный датчик», «Кнопка», «Датчик протечки», «Датчик утечки газа», «Датчик движения», «Охранный датчик» необходимо прописать в поле «Данные/Яркость» выбранную глобальную группу, а также в настройках всех задействованных в группе датчиков Swiitch прописать эту же глобальную группу
Пример: «Данные/Яркость» = 2

ВНИМАНИЕ! В виртуальном датчике будут отображаться данные с последнего датчика, отправившего свои данные.

Протокол Noolite и Noolite F

Для работы по этому протоколу необходим модуль расширения Home Ext Noolite.
Для управления устройством Noolite или получения данных от датчика Noolite необходимо в поле «Данные/Яркость» прописать номер Noolite канала 1-31
Пример: «Данные/Яркость» = 3

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

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

Для очистки канала в web-интерфейсе необходимо нажать кнопку «Отвязать».

Протокол Zigbee

Для работы по этому протоколу необходим модуль расширения Home Ext Zigbee.

Подключение датчиков и устройств Zigbee состоит из двух этапов:
1. Подключение датчиков и устройств Zigbee к контроллеру:
Web-интерфейс > Беспроводные > Кнопка «Добавить» (включится режим добавления, кнопка изменит цвет), далее выполнить действия для перевода этого Zigbee устройства в режим добавления по инструкции на это устройство (или см. пункт «Подключение» на странице Поддержка Zigbee устройств), после этого обновить страницу «Беспроводные». Если всё сделано правильно, на странице появится новое устройство.

2. Добавление виртуального устройства и связь его с новым устройством Zigbee:
Web-интерфейс > Виртуальные, выбрать нужное виртуальное устройство в выпадающем меню, выбрать протокол - Zigbee, выбрать тип подключенного устройства и нажать кнопку «Связать», после этого инициировать отправку данных с добавляемого устройства Zigbee (например нажать кнопку или дать сработку по этому устройству), после этого обновить страницу. В полях «Данные/Яркость» и «Данные/Цвет» появятся данные добавленного устройства Zigbee.