转自【https://blog.siriling.com:1212/2023/03/18/openwrt-5g-modem/】

• 目录

• 一、5G模组

  • 简介
  • 资源下载

• 二、硬件相关资料

  • • 连接主机方式
    • 天线选择

• 三、热门的5G模组

  • 数据传输模式

    • USB传输模式
    • PCIE传输模式
  • 端口模式和虚拟机直通支持

• 四、使用模组

  • 基本说明

  • 驱动

    • USB驱动

      • QMI
      • GobiNet
      • ECM
      • MBIM
      • RNDIS
      • NCM

    • PCIE驱动

      • 通用驱动
      • 制造商私有驱动

    • 其他驱动

      • USB
      • 串口

  • 工具

    • 命令行工具
    • 拨号工具

  • 拨号模式

    • 拨号模式信息汇总

  • 网络接口设置

    • ECM拨号
    • MBIM拨号
    • RNDIS拨号
    • QMI拨号
    • GobiNet拨号
    • NCM拨号

  • 拨号上网及使用

    • 源码
    • 安装

    • 功能说明

      • 自动扫描识别功能
      • 模组信息展示功能
      • 拨号功能
      • 手动扫描功能
      • 手动配置功能
      • 版本信息展示功能
    • 常见问题

• 六、常用AT命令

  • 移远

    • 查询SIM卡状态
    • SIM卡状态上报
    • 双SIM卡设置
    • 查询网络信息
    • 查询此时信号强度
    • 设置频段
    • 锁频段
    • 查询模组IMEI
    • 更改模组IMEI
    • 获取模组温度
    • 切换通信端口
    • 启用通过以太网接口收发AT命令
    • 重启模组

  • 广和通

    • 查询SIM卡状态
    • 双SIM卡设置
    • 查询此时信号强度
    • 查询网络信息
    • 锁频段
    • 查询模组IMEI
    • 更改模组IMEI
    • 获取模组温度
    • 重启模组

  • 美格

    • 查询SIM卡状态
    • SIM卡状态上报
    • 双SIM卡设置
    • 查询网络信息
    • 查询此时信号强度
    • 锁频段
    • 查询模组IMEI
    • 更改模组IMEI
    • 获取模组温度
    • 重启模组

一、5G模组

简介

5G通信模组可集成在各种嵌入式机器内，实现更强大的功能

资源下载

5G模组资料：点击查看

NanoPi R5S固件

• Lede：点击前往
• iStoreOS：点击前往

X86-64固件

• Lede：点击前往
• iStoreOS：点击前往

二、硬件相关资料

连接主机方式

请根据自己的机器接口选择合适的开发板或转接板，注意看开发板连接5G模组所走的通道

开发板或转接板汇总

天线选择

三、热门的5G模组

iStoreOS固件对当下较为热门的5G模组都添加了支持，冷门5G模组还未适配，可参照自定义拨号脚本进行配置

• 移远通信5G模组：RG200U-CN，RM500U-CN，RM500Q-GL
• 广和通5G模组：FM650-CN，FM150-AE，FM350-GL
• 美格智能5G模组：SRM815，SRM825

数据传输模式

这里只列举部分常见的模组

USB传输模式

PCIE传输模式

端口模式和虚拟机直通支持

使用USB通信的模组都可以直通，使用PCIE通信的模组看型号而定

• 模组支持信息汇总

四、使用模组

基本说明

要使用5G模组进行拨号上网，需要了解以下内容

• 拨号模式
• 驱动
• 拨号工具
• 网络接口设置

要对5G模组进行调试，需要了解以下内容

• 驱动
• 命令行工具
• AT命令

驱动

USB驱动

QMI

官方说明

• kmod-mii（Mii 驱动程序）
• kmod-usb-wdm
• kmod-usb-net-qmi-wwan
• uqmi（控制工具）

GobiNet

• kmod-gobinet

ECM

• kmod-usb-net-cdc-ether

MBIM

• kmod-usb-net-cdc-mbim
• umbim

RNDIS

官方说明

需要安装以下软件包

• kmod-usb-net-rndis

NCM

官方说明

• comgt-ncm
• kmod-usb-net-cdc-ncm
• kmod-usb-net-huawei-cdc-ncm

PCIE驱动

PCIE通用驱动支持MBIM和QMI两种拨号模式，私有驱动根据芯片平台安装对应的驱动

通用驱动

• kmod-mhi-net
• kmod-qrtr-mhi
• kmod-mhi-pci-generic
• kmod-mhi-wwan-mbim
• kmod-mhi-wwan-ctrl

制造商私有驱动

