Modem-bullseye: различия между версиями

Версия 09:16, 31 марта 2023

Общая информация

В контроллеры Wiren Board могут быть установлены 2G/3G/4G(LTE)/NB-IOT модемы — зависит от комплектации.

В Debian Bullseye для управления 4G-модемами используются сервисы ModemManager и NetworkManager. Остальные модемы управляются аналогично тому, как это делалось в Debian Stretch.

Описанное ниже относится к работе с использованием ModemManager.

С помощью модемов можно:

отправлять и принимать SMS,
подключаться к интернету по протоколу PPP.

Модемы подключаются к процессору по uart и usb, исключение — модемы 2G. Подробнее о подключении модемов и низкоуровневом взаимодействии с ними можно почитать в разделе Низкоуровневая работа по uart.

Управление питанием и переключением активных sim-карт (если их две) производится с помощью gpio, процесс описан в разделе Переключение активной sim-карты.

Включение и отключение модема рекомендуем делать с помощью сервиса wb-gsm.

Получение информации о модеме

В контроллерах, начиная с 2019 года, некоторая информация о модеме заносится в память. Получить её можно с помощью чтения файлов в директории /proc/device-tree/wirenboard/gsm/.

В контроллерах версии 6.7 модем устанавливается модулем расширения.

После физического подключения модема его нужно добавить в конфигурацию контроллера:

В веб-интерфейсе перейдите в раздел Настройки → Конфигурационные файлы → Модули расширения и порты, выберите Слот модема.
В раскрывающемся списке Тип модуля выберите тип установленного модуля.
Нажмите кнопку Сохранить. Контроллер включит нужные для работы модема порты.

Для удаления модуля выберите тип Не установлен.

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

Например, чтобы узнать модель модема, нужно выполнить команду

cat /proc/device-tree/wirenboard/gsm/model

Подробнее о файлах внутри директории можно узнать из таблицы:

Файл	Описание
/proc/device-tree/wirenboard/gsm/model	модель модема
/proc/device-tree/wirenboard/gsm/type	поддерживаемые сети
/proc/device-tree/wirenboard/gsm/status	статус модема в системе

ModemManager позволяет получить информацию о модеме. Сделать это можно с помощью утилиты mmcli.

Включение и начало работы

Чтобы начать работу с модемом, нужно:

Подключить антенну.
Вставить sim-карту.

Сервис wb-gsm

Сервис wb-gsm предназначен для управления питанием модема, он входит в пакет wb-utils.

Питание подаётся на модем при старте сервиса и отключается при остановке.

Сервис автоматически запускается при старте контроллера, если модем выбран в настройках модулей расширения.

Управлять работой сервиса можно через команды systemctl. Например, для остановки надо выполнить

systemctl stop wb-gsm

Переключение активной sim-карты

По умолчанию активна Sim1 — в каждый момент времени только одна sim-карта может быть активной.

Для переключения sim-карты используется mmcli с параметром --set-primary-sim-slot. Например:

ModemManager выполнит переключение sim-карты и переинициализирует модем.

Низкоуровневая работа по uart

Любое взаимодействие с модемом так или иначе сводится к отправке AT-команд через последовательный порт модема.

Если необходимо отправлять команды модему нужно остановить сервис ModemManager systemctl stop ModemManager

После этого можно работать с портом как описано здесь, либо запустить ModemManager с параметром --debug и использовать mmcli для отправки команд

Работа с sms

Для отправки sms надо:

Cоздать её с использованием параметра --messaging-create-sms. mmcli вернёт идентификационный номер sms.
Использовать полученный идентификационный номер для отправки командой --send.

SMS-уведомления

Отправка sms-уведомлений об изменении состояния какого-либо устройства реализована в ПО Wiren Board с помощью сервиса уведомлений. Также можно отправлять SMS из движка правил wb-rules, вызывая соответствующую функцию. Подробнее в статье « Модуль уведомлений».

Интернет через PPP

ModemManager и NetworkManager позволяют организовать выход в Интернет через PPP.

После настройки модема в контроллере создаются два соединения NetworkManager'а wb-gsm-sim1 и wb-gsm-sim2. wb-gsm-sim1 задаёт параметры соединения при использовании sim-карты в первом слоте, wb-gsm-sim2 - во втором слоте.

Контроллер имеет базу APN сотовых операторов. NetworkManager сам определит нужный APN в зависимости от вставленной sim-карты.

Настройки соединений можно изменить либо в web-интерфейсе конфигурирования контроллера, либо в консоли утилитой nmcli.

Документация на модемы

Модель	Режимы сети	краткое описание	hardware design	AT-команды
SIM800	2G	pdf	pdf	pdf
SIM5300E	2G/3G	pdf	pdf	pdf
SIM7000E	2G/NB-IOT	pdf	pdf	pdf
7600E	2G/3G/4G	WBC-4G

@@ Строка 102: / Строка 102: @@
 == Интернет через PPP ==
