Luci App Modeminfo: мониторинг 3G/4G-модема в OpenWrt

Если в веб-интерфейсе LuCI вашего роутера на OpenWrt не отображаются уровень сигнала, оператор сети и параметры подключения USB-модема, пакет luci-app-modeminfo решает именно эту задачу: он добавляет в LuCI страницу с телеметрией 3G/4G/LTE-модема — RSSI, RSRP, RSRQ, SINR, имя оператора, технологию сети и данные о соте. Приложение работает поверх скриптов, которые опрашивают модем AT-командами через последовательный порт, поэтому корректная настройка порта — ключевой момент всей установки.

Ниже разберём, что умеет пакет, как его установить через opkg или веб-интерфейс, как указать порт модема и что проверить, если страница открывается, но поля пустые. Инструкция ориентирована на свежие версии OpenWrt; точные названия пунктов меню могут немного отличаться в зависимости от версии пакета и темы LuCI.

Что такое luci-app-modeminfo и для чего он нужен

luci-app-modeminfo — это модуль веб-интерфейса LuCI для OpenWrt, который выводит диагностическую информацию с сотового модема. Он не создаёт интернет-подключение сам по себе: настройка интерфейса (через qmi, mbim, ncm или режим HiLink) выполняется отдельно. Задача пакета — показать состояние радиоканала и сети.

Типичные данные, которые отображает страница Modeminfo:

  • 📶 Уровень сигнала: RSSI, RSRP, RSRQ, SINR;
  • 📡 Технология сети: 2G/3G/LTE, иногда с указанием агрегации несущих;
  • 🏢 Название и код оператора (MCC/MNC);
  • 📍 Идентификаторы соты: Cell ID, TAC/LAC, PCI;
  • 🔧 Информация об устройстве: производитель, модель, версия прошивки, IMEI, температура.

Это особенно полезно при установке внешней антенны: вы видите реакцию модема на изменение положения антенны в реальном времени, без костылей вроде сторонних утилит с ПК.

Установка пакета в OpenWrt

Установить пакет можно двумя способами: через веб-интерфейс или через SSH. В обоих случаях роутер должен иметь доступ в интернет для загрузки пакета из репозитория. Учтите, что наличие пакета в официальных репозиториях зависит от версии OpenWrt — в некоторых сборках его нужно ставить из стороннего репозитория или вручную из .ipk-файла.

Установка через SSH выглядит так:

opkg update

opkg install luci-app-modeminfo

Через LuCI: откройте System → Software, нажмите Update lists, затем найдите luci-app-modeminfo в поле фильтра и установите его. После установки обновите страницу интерфейса или перелогиньтесь — новый пункт меню появится без перезагрузки роутера.

☑️ Чек-лист перед установкой

Выполнено: 0 / 5
⚠️ Внимание: если пакет ставится из стороннего источника в виде .ipk-файла, убедитесь, что он собран под архитектуру вашего роутера и вашу версию OpenWrt. Пакет под чужую архитектуру либо не установится, либо приведёт к ошибкам зависимостей. Сверяйте версию с источником пакета.

Настройка порта модема и основных параметров

После установки откройте страницу настроек модема — обычно она находится в разделе Network → Modeminfo или в Modem, в зависимости от версии пакета. Главный параметр — последовательный порт, через который скрипт отправляет AT-команды. Для USB-модемов это обычно /dev/ttyUSBx или /dev/cdc-wdm0 (для QMI/MBIM-режимов).

Как определить правильный порт? Посмотрите вывод команды:

ls /dev/ttyUSB* /dev/cdc-wdm* 2>/dev/null

dmesg | grep -i tty

Модемы в режиме QMI часто создают несколько портов ttyUSB, и AT-команды принимает не каждый из них. Практический способ проверки — отправить тестовую команду и посмотреть, отвечает ли модем:

echo -e "ATI\r" > /dev/ttyUSB2 && cat /dev/ttyUSB2

Если в ответ приходит информация о модеме — порт рабочий. Для удобства можно использовать пакет picocom или minicom, если они доступны в репозитории вашей сборки.

📊 Какой режим подключения использует ваш USB-модем?
QMI (cdc-wdm)
MBIM
NCM / RNDIS
HiLink (модем как отдельный роутер)

Что показывает страница мониторинга

Основная страница пакета обновляет данные с заданным интервалом и показывает сводку по соединению. Наиболее важные показатели для оценки качества LTE-сигнала — RSRP (мощность принимаемого сигнала) и SINR (соотношение сигнал/шум). Именно по ним стоит ориентироваться при настройке антенны: рост RSRP без роста SINR часто означает, что усиливается и помеха.

