Приложение "Smacont RC03"
для работы с модулями SC120

Содержание

Общее описание
Ссылки
Описание элементов приложения
Описание пунктов меню
Раздел "Настройки контроля"
Раздел "Настройки пульта"
Раздел "Конфигурация"
Описание пунктов списка команд
Основные разделы пульта

Общее описание

Приложение "Smacont RC03" работает под операционной системой Android (версия 5 и выше) и предназначено для локального и/или глобального (дистанционного) управления WiFi-модулями SC120.

В качестве постоянно включенного сервера, на котором будет запущено приложение "Smacont RC03" может использоваться старый планшет или смартфон (или с разбитым, но работающим экраном).

В качестве сервера можно использовать смартфоны низкой ценовой категории (1800...2500 рублей), которые с запасом справляются с работой.

Достоинства смартфона в качестве сервера, по сравнению с персональным компьютером, также можно считать:
• замену системного блока, клавиатуры, мыши, монитора, микрофона, звуковых колонок, источника бесперебойного питания (за счет наличия встроенной аккумуляторной батареи);
• наличие канала связи в виде GSM-сети для работы по протоколу MQTT и/или через SMS, который может использоваться как основным (удаленные объекты, коттеджи, дачи, промплощадки), так и резервным, для использовании при пропадании основного канала связи в виде домашней локальной сети;
• массо-габаритные показатели.

Также, в качестве сервера можно использовать планшет, который пользователь использует в домашних условиях. Приложение "Smacont RC03" выполняется в фоновом режиме и не доставляет неудобств при повседневном пользовании домашним планшетом.

Энергопотребление приложения "Smacont RC03" определяется периодом опроса WiFi-модулей SC120. При оптимальных настройках пульта, нагрузка на планшета не приводит к быстрой разрядке аккумуляторной батареи.

На данный момент приложение "Smacont RC03" реализует составление и выпонение сценариев, т.к. данная функция перенесена непосредственно в WiFi-контроллер SC120 в виде обработчиков событий. В тоже время, микро-сценариями можно считать макро-команды, которые составляет сам пользователь.

Приложение "Smacont RC03" может функционировать в двух режимах:
1. "Мастер": опрос и управление модулями в локальной сети и при необходимости информация о их состоянии передается по Internet-сети (MQTT) и/или GSM-сеть (SMS) на другой смартфон или планшет, на котором также должно быть установлено приложение "Smacont RC03", но работающее в режиме "Клиент".
2. "Клиент": прием информации о состоянии модулей по Internet-сети (MQTT) и/или GSM-сеть (SMS) от "Мастер". Также имеется возможность управления модулями, опрашиваемых "Мастером" (если это разрешено на стороне "Мастер").

Основные функции приложения "Smacont RC03":
• опрос до трех WiFi-контроллеров SC120;
• контроль значений входов, переменных;
• контроль и редактирование значений переменных;
• автоматически пересчитывать значения входов/переменных модулей по заданным формулам или корректировать значения входов/переменных модулей для более точного отображения;
• контроль и управление состоянием флагов, выходов;
• подача предупреждающего звукового сигнала при включении заданного флага (режим контроль);
• автоматическая передача команды на модуль для включения зарядного устройства, при разряде аккумуляторной батареи на "Мастер";
• автоматический контроль состояния работоспособности с регулируемым периодом передачи.

При помощи приложения "Smacont RC03" и сервиса "Dealgate" можно реализовать работу модулей под управлением голосового помощника "Алиса", т.е. управлять модулями при помощи голосовых команд. Сервис "Dealgate" не только предоставляет работу в виде брокера, но и реализует навык, который позволяет управлять виртуальными устройствами, которые создаются на сайте dealgate.ru и впоследствии могут быть сопряжены с реальными по протоколу MQTT.

Ссылки

Описание	Ссылка
Руководство пользователя приложения "Smacont RC03"	В разработке
Скачать zip

Описание элементов приложения

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

2. Кнопка выпадающего списка команд.
Список содержит список макро-команд и команды сброса звука и тревог.

3. Поле основных разделов программы: "Входы", "Выходы", "Флаги/Контроль", "Переменные", "Макро-команды".
Название активного (выбранного) раздела подсвечивается чертой бирюзового цвета.

4. Поле статуса устройств: порядковый номер устройства ("У0", "У1", "У2"); текущее состояние устройства ("Соединение...", "Снят с контроля", "Контроль", "Тревога", "Нет связи"); название устройства (может быть изменено пользователем).

