
Для подключения 4G-модема к роутеру под управлением OpenWrt требуется точная подготовка: выбор пакетов под тип устройства, проверка доступных интерфейсов и корректное определение режима работы модема. В большинстве случаев используются протоколы NCM, MBIM или QMI, каждый из которых требует своих модулей и настроек.
Заранее стоит уточнить, как именно модем определяется системой: как сетевой интерфейс, последовательное устройство или несколько виртуальных портов. Это влияет на команду подключения и дальнейшую конфигурацию. Для USB-модемов нередко требуется активировать автоматическую загрузку драйвера и проверить, не уходит ли устройство в режим хранения.
При работе с SIM-картой важно проверить наличие PIN-кода и при необходимости отключить его через меню LuCI или утилиту comgt. После активации интерфейса полезно изучить логи, чтобы убедиться в регистрации в сети оператора, корректном получении адреса и параметров маршрутизации.
Подготовка прошивки и установка необходимых пакетов для работы с 4G

Перед настройкой модема важно убедиться, что прошивка содержит поддержку USB, нужные драйверы и пакеты для выбранного режима подключения. В минимальных сборках OpenWrt функциональность для работы с мобильными сетями часто отсутствует и требуется ручная установка компонентов.
Для USB-модемов требуется проверить наличие базовых модулей ядра:
- kmod-usb-core
- kmod-usb2 или kmod-usb3
- kmod-usb-serial и kmod-usb-serial-option для устройств, работающих через последовательные порты
- kmod-usb-net, если модем определяется как сетевой адаптер
Для подключения через NCM, MBIM или QMI понадобятся дополнительные пакеты:
- luci-proto-ncm и kmod-usb-net-huawei-cdc-ncm
- luci-proto-mbim и umbim
- luci-proto-qmi, uqmi и kmod-usb-net-qmi-wwan
Установка выполняется через команду:
- opkg update
- opkg install <название пакета>
Если используется нестандартная сборка или требуется поддержка конкретной модели, стоит проверить списки пакетов в сборщиках ImageBuilder или Firmware Selector. Это помогает включить модули для редких моделей и избежать последующей ручной установки.
Определение модема в системе и проверка доступных интерфейсов
Для просмотра USB-устройств используется:
dmesg | grep -i usb
По сообщениям ядра можно увидеть загрузку драйверов, назначенные порты и переход модема из режима хранения в рабочий режим. Если устройство осталось в режиме CD-ROM, потребуется usb-modeswitch.
Для проверки сетевых интерфейсов выполняется:
ip link show
Если модем работает как NCM, MBIM или QMI, появятся интерфейсы вида wwan0 или usb0. При работе через QMI иногда создаются интерфейсы cdc-wdmX, которые используются утилитой uqmi.
Для последовательных портов используется команда:
ls -l /dev/ttyUSB*
Порты с разными номерами выполняют разные функции: один предназначен для AT-команд, остальные – для служебного обмена. Определение правильного порта важно для возможности управления модемом через comgt или picocom.
Настройка NCM, MBIM или QMI подключения в LuCI

В интерфейсе LuCI настройка 4G выполняется через раздел «Сеть → Интерфейсы». Для добавления нового подключения выбирается протокол, соответствующий режиму работы модема. Важно использовать только те устройства, которые отображаются системой после загрузки драйверов.
Для режима NCM выбирается пункт «NCM». В списке устройств появится порт вида /dev/cdc-wdm0 или сетевой интерфейс usb0. В поле APN вводится строка оператора. Параметры авторизации задаются только при необходимости. При нестабильном соединении можно указать явное значение режима «ipv4» в поле типа PDP.
Для MBIM используется протокол «MBIM». LuCI отображает устройства cdc-wdmX. Помимо APN можно указать команду инициализации, если модем требует перевода в рабочий режим. При наличии PIN-кода LuCI позволяет отключить его перед установкой соединения.
Для QMI выбирается «QMI Cellular». В настройках указывается wwan0 и соответствующий cdc-wdmX. В дополнительных параметрах можно включить запрос только IPv4 или задать профиль с конкретным номером PDP-контекста. Если оператор использует нестандартный APN для передачи данных, его требуется указать вручную.
После сохранения изменений интерфейс перезапускается. В разделе «Состояние → Интерфейсы» отображаются регистрация в сети, IP-адрес, маска и шлюз. При отсутствии адреса стоит проверить доступность устройства, корректность APN и состояние SIM-карты.
Конфигурация подключения в файле network для разных типов модемов

Редактирование файла /etc/config/network позволяет задать точные параметры подключения и обойти возможные сбои при настройке через LuCI. Для корректной работы важно указать протокол, устройство и параметры PDP-контекста.
Пример настройки для NCM:
- config interface ‘mobile’
- option proto ‘ncm’
- option device ‘/dev/cdc-wdm0’
- option apn ‘internet’
- option ipv6 ‘0’
Настройка для MBIM отличается использованием другого протокола и указанием режима подключения:
- config interface ‘mobile’
- option proto ‘mbim’
- option device ‘/dev/cdc-wdm0’
- option apn ‘internet’
- option pdptype ‘ipv4’
Пример конфигурации для QMI-модема:
- config interface ‘mobile’
- option proto ‘qmi’
- option device ‘/dev/cdc-wdm0’
- option apn ‘internet’
- option autoconnect ‘1’
- option pdptype ‘ipv4’
Для модемов, работающих через последовательные порты, используется протокол ppp:
- config interface ‘mobile’
- option proto ‘3g’
- option device ‘/dev/ttyUSB2’
- option apn ‘internet’
- option service ‘umts’
После изменения конфигурации выполняется перезапуск сетевых служб командой /etc/init.d/network restart. Это позволяет убедиться, что интерфейс получает IP-адрес и регистрируется в сети оператора.
Настройка PIN-кода SIM-карты и параметров авторизации

