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

Материал из Система 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_port_mode_button_new_device.png |200px | Главный экран с кнопкой добавления нового устройства]]
+
«Диммер» – Устройство с возможностью регулировки яркости<br>
[[Файл: IOS_new_device_connect.png |200px | Меню "Новое устройство" - подключение]]
+
«Диммер и температура» – Устройство с возможностью регулировки яркости и изменения температуры свечения<br>
[[Файл: IOS_new_device.png |200px | Меню "Новое устройство"]]
+
«RGB» – Устройство с возможностью изменения яркости и цвета свечения<br>
[[Файл: IOS_new_device_sensor.png |200px | Меню "Новое устройство" - выбор датчика]]
+
«RGB и температура» – Устройство с возможностью изменения яркости, цвета и температуры свечения<br>
</center>
+
«Датчик температуры» – Датчик температуры<br>
 +
«Датчик темп и влажности» – Датчик температуры и влажности<br>
 +
«Дискретный датчик» – Датчик с двумя состояниями (замкнуто / размокнуто)<br>
 +
«Аналоговый датчик» – Датчик с аналоговым значением<br>
 +
«Датчик давления» – Датчик давления<br>
 +
«Датчик освещенности» – Датчик освещенности<br>
 +
«Датчик CO2» – Датчик углекислого газа<br>
 +
«Кнопка» – Датчик с событием «Нажатие кнопки»<br>
 +
«Датчик протечки» – Датчик протечки, выдает событие «Протечка»<br>
 +
«Датчик утечки газа» – Датчик утечки газа, выдает событие «Утечка газа»<br>
 +
«Датчик движения» – Датчик движения, выдает событие «Есть движение / Нет движения»<br>
 +
«Охранный датчик» – Датчик движения, выдает событие «Тревога проникновения»<br>
 +
«Счетчик энергии» – Устройство, показывающее количество использованной энергии<br>
  
На главном экране находится кнопка «Новое устройство», которое служит для добавления нового устройства в приложение. При ее нажатии появляется меню, где пошагово показан процесс подключения нового устройства. Пролистайте инструкцию, нажимая «Дальше» до последнего слайда, где нужно нажать «Закрыть». После этого приложение спросит у вас разрешение подключиться к сети Wi-Fi. Нажмите «Подключиться». Откроется диалог с полями для ввода ваших данных от сети Wi-Fi. Введите название вашей Wi-Fi сети, пароль от нее, впишите название для устройства, которое будет отображаться в приложении (например «Спальня») и выберите дополнительную функцию устройства (кнопка, движение, температура, влажность, счетчик), если есть.
+
== Протокол HTTP GET ==
 +
[[Файл:ВиртуальныеHTTPGET.png |200px|Настройка виртуального устройства по протоколу HTTP GET в системе Swiitch|right]]
 +
'''ВНИМАНИЕ!''' На данный момент этот протокол работает только с исполнительными устройствами («Реле», «Диммер», «Диммер и температура», «RGB»).<br><br>
 +
Для включения / выключения устройства необходимо в разделе «Управление» прописать в поля «Включить» и «Выключить» строки http для включения / выключения (берем данные из инструкции на устройство).<br>
 +
''Пример: «Включить» = http://192.168.1.55/?state=on''<br>
 +
''«Выключить» = http://192.168.1.55/?state=off''<br><br>
 +
Для управления яркостью устройства необходимо в поле «Данные/Яркость» прописать строку управления яркостью устройства, вместо значения прописать %value%<br>
 +
''Пример: «Данные/Яркость» = http://192.168.1.55/?brightness=%value%''<br>
 +
<br>
 +
Для управления цветом или температурой свечения необходимо в поле «Данные/Цвет» прописать строку управления цветом или температурой свечения устройства, вместо значения прописать %value%<br>
 +
''Пример: «Данные/Цвет» = http://192.168.1.55/?color=%value%''<br>
 +
'''ВНИМАНИЕ!''' У одного устройства можно управлять только одним параметром – либо цветом либо температурой свечения.<br>
  