5. Элементы контроля или управления устройств: порядковый номер входа (или выхода, флага, переменной); название (может быть изменено пользователем), текущее значение.
В зависимости от активного (выбранного) раздела элементы полей могут содержать дополнительную информацию и органы управления, не показанные на рисунке.

6. Поле статуса.
В поле статуса отображается информация о текущем состоянии пульта.

Описание пунктов меню

Приложение "Smacont RC03" (далее пульт) имеет множество настроек, позволяющих гибко использовать возможности пульта по требованиям пользователя.

"Настройки контроля"

Постановка и снятие с контроля как всего устройства, так и отдельных флагов.

"Настройки пульта"

Основные настройки работы пульта.

"Отключить пульт"

Команда на отключение пульта.
При подаче данной команды снимаются с контроля сразу все устройства (модули), при этом настройки контроля флагов не меняются.
При необходимости, устройства можно снова поставить на контроль, перейдя в раздел "Настройки контроля".

"Техническая информация"

При выборе данного пункта будет открыто окно с технической информацией по каждому устройству.

"Программа конфигурирования"

При выборе данного пункта, в браузере смартфона или планшета будет открыта программа "Программа конфигурирования" с сайта smacont.ru в режиме on-line.
Применяется для удобства пользования, если появилась необходимость перехода в "Программа конфигурирования" для настройки WiFi-модулей SC120.

"Конфигурация"

Настройка описаний элементов пульта по требованию пользователя и задание некоторых параметров работы пульта.

"Помощь"

При выборе данного пункта, в браузере смартфона или планшета будет открыта страница "Помощь при работе с приложением " с сайта smacont.ru в режиме on-line.

"О программе"

При выборе данного пункта будет открыто окно с информацией о программе - название программы, текущая версия.

Раздел "Настройки контроля"

В данном разделе осуществляется постановка и снятие с контроля, как всего устройства, так и отдельных флагов.

Постановка и снятие с контроля устройства

При постановке устройства на контроль, пульт начинает обмен информацией с устройством. Соответственно, при снятии устройства с контроля, пульт прекращает обмен с модулем. При этом настройки контроля флагов не меняются.

Для одновременного снятия всех устройств с контроля можно использовать пункт меню "Отключить пульт".

Постановка и снятие с контроля флагов

В приложении "Smacont RC03" предусмотрена возможность формирования тревожного состояния (далее "Тревога") при установке значения соответствующего флага в активное состояние.

Если заданный флаг взят на контроль, то в момент, когда при ответе устройства, флаг будет установлен в активное состояние, пульт будет индицировать "Тревогу". Индикация "Тревога" может сочетаться из звукового сигнала и вибро-индикации. Тип индикации "Тревога" определяется пользователем в разделе "Настройки пульта".

Если заданный флаг снят с контроля, то состояние флага не будет влиять на состояние "Тревога".

Сброс индикации "Тревога" (звуковой и/или вибро-индикации) производится по команде "Сброс звука" из выпадающего списка команд. При появлении нового (другого) флага в активном состоянии (при условии, что он находится на контроле), снова будет включена индикация "Тревога" (звуковая и/или вибро-индикация).

Сброс состояния "Тревога" производится по команде "Сброс ТРЕВОГА" из выпадающего списка команд. При этом, на устройство будет отправлена команда сброса соответствующих флагов, и, если флаги на устройстве будут сброшены в неактивное состояние, пульт будет работать в дежурном состоянии.

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

Раздел "Настройки пульта"

В данном разделе осуществляется основные настройки работы пульта.

Параметр "Реж.: Клиент/Мастер"

Приложение "Smacont RC03" может функционировать в двух режимах:
1. "Мастер": опрос и управление модулями в локальной сети и при необходимости информация об их состоянии передается по Internet-сети (MQTT) и/или GSM-сеть (SMS) на другой смартфон или планшет, на котором также должно быть установлено приложение "Smacont RC03", но работающее в режиме "Клиент".
2. "Клиент": прием информации о состоянии модулей по Internet-сети (MQTT) и/или GSM-сеть (SMS) от "Мастер". Также имеется возможность управления модулями, опрашиваемых "Мастером" (если это разрешено на стороне "Мастер").

Параметр "Мастер: Упр.ЗУ"

