linuxer
Published on 2024-11-30 / 2 Visits
0
0

在OpenWRT中使用5G模组

一、5G模组

简介

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

资源下载

5G模组资料:点击查看

NanoPi R5S固件

Lede:点击前往

iStoreOS:点击前往

X86-64固件

Lede:点击前往

iStoreOS:点击前往

二、硬件相关资料

连接主机方式

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

开发板或转接板汇总

名称 概称 通道类型 图片链接

USB3.0 to M.2 B Key WWAN 开发板 USB转5G USB3.0(5Gbps) 点击查看

Type-C to M.2 B Key WWAN 开发板 Type-C转5G USB3.0(5Gbps) 点击查看

RJ45 to M.2 B Key WWAN 开发板 网口转5G Ethernet(1/2.5Gbps) 点击查看

MINI PCIE to M.2 B Key WWAN 转接板 MINI PCIE转5G PCIE 点击查看

MINI PCIE to USB 转接板 MINI PCIE转USB USB2.0(480Mbps) 点击查看

M.2 B Key to USB 转接板 WWAN网卡转USB USB3.0(5Gbps) 点击查看

M.2 A & E Key to M.2 B Key WWAN 转接板 无线网卡转5G PCIE 点击查看

M.2 A & E Key to MINI PCIE WWAN 转接板 无线网卡转MINI PCIE 5G 未知 点击查看

M.2 B & M Key to MINI PCIE WWAN 转接板 NVME转MINI PCIE 5G 未知 点击查看

M.2 B & M Key to M.2 B Key WWAN 转接板 NVME or NGFF转5G PCIE 点击查看

M.2 B & M Key to USB 19Pin 转接板 NVME or NGFF转USB*2 USB3.0(5Gbps) 点击查看

M.2 B & M Key to Type-E 转接板 NVME or NGFF转Type-E USB3.0(10Gbps) 点击查看

M.2 B & M Key to Type-C 转接板 NVME or NGFF转Type-C USB3.0(10Gbps) 点击查看

天线选择

厂家名称 天线型号 支持频段 用途 文档说明

思科(cisco) 5G-ANTM-SMA-D 617-960 MHz,1430-3500 MHz,3500-6000 MHz 4G,5G,2.4/5GHz WiFi 点击查看

思科(cisco) LTE-ANTM2-SMA-D 617-960 MHz,1400-1700 MHz,1710-2690 MHz,3400-3900 MHz,5150-6000 MHz 4G,5G,2.4/5GHz WiFi 点击查看

思科(cisco) LTE-ANTM-SMA-D 698-960 MHz,1447-1511 MHz,1710-2690 MHz 4G,2.4GHz WiFi 点击查看

普思电子(Pulse) W5151 617-960 MHz,1430-3500 MHz,3500-7125 MHz 4G,5G,2.4/5GHz WiFi 点击查看

普思电子(Pulse) W5150 617-960 MHz,1430-3500 MHz,3500-6000 MHz 4G,5G,2.4/5GHz WiFi 点击查看

普思电子(Pulse) W5084K 698-960 MHz,1400-2690 MHz,3400-3700 MHz 4G,5G(国内),2.4GHz WiFi 点击查看

普思电子(Pulse) W5095K 698-960 MHz,1400-1700 MHz,1710-2690 MHz 4G,2.4GHz WiFi 点击查看

普思电子(Pulse) SPDA24617/3900 698-960 MHz,1400-2700 MHz,3200-3900 MHz 4G,5G(国内),2.4GHz WiFi 点击查看

普思电子(Pulse) SPDA24700/2700 698-960 MHz,1710-2170 MHz,2500-2700 MHz 4G,2.4GHz WiFi 点击查看

普思电子(Pulse) ICEBLADELS 698-960 MHz,1710-2690 MHz 4G,2.4GHz WiFi 点击查看

亚当技术(Adam Tech) ANT-19073EB56 600-6000 MHz 4G,5G,2.4/5GHz WiFi 点击下载

亚当技术(Adam Tech) ANT-20228WB56 600-960 MHz,1400-2700 MHz,3000-6000 MHz 4G,5G,2.4/5GHz WiFi 点击下载

三、热门的5G模组

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

移远通信5G模组:RG200U-CN,RM500U-CN,RM500Q-GL

广和通5G模组:FM650-CN,FM150-AE,FM350-GL

美格智能5G模组:SRM815,SRM825

数据传输模式

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

USB传输模式

厂家名称 模组名称

移远通信 RG200U-CN(DONGLE版),RM500U-CN,RM500Q-GL

广和通 FM650-CN,FM150-AE-01,FM150-AE-11,FM150-AE-21,FM150-NA-01,FM350-GL

美格智能 SRM815,SRM825

PCIE传输模式

厂家名称 模组名称

移远通信 RG200U-CN(MINIPCIE版),RM500U-CN,RM500Q-GL

广和通 FM150-AE-00,FM150-AE-10,FM150-AE-20,FM150-NA-00,FM350-GL

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

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

模组支持信息汇总

厂家名称 模组名称 平台 数据传输模式 端口模式 虚拟机直通

移远通信 RG200U-CN(DONGLE版) 紫光展锐 USB ECM,MBIM,RNDIS,NCM ✅

移远通信 RG200U-CN(MINIPCIE版) 紫光展锐 PCIE ❔ ❔

移远通信 RM500U-CN 紫光展锐 USB ECM,MBIM,RNDIS,NCM ✅

移远通信 RM500U-CN 紫光展锐 PCIE ❔ ❔

移远通信 RM500U-CNV 紫光展锐 USB ECM,MBIM,RNDIS,NCM ✅

移远通信 RM500U-CNV 紫光展锐 PCIE ❔ ❔

移远通信 RM500Q-CN 高通 USB RMNET,ECM,MBIM,RNDIS,NCM ✅

移远通信 RM500Q-CN 高通 PCIE RMNET,MBIM ❔

移远通信 RM500Q-GL 高通 USB RMNET,ECM,MBIM,RNDIS,NCM ✅

移远通信 RM500Q-GL 高通 PCIE RMNET,MBIM ❌

移远通信 RG500Q-EA 高通 PCIE RMNET,MBIM ❔

移远通信 RM502Q-GL 高通 USB RMNET,ECM,MBIM,RNDIS,NCM ✅

移远通信 RM502Q-GL 高通 PCIE RMNET,MBIM ❔

移远通信 RM502Q-AE 高通 USB RMNET,ECM,MBIM,RNDIS,NCM ✅

移远通信 RM502Q-AE 高通 PCIE RMNET,MBIM ❔

移远通信 RM520N-CN 高通 USB RMNET,ECM,MBIM,RNDIS,NCM ✅

移远通信 RM520N-CN 高通 PCIE RMNET,MBIM ❔

移远通信 RM520N-GL 高通 USB RMNET,ECM,MBIM,RNDIS,NCM ✅

移远通信 RM520N-GL 高通 PCIE RMNET,MBIM ✅

移远通信 RG520N-EU 高通 PCIE RMNET,MBIM ❔

广和通 FM650-CN 紫光展锐 USB ECM,MBIM,RNDIS,NCM ✅

广和通 FM650-CN 紫光展锐 PCIE ❔ ❔

广和通 FM350-GL 联发科 USB RNDIS ✅

广和通 FM350-GL 联发科 PCIE MBIM ✅

广和通 FM150-AE-01,FM150-AE-11,FM150-AE-21,FM150-NA-01 高通 USB RMNET,ECM,MBIM,RNDIS,NCM ✅

广和通 FM150-AE-00,FM150-AE-10,FM150-AE-20,FM150-NA-00 高通 PCIE RMNET,MBIM ✅

美格智能 SRM815 高通 USB RMNET,ECM,MBIM,RNDIS,NCM ✅

美格智能 SRM825 高通 USB RMNET,ECM,MBIM,RNDIS,NCM ✅

美格智能 SRM825N 高通 USB RMNET,ECM,MBIM,RNDIS,NCM ✅

四、使用模组

基本说明

要使用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

拨号模式

拨号模式信息汇总

端口模式 拨号模式 依赖和驱动支持 拨号方式

RMNET QMI,GobiNet 驱动,拨号工具 路由器拨号

ECM ECM 驱动 模组拨号

MBIM MBIM 驱动,拨号工具 路由器拨号

RNDIS RNDIS 驱动 模组拨号

NCM NCM 驱动 模组拨号

网络接口设置

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模块支持

166 90

安装

安装软件包

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


Comment