== Основные настройки ==
+
== Протокол MQTT ==
<center>
+
Для включения устройства необходимо прописать в поле «Включить» канал MQTT для включения устройства, а в параметр «Включить» – значение, отправляемое в выбранный канал MQTT.<br>
[[Файл: IOS_settings_top.png |200px|Основные настройки]]
+
''Пример: В разделе «Управление»: «Включить» = /diy_device/set''<br>
[[Файл: IOS_settings_bottom.png |200px |Основные настройки]]
+
''В разделе «Параметр»: «Включить» = on''<br>
</center>
+
<br>
В диалоге «Настройки» (он открывается при нажатии на кнопку «Шестеренка» в верхнем меню основного экрана) можно отрегулировать следующие параметры:<br><br>
+
Для выключения устройства необходимо прописать в поле «Выключить» канал MQTT для выключения устройства, а в параметр «Выключить» – значение, отправляемое в выбранный канал MQTT.<br>
Режим «Эксперт»: включает показ в интерфейсе дополнительных опций настройки<br>
+
''Пример: В разделе «Управление»: «Выключить» = /diy_device/set''<br>
Режим «На стене»: включает горизонтальную ориентацию интерфейса, для просмотра на планшете <br>
+
''В разделе «Параметр»: «Выключить» = off''<br>
Основная комната: если здесь выбрана конкретная группа, то после изменения вручную группы отображаемых устройств, по прошествии некоторого времени без активности, основной экран возвращается к отображению списка устройств этой группы<br>
+
<br>
Тема экрана: включение дневной или ночной темы экрана или установка автоматической смены тем в зависимости от времени суток (конкретное время выбирается ниже)<br>
+
Для управления яркостью устройства необходимо прописать в поле «Данные/Яркость» канал MQTT для изменения яркости устройства. Значение яркости будет отправляться в выбранный канал MQTT.<br>
Яркость в ночном режиме: выставляется уровень подсветки экрана в ночном режиме<br>
+
''Пример: «Данные/Яркость» = /diy_device/brightness''<br>
Дневной режим начинается: выставляется время начала дневного режима во всей системе <br>
+
<br>
Ночной режим начинается: выставляется время начала ночного режима во всей системе <br>
+
Для управления цветом или температурой свечения необходимо прописать в поле «Данные/Цвет» канал MQTT для изменения цвета или температуры свечения. Значение цвета или температуры свечения будет отправляться в выбранный канал MQTT.<br>
Датчик на главном экране: выбор датчика, данные которого будут отображаться под верхним меню рядом с кнопкой выбора отображаемых устройств на основном экране <br>
+
''Пример: «Данные/Цвет» = /diy_device/color''<br>
Отправлять события на почту: при включении уведомления системы будут отправляться на ящик электронной почты, указанный при регистрации аккаунта<br>
+
<br>
Отправлять события в telegram: при включении уведомления системы будут отправляться на telegram-аккаунт, который привязан к вашему контакту <br>
+
Для работы с датчиками «Датчик температуры», «Датчик темп и влажности», «Аналоговый датчик», «Датчик давления», «Датчик освещенности», «Датчик CO2», «Счетчик энергии» необходимо прописать в поле «Данные/Яркость» канал MQTT, в котором будут получаться данные датчика. Для датчика типа «Датчик темп и влажности» также нужно указать в поле «Данные/Цвет» канал MQTT, в котором будут получаться данные влажности. В поле «Включить/Множитель» и «Выключить/Множитель» нужно прописать множитель для читаемых данных.<br>
Отправлять события в приложение: при включении уведомления системы будут отправляться на все мобильные устройства, на которых выполнен вход в ваш аккаунт<br>
+
''Пример: «Данные/Яркость» = /diy_device/temp''<br>
Отправлять инфо-сообщения: отправлять информационные уведомления системы на те каналы, которые включены<br>
+
''В разделе «Параметр»: «Включить/Множитель» = 1''<br>
Оповещать о входе: отправлять уведомления о входе в аккаунт в личном кабинете на сервере www.swiitch.ru <br>
+
''«Выключить/Множитель» = 1''<br>
Оповещать о тревогах: отправлять уведомления о проникновениии при включенном режиме охраны на нужных датчиках <br>
+
<br>
Оповещать о пожарах: отправлять уведомления о пожарной тревоге при включенном режиме охраны на нужных пожарных датчиках <br>
+
Для работы с датчиками «Дискретный датчик», «Кнопка», «Датчик протечки», «Датчик утечки газа», «Датчик движения», «Охранный датчик» необходимо прописать в поле «Данные/Яркость» канал MQTT, в котором будут получаться данные датчика, а в разделе «Параметр» в поле «Включить/Множитель» прописать значение, при котором будет считаться, что датчик включен/замкнут. Остальные значения, прочитанные из выбранного канала MQTT будут восприниматься, как состояние датчика «выключен/разомкнут».<br>
Оповещать о включении датчика: отправлять уведомления обо всех изменениях состояния дискретных датчиков (кнопки, выключатели, датчики движения)<br>
+
''Пример: В разделе «Управление»: «Включить» = /diy_device/motion''<br>
Оповещать о включениях сигнализации: отправлять уведомления обо всех изменениях состояния охранных датчиков (датчики движения, датчики протечки, пожарные датчики) <br>
+
''В разделе «Параметр»: «Включить/Множитель» = true''<br>
Оповещать о включениях реле: отправлять уведомления обо всех изменениях состояния исполняемых устройств (включение/выключение)<br>
+
<br>
Оповещать о картах доступа: отправлять уведомления обо всех предъявленных картах доступа<br>
+
Для работы с сторонними устройствами по протоколу MQTT, необходимо подключить контроллер к своему MQTT брокеру<br>
Оповещать о запуске устройств: отправлять уведомления о запуске и перезагрузке устройств<br>
 
  
== Разделы «События», «Группы», «Облако» в диалоге «Настройки» ==
+
== Протокол Modbus RTU ==
<center>
+
[[Файл:ВиртуальныеModbusRTU.png |200px|Настройка виртуального устройства по протоколу Modbus RTU в системе Swiitch|right]]
[[Файл: IOS_events.png |200px |События]]
+
Для работы по этому протоколу необходим модуль расширения Home Ext Modbus RTU.<br><br>
[[Файл: Ios_groups_edit.png |200px |Редактирование групп]]
+
Список устройств Modbus RTU, для которых в системе уже существуют готовые профили: http://wiki.swiitch.ru/index.php/Поддержка_Modbus_RTU_устройств.<br>
[[Файл: IOS_groups_edit_picture.png |200px |Выбор изображния для группы]]
+
<br>
[[Файл: IOS_cloud.png |200px | Облако]]
+
Для включения устройства необходимо прописать в поле «Включить» ячейку для включения устройства, а в параметр «Включить» – значение, записываемое в выбранную ячейку.<br>
[[Файл: IOS_cloud_registration.png |200px | Облако - регистрация]]
+
Формат: x:y/z<br>
</center>
+
x – тип команды Modbus RTU: «r» – 0x06 Write register или «c» – 0x05 Write coil<br>
В диалоге «Настройки» можно посмотреть и настроить разделы «События», «Группы», «Облако», нажав соответствующие кнопки.<br><br>
+
y – адрес устройства Modbus RTU: 1-255<br>
Раздел «События» служит для просмотра истории уведомлений за день. Для выбора другой даты нужно щелкнуть по текущей, либо использовать стрелки справа и слева от нее.<br>
+
z – ячейка устройства Modbus RTU: 0-65535<br>
Раздел «Группы» позволяет редактировать группы устройств. Здесь можно задать название группы и выбрать для нее соответствующее изображение. Изменения сохраняются автоматически при закрытии диалога.<br><br>
+
''Пример: В разделе «Управление»: «Включить» = r:3/1''<br>
В разделе «Облако» открывается диалог для входа в облако или регистрации нового аккаунта.<br>
+
''В разделе «Параметр»: «Включить/Множитель» = 256''<br>
Вход в облако: ввести данные от аккаунта и нажать кнопку «Вход», если аккаунта еще нет – нажать кнопку «Регистрация»<br>
+
<br>
Для регистрации в облаке необходимо ввести следующие данные: «Имя» – произвольное имя для отображения в личном кабинете, EMail – адрес почты, на который будут приходить сообщения (будет использоваться для восстановления пароля), «Пароль» (вводится повторно в поле «Повтор») пароль для аккаунта в личном кабинете Swiitch.
+
Для выключения устройства необходимо прописать в поле «Выключить» ячейку для выключения устройства, а в параметр «Выключить» – значение, записываемое в выбранную ячейку.<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_port_mode.png |200px | Главный экран]]
+
Подключение датчиков и устройств Zigbee состоит из двух этапов:<br>
[[Файл: IOS_climat.png |200px | Меню "Климат"]]
+
1. Подключение датчиков и устройств Zigbee к контроллеру:<br>
[[Файл: IOS_climat_menu.png |200px |Настройки в меню "Климат"]]
+
Web-интерфейс > Беспроводные > Кнопка «Добавить» (включится режим добавления, кнопка изменит цвет), далее выполнить действия для перевода этого Zigbee устройства в режим добавления по инструкции на это устройство (или см. пункт «Подключение» на странице [[Поддержка Zigbee устройств]]), после этого обновить страницу «Беспроводные». Если всё сделано правильно, на странице появится новое устройство.<br>
</center>
+
<br>
 
