RG500U-CN&RM500U-CN
Linux USB 驱动用户指导
5G 模块系列
版本:1.1
日期:2021-05-26
状态:受控文件
RG500U-CN&RM500U-CN Linux USB 驱动用户指导
上海移远通信技术股份有限公司始终以为客户提供最及时、最全面的服务为宗旨。如需任何帮助,请随时
联系我司上海总部,联系方式如下:
上海移远通信技术股份有限公司
上海市闵行区田林路 1016 号科技绿洲 3 期(B 区)5 号楼 邮编:200233
电话:+86 21 51086236 邮箱:info@quectel.com
或联系我司当地办事处,详情请登录:http://www.quectel.com/cn/support/sales.htm。
如需技术支持或反馈我司技术文档中的问题,可随时登陆如下网址:
http://www.quectel.com/cn/support/technical.htm 或发送邮件至:support@quectel.com。
前言
上海移远通信技术股份有限公司提供该文档内容用以支持其客户的产品设计。客户须按照文档中提供的规
范、参数来设计其产品。因未能遵守有关操作或设计规范而造成的损害,上海移远通信技术股份有限公司
不承担任何责任。在未声明前,上海移远通信技术股份有限公司有权对该文档进行更新。
免责声明
上海移远通信技术股份有限公司尽力确保开发中功能的完整性、准确性、及时性或效用,但不排除上述功
能错误或遗漏的可能。除非其他有效协议另有规定,否则上海移远通信技术股份有限公司对开发中功能的
使用不做任何暗示或明示的保证。在适用法律允许的最大范围内,上海移远通信技术股份有限公司不对任
何因使用开发中功能而遭受的损失或损害承担责任,无论此类损失或损害是否可以预见。
保密义务
除非上海移远通信技术股份有限公司特别授权,否则我司所提供文档和信息的接收方须对接收的文档和信
息保密,不得将其用于除本项目的实施与开展以外的任何其他目的。未经上海移远通信技术股份有限公司
书面同意,不得获取、使用或向第三方泄露我司所提供的文档和信息。对于任何违反保密义务、未经授权
使用或以其他非法形式恶意使用所述文档和信息的违法侵权行为,上海移远通信技术股份有限公司有权追
究法律责任。
版权申明
本文档版权属于上海移远通信技术股份有限公司,任何人未经我司允许而复制转载该文档将承担法律责任。
版权所有 ©上海移远通信技术股份有限公司 2021,保留一切权利。
Copyright © Quectel Wireless Solutions Co., Ltd. 2021.
上海移远通信技术股份有限公司 1 / 17
RG500U-CN&RM500U-CN Linux USB 驱动用户指导
文档历史
修订记录
版本 日期
作者
变更表述
-
2021-01-11
Lee LI
文档创建
1.0
2021-01-28
Lee LI
受控版本
1.1
2021-05-26 Carl YIN
增加适用模块 RM500U-CN。
上海移远通信技术股份有限公司 2 / 17
RG500U-CN&RM500U-CN Linux USB 驱动用户指导
目录
文档历史 ....................................................................................................................................................... 2
目录 .............................................................................................................................................................. 3
表格索引 ....................................................................................................................................................... 4
图片索引 ....................................................................................................................................................... 5
1 引言 ....................................................................................................................................................... 6
2 Linux USB 接口概述 ............................................................................................................................ 7
3 Linux USB 驱动移植 ............................................................................................................................ 8
3.1. USB 转串口驱动 ......................................................................................................................... 8
3.1.1. 添加 VID 和 PID ............................................................................................................... 8
3.1.2. 添加 USB 零包机制 ......................................................................................................... 8
3.1.3. 增加复位恢复机制 ........................................................................................................... 9
3.1.4. 增加批量输出 URB 的数量和容量(Linux 内核 2.6.29 及以下版本) ........................... 10
3.1.5. 使能内核配置项 .............................................................................................................. 11
3.2. USB 网卡驱动............................................................................................................................ 11
3.3. 使能 PPP 拨号(不推荐) ........................................................................................................ 12
4 AT 和 USB 网卡拨号功能测试 ............................................................................................................ 14
4.1. AT 功能测试 .............................................................................................................................. 14
4.2. USB 网卡拨号测试 ................................................................................................................... 14
5 常见问题 .............................................................................................................................................. 15
5.1. 如何检查 Linux 系统中是否移植了所需 USB 驱动 ................................................................... 15
5.2. 如何检查模块是否正确加载 Linux USB 驱动 ........................................................................... 15
6 附录 参考文档和术语缩写 .................................................................................................................. 16
上海移远通信技术股份有限公司 3 / 17
RG500U-CN&RM500U-CN Linux USB 驱动用户指导
表格索引
表 1:Linux USB 接口信息 ........................................................................................................................... 7
表 2:USB 网卡模式 ....................................................................................................................................11
表 3:参考文档 ........................................................................................................................................... 16
表 4:术语缩写 ........................................................................................................................................... 16
上海移远通信技术股份有限公司 4 / 17
RG500U-CN&RM500U-CN Linux USB 驱动用户指导
图片索引
图 1:Kernel 中配置 USB 网卡................................................................................................................... 12
图 2:AT 功能测试结果 .............................................................................................................................. 14
图 3:内核日志 ........................................................................................................................................... 15
上海移远通信技术股份有限公司 5 / 17
RG500U-CN&RM500U-CN Linux USB 驱动用户指导
1 引言
本文档主要介绍如何在 Linux 系统上移植移远通信 5G 模块 RG500U-CN 和 RM500U-CN 的 USB 转串
口驱动和 USB 网卡驱动、如何测试模块的 AT 功能和 USB 网卡拨号功能以及驱动移植相关常见问题。
上海移远通信技术股份有限公司 6 / 17
RG500U-CN&RM500U-CN Linux USB 驱动用户指导
2 Linux USB 接口概述
移 远 通 信 RG500U-CN 和 RM500U-CN 模 块 的 USB 驱 动 包 含 多 个 不 同 的 功 能 接 口 。 下 表 以
RG500U-CN 为例描述了在 Linux 操作系统下模块 USB 接口的详细信息:
表 1:Linux USB 接口信息
模块的 VID 和 PID
Linux USB 驱动程序
接口
USB RNDIS/ECM/NCM/MBIM 网卡
接口 0/1:USB 网络适配器
接口 2:DIAG 命令通信端口
接口 3:LOG 端口
VID:0x2c7c
PID:0x0900
USB 转串口 option
接口 4:AT 命令通信端口
接口 5:Modem 命令通信端口
接口 6:NMEA 命令通信端口
USBFS
接口 7:ADB 命令通信端口
上海移远通信技术股份有限公司 7 / 17