• kmod-pcie_mhi（高通平台，支持QMI，MBIM拨号）
• kmod-mtk-pcie-wwan-m80（MTK平台，支持MBIM拨号）

其他驱动

USB

• kmod-usb2
• kmod-usb3
• kmod-usb-net（USB 转以太网）
• usb-modeswitch

串口

• kmod-usb-serial
• kmod-usb-serial-option
• kmod-usb-serial-wwan

工具

命令行工具

• usbutils（USB工具包）
• pciutils（PCIE工具包）
• minicom（AT串口调试工具）

拨号工具

• 移远：quectel-CM-5G
• 广和通：fibocom-dial
• 美格：meig-cm

拨号模式

拨号模式信息汇总

网络接口设置

ECM拨号

网络接口配置

config interface 'wwan_5g'
    option device 'usb0'
    option proto 'dhcp'
    
config interface 'wwan6_5g'
    option proto 'dhcpv6'
    option extendprefix '1'
    option device '@wwan_5g'

MBIM拨号

网络接口配置

config interface 'wwan_5g'
    option proto 'dhcp'
    option device 'wwan0'
    
config interface 'wwan6_5g'
    option proto 'dhcpv6'
    option extendprefix '1'
    option device '@wwan_5g'

RNDIS拨号

网络接口配置

config interface 'wwan_5g'
    option device 'usb0'
    option proto 'dhcp'
    
config interface 'wwan6_5g'
    option proto 'dhcpv6'
    option extendprefix '1'
    option device '@wwan_5g'

QMI拨号

网络接口配置

USB

移远

config interface 'wwan_5g'
    option proto 'dhcp'
    option ifname 'wwan0_1'
 
config interface 'wwan6_5g'
    option proto 'dhcpv6'
    option extendprefix '1'
    option device '@wwan_5g'

广和通

config interface 'wwan_5g'
    option proto 'dhcp'
    option ifname 'wwan0'
 
config interface 'wwan6_5g'
    option proto 'dhcpv6'
    option extendprefix '1'
    option device '@wwan_5g'

PCIE

config interface 'wwan_5g'
    option proto 'dhcp'
    option ifname 'rmnet_mhi0.1'
 
config interface 'wwan6_5g'
    option proto 'dhcpv6'
    option extendprefix '1'
    option device '@wwan_5g'

GobiNet拨号

网络接口配置

暂无

NCM拨号

网络接口配置

config interface 'wwan_5g'
    option ifname 'usb0'
    option proto 'dhcp'
 
config interface 'wwan6_5g'
    option proto 'dhcpv6'
    option extendprefix '1'
    option device '@wwan_5g'

拨号上网及使用

一站式解决模组信息查看，一键拨号上网，模组调试，驱动检查

源码

GitHub

Siriling/5G-Modem-Support

5G模块支持

188 96

安装

安装软件包

• luci-app-modem

功能说明

自动扫描识别功能

模组连接路由器后，会自动扫描并配置模组信息

如果从iStore商店安装，或者通过ipk文件安装，则需要进行以下中任意一个操作才能识别模组

• 手动扫描
• 手动配置（如果不了解模组，请勿使用该功能！）
• 重启路由器（模组断电）
• 插拔模组

提示：如果模组固定在当前系统环境下使用，则可以通过手动配置功能，将模组信息永久存储下来，实现开机快速识别模组

模组信息展示功能

移动通信模组->模组信息

• 信息默认为每5秒钟刷新一次
• 可在模组名称处自动切换任意一个模组，信息会随之刷新
• 由于每个模组开放信息获取方式不同，可能导致显示的信息不同
• 未适配的模组只会显示少量信息（查看已适配模组）
• 若要适配未适配的模组，请提供模组和模组资料

拨号功能

移动通信模组->拨号总览

• 添加一个拨号配置并启用，即可自动拨号上网

注意：

• 移远模组建议选择移远拨号工具进行拨号
• 广和通FM350-GL模组拨号，需要选择接入点，才能拨号成功（移动卡貌似得选择广电的接入点）
• 拨号后无法上网，请查看拨号日志，排查失败原因

手动扫描功能

移动通信模组->插件配置

• 点击扫描后，等待几秒钟，会扫描并配置模组信息，并在下方的模组配置里显示出来

手动配置功能

移动通信模组->插件配置

如果不了解模组，请勿使用该功能，使用该功能错误配置可能导致插件异常

• 开启手动配置后，会将模组信息永久存储下来，实现开机快速识别模组（启用后将禁用自动扫描并配置模组信息功能）
• 新建或修改模组配置，直接对模组配置进行修改，适用于自动扫描时模组信息未配置正确或插件未适配该模组。

版本信息展示功能

移动通信模组->插件信息

• 显示当前插件的版本，拨号工具的版本
• 显示驱动安装情况

常见问题

问题：显示没有找到模组

• 答：请检查模组和路由器的连接。查看路由器/dev目录下是否存在AT串口

问题：启用拨号配置后，没有拨号日志显示，即没有反应

• 答：请到启动项查看Modem插件是否已经运行，查看/etc/init.d/modem是否有执行权限

问题：启用拨号配置后，有拨号日志，但是无法联网

• 答：请到插件信息页面查看对应拨号驱动是否已经安装，若已安装，请检查模组是否已锁频段，该频段可能没有信号，需要解除锁定，然后参照拨号功能重新配置，若拨号还是不正常重启路由器再尝试

问题：XX运营商SIM卡，无法拨号上网，换另一个运营商的SIM卡可以

• 答：请检查SIM卡是否欠费，SIM卡是否插牢卡槽，模组天线是否连接正常。如果都无问题，请更换模组固件或模组驱动

问题：XX运营商SIM卡，原来能正常拨号上网，但是获取不到IP或者获取到IP了没有网络

• 答：请检查SIM卡是否欠费，SIM卡是否被局停

问题：IMEI无法修改

• 答：修改模组IMEI时，IMEI一定要填写正确才能被修改

六、常用AT命令

移远

查询SIM卡状态

AT+CPIN?   

SIM卡状态上报

AT+QSIMSTAT?   

双SIM卡设置

设置当前使用的为卡1

AT+QUIMSLOT=1   

设置当前使用的为卡2

AT+QUIMSLOT=2   

查询网络信息

AT+COPS?   

运营商聚合信息

AT+QNWINFO   

查询此时信号强度

AT+CSQ   

设置频段

4G频段

AT+QNWPREFCFG="lte_band",1:2:3:4:5:7:8:12:13:14:17:18:19:20:25:26:28:29:30:32:34:38:39:40:41:42:43:48:66:71   

5G NR NSA频段

AT+QNWPREFCFG="nsa_nr5g_band",1:2:3:5:7:8:12:20:25:28:38:40:41:48:66:71:77:78:79:257:258:260:261   

5G NR SA频段

AT+QNWPREFCFG="nr5g_band",1:2:3:5:7:8:12:20:25:28:38:40:41:48:66:71:77:78:79   

锁频段

默认

AT+QNWPREFCFG="mode_pref",AUTO   

锁4G

AT+QNWPREFCFG="mode_pref",LTE   

锁5G

AT+QNWPREFCFG="mode_pref",NR5G   

查询模组IMEI

AT+EGMR=0,7   

更改模组IMEI

AT+EGMR=1,7,"IMEI"   

获取模组温度

AT+QTEMP   

切换通信端口

USB

AT+QCFG="data_interface",0,0   

PCIE

AT+QCFG="data_interface",1,0   

启用通过以太网接口收发AT命令

AT+QETH="eth_at","enable"   

重启模组

AT+CFUN=1,1   

广和通

查询SIM卡状态

AT+CPIN?   

双SIM卡设置

设置当前使用的为卡1

AT+GTDUALSIM=0   

设置当前使用的为卡2

AT+GTDUALSIM=1   

查询此时信号强度

AT+CSQ   

查询网络信息

AT+COPS?   

锁频段

默认

AT+GTACT=20   

锁4G

AT+GTACT=2   

锁5G

AT+GTACT=14   

查询模组IMEI

AT+GTSN=0,7   

更改模组IMEI

AT+GTSN=1,7,"IMEI"   

获取模组温度

报告一次当前BBIC的温度

AT+MTSM=1,6   

报告一次当前射频的温度

AT+MTSM=1,7   

重启模组

AT+CFUN=15   

美格

查询SIM卡状态

AT+CPIN?   

SIM卡状态上报

AT^SIMSLOT?   

双SIM卡设置

设置当前使用的为卡1

AT^SIMSLOT=1   

设置当前使用的为卡2

AT^SIMSLOT=2   

查询网络信息

AT+COPS?   

具体网络信息

AT^SYSINFOEX   

查询此时信号强度

AT+CSQ   

锁频段

默认

AT^SYSCFGEX="00",all,0,2,all,all,all,all,1   

锁4G

AT^SYSCFGEX="03",all,0,2,all,all,all,all,1   

锁5G

AT^SYSCFGEX="04",all,0,2,all,all,all,all,1   

查询模组IMEI

AT+LCTSN=0,7   

更改模组IMEI

AT+LCTSN=1,7,"IMEI"   

获取模组温度

AT+TEMP   

重启模组

AT+RESET