+
2. Добавление виртуального устройства и связь его с новым устройством Zigbee:<br>
Если у вас установлен датчик температуры и влажности, под верхним меню на главном экране отображаются текущие значения температуры и влажности. При нажатии на значок «Термометр» появляется диалог «Климат». Здесь выводится список всех подключенных термостатов, отображаются их данные и состояние. Для быстрой настройки комфортной температуры нужно нажать на значок «Термометр» слева от названия термостата или на само название.
+
Web-интерфейс > Виртуальные, выбрать нужное виртуальное устройство в выпадающем меню, выбрать протокол - Zigbee, выбрать тип подключенного устройства и нажать кнопку «Связать», после этого инициировать отправку данных с добавляемого устройства Zigbee (например нажать кнопку или дать сработку по этому устройству), после этого обновить страницу. В полях «Данные/Яркость» и «Данные/Цвет» появятся данные добавленного устройства Zigbee.
 
 
== Меню исполнительного устройства: общие параметры ==
 
<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>
 
 
 
При нажатии на название или картинку устройства в основном списке на главном экране открывается меню этого устройства. Рассмотрим параметры, общие для всех меню.<br><br>
 
По центру находится кнопка включения/выключения устройства. Если устройство выключено, кнопка – белого цвета, если же устройство включено, кнопка – желтого цвета.<br>
 
