1. Управление с помощью SMS
Эта функция позволяет информировать пользователей о событиях и состоянии контроллера, а также управлять контроллером с помощью SMS.
1.1. Общие правила формирования управляющих SMS
Управляющие SMS задаются в форме:
-
/ПАРОЛЬ␣КОМАНДА␣АРГУМЕНТ␣! -
/ПАРОЛЬ␣КОМАНДА=АРГУМЕНТ␣! -
/ПАРОЛЬ␣КОМАНДА?АРГУМЕНТ -
КОМАНДА
| Поле | Описание |
|---|---|
|
Прямой слеш. Обязательный признак начала сообщения. |
|
Пароль для SMS управления. Задается на странице Общие параметры соединений конфигуратора. Если пароль не задан в конфигураторе, то это поле не указывается. Пароль чувствителен к регистру. |
|
Пробел. Является разделителем полей. |
|
Знак равенства. В некоторых случаях является разделителем команды и аргумента вместо пробела. |
|
Знак вопроса. В некоторых случаях является разделителем команды и аргумента вместо пробела. |
|
Данное поле содержит командное слово, например: |
|
Данное поле содержит аргумент команды. Некоторые команды не имеют аргумента, например: |
|
Восклицательный знак. Запрос подтверждения выполнения команды. Необязательное поле. |
Одно сообщение может содержать несколько команд и аргументов, например:
/ПАРОЛЬ␣КОМАНДА␣АРГУМЕНТ␣КОМАНДА␣АРГУМЕНТ␣!
В этом случае команды будут выполнены в порядке следования.
Если в команде или ее аргументе допущена ошибка, то данная команда не выполняется и происходит обработка следующей части управляющего SMS. Если включена настройка Контроль ошибок управляющих SMS на странице Соединения конфигуратора, то ответное сообщение содержит информацию об ошибках.
Если включена настройка Всегда подтверждать выполнение SMS команды на странице Общие параметры соединений конфигуратора, подтверждение формируется всегда, независимо от наличия в сообщении !.
| Если несколько элементов управления (входы, выходы, и т.д.) имеют одинаковые названия, то команда будет воздействовать на все одноименные элементы. |
Зарезервированные слова, использующиеся в командах и аргументах (ARM, DISARM, TEST и т.д.) нельзя использовать в качестве названий элементов управления (входы, выходы, и т.д.). Команды и аргументы не чувствительны к регистру.
|
1.2. Список команд управления
| Название команды | Пароль | Команда | Разделитель | Аргумент | Запрос |
|---|---|---|---|---|---|
Включить/выключить выход |
Есть |
Название выхода. Например: |
|
Название активного или пассивного состояния выхода. Например: |
|
Заблокировать/разблокировать вход |
Есть |
Название входа. Например: |
|
Заблокировать: |
|
Установить границы тревожной зоны |
Есть |
Название входа. Например: |
|
Нижняя и верхняя границы. Например: |
|
Запросить состояние входа или выхода |
Есть |
Название входа или выхода. Например: |
|
|
|
Применить профиль |
Есть |
Название профиля. Например: |
|
||
Запросить состояние всех разрешенных входов |
Есть |
|
|||
Запросить состояние всех разрешенных выходов |
Есть |
|
|||
Перейти в режим ОХРАНА |
Есть |
|
|
||
Перейти в режим НАБЛЮДЕНИЕ |
Есть |
|
|
||
Перейти в режим ЗАЩИТА |
Есть |
|
|
||
Перейти в режим ОХРАНА для многораздельного режима контроллера |
Есть |
Название раздела. Например: |
|
|
|
Перейти в режим НАБЛЮДЕНИЕ для многораздельного режима контроллера |
Есть |
Название раздела. Например: |
|
|
|
Запросить тестовое сообщение |
Есть |
|
|||
Установить дату и время |
Есть |
|
|
Дата и время в формате: |
|
Синхронизировать дату и время с часами оператора сотовой связи |
Есть |
|
|
||
Запросить информацию о контроллере (аппаратная версия, версия прошивки и т.д.) |
Есть |
|
|||
Запросить список номеров телефонов соединений |
Есть |
|
|||
Заблокировать соединение по номеру телефона или по порядковому номеру |
Есть |
|
|
Номер телефона |
|
Разблокировать соединение по номеру телефона или по порядковому номеру |
Есть |
|
|
Номер телефона |
|
Изменить задачу планировщика |
Есть |
|
|
См. подробное описание команды ниже. |
|
Запросить параметры задачи планировщика |
Есть |
|
|
Номер задачи планировщика |
|
Вывести контроллер в Интернет |
Есть |
|
|||
Запретить выход в Интернет до перезагрузки контроллера |
Есть |
|
|||
Разрешить выход в Интернет |
Есть |
|
|||
Перезагрузить контроллер |
Есть |
|
|||
Запретить привязку номера телефона к боту |
|
||||
Разрешить привязку номера телефона к боту |
|
||||
Запросить временный доступ к контроллеру |
|
1.3. Подробное описание команд управления
Все команды управления начинаются с конструкции /ПАРОЛЬ␣.
ПАРОЛЬ — пароль для SMS управления, который задается на странице Общие параметры соединений конфигуратора. Если пароль для SMS управления не задан в конфигураторе, то команды управления начинаются с конструкции /␣. Пароль чувствителен к регистру.
Пример команды управления, если пароль не задан в конфигураторе:
/ ОТОПЛЕНИЕ ВКЛ
Если время доставки SMS команды превышает значение, установленно в настройке Не выполнять SMS команды старше, чем на странице Общие параметры соединений, команда не выполняется, а в ответ приходит сообщение:
OUTDATED MESSAGE
1.3.1. Включить/выключить выход
/ПАРОЛЬ␣КОМАНДА␣АРГУМЕНТ␣!
КОМАНДА — название выхода. Например: ОТОПЛЕНИЕ, ЗАМОК. Название выхода задается на странице Выходы конфигуратора.
АРГУМЕНТ — название активного или пассивного состояния выхода. Например: ВКЛ, ОТКРЫТ. Название активного и пассивного состояния выхода задается на странице Выходы конфигуратора.
/pass ОТОПЛЕНИЕ ВКЛ ЗАМОК ОТКРЫТ !
12:30
ОТОПЛЕНИЕ ВКЛ
ЗАМОК ОТКРЫТ
| Команда действует на выход, только если включена опция Разрешено дистанционное управление на странице Выходы конфигуратора. |
1.3.2. Заблокировать/разблокировать вход
/ПАРОЛЬ␣КОМАНДА␣АРГУМЕНТ␣!
КОМАНДА — название входа. Например: ДВЕРЬ, ТЕМПЕРАТУРА. Название входа задается на странице Входы конфигуратора.
АРГУМЕНТ — признак блокрировки. Заблокировать: –. Разблокировать: +. Команда блокировки позволяет заблокировать вход на время текущей охранной сессии. В заблокированном состоянии вход не генерирует тревожные события. Вход разблокируется при переходе в режим ОХРАНА/НАБЛЮДЕНИЕ или по команде разблокировки. Вход может самоблокироваться в соответствии с настройкой Максимальное кол-во тревог в одной охранной сессии на странице Входы конфигуратора.
/pass ДВЕРЬ – !
12:30
ДВЕРЬ ОТКРЫТА –
При заблокированном входе в конце соответствующей строки добавляется признак блокировки –. Если вход разблокирован, информация об этом не добавляется.
1.3.3. Установить границы тревожной зоны
/ПАРОЛЬ␣КОМАНДА␣АРГУМЕНТ␣!
КОМАНДА — название входа. Например: НАПРЯЖЕНИЕ, ТЕМПЕРАТУРА. Название входа задается на странице Входы конфигуратора.
АРГУМЕНТ — нижняя и верхняя границы. Например: 21:23, 16.5:18.5. В качестве разделителя целой и дробной части можно использовать точку или запятую. Заданные пользователем границы приводятся в контроллере к ближайшим внутренним значениям, поэтому установленные значения могут несколько отличаться от заданных.
/pass НАПРЯЖЕНИЕ 200:230
12:30
НАПРЯЖЕНИЕ 225.2 [200:230.39] В
Текущее напряжение 225.2, в квадратных скобках установленные нижняя и верхняя границы.
1.3.4. Запросить состояние входа или выхода
/ПАРОЛЬ␣КОМАНДА␣АРГУМЕНТ
КОМАНДА — название входа или выхода. Например: ТЕМПЕРАТУРА, ЗАМОК. Название входа задается на странице Входы конфигуратора. Название выхода задается на странице Выходы конфигуратора.
АРГУМЕНТ — признак запроса состояния ?.
/pass ПРИХОЖАЯ ? ДВЕРЬ ? ОКНО ? НАГРЕВАТЕЛЬ ? ТЕМПЕРАТУРА ?
12:30
ПРИХОЖАЯ НОРМА
ДВЕРЬ ЗАКРЫТА
ОКНО ЗАКРЫТО
НАГРЕВАТЕЛЬ ВКЛЮЧЕН
ТЕМПЕРАТУРА 15 [13,7:17,7] C
1.3.5. Применить профиль
/ПАРОЛЬ␣КОМАНДА␣!
КОМАНДА — название профиля. Например: ЭКОНОМ, КОМФОРТ. Название профиля задается на странице Профили конфигуратора.
/pass КОМФОРТ !
12:30
КОМФОРТ
| Заметим, что профиль не является режимом, поэтому не существует понятия активный профиль. Профиль только устанавливает новые значения параметров. При необходимости можно запросить значения параметров, на которые воздействовал профиль соответствующими командами. |
1.3.6. Запросить состояние всех разрешенных входов
/ПАРОЛЬ␣КОМАНДА
КОМАНДА — INS.
/pass INS
12:30
ПРИХОЖАЯ НОРМА
ДВЕРЬ ЗАКРЫТА
ОКНО ЗАКРЫТО
КУХНЯ НОРМА
ДАТЧИКВОДЫ НОРМА
ТЕМПЕРАТУРА 15 C
| Заметим, что для входов значения границ тревожной зоны не включается в ответ при данном запросе. |
1.3.7. Запросить состояние всех разрешенных выходов
/ПАРОЛЬ␣КОМАНДА
КОМАНДА — OUTS.
/pass OUTS
12:30
ЗАМОК ЗАКРЫТ
НАГРЕВАТЕЛЬ ВЫКЛЮЧЕН
ПОЛИВ ВКЛЮЧЕН
1.3.8. Перейти в режим ОХРАНА
/ПАРОЛЬ␣КОМАНДА␣!
КОМАНДА — ARM или ОХРАНА.
Выполнение этой команды происходит мгновенно, задержка перехода в режим ОХРАНА игнорируется.
/pass ARM !
12:30
ARM
1.3.9. Перейти в режим НАБЛЮДЕНИЕ
/ПАРОЛЬ␣КОМАНДА␣!
КОМАНДА — DISARM или НАБЛЮДЕНИЕ.
/pass DISARM !
12:30
DISARM
1.3.10. Перейти в режим ЗАЩИТА
/ПАРОЛЬ␣КОМАНДА␣!
КОМАНДА — PROTECT или ЗАЩИТА.
/pass PROTECT !
12:30
PROTECT
1.3.11. Перейти в режим ОХРАНА для многораздельного режима контроллера MultiPart
/ПАРОЛЬ␣КОМАНДА␣АРГУМЕНТ␣!
КОМАНДА — название раздела. Например: ДВОР, ПРИХОЖАЯ. Название раздела задается на странице Охрана конфигуратора.
АРГУМЕНТ — ARM или ОХРАНА.
Выполнение этой команды происходит мгновенно, задержка перехода в режим ОХРАНА игнорируется.
/pass ПРИХОЖАЯ ARM !
12:30
ПРИХОЖАЯ ARM
1.3.12. Перейти в режим НАБЛЮДЕНИЕ для многораздельного режима контроллера MultiPart
/ПАРОЛЬ␣КОМАНДА␣АРГУМЕНТ␣!
КОМАНДА — название раздела. Например: ДВОР, ПРИХОЖАЯ. Название раздела задается на странице Охрана конфигуратора.
АРГУМЕНТ — DISARM или НАБЛЮДЕНИЕ.
/pass ДВОР DISARM !
12:30
ДВОР DISARM
1.3.13. Запросить тестовое сообщение
/ПАРОЛЬ␣КОМАНДА
КОМАНДА — TEST или TECT.
Тестовое сообщение содержит информацию о текущем состоянии контроллера. Тестовое сообщение может быть получено по запросу пользователя в любое время и по расписанию планировщика задач.
/pass TEST
TEST 12:30
DISARM
POWER OK (15,3v)
BATTERY 90%
TEMPERAT 31C
BALANS 251
В многораздельном режиме контроллера в тестовое сообщение не включается информация о неиспользуемых разделах. В тестовое сообщение не включется информация о батарее, если она ни разу не подключалась с момента подачи основного питания. В тестовое сообщение не включается информация о балансе, если с момента включения контроллера значение баланса не было определено или функция контроля баланса отключена.
1.3.14. Установить дату и время
/ПАРОЛЬ␣КОМАНДА␣АРГУМЕНТ␣!
КОМАНДА — SETTIME.
АРГУМЕНТ — дата и время в формате: ДД.ММ.ГГ.чч:мм.
Часы контроллера имеют некоторую погрешность и при длительной работе может появится расхождение. Команда установки даты и времени позволяет удаленно произвести корректировку.
/pass SETTIME 30.08.19.20:04 !
CLOCK 30.08.19.20:04
1.3.15. Синхронизировать дату и время с часами оператора сотовой связи
/ПАРОЛЬ␣КОМАНДА␣!
КОМАНДА — SYNCTIME.
Команда позволяет синхронизировать часы контроллера с часами SMS центра оператора сотовой связи. При получении этой команды, контроллер извлечет время из специального поля SMS и установит часы.
/pass SYNCTIME !
CLOCK 30.08.19.20:04
1.3.16. Запросить информацию о контроллере (аппаратная версия, версия прошивки и т.д.)
/ПАРОЛЬ␣КОМАНДА
КОМАНДА — VERSION.
При обращении в службу поддержки, необходимо знать аппаратную версию контроллера, версию прошивки и т.д. Эту информацию можно получить с помощью команды VERSION.
/pass VERSION
DEVICE: CCU825
FW: PLC.02.19
HW: 16.00
DATE: Feb 14 2019
LOC: RUS
Id: 00000000 11111111 22222222 33333333
IMEI: 123456789012345
GSM: M95FAR02A09
www.radsel.ru
1.3.17. Запросить список номеров телефонов соединений
/ПАРОЛЬ␣КОМАНДА
КОМАНДА — NUMINFO.
С помощью команды NUMINFO можно получить список телефонов соединений. Если в ответе после номера соединения присутствует символ *, это означает, что номер телефона этого соединения заблокирован с помощью команды NUMBLOCK.
/pass NUMINFO
12:30
1*+79101111111
2 +79102222222
3
4 +79104444444
5
6
7
8
1.3.18. Заблокировать соединение по номеру телефона или по порядковому номеру
/ПАРОЛЬ␣КОМАНДА=АРГУМЕНТ␣!
КОМАНДА — NUMBLOCK.
АРГУМЕНТ — номер телефона +71112223344 или порядковый номер соединения в формате N1-N8.
В некоторых случаях, например при отъезде в отпуск, получение тревожных и информационных сообщений может быть неудобным. Передачу сообщений такому пользователю можно временно заблокировать этой командой. Существует два способа блокировки: по номеру телефона и по номеру соединения. Блокировка действует только на голосовые и SMS оповещения.
/pass NUMBLOCK=+79105555555
/pass NUMBLOCK=N2
12:30
[2]+79105555555 BLOCKED
1.3.19. Разблокировать соединение по номеру телефона или по порядковому номеру
/ПАРОЛЬ␣КОМАНДА=АРГУМЕНТ␣!
КОМАНДА — NUMUNBLOCK.
АРГУМЕНТ — номер телефона +71112223344 или порядковый номер соединения в формате N1-N8.
При необходимости возобновить получение сообщений на заблокированное ранее соединение, нужно разблокировать соединение этой командой.
/pass NUMUNBLOCK=+79105555555
/pass NUMUNBLOCK=N2
12:30
[2]+79105555555 UNBLOCKED
1.3.20. Изменить задачу планировщика
/ПАРОЛЬ␣КОМАНДА=АРГУМЕНТ␣!
КОМАНДА — SHEDITEM.
АРГУМЕНТ — параметры задачи планировщика в формате представленном ниже.
| 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1. Номер задачи в диапазоне 1-8.
2. Признак включения задачи. Возможные значения: 0 — выключена, 1 — включена.
3. Время исполнения задачи в формате чч:мм.
4. Числовое поле из семи цифр, каждая из которых соответствует дню недели исполнения задачи. Понедельник справа, воскресенье слева. Возможные значения: 0 — день недели запрещен, 1 — день недели разрешен.
5. Признак включения тестового сообщения. Возможные значения: 0 — выключено, 1 — включено.
6. Признак включения информационного сообщения. Возможные значения: 0 — выключено, 1 — включено.
7. Действие, которое будет происходить при исполнении задачи планировщика. Возможные значения: 0 — нет действия, 1 — перейти в режим ОХРАНА, 2 — перейти в режим НАБЛЮДЕНИЕ, 3 — управлять выходом, 4 — применить профиль.
8. Значение этого параметра зависит от выбранного в поле 7 действия. См. таблицу ниже.
9. Значение этого параметра зависит от выбранного в поле 8 значения. См. таблицу ниже.
| Поле 7 (действие) | Поле 8 | Поле 9 |
|---|---|---|
|
||
|
В многораздельном режиме: |
|
|
В многораздельном режиме: |
|
|
Номер выхода |
|
|
Номер профиля |
Все параметры, кроме первого, являются необязательными. Если нет необходимости изменять параметр, то он опускается, а запятые остаются. Если нет необходимости изменять параметры в оставшейся части команды справа, то эта часть может быть отброшена.
/pass SHEDITEM=1,1,12:00,0101010,,1
12:30
SHEDITEM=1,1,12:00,0101010,1,0,0,1,0
1.3.21. Запросить параметры задачи планировщика
/ПАРОЛЬ␣КОМАНДА?АРГУМЕНТ
КОМАНДА — SHEDITEM.
АРГУМЕНТ — порядковый номер задачи в дипазоне 1-8.
/pass SHEDITEM?1
12:30
SHEDITEM=1,1,12:00,0101010,1,0,0,1,0
1.3.22. Вывести контроллер в Интернет
/ПАРОЛЬ␣КОМАНДА
КОМАНДА — ONLINE.
Если задан режим подключения контроллера к Интернету по запросу пользователя, эта команда приведет к выходу контроллера в Интернет на время, указанное в настройке Максимальная длительность сессии на странице Общие параметры соединений конфигуратора. Для выхода в Интернет контроллеру требуется несколько секунд.
/pass ONLINE
12:30
ACCEPTED
1.3.23. Запретить выход в Интернет до перезагрузки контроллера
/ПАРОЛЬ␣КОМАНДА
КОМАНДА — GPRSLOCK.
Эта команда запрещает выход в Интернет до перезагрузки контроллера или разрешения с помощью команды GPRSUNLOCK. Если соединение установлено, оно завершается. Эта команда не влияет на Интернет соединение с программой GuardTracker.
/pass GPRSLOCK
12:30
ACCEPTED
1.3.24. Разрешить выход в Интернет
/ПАРОЛЬ␣КОМАНДА
КОМАНДА — GPRSUNLOCK.
Эта команда разрешает выход в Интернет. Соединение будет установлено при наступлении условия для подключения.
/pass GPRSUNLOCK
12:30
ACCEPTED
1.3.25. Перезагрузить контроллер
/ПАРОЛЬ␣КОМАНДА
КОМАНДА — RESTART.
Эта команда запускает процедуру перезагрузки. Если в момент поступления команды существует активное голосовое соединение или контроллер подключен к Интернету, перезагрузка будет отложена до момента завершения указанных соединений.
/pass RESTART
1.3.26. Запретить привязку номера телефона к боту
КОМАНДА
КОМАНДА — LINKLOCK.
LINKLOCK
12:30
ACCEPTED
1.3.27. Разрешить привязку номера телефона к боту
КОМАНДА
КОМАНДА — LINKUNLOCK.
LINKUNLOCK
12:30
ACCEPTED
1.4. Сообщения формируемые контроллером автоматически
Контроллер автоматически отправляет SMS сообщения в следующих случаях:
-
при переходе входа в активное состояние;
-
при переходе входа в пассивное состояние;
-
при применении профиля;
-
при отключении и восстановлении основного питания;
-
при разряде батареи;
-
при выходе температуры системной платы за заданные границы и возврате в норму;
-
при снижении баланса до установленного значения;
-
при наступлении времени отправки тестового и информационного сообщения по планировщику задач;
-
при всрытии корпуса контроллера;
-
и т. д.
| SMS сообщение на английском языке | SMS сообщение на русском языке | Описание сообщения |
|---|---|---|
|
|
Вход ДВЕРЬ, к которому подключен датчик открытия двери, перешел в активное состояние ОТКРЫТА. Знак |
|
|
Вход ТЕМПЕРАТУРА, к которому подключен термодатчик, перешел в активное состояние. Температура 12°С, вышла за границы тревожной зоны 13.7-17.7°С. Знак |
|
|
Применен профиль КОМФОРТ. Название профиля задается на странице Профили конфигуратора. |
|
|
Контроллер переведен в режим ОХРАНА ключом Touch Memory. Пользователь МАКСИМ. Имя ключа задается на странице Охрана конфигуратора. |
|
|
Раздел ПРИХОЖАЯ переведен в режим ОХРАНА ключом Touch Memory. Пользователь МАКСИМ. Только для многораздельного режима контроллера. Название раздела задается на странице Охрана конфигуратора. Имя ключа задается на странице Охрана конфигуратора. MultiPart |
|
|
Контроллер переведен в режим ЗАЩИТА кнопкой. |
|
|
Контроллер переведен в режим НАБЛЮДЕНИЕ через голосовое меню. Номер телефона пользователя +71112223344. Номер телефона задается на странице Соединения конфигуратора. |
|
|
Раздел ПРИХОЖАЯ переведен в режим НАБЛЮДЕНИЕ через голосовое меню. Номер телефона пользователя +71112223344. Название раздела задается на странице Охрана конфигуратора. Номер телефона задается на странице Соединения конфигуратора. MultiPart |
|
|
Контроллер переведен в режим ОХРАНА с помощью SMS команды. Пользователь неизвестен. |
|
|
Контроллер переведен в режим ОХРАНА кнопкой. |
|
|
Основное питание восстановлено. |
|
|
Основное питание отключено. |
|
|
Заряд батареи 90 %. |
|
|
Батарея отключена или неисправна. |
|
|
Температура системной платы снизилась до нижней границы. Текущая температура 15°C. |
|
|
Температура системной платы вернулась в норму. Текущая температура 18°C. |
|
|
Температура системной платы повысилась до верхней границы. Текущая температура 35°C. |
|
|
Баланс снизился до заданного значения. Значение баланса 125.15 единиц. |
|
|
Вскрытие корпуса контроллера. |
|
|
Номер пользователя заблокирован с помощью команды |
|
|
Номер пользователя заблокирован с помощью команды |
|
|
Контроллер включен. |
|
|
Контроллер перезагружен. |
|
|
Обновлена прошивка контроллера. |
|
|
Контроллер не смог подключиться к коммуникационному серверу в Интернете. |
|
|
Контроллер не смог подключиться к Интернету. |
|
|
Произоша ошибка выполнения программы EXT. Код ошибки 5. Программа остановлена. |
| Заметим, что SMS сообщения на кириллице менее экономичны. Одно SMS сообщение на кириллице может содержать максимум 70 символов. Одно SMS сообщение на латиннице может содержать максимум 160 символов. Если количество символов превышает указанные значения, сообщение будет отправлено в виде двух и более SMS. |