Отдельные версии пакета умеют показывать расширенные данные: список видимых сот, частотные диапазоны (band), агрегацию несущих. Набор отображаемых полей зависит от того, какие AT-команды поддерживает конкретный модем — Quectel, Huawei, ZTE и Fibocom имеют разные наборы команд, и не все параметры доступны на каждом устройстве.

ПараметрЧто означаетЧем выше, тем лучше?
RSSIОбщий уровень принимаемого сигналаДа
RSRPМощность опорного сигнала LTEДа (меньше по модулю)
RSRQКачество опорного сигналаДа (меньше по модулю)
SINRСоотношение сигнал/помехаДа
Cell ID / PCIИдентификатор обслуживающей сотыИнформационный параметр

Если модем работает в режиме HiLink (собственная прошивка-роутер, как у многих Huawei), AT-порт может быть недоступен из OpenWrt — тогда modeminfo не получит данные напрямую, и нужны модифицированные прошивки модема либо API-запросы к самому модему.

Типичные проблемы и их решение

Самая частая жалоба — страница открывается, но все поля пустые или показывают «нет данных». Причины стоит проверять в таком порядке:

  • 🔌 Неверно указан порт — проверьте ответ на AT-команду вручную, как описано выше;
  • ⛔ Порт занят другим процессом (например, qmi-демоном или sms-tool);
  • 🚫 Модем в режиме HiLink/NCM не предоставляет AT-порт;
  • 📦 Отсутствуют зависимости — проверьте, установились ли сопутствующие скрипты пакета;
  • 🔁 Устаревший кэш LuCI — очистите /tmp/luci-* и перезапустите uhttpd.

Если пункт меню вообще не появился после установки, выполните:

rm -rf /tmp/luci-indexcache /tmp/luci-modulecache

/etc/init.d/uhttpd restart

⚠️ Внимание: не отправляйте AT-команды управления радиомодулем (смена режима, сброс настроек модема) без понимания их действия. Команды вроде заводского сброса модема могут изменить конфигурацию устройства, и вернуть исходное состояние бывает непросто. Начинайте с безопасных информационных команд: ATI, AT+CSQ, AT+COPS?.
Полезные диагностические AT-команды

ATI — информация о модеме; AT+CSQ — уровень сигнала; AT+COPS? — текущий оператор; AT+CREG? — статус регистрации в сети. Синтаксис расширенных команд (RSRP, band) различается у Quectel, Huawei и других вендоров — сверяйтесь с документацией на ваш модем.

Совместимость с модемами и версиями OpenWrt

Пакет ориентирован на популярные модемы Quectel (например, серии EP06, EC25), Huawei (ME909 и аналогичные) и ряд моделей Fibocom и ZTE. Однако набор поддерживаемых устройств зависит от версии пакета: перед установкой стоит проверить список поддерживаемых модемов в описании пакета или репозитории автора.

По версиям OpenWrt: пакет требует работающий LuCI, поэтому подходит для стандартных сборок с веб-интерфейсом. В минимальных или самосборных образах может не хватать зависимостей — в этом случае opkg сообщит о проблеме при установке, и недостающие пакеты нужно доустановить вручную.

Часто задаваемые вопросы

Почему modeminfo показывает пустые поля, хотя интернет через модем работает?

Работа интернета и доступ к AT-порту — разные вещи. Скорее всего, в настройках пакета указан неверный порт или порт занят процессом подключения. Проверьте ответ модема на команду ATI через предполагаемый порт и при необходимости переберите доступные ttyUSB.

Работает ли пакет с модемами Huawei в режиме HiLink?

Напрямую — как правило, нет: в режиме HiLink модем сам является роутером и не предоставляет AT-порт хосту. Варианты решения — прошивка модема в «stick»-режим (рискованная операция, требующая точного соответствия прошивки модели) либо получение данных через API модема сторонними средствами.

Нужно ли перезагружать роутер после установки пакета?

Полная перезагрузка обычно не требуется. Достаточно обновить страницу LuCI или перезапустить uhttpd и очистить кэш LuCI, если пункт меню не появился.

Какие показатели сигнала считать хорошими для LTE?

Точные пороги зависят от условий конкретной сети, поэтому ориентируйтесь на динамику: при настройке антенны добивайтесь уменьшения RSRP по модулю и роста SINR. Сравнивайте замеры в одинаковых условиях и с паузой между изменениями положения антенны.

Можно ли использовать modeminfo без интернета на роутере?

Да, если пакет уже установлен: опрос модема выполняется локально через последовательный порт и не требует выхода в сеть. Интернет нужен только на этапе загрузки и установки пакета.