Модемы серии RX, разработанные на базе беспроводных модулей компании Telit, имеют встроенный интерпретатор языка программирования Python. Это дает возможность использовать модем RX в ряде задач, где модем выполняет отличные функции от базового.
На протяжении длительного времени, наша компания разработала ряд скриптов для нестандартного использования, в том числе и для наших служб.
Важно! На текущий момент, наша компания осуществляет поддержку обновления только одного скрипта - GPRSTerminal. Обновление остальных скриптов больше не производится, Вы можете использовать данные скрипты "как есть".
О том, как загружать, изменять, останавливать и удалять скрипты из модемов Вы можете узнать из отдельной статьи:
На данный момент многие модели модемов выпускаются во второй аппаратной версии (на этикетке модема это обозначается надписью "rel.2"). В новой аппаратной версии присутствует важное отличие - встроенный аппаратный Watchdog, перезагружающий модем в случае зависания, что дополнительно повышает отказоустойчивость.
Данное изменение в работе модемов требует изменение в работе скриптов. Так как мы более не поддерживаем готовые скрипты, большинство из них необходимо будет доработать самостоятельно, если Вы планируете работать с ними на модеме модификации rel.2. Единственное исключение - скрипт GPRSTerminal - для него была выпущена совместимая с rel.2 версия.
В случае, если Вам необходимо использовать с модемами rel.2 один из представленных ниже скриптов, изначально предназначенных для модемов первой аппаратной модификации, или какой-то собственный скрипт, также написанный для модемов первой модификации, нужно будет предусмотреть сброс аппаратного Watchdog с помощью вызова в скрипте двух команд:
Команда | Описание | Режим вызова |
SER2.set_speed('9600', '8N1') | Инициализация второго физического последовательного порта на скорости 9600 с параметрами 8N1 | Вызывается однократно в начале скрипта |
SER2.send('OK\r\n') | Heartbeat-сообщение, которое сбрасывает счетчик внешнего Watchdog таймера | Вызывается в основном цикле скрипта с периодичностью не реже 1 раза в 5 секунд |
С примером добавления данных строк можете ознакомиться в версии скрипта GRRSTerminal, предназначенной для модемов rel.2
Документация по работе с программированием на Python в GSM модуляx Telit GL868-Dual доступна по ссылке:
http://gprs-modem.ru/docs/TELIT/Python_Tools/
1. Скрипт GprsTerminal (Поддержка обновлений)
Поддерживаемые модели: Подходит для всех модемов TELEOFIS c GSM модулем Telit GL868-Dual
Ссылка для скачивания скрипта для первой аппаратной версии модемов RX
Ссылка для скачивания скрипта для второй аппаратной версии модемов RX (rel.2)
ВНИМАНИЕ: Скрипт GPRS Terminal для первой версии модемов необходимо использовать также для версий: rel 2.2a, rel 2.3
Скрипт GPRS Terminal для GPRS Terminal для версии модемов RX rel.2 необходимо использовать для версий: rel 2.0, rel 2.1, rel 2.2
Данный скрипт обладает следующими функциональными возможностями:
- Подключение и поддержание GPRS соединения.
- Работа в режиме TCP-клиента. (режим TCP-сервера с данный скрипт НЕ поддерживает!)
- Контроль соединения с удаленным хостом (пингуется внешний IP и порт)
- Подключение к сервису авторизации (M2M24.RU)
- Отправка лога по TCP (c авторизацией и без)
- Возможность подключения по CSD в качестве резервного канала.
Пример конфигурации:
Все поля должны быть заполнены, иначе могут возникнуть ошибки в работе скрипта.
Более подробно работа с данным скриптом описана в руководстве по настройке модемов для работы с сервером M2M24Cloud, последнюю редакцию которого Вы можете найти на странице утилиты Сервер TCP-соединений М2М24 Cloud
2. Скрипт SmartSMS (Архивный)
Поддерживаемые модели: RX100-R4, RX108-R4, RX102-R4
Ссылка для скачивания скрипта для первой аппаратной версии модемов RX
Скрипт позволяет:
- При замыкании входа "Сухой контакт" рассылать SMS с уведомлением о событии.
- Управлять выходом (при наличии управляемого выхода), т.е. при получении SMS определенного формата, скрипт замкнет управляющий выход.
Не любая SMS может запустить событие на замыкание. Для защиты устройства используется пароль доступа.
Пароль по умолчанию: 0000
Поддерживаемые SMS команды.
Управление выходами:
OUT1=0 (отключить выход)
OUT1=1 (включить выход)
Пароль доступа:
PASS=Password123 (строка из латинских букв и цифр)
Список номеров для оповещения об изменении состояния входов:
ALERT=+79261234567,+79169876543 (перечень телефонных номеров в формате +7...., разделенных запятой, количество не ограничено)
Пользовательское название входов для SMS оповещения:
(текст, только латинские буквы)
IN1ONTXT=... сообщение при лог. 1 на входе
IN1OFFTXT=... сообщение при лог. 0 на входе
Время включения выхода:
OUT1TIME=10 (значение в сек)
Формат отправляемого на модем SMS:
PASSWORD;OUT1=1
Пример:
0000;OUT1=1
Параметр SMSDELETEALL должен всегда быть 1
Пример конфигурации:
3. Скрипт NetQualitySimSwitcherRx (Архивный)
Поддерживаемые модели: RX102-R2, RX602-R2
Ссылка для скачивания скрипта для первой аппаратной версии модемов RX
Позволяет реализовать автоматическое переключение SIM-карты на резервную в случае низкого уровня сигнала или отсутствия регистрации в сети.
Переключение с резервной SIM-карты на основную также происходит в автоматическом режиме.
Алгоритм работы скрипта следующий:
- Проверка регистрации в сети.
- Измерение уровня сигнала.
- Если уровень сигнала ниже заданного (12), модем переключается на резервную SIM.
- Через заданное время (300 сек) модем переключается с резервной SIM на основную SIM.
4. Скрипт RX608SimSwitcher
Поддерживаемые модели: RX608-L4U V.1
Позволяет реализовать автоматическое переключения SIM-карты на резервную в случае низкого уровня сигнала или отсутствие регистрации в сети.
Алгоритм работы скрипта следующий:
- Проверка регистрации в сети.
- Измерение уровня сигнала.
- Если уровень сигнала ниже или равен (10), модем переключается на резервную SIM.
Данный скрипт необходимо установить вручную. Алгоритм установки скрипта простой:
1. Скачайте архив со скриптом по ссылке и распакуйте его;
2. Подключите модем к компьютеру*, откройте программу RXConfigurationTool и выберите COM-порт устройства;
3. Перейдите во вкладку "Настройки программы" - "Скрипт" и укажите путь до архива со скриптом;
4. Откройте Терминал и введите команду AT#ESCRIPT="switcher.pyo"
*подключиться к модему можно по интерфейсам RS-232 и RS-485
5. Скрипт TcpSimSwitcherRx (Архивный)
Поддерживаемые модели: RX102-R2, RX602-R2
Ссылка для скачивания скрипта для первой аппаратной версии модемов RX
Позволяет реализовать автоматическое переключение SIM в случае пропадания связи.
После установки скрипта, модем будет проверять регистрацию в сети, наличие подключения к сети Интернет и в случае отсутствия подключения, будет переключаться на резервную SIM.
Алгоритм работы скрипта следующий:
- Проверка регистрации в сети.
- Проверка подключения к GPRS.
- Проверка доступности заданного адреса (по TCP протоколу).
- Если нет связи с заданным адресом модем переключается на резервную SIM.
6. Скрипт WDT_10m (Архивный)
Поддерживаемые модели: RX100-R2, RX100-R4, RX108-R2, RX108-R4, RX112-L4 и другие с модулем GL868
Ссылка для скачивания скрипта для первой аппаратной версии модемов RX
Внимание! Данный скрипт предназначен только для первой аппаратной ревизии модемов серии RX.
Выполняет перезагрузку модема в случае зависания GSM модуля в течении 10 минут, а так же безусловно - каждые 24 часа.
Данный скрипт идет по умолчанию при продаже с поддерживаемыми моделями модемов.
Для второй аппаратной версии модемов (rel.2) данный скрипт не используется, так как его функционал полностью берёт на себя встроенный аппаратный Watchdog.
7. Скрипт TcpSimSwitcherProf (Архивный)
Поддерживаемые модели: Подходит для модемов TELEOFIS серии Professional
Позволяет реализовать автоматическое переключение SIM в случае пропадания связи.
После установки скрипта, модем будет проверять регистрацию в сети, наличие подключения к сети Интернет и в случае отсутствия подключения, будет переключаться на резервную SIM.
Алгоритм работы скрипта следующий:
- Проверка регистрации в сети.
- Проверка подключения к GPRS.
- Проверка доступности заданного адреса (по TCP протоколу).
- Если нет связи с заданным адресом модем переключается на резервную SIM.
8. Скрипт Zatvor (Архивный)
Поддерживаемые модели: RX102-R2 Professional (питание 7-30 В), RX602-R2 Professional (питание 220 В)
Предназначен для дистанционного управления нагрузкой и контроля состояния входов с отправкой тревожных сообщений по SMS.
Настройка скрипта осуществляется с помощью отправки SMS сообщений на модем, либо через порт RS232 универсальной программой конфигурации Python Configuration Tool.
Доступ к настройкам ограничен паролем (по умолчанию - 0000).
Количество выходов типа "открытый коллектор": 2
Количество входов типа "АЦП": 1
Количество входов типа "сухой контакт": 4
Управление выходом осуществляется, либо посредством SMS сообщения, либо c помощью телефонного звонка с номера, находящегося в белом списке.
Минимальная длительность замыкания датчика на входе для гарантированного срабатывания оповещения - 20 секунд.
Формат SMS сообщения для настройки прибора:
PASSWORD;OUT1=1;ADCTXT=Text dlya adc;WHITE=+79161234567,+79267654321
Команды управления выходом:
OUT1=0 (отключить выход 1)
OUT1=1 (включить выход 1)
OUT2=0 (отключить выход 2)
OUT2=1 (включить выход 2)
Получение текущего значения на входе АЦП:
ADC=?
Перечень параметров для SMS команд:
Команда SMS | По умолчанию | Описание |
PASS | 0000 | Пароль доступа (до 32 печатных символов) |
WHITE | Список разрешенных “белых” номеров (до 10 номеров) для управления выходом в формате: +7xxxyyyzzxx, +7yyyxxxzzxx | |
ALERT | Список номеров для оповещения об изменении состояния входов в формате: +7xxxyyyzzxx, +7yyyxxxzzxx | |
ADCVAL | 5000 | Порог срабатывания АЦП (в мВ) |
ADCHYST | 500 | Гистерезис порога срабатывания АЦП (в мВ) |
OUT1TIME OUT2TIME | 0 | Время включения выходов 1 и 2 (в сек, 0 - бесконечно) |
ADCTXTOVR | ADC>VALUE | Текстовое сообщение, отправляемое при превышении напряжения порога АЦП |
ADCTXTUND | ADC<VALUE | Текстовое сообщение, отправляемое при понижении напряжения ниже заданного порога АЦП |
IN1ONTXT | IN1=H | Текст сообщения о логической 1 на входе 1 |
IN1OFFTXT | IN1=L | Текст сообщения о логической 0 на входе 1 |
IN2ONTXT | IN2=H | Текст сообщения о логической 1 на входе 2 |
IN2OFFTXT | IN2=L | Текст сообщения о логической 0 на входе 2 |
IN3ONTXT | IN3=H | Текст сообщения о логической 1 на входе 3 |
IN3OFFTXT | IN3=L | Текст сообщения о логической 0 на входе 3 |
IN4ONTXT | IN4=H | Текст сообщения о логической 1 на входе 4 |
IN4OFFTXT | IN4=L | Текст сообщения о логической 0 на входе 4 |
SMS_ACK | 1 | Уведомление о выполнении SMS команд (0 - выкл., 1 - вкл.) |
DEBUG | 0 | Режим отладки (0 - откл., 1 - вкл.) |
ADCFRONT | 3 | Режим срабатывания оповещения АЦП (1 - фронт, 2 - спад, 3 - оба) |
IN1FRONT | 3 | Режим срабатывания оповещения входа 1 (1 - фронт, 2 - спад, 3 - оба) |
IN2FRONT | 3 | Режим срабатывания оповещения входа 2 (1 - фронт, 2 - спад, 3 - оба) |
IN3FRONT | 3 | Режим срабатывания оповещения входа 3 (1 - фронт, 2 - спад, 3 - оба) |
IN4FRONT | 3 | Режим срабатывания оповещения входа 4 (1 - фронт, 2 - спад, 3 - оба) |
ADCDELAY | 20 | Задержка повторного оповещения по срабатыванию АЦП (в сек) |
IN1DELAY | 20 | Задержка повторного оповещения по срабатыванию входа 1 (в сек) |
IN2DELAY | 20 | Задержка повторного оповещения по срабатыванию входа 2 (в сек) |
IN3DELAY | 20 | Задержка повторного оповещения по срабатыванию входа 3 (в сек) |
IN4DELAY | 20 | Задержка повторного оповещения по срабатыванию входа 4 (в сек) |
REBOOTPERIOD | 86400 | Период плановой перезагрузки (в сек, 0 - выкл.) |
SAVEINPUTS | 0 | Сохранять состояние входов в энергонезависимой памяти (0 - не сохранять, 1 - сохранять) |
ALIVESMS | 0 | Количество плановых перезагрузок между отправкой тестового SMS (0 - выкл.) |
Пример конфигурации:
Дополнительная информация:
GSM модемы TELEOFIS серии RX. Руководство по эксплуатации
Ссылки по теме:
Описание работы со скриптами в модемах RX