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

Материал из Система 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>
Раздел «События» служит для просмотра истории уведомлений за день. Для выбора другой даты нужно щелкнуть по текущей, либо использовать стрелки справа и слева от нее.<br>
+
Для управления цветом или температурой свечения необходимо в поле «Данные/Цвет» прописать строку управления цветом или температурой свечения устройства, вместо значения прописать %value%<br>
Раздел «Группы» позволяет редактировать группы устройств. Здесь можно задать название группы и выбрать для нее соответствующее изображение. Изменения сохраняются автоматически при закрытии диалога.<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>
 
  
Если у вас установлены датчики, тип которых в приложении вы выбрали как «охранный», то при нажатии на кнопку «Щит» в верхнем меню на главном экране, открывается диалог «Сигнализация». Если таких датчиков у вас нет, кнопка не активна.<br><br>
+
== Протокол Yeelight ==
В диалоге «Сигнализация» могут отображаться любые виды сигнализаций, в зависимости от вида ваших датчиков (движения, протечки, утечки газа и др.). Чтобы увидеть все зоны, где стоят датчики, нужно нажать «Показать все зоны». У каждой зоны есть кнопка «Щит» и кнопка «Сигнализация». Кнопка «Щит» включает режим охраны. Если она желтого цвета, это значит, что зона «Под охраной». В этом режиме при срабатывании датчика вам приходит уведомление на телефон. Одновременно с этим кнопка «Сигнализация» становится красного цвета, и, чтобы снять тревогу, нужно нажать на нее. Под названием зоны пишется текущий статус, например «Есть движение» или «Под охраной».<br><br>
+
[[Файл:Виртуальные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>
  
Диалог «Сцены» вызывается при нажатии на кнопку «Волшебная палочка» в верхнем меню на главном экране. Эта кнопка активна, если вы заранее создали какие-либо сцены в личном кабинете на сайте Swiitch.ru. Каждая сцена запускается единовременно при нажатии на кнопку «Волшебная палочка» справа от ее названия.
+
== Протокол Noolite и Noolite F ==
 +
Для работы по этому протоколу необходим модуль расширения Home Ext Noolite.<br>
 +
Для управления устройством Noolite или получения данных от датчика Noolite необходимо в поле «Данные/Яркость» прописать номер Noolite канала 1-31<br>
 +
''Пример: «Данные/Яркость» = 3''<br><br>
 +
Для привязки датчика необходимо в Web-интерфейсе в карточке виртуального устройства нажать кнопку «Связать», потом нажать кнопку привязки на датчике (см. инструкцию на датчик).<br>
 +
<br>
 +
Для привязки исполнительного устройства необходимо на устройстве Noolite нажать кнопку привязки, после чего в web-интерфейсе нажать кнопку «Связать» и далее подтвердить привязку на устройстве Noolite (см. инструкцию на устройство).<br>
 +
<br>
 +
Для очистки канала в web-интерфейсе необходимо нажать кнопку «Отвязать».<br>
  
== Меню «Модули» ==
+
== Протокол Zigbee ==
<center>
+
Для работы по этому протоколу необходим модуль расширения Home Ext Zigbee.<br><br>
[[Файл: IOS_device_list.png |200px | Меню "Модули"]]
+
Подключение датчиков и устройств Zigbee состоит из двух этапов:<br>
[[Файл: IOS_hard_settings_top.png |200px | Настройки устройства]]
+
1. Подключение датчиков и устройств Zigbee к контроллеру:<br>
[[Файл: IOS_hard_settings_bottom.png |200px | Настройки устройства]]
+
Web-интерфейс > Беспроводные > Кнопка «Добавить» (включится режим добавления, кнопка изменит цвет), далее выполнить действия для перевода этого Zigbee устройства в режим добавления по инструкции на это устройство (или см. пункт «Подключение» на странице [[Поддержка Zigbee устройств]]), после этого обновить страницу «Беспроводные». Если всё сделано правильно, на странице появится новое устройство.<br>
</center>
+
<br>
 
+
2. Добавление виртуального устройства и связь его с новым устройством Zigbee:<br>
Если включен режим «Эксперт» в настройках приложения, при нажатии на логотип Swiitch в верхнем меню можно посмотреть все установленные модули.
+
Web-интерфейс > Виртуальные, выбрать нужное виртуальное устройство в выпадающем меню, выбрать протокол - Zigbee, выбрать тип подключенного устройства и нажать кнопку «Связать», после этого инициировать отправку данных с добавляемого устройства Zigbee (например нажать кнопку или дать сработку по этому устройству), после этого обновить страницу. В полях «Данные/Яркость» и «Данные/Цвет» появятся данные добавленного устройства Zigbee.
У каждого модуля есть кнопка «Настройки», под его названием пишется серийный номер устройства.<br><br>
 
В диалоге «Настройки» для каждого модуля можно отрегулировать следующие параметры:<br>
 
Название: изменение названия устройства, за которое отвечает модуль<br>
 
Светодиод: будет ли светиться индикатор на модуле при включенном устройстве. Если отключить этот параметр, то на модуле индикатор не будет светиться, даже если устройство включено.<br>
 
Перезапуск WiFi: если этот параметр включен, то при плохой связи модуль перезапускается, если не смог подключиться к WiFi несколько раз подряд.<br>
 
Гостевой: предоставление гостевого доступа. Если этот параметр включен, то управление устройством становится доступно для всех, кто находится в пределах сети.<br>
 
Основная функция: здесь выставляется тип модуля (кнопка, движение, температура, влажность, счетчик, реле, радиорасширитель, переключатель, универсальный, радиопередатчик, ИК-приемник, ИК-передатчик, считыватель карт).<br>
 
Функция основного порта: здесь выставляется тип датчика или модуля расширения, который подключается к этому модулю (если есть).<br>
 
Функция порт 1: здесь выставляется тип дополнительного датчика или модуля расширения.<br>
 
Функция порт 2: здесь выставляется тип дополнительного датчика или модуля расширения.<br>
 
Функция порт 3: здесь выставляется тип дополнительного датчика или модуля расширения.<br>
 
Часовой пояс: значение, равное 0, соответствует времени по Гринвичу<br>
 
Дневной режим начинается: выставляется время начала дневного режима конкретно для этого устройства<br>
 
Ночной режим начинается: выставляется время начала ночного режима конкретно для этого устройства<br>
 
Температура пожара: выставляется температура, которую датчик будет воспринимать как пожар (только для пожарных датчиков)<br>
 
Кнопка на корпусе: выбор реле, которое будет включатся/выключаться при нажатии кнопки на корпусе.<br>
 
Под списком параметров находятся кнопки «Удалить» и «К заводским» для удаления модуля из приложения и сброса к заводским настройкам.
 
 
 
== Меню «Новое устройство» ==
 
<center>
 
[[Файл: IOS_port_mode_button_new_device.png |200px | Главный экран с кнопкой добавления нового устройства]]
 
[[Файл: IOS_new_device_connect.png |200px | Меню "Новое устройство" - подключение]]
 
[[Файл: IOS_new_device.png |200px | Меню "Новое устройство"]]
 
[[Файл: IOS_new_device_sensor.png |200px | Меню "Новое устройство" - выбор датчика]]
 
</center>
 
 
 
На главном экране находится кнопка «Новое устройство», которое служит для добавления нового устройства в приложение. При ее нажатии появляется меню, где пошагово показан процесс подключения нового устройства. Пролистайте инструкцию, нажимая «Дальше» до последнего слайда, где нужно нажать «Закрыть». После этого приложение спросит у вас разрешение подключиться к сети Wi-Fi. Нажмите «Подключиться». Откроется диалог с полями для ввода ваших данных от сети Wi-Fi. Введите название вашей Wi-Fi сети, пароль от нее, впишите название для устройства, которое будет отображаться в приложении (например «Спальня») и выберите дополнительную функцию устройства (кнопка, движение, температура, влажность, счетчик), если есть.
 
 
 
== Выбор группы ==
 
<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>
 

Версия от 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.