Приложение "Smacont RC03" может отслеживать значение текущего заряда аккумуляторной батареи смартфона или планшета и в случае необходимости включать или отключать Зарядное Устройство (далее ЗУ). Управление ЗУ производится только в режиме "Мастер", только для устройства "У0" и только для "Выход №5".

При установленном переключателе в положение "Включено":
• при достижении заряда аккумуляторной батареи <15%, программа отправляет команду на устройство "У0" для перевода "Выход №5" в активное состояние;
• при достижении заряда аккумуляторной батареи >95%, программа отправляет команду на устройство "У0" для перевода "Выход №5" в неактивное состояние.

При установленном переключателе в положение "Отключено" контроль значения текущего заряда аккумуляторной батареи смартфона или планшета не осуществляется.

Для реализации управления ЗУ смартфона или планшета необходимо реализовать следующую схему.

Схема управления ЗУ

Данная схема управления ЗУ необходима для исключения режима постоянного заряда аккумуляторной батареи смартфона или планшета, находящегося в продолжительном или постоянном режиме работы с модулями, что может привести к вздутию батареи и выходу ее из строя.

Параметр "У0(У1,У2): Только прием"

Приложение "Smacont RC03" может работать с конкретным устройством в режиме "Только прием".

При установленном переключателе в положение "Включено" программа не производит циклический опрос модулей, а ожидает только прием информации от устройства.

Данный вариант позволяет работать с устройствами находящимися в одном из sleep-режимов ("1" или "2", см. "Руководство пользователя WIFI-модуля SC120"). Модуль, находящийся в sleep-режиме ("1" или "2") не может отвечать на запросы от приложения "Smacont RC03", т.к. в этом режиме, для снижения энергопотребления модуля SC120, отключен радио-модуль WiFi. Но, при услових, заданных пользователем при конфигурировании модуля в обработчиках событий, последний может выйти из sleep-режима и передать информацию на смартфон.

Внимание!
1. Для работы модулей с приложением в режиме "Только прием", необходим дополнительный плагин "TNES: Tasker Network Event Server".
2. Конфигурирование WiFi-контроллера SC120 и приложения для работы в режиме "Только прием" рассмотрено в отдельной статье.

Параметр "Звук при ТРВ"

Запрет/Разрешение звуковой индикации "Тревога" во время состояния "Тревога".

Параметр "Вибрация при ТРВ"

Запрет/Разрешение вибро-индикации "Тревога" во время состояния "Тревога".

Параметр "Откр. прог. при ТРВ"

Запрет/Разрешение показа окна приложения "Smacont RC03" поверх всех программ при переходе в состояние "Тревога".

Параметр "Пауза между запросами, сек"

Определяет время между запросами состояния модулей. Время задается в секундах, минимальное значение: 2 сек.

Параметр "Количество "неответов"

Определяет количество запросов состояния модуля, на которые модуль не отвечает. Минимальное значение параметра: 1. После отсчета заданного количества "неответов" в поле статуса устройства появится надпись "Нет связи".

Параметр "Мастер: Авто сброс ТРЕВОГИ"

При установленном переключателе в положение "Включено", через время ~15 сек. с момента перехода модуля в состояние "Тревога", происходит автоматический сброс состояния "Тревога". Автоматический сброс состояния "Тревога" применяется совместно с режимом передачи тревоги по SMS.

Параметр "Мастер: внешнее управление"

Запрет/Разрешение внешнего управления WiFi-модулями SC120 при использовании работы по Internet-сети (MQTT) и/или GSM-сети (MQTT, SMS). При установленном переключателе в положение "Отключено" производится только передача информации о состоянии модулей (устройств) на "Клиент".

Параметр "MQTT"

Запрет/Разрешение работы "Мастер"-"Клиент" по Internet-сети и/или GSM-сети по протоколу MQTT. При установленном переключателе в положение "Отключено" производится только передача информации о состоянии модулей (устройств) на "Клиент". Работа "Мастер"-"Клиент" по протоколу MQTT рассмотрена в отдельной статье.

Параметр "Период АвтоКонтроля MQTT"

Устанавливает период отправки информации о состоянии WiFi-контроллера SC120 в автоматическом режиме, для реализации функции Автоматического Контроля (далее АК) работоспособности.

Время рассчитывается как введенное, умноженное на 2. Например: устанавливаем значение 2, получаем период АК 4-ре минуты. Минимальное значение: 1.