Для корректной работы 4G-модема важно проверить состояние PIN-кода SIM-карты и задать параметры авторизации, если оператор требует логин и пароль. В OpenWrt управление PIN осуществляется через LuCI или консоль.
Для отключения PIN через консоль используется команда:
comgt -d /dev/ttyUSB2 «AT+CPIN=1234»
где 1234 – текущий код PIN. После успешного ввода модем готов к регистрации в сети.
Параметры авторизации обычно включают имя пользователя и пароль для APN. В LuCI они задаются при создании интерфейса. Для ручной конфигурации в /etc/config/network используется следующая структура:
| Параметр | Пример значения | Описание |
|---|---|---|
| option username | user123 | Имя пользователя, предоставленное оператором |
| option password | pass123 | Пароль для подключения к APN |
| option pin | 1234 | PIN-код SIM-карты, если требуется |
| option apn | internet | Имя точки доступа |
После настройки PIN и авторизации рекомендуется перезапустить интерфейс командой /etc/init.d/network restart и проверить регистрацию модема в сети оператора через logread | grep -i modem.
Проверка регистрации в сети оператора и получение IP-адреса
После настройки модема важно убедиться, что устройство зарегистрировано в сети оператора и получает корректный IP-адрес. Для этого используется несколько инструментов OpenWrt.
Для интерфейсов NCM и MBIM проверка выполняется командой:
ifstatus <имя_интерфейса>
Для QMI-модемов используется утилита:
uqmi -d /dev/cdc-wdm0 —get-data-status
ifconfig wwan0
Если интерфейс не получает IP, проверяют:
- Корректность APN и параметров авторизации
- Состояние SIM-карты и PIN
- Сигнал сети через at+csq на последовательном порте
После подтверждения регистрации и получения IP-адреса модем готов к использованию для маршрутизации интернет-трафика на устройства локальной сети.
Диагностика неполадок: логи, проверка USB-питания и перезапуск интерфейса

logread | grep -i modem
dmesg | grep -i usb
Если модем не определяется, возможно, недостаточно питания. Проверку USB-питания выполняют через команду:
cat /sys/bus/usb/devices/usbX/power/active
Для слабых портов рекомендуется использовать USB-хаб с отдельным питанием или проверить напряжение на роутере.
Перезапуск сетевого интерфейса выполняется командой:
/etc/init.d/network restart
Если модем работает через QMI или MBIM, можно перезапустить только интерфейс командой:
ifdown wwan0 && ifup wwan0
После перезапуска проверяются регистрация в сети и получение IP-адреса. Если проблемы сохраняются, проверяют правильность APN, PIN-кода и совместимость пакетов с прошивкой.
Вопрос-ответ:
Какие пакеты нужно установить для работы 4G-модема в OpenWrt?
Для корректной работы USB-модема в OpenWrt требуется базовый набор модулей ядра: kmod-usb-core, kmod-usb2/3, kmod-usb-serial и kmod-usb-net. Дополнительно устанавливаются пакеты для конкретного протокола: NCM — luci-proto-ncm и kmod-usb-net-huawei-cdc-ncm; MBIM — luci-proto-mbim и umbim; QMI — luci-proto-qmi, uqmi и kmod-usb-net-qmi-wwan. После установки пакетов интерфейс модема определяется системой и становится доступен для настройки.
Как определить, в каком режиме работает мой 4G-модем?
Для проверки используйте команду dmesg | grep -i usb, которая покажет загрузку драйверов и назначенные порты. Если модем отображается как последовательные порты — ttyUSB0-2, значит, он работает через AT-команды. Для сетевых интерфейсов NCM/MBIM/QMI проверяйте ip link show: появление wwan0 или usb0 означает готовность к настройке. В случае режима CD-ROM требуется usb-modeswitch для переключения в рабочий режим.
Как правильно настроить подключение NCM, MBIM или QMI через LuCI?
В LuCI создайте новый интерфейс в разделе «Сеть → Интерфейсы» и выберите протокол, соответствующий модему. Для NCM укажите устройство /dev/cdc-wdm0 или usb0 и APN. Для MBIM также укажите cdc-wdmX, APN и, при необходимости, отключите PIN. Для QMI выберите wwan0 и cdc-wdmX, задайте тип PDP-контекста и APN. После сохранения интерфейс перезапускается, и в разделе «Состояние» проверяется IP-адрес и регистрация в сети.
Как задать PIN-код SIM-карты и параметры авторизации в OpenWrt?
PIN-код можно отключить командой comgt -d /dev/ttyUSB2 «AT+CPIN=1234», где 1234 — текущий PIN. Параметры авторизации указываются в файле /etc/config/network или в LuCI: option username, option password и option apn. После сохранения изменений перезапускают интерфейс командой /etc/init.d/network restart и проверяют регистрацию модема в сети через logread.
Что делать, если 4G-модем не получает IP-адрес?
Сначала проверьте лог модема через logread | grep -i modem и dmesg | grep -i usb. Убедитесь, что устройство получает питание и правильно определяется системой. Проверьте корректность APN, PIN-кода и выбранного протокола. При необходимости перезапустите интерфейс командой ifdown wwan0 && ifup wwan0. Для QMI и MBIM используйте uqmi или ifstatus для проверки состояния подключения. Также стоит убедиться, что модем не находится в режиме CD-ROM и драйвер соответствует устройству.
