Linux下SORACOM Onyx LTE USB调制解调器数据连接故障排查

基础配置检查 #

1. 确认Raw IP模式正确开启
   执行命令需确保权限充足（如添加sudo）：

   ip link set wwan0 down
   echo 'Y' > /sys/class/net/wwan0/qmi/raw_ip
   ip link set wwan0 up
   

   检查/sys/class/net/wwan0/qmi/raw_ip文件内容是否为Y，若文件不存在，说明QMI驱动未正确绑定wwan0接口。

2. 验证驱动加载状态
   确认核心驱动已加载：

   lsmod | grep qmi_wwan
   lsmod | grep usbserial
   

   若输出为空，需重新加载对应驱动或检查内核配置是否开启QMI WWAN支持。

3. 确认APN配置生效
   通过AT命令写入并验证APN（以Twilio的super为例）：

   # 写入APN
   echo -e "AT+CGDCONT=1,\"IP\",\"super\"\r\n" > /dev/ttyUSB2
   # 验证配置
   echo -e "AT+CGDCONT?\r\n" > /dev/ttyUSB2
   

   返回结果需包含你设置的APN名称，确保CID（第一个参数）为1，后续操作统一使用该CID。

AT命令深度排查网络状态 #

通过/dev/ttyUSB2发送以下AT命令，确认网络附着与激活状态：

• 网络注册状态：AT+CREG?
  正常返回应为+CREG: 0,1（本地注册）或+CREG: 0,5（漫游注册），其他值表示未注册成功。
• EPS附着状态：AT+CEREG?
  正常返回应为+CEREG: 0,1或+CEREG: 0,5，确认LTE网络附着成功。
• 信号强度：AT+CSQ
  返回格式为+CSQ: <rssi>,<ber>，<rssi>值在10-30之间为正常信号（数值越高信号越强）。
• PDN连接激活：AT+CGACT?
  正常返回应为+CGACT: 1,1，表示CID为1的PDN连接已激活；若返回+CGACT: 1,0，需执行AT+CGACT=1,1手动激活。

网络配置验证 #

1. 手动触发QMI网络连接
   使用qmicli工具直接建立连接（需确保qmicli已安装）：

   qmicli -d /dev/cdc-wdm0 --wds-start-network="apn='super'",ip-type=ipv4 --client-no-release-cid
   

   若连接成功，会返回IP地址、网关等信息，随后可手动配置IP或再次运行udhcpc。

2. 检查udhcpc日志
   执行udhcpc时开启 verbose 模式，查看具体错误：

   udhcpc -i wwan0 -v
   

   若出现No lease, failing，说明调制解调器未收到DHCP服务器响应，需回到AT命令排查PDN是否激活。

3. 确认防火墙规则
   嵌入式系统默认可能关闭防火墙，但仍需确认是否有规则阻止DHCP请求：

   iptables -L
   

   若存在DROP规则，需临时关闭防火墙（iptables -F）后重试。

SIM卡状态确认 #

既然SIM卡插入手机也无法通话联网，需重点确认：

• SIM卡解锁状态：AT+CPIN?，返回+CPIN: READY表示已解锁，若返回+CPIN: SIM PIN则需输入PIN码（AT+CPIN="<PIN>"）。
• 运营商匹配：AT+COPS?，返回的运营商名称需与SIM卡所属运营商一致，若显示未知，可能是SIM卡未激活或运营商网络覆盖问题。
• 联系运营商：确认SIM卡是否激活、套餐是否有效、是否存在漫游限制（若在非归属地使用）。

可能的配置遗漏点 #

• 未手动激活PDN连接：需执行AT+CGACT=1,1确保数据通道开启。
• Raw IP模式开启失败：部分内核版本需使用echo '1'而非echo 'Y'写入raw_ip文件，可尝试切换值。
• QMI接口未正确识别：检查/dev/cdc-wdm0是否存在，若不存在，需重新插拔调制解调器或调整udev规则。

内容的提问来源于stack exchange，提问作者thecdoctor