-{{YouTube
-| link= https://youtu.be/ZbJUwoifbzE
-| text= Настройка интернета через PPP с помощью 2G-модема
-}}
-=== Быстрый выход в интернет ===
-Настройки быстрого подключения сбрасываются после перезагрузки контроллера. Если вам нужен постоянный доступ к интернету — настройте автоматический запуск подключения.
-В стандартное ПО контроллера входят настройки подключения для операторов МТС, Мегафон и Билайн по протоколу ppp. Если вы пользуетесь одним из них, то для быстрого подключения к интернету нужно перезапустить модем и подключится с использованием одной из настроек:
+ModemManager и NetworkManager позволяют организовать выход в Интернет через PPP.
-#Перезапустите модем:
-#:<syntaxhighlight lang="bash">
-wb-gsm restart_if_broken
-</syntaxhighlight>
-#Установите соединение, например, для оператора МТС:
-#:<syntaxhighlight lang="bash">
-pon mts
-</syntaxhighlight>
-#:<code>mts</code> можно заменить на <code>megafon</code> или <code>beeline</code> — зависит от вашего оператора связи.
-# Если соединение больше не нужно — вы можете его завершить командой:
-#:<syntaxhighlight lang="bash">
-poff mts
-</syntaxhighlight>
-Если на контроллере установлен модуль 3G- или 4G-модем, то для увеличения пропускной способности соединения, демону pppd нужно указать другой порт. Для этого в файле <code>/etc/ppp/peers/<ваш_провайдер_связи></code> замените устройство <code>/dev/ttyGSM</code> на (в зависимости от модема) <code>/dev/ttyUSB0</code> или <code>/dev/ttyACM0</code>.
+После настройки модема в контроллере создаются два соединения NetworkManager'а <code>wb-gsm-sim1</code> и <code>wb-gsm-sim2</code>.
+<code>wb-gsm-sim1</code> задаёт параметры соединения при использовании sim-карты в первом слоте, <code>wb-gsm-sim2</code> - во втором слоте.
-Например, изменим порт для провайдера МТС:
+Контроллер имеет базу APN сотовых операторов. NetworkManager сам определит нужный APN в зависимости от вставленной sim-карты.
-# Откройте файл <code>/etc/ppp/peers/mts</code>
-#:<syntaxhighlight lang="bash">
-nano /etc/ppp/peers/mts
-</syntaxhighlight>
-# Закомментируйте старый порт и добавьте новый:
-#:<syntaxhighlight lang="bash">
-#/dev/ttyGSM
-/dev/ttyUSB0
-</syntaxhighlight>
-#:порт можно использовать /dev/ttyUSB[0..2] в зависимости от количества и настроек сервисов работающих с модемом.
-# {{Wbincludes:Save nano}}
-Порты <code>/dev/ttyUSB0</code>,<code>/dev/ttyUSB1</code>,<code>/dev/ttyUSB2</code> появляются автоматически после включения модема командой <code>wb-gsm on</code>.
+Настройки соединений можно изменить либо в web-интерфейсе конфигурирования контроллера, либо в консоли утилитой [https://networkmanager.dev/docs/api/latest/nmcli.html nmcli].
-=== Автоматический запуск подключения ===
+[[Image:homeui-network-modem-settings.png|650px|Настройка PPP модем]]
-[[Image:Etc-network-interfaces.png|300px|thumb|right|Файл ''/etc/network/interfaces'', автоматически запускающий подключение к МТС]]
-Чтобы подключение запускалось автоматически:
-#Откройте файл <code>/etc/network/interfaces</code> для редактирования:
-#:<syntaxhighlight lang="bash">
-nano /etc/network/interfaces
-</syntaxhighlight>
-#Раскомментируйте или отредактируйте следующие строки:
-#:<syntaxhighlight lang="bash">
-auto ppp0
-iface ppp0 inet ppp
-  provider mts # можно заменить mts на megafon или beeline
-  #перезапускаем модем, если он завис
-  pre-up wb-gsm restart_if_broken
-  #Ждем, пока он загрузится и найдет сеть.
-  pre-up sleep 10
-</syntaxhighlight>
-# Сохраните изменения и закройте файл.
-# Теперь запустите интерфейс <code>ppp0</code> командой:
-#:<syntaxhighlight lang="bash">
-ifup ppp0
-</syntaxhighlight>
-#:через 10-15 секунд интерфейс <code>ppp0</code> будет доступен.
-# Настройка завершена, теперь при перезагрузке контроллера подключение к интернету восстановится автоматически.
-Параметры протокола пакетной передачи данных и номера для соединения для каждого провайдера хранятся в директории <code>/etc/chatscripts</code>. В большинстве случаев ничего менять в этих файлах не придется.
-Для ppp-интерфейсов существуют директории, исполняемые файлы из которых также запускаются на разных фазах установления соединения. Но, если, например, для ethernet-интерфейсов эти скрипты должны находиться в директориях <code>/etc/network/if-down.d</code>, <code>if-post-down.d</code>, <code>if-pre-up.d</code>, <code>if-up.d</code>, то соответствующие директории для ppp-интерфейсов находятся в <code>/etc/ppp/ip-down.d</code>, <code>ip-up.d</code> и т.п. Подробнее об их назначении и функционировании можно узнать в документе [http://citforum.ru/operating_systems/linux/HOWTO/PPP-HOWTO.shtml PPP HOWTO].

Навигация