Кнопка справа от кнопки включения открывает настройки таймера. Здесь можно задать время, через которое устройство должно включиться или выключиться. Для этого выставите время в формате чч:мм:сс и нажмите кнопку «Вперед» (устройство включится через заданное время) или «Назад» (устройство выключится через заданное время). Кнопка «Стоп» останавливает таймер. Если выставлен таймер для устройства, кнопка «Таймер» окрашена в желтый цвет.<br>
 
Под кнопкой включения справа находится кнопка «Расписание», которая открывает меню настройки расписание работы устройства. Выберите время в формате чч:мм и действие, которое будет выполняться в это время. Например, для устройства можно выставить время 05:00 + действие «Включить» и одновременно время 15:00 и действие «выключить». Это значит, что устройство будет автоматически включаться в 5 часов утра и выключаться в 15:00 каждый день. Если выставлено расписание работы для устройства, кнопка «Расписание» окрашена в желтый цвет.
 
 
 
== Меню исполнительного устройства с термостатом ==
 
<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>
 
 
 
Рассмотрим меню для управления отопительным прибором.<br><br>
 
По центру находится кнопка включения/выключения устройства. Если устройство выключено, кнопка – белого цвета, если же устройство включено, кнопка – желтого цвета.<br>
 
Кнопка слева от кнопки включения – это индикатор текущего состояния устройства, он показывает, что происходит с прибором в данную минуту: охлаждение, нагрев или прогрев без ограничения температуры.<br>
 
Кнопка справа от кнопки включения открывает настройки таймера. Здесь можно задать время, через которое устройство должно включиться или выключиться. Для этого выставите время и нажмите кнопку «Вперед» (устройство включится через заданное время) или «Назад» (устройство выключится через заданное время). Кнопка «Стоп» останавливает таймер.<br>
 
Под кнопкой включения слева находится кнопка «Термостат». Она активна, если у вас подключен датчик температуры к устройству и служит для выставления комфортной температуры в помещении. С помощью кнопок «Плюс» и «Минус» в меню термостата выберите значение желаемой температуры. Если кнопка «Термостат» желтого цвета, значит режим термостата включен.<br>
 
Под кнопкой включения справа находится кнопка «Расписание». Здесь можно задать расписание работы устройства.
 
 
 
== Меню исполнительного устройства с возможностью диммирования или изменения цвета ==
 
<center>
 
[[Файл: IOS_relay_dimmer.png |200px | Меню диммера и выбора цвета]]
 
[[Файл: IOS_relay_color_select.png |200px | Выбор цвета]]
 
[[Файл: IOS_relay_color_temp_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_device_list.png |200px | Меню "Модули"]]
 
[[Файл: IOS_hard_settings_top.png |200px | Настройки устройства]]
 
[[Файл: IOS_hard_settings_bottom.png |200px | Настройки устройства]]
 
</center>
 
 
 
Если включен режим «Эксперт» в настройках приложения, при нажатии на логотип Swiitch в верхнем меню можно посмотреть все установленные модули.
 
У каждого модуля есть кнопка «Настройки», под его названием пишется серийный номер устройства.<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_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.