Параметр "SMS"

Запрет/Разрешение работы "Мастер"-"Клиент" по GSM-сети через SMS. Работа "Мастер"-"Клиент" через SMS рассмотрена в отдельной статье.

Параметр "SMS.ru"

Запрет/Разрешение работы "Мастер"-"Клиент" по Internet-сети через API сервиса sms.ru. Работа "Мастер"-"Клиент" через API сервиса sms.ru рассмотрена в отдельной статье.

Раздел "Конфигурация"

В данном разделе осуществляется настройка описаний элементов пульта по требованию пользователя и задание некоторых параметров работы пульта. Раздел "Конфигурация" состоит из 8-ми подразделов.

Подраздел 1: "Выходы. Описание"

В данном подразделе задается название для выходов каждого устройства. При вводе текста поддерживается использование html-тегов, например, таких как "<br>" (перенос строки), "<b>" и "</b>" (выделение).

Также здесь имеется возможность задать "Выход 0", "Выход 1" и "Выход 2" как группу для управления RGB-лентой для каждого WiFi-контроллера SC120. Данная функция используется для голосового управления модулями при помощи помощника "Яндекс.Алиса" (подробная информация в отдельной статье).

Подраздел 2: "Флаги/Контроль. Описание", "Устройства. Описание", "IP-адрес", "Серийный номер", "Пароль"

В данном подразделе задается название для флагов, устройств. Задается IP-адрес модулей SC120, серийный номер (используется при работе в режиме "Только чтение"). Задается пароль для доступа к WiFi-контроллерам SC120 (например: для "Оператор" - "pwd=oper", для "Администратор" - "pwda=admin"). При вводе названий поддерживается использование html-тегов, например, таких как <br> (перенос строки), <b> и </b> (выделение).

Подраздел 3: "Входы. Описание"

В данном подразделе задается название для входов каждого устройства. При вводе текста поддерживается использование html-тегов.

Если к устройству подключен датчик DHT11/DHT22, то для корректного отображения показаний, необходимо активировать соответствующий чекбокс "DHT11/22".

Подраздел 4: "Входы. Формулы"

В данном подразделе задаются математические формулы для пересчета получаемых значений входа, в значения для отображения пользователю. Если нет необходимости в пересчете значений, то в поле должно быть текст val.

ПРИМЕР.
Пересчет значений входа при подключении датчика температуры DS18B20.
Датчик температуры DS18B20 подключен к входу «IN0» устройства "У0".
1. Для корректного отображения значения температуры необходимо пересчитать принимаемое значение входа «IN0» по формуле:
Т = (val - 30000) / 100,
где: Т - значение температуры в градусах Цельсия;
val – цифровое значений входов «IN0» … «IN5», к которому подключен датчик температуры ds18b20.
2. В поле "У0.0" вводим формулу: (val-30000)/100.

Подраздел 5: "Переменные. Описание"

В данном подразделе задается название для переменных каждого устройства. При вводе текста поддерживается использование html-тегов.

Подраздел 6: "Переменные. Формулы"

В данном подразделе задаются математические формулы для пересчета получаемых значений переменных, в значения для отображения пользователю. Если нет необходимости в пересчете значений, то в поле должно быть текст val.

Пример применения формул см. в пункте "Подраздел 4: "Входы. Формулы".

Подраздел 7: "Команды"

В данном подразделе задаются описание и код Макро-команд.

Подраздел 8: "Глобальное управление"

В данном подразделе задается:
• Номера телефонов, кому будут отправляться SMS;
• Номера телефонов, от кого будут приниматься SMS;
• API ID номер для работы через сервис sms.ru;
• MQTT prefix для работы по протоколу MQTT.

Описание пунктов списка команд

Выпадающий список команд содержит перечень макро-команд, команду "Сброс ТРЕВОГИ", команду "Сброс звука" и команду "Обновить данные"..

Перечень макро-команд

Перечень макро-команд предназначен для отправки на WiFi-контроллер SC120 команд, выполнение которых через окна "Выходы", "Флаги/Контроль" и "Переменные" заняло у пользователя много времени.

Код макро-команд определяется в подразделе 7 ("Команды") раздела "Конфигурация", в соответствии с описанием HTTP–запросов/команд, как описано в п.8 руководства пользователя WiFi-модуля SC120.

ПРИМЕР
Необходимо одной командой включить "OUT1", "OUT3", "OUT5" на устройстве "У2".
1. Открыть подраздел 7 ("Команды") раздела "Конфигурация".
2. В строке (например, "2"), в поле "Команды. Описание" прописываем описание команды (например, "Включить нагрузку").
3. В поле "Команда" прописываем следующий код: out1_ctrl=1&out3_ctrl=1&out5_ctrl=1.
4. В поле "Устр.(0,1,2)" указать номер устройства, для нашего примера прописываем число: 2.
5. Нажать кнопку "<" для выхода из раздела "Конфигурация".

Команда "Сброс ТРЕВОГИ"

Сброс состояния "Тревога" производится по команде "Сброс ТРЕВОГА". При этом, на устройство будет отправлена команда сброса соответствующих флагов, и, если флаги на устройстве будут сброшены в неактивное состояние, пульт будет работать в дежурном состоянии.

Команда "Сброс звука"

Сброс индикации "Тревога" (звуковой и/или вибро-индикации) производится по команде "Сброс звука". При появлении нового (другого) флага в активном состоянии (при условии, что он находится на контроле), снова будет включена индикация "Тревога" (звуковая и/или вибро-индикация).

Команда "Обновить данные"

Принудительное обновление показаний пульта производится по команде "Обновить данные". Команда применяется при большом значении "Пауза между запросами" (см. п. "Раздел "Настройки пульта") или при работе пульта в режиме "Клиент".

Основные разделы пульта

Основные разделы программы: "Входы", "Выходы", "Флаги/Контроль", "Переменные", "Макро-команды".

Раздел "Входы"

В данном разделе отображается описание входов и информация о состоянии или значении входов. Значения входов могут отображаться как в "чистом" виде (значения, полученные от контроллера SC120), так и в пересчитанном или откорректированном виде по формулам пользователя.

Описание входов задается в разделе "Конфигурация", п. "Подраздел 3: "Входы. Описание". Формулы задаются в разделе "Конфигурация", п. "Подраздел 4: "Входы. Формулы".

Раздел "Выходы"

В данном разделе отображается описание выходов и информация о их состоянии. Состояние выхода (включен/отключен) отображается в виде пинтограммы в правом верхнем углу поля выхода. Также здесь имеется возможность управления скважностью PWM-выходов при помощи ползунков (слайдеров).

Описание выходов задается в разделе "Конфигурация", п. "Подраздел 1: "Выходы. Описание".

Раздел "Флаги/Контроль"

В данном разделе отображается описание флагов/контроля и информация о их состоянии.

Состояние флага (включен/отключен) отображается в виде пинтограммы в правом верхнем углу поля флага. Состояние контроля ("Снят"/"Контроль"/"Тревога") отображается в нижней части поля флага.

Описание флагов/контроля задается в разделе "Конфигурация", п. "Подраздел 2: "Флаги/Контроль. Описание".

Раздел "Переменные"

В данном разделе отображается описание переменных и информация о значениях переменных. Значения переменных могут отображаться как в "чистом" виде (значения, полученные от контроллера SC120), так и в пересчитанном или откорректированном виде по формулам пользователя.

Описание переменных задается в разделе "Конфигурация", п. "Подраздел 5: "Переменные. Описание". Формулы задаются в разделе "Конфигурация", п. "Подраздел 6: "Переменные. Формулы".

Раздел "Макро-команды"

Работа с макро-командами раздела аналогична работе с макро-командами из выпадающего списка команд, как было описано в пункте "Перечень макро-команд"

Раздел "Макро-команды" создан для удобства пользования макро-командами пользователем. Имеется два способа доступа к макро-командам: из выпадающего списка команд и из данного раздела.

Программы

Скачать программы (zip)

Скачать "Smacont RC03" (zip)

04.11.2020

Блок управления кухонной вытяжкой

25.09.2020

Терморегулятор на четыре канала

22.09.2020

Термометр для измерения температуры воздуха на базе светодиодной ленты ws2811, ws2812b (sk6812)

13.09.2020

Контроллер управления сервоприводами и светодиодной подсветкой для полноростовых крыльев

25.08.2020

Сравнение датчиков температуры при работе с WiFi-модулем SC120

24.08.2020

Подключение терморезисторов (термисторов, термосопротивлений) к WiFi-модулю SC120

22.08.2020

Подключение датчиков температуры LM35 (TMP35, TMP36, TMP37) к WiFi-контроллеру SC120

все новости