海鸥派5G RedCap 功能验证

当前文档验证 openeuler 系统 redcap 模块 5G 上网功能。使用固件为百度网盘【易百纳】Euler Pi/03.开发板软件资料/01.出厂固件/openeuler_v1.1.1.zip。若无特殊标注，本文档适用于 v1.1.1 及之后版本和其他系统固件。
正常连接串口，电源，网线；分别通过串口和 ssh 连接板端，由于当前测试环境是 5 网段，使用 ifconfig 命令修改了板端 eth0 网络 IP。根据个人情况调整。

硬件连接

硬件准备

海鸥派开发板
5G RedCap 模块 （鼎桥 MT5710-CN）
USB 扩转接板（M.2(NGFF)/LTE USB3.0）
天线

连接说明

将 RedCap 模块固定在转接板上，SIM 卡安装在转接板卡槽上，将转接板插在 USB 接口。

注：需检查 RedCap 转接板卡座 43 脚处于断开状态（从 51 脚往 1 脚数第五个为 43 脚）。若信号不好，考虑安装天线。

验证

正常登录后，插上已连接好的 RedCap 转接板，等待近 30s 启动，串口会有如下打印，之后 ifconfig -a 查看网卡可查看到名为 usb1 的网卡。
注：使用“ifconfig -a”查看所有网卡信息；linux 系统加载后，对应新增网卡名为 usb0；ubuntu 系统无打印信息，新增网卡名为 enx 开头。

可在当前目录下创建编辑测试拨号脚本 dial.sh 并修改文件执行权限。

vi dial.sh
chmod 777 dial.sh
1
2
登录后即可复制

具体内容如下，“udhcpc -i 网卡名称（对应修改）”：

#!/bin/bash
echo -e "AT^NDISDUP=1,1\r\n" > /dev/ttyUSB1
sleep 1
udhcpc -i usb1
1
2
3
4
登录后即可复制

执行脚本，实现拨号，配置网络。尝试 ping www.baidu.com，可 ping 通。

若未能正常联网，按照下面命令说明进行检查测试。

部分 AT 命令说明

当前部分内容说明参考“MT5710-CN 5G RedCap 模组 AT 命令手册.pdf”文档。 AT 命令用于控制板端与模块之间的交互，本文档中通过在串口连接终端 echo 发送 AT 命令，在 ssh 连接终端 cat 接收查看返回值。先执行“cat/dev/ttyUSB1 > a.out”，再“echo -e “AT 命令” >/dev/ttyUSB1”，最后 cat a.out 查看具体命令及返回值情况。

设置模式及查询

接口说明：AT^SETMODE 命令用于设置和查询 Windows 和 Linux 下 USB 的端口形态。以适应不同场景下的客户需求。设置命令生效后，会触发模组重启。
当前系统中配置应为“4” “专为类 Linux 上位机准备的 NCM 正常模式，支持 NCM 端口、DIAG 调试端口、SERIAL_C调试端口和 GPS 端口”。可先通过“AT^SETMODE?” 命令查询当前端口形态配置，根据情况调整。

echo -e "AT^SETMODE?\r\n" > /dev/ttyUSB1
echo -e "AT^SETMODE=4\r\n" > /dev/ttyUSB1
1
2
登录后即可复制

SIM 卡状态查询

接口说明：AT+CPIN?命令用来指示是否存在密码输入请求。
返回值“+CPIN: READY”表示 SIM 卡已准备好，并且没有被 PIN 锁定。

网络状态查询

接口说明：仅当终端注册在 5G 核心网时候上报 AT+C5GREG 命令。
使用“AT+C5GREG?”查询时，返回值“+C5GREG:<n>,<stat>...”中，<n>=2 表示使能网络注册情况变化的主动上报，<stat>=1 表示注册了本地网络，=2 表示没有注册，正在搜寻要注册的新的运营商。需要注册了网络才能进行拨号。

echo -e "AT+C5GREG?\r\n" > /dev/ttyUSB1
1
登录后即可复制

信号查询

接口说明：AT^HCSQ 命令用于查询和主动上报当前服务网络的信号强度。读命令查询模块当前测量到的网络信号强度。
使用“AT^HCSQ?”查询时，返回值“^HCSQ:<sysmode>...”中，<sysmode>=NR 表示 NR 模式，后面数据分别对应为，nr_rsrp 参考信号接收功率，nr_sinr 信号与干扰加噪声比，nr_rsrq 参考信号接收功率，255 表示无效值。

echo -e "AT^HCSQ?\r\n" > /dev/ttyUSB1
1
登录后即可复制

拨号

接口说明：AT^NDISDUP 命令用于实现 NDIS 拨号。当 AT^NDISDUP=1,1 时，表示不需要其他参数的拨号方式。

echo -e "AT^NDISDUP=1,1\r\n" > /dev/ttyUSB1
1
登录后即可复制

IP 查询

接口说明：查询<cid>所标识的 PDP 上下文实际使用的 IP 地址，如果不输入<cid>则返回所有激活的 PDP 上下文实际使用的 IP 地址。

echo -e "AT+CGPADDR\r\n" > /dev/ttyUSB1
1
登录后即可复制

使用 udhcpc 动态获取网络配置后，usb1 网卡 IP 地址即为查询到的 cid=1 的 IP 地址。