简介这份资源是Quectel EC20模块在Linux与Android平台下的CMUX驱动V2.0.1版本面向嵌入式开发、物联网设备及车载通信方向的工程师用于解决单一UART接口上数据、语音、短信等多业务并发传输的问题。压缩包共3个文件包含1个C源码文件、1个Makefile和1份PDF用户指南整体约354KB源码可直接编译定制Makefile便于快速构建PDF文档则说明驱动的安装配置与API调用方式。目前已有349人学习下载。通过该驱动开发者可掌握CMUX时分复用机制、Linux内核适配要点以及Android HAL层接入方法并借助示例与测试脚本验证模块的唤醒、睡眠控制与数据收发流程为物联网终端、车载信息娱乐系统等场景下的稳定通信提供参考。1. CMUX 驱动到底解决什么问题从 EC20 多路串口需求说起如果你在 Linux 或 Android 上接过 Quectel EC20 这类 4G 模组大概率遇到过这个场景模组只暴露一个 USB 串口给应用层但你的设备同时要跑 AT 指令、PPP 拨号、GPS NMEA 上报、短信收发甚至还要留一路给 OTA 升级。单串口被多进程抢占AT 命令互相插队返回数据串台调试起来像开盲盒。CMUXConnection Multiplexing就是为解决这个问题而生的——它把一条物理串口虚拟成多条逻辑通道每条通道独立跑一种业务互不干扰。标题里的Quectel_LinuxAndroid_CMUX_Driver_V2.0.1_Follow_ec20cmux_gsm0701指向的正是移远官方为 Linux 和 Android 平台提供的 CMUX 驱动包版本 V2.0.1遵循 GSM 07.10 协议规范。它要解决的核心诉求很明确让 EC20 模组在嵌入式 Linux 或 Android 系统上通过一条 USB AT 口复用出多路虚拟串口供上层不同业务模块并行使用。适合谁看做工业网关、车载终端、Android 智能硬件的嵌入式工程师尤其是那些被单串口并发问题折磨过、正在找稳定复用方案的人。下面我从协议原理讲到内核驱动集成再到实际调参和踩坑把这条路走通。2. GSM 07.10 与 CMUX 的底层逻辑为什么不是简单开几个线程2.1 GSM 07.10 帧结构决定了复用能力的上限CMUX 不是应用层自己封装一个协议头就完事它依赖的是 GSM 07.10 标准定义的帧格式。每一帧数据在物理串口上传输时都带有地址字段、控制字段、长度字段和校验字段。地址字段标识这条帧属于哪个 DLCIData Link Connection Identifier相当于逻辑通道号。控制字段区分是数据帧还是命令帧比如 SABMSet Asynchronous Balanced Mode用于建立通道UAUnnumbered Acknowledgment用于确认DISC 用于断开。理解这一点很关键CMUX 驱动的工作是在内核态或串口驱动层把上层写入不同虚拟串口的数据按照 GSM 07.10 格式打包成帧再通过唯一物理串口发出去收到数据后根据 DLCI 拆包分发到对应的虚拟串口。整个过程对上层应用透明应用看到的只是/dev/ttyGSM0、/dev/ttyGSM1这样的设备节点。常见做法是 DLCI 0 作为控制通道DLCI 1 跑 AT 指令DLCI 2 跑 PPPDLCI 3 跑 GPS。但具体怎么分配取决于模组固件和驱动配置。EC20 的 CMUX 实现通常支持 4 路复用够大多数场景用。2.2 内核驱动集成方式tty line discipline 还是独立驱动移远这个驱动包 V2.0.1 在 Linux 侧的集成方式常见有两种一种是作为 tty line discipline 挂载到物理串口上另一种是编译成独立内核模块直接接管 USB 串口设备。从包名Follow_ec20cmux_gsm0701看它大概率是参考了 EC20 的 CMUX 实现并遵循 GSM 07.10 规范。我一般会先确认内核版本和 tty 子系统是否支持N_GSM0710line discipline。如果内核已经内置了n_gsm模块可以直接用ldattach工具把物理串口绑定到 GSM 0710 协议上再通过gsmtty设备节点访问。但移远这个驱动包通常提供了更贴合 EC20 的适配层包括 USB 接口的识别、模组上下电时序、以及 Android 侧的 HAL 对接。选型理由如果你的系统内核版本较新且稳定优先用内核自带的n_gsm减少维护成本如果内核版本老或者 EC20 固件有特殊时序要求用移远提供的驱动包更稳妥。Android 侧还要考虑 SELinux 策略和权限配置否则应用层根本打不开虚拟串口节点。2.3 物理串口选哪一路AT 口还是 DM 口EC20 通常枚举出多个 USB 接口AT 口、DMDiagnostic Monitor口、NMEA 口、Modem 口等。CMUX 复用的对象一般是 AT 口因为 AT 口支持完整的 AT 命令集且模组固件默认在 AT 口上支持 CMUX 激活命令ATCMUX0。这里有个容易翻车的点不是所有 USB 接口都支持 CMUX。如果你把 CMUX 驱动绑到 DM 口上可能连ATCMUX都发不出去。我一般先用lsusb -v和dmesg确认 EC20 枚举出的接口编号再对照移远文档确认哪个接口是 AT 口。常见做法是接口 0 或接口 2 作为 AT 口具体看模组固件配置。3. 在 Linux 上跑通 CMUX从内核模块编译到虚拟串口验证3.1 确认内核配置与依赖动手之前先检查内核是否开启了 tty line discipline 相关配置。进入内核源码目录查看.config# 检查 N_GSM0710 是否启用 grep -E CONFIG_N_GSM|CONFIG_TTY|CONFIG_USB_SERIAL .config如果CONFIG_N_GSM是m或y说明内核支持 GSM 0710 line discipline。如果是n需要重新配置内核并编译模块。移远驱动包通常也依赖CONFIG_USB_SERIAL_OPTION或CONFIG_USB_SERIAL_WWAN确保 USB 串口驱动已就绪。参数说明CONFIG_N_GSMm表示编译成模块系统启动后可以动态加载y表示编入内核启动即生效。嵌入式系统为了减小内核体积常用m但要注意根文件系统里要有对应的.ko文件。3.2 编译并加载移远 CMUX 驱动模块假设你已经拿到了驱动包解压后进入源码目录。典型结构包含Makefile、Kconfig、quectel_cmux.c等文件。编译前先确认内核头文件路径# 进入驱动源码目录 cd Quectel_Linux_Android_CMUX_Driver_V2.0.1 # 指定内核源码路径并编译 make -C /path/to/kernel/source M$(pwd) modules ARCHarm CROSS_COMPILEarm-linux-gnueabihf-编译成功后生成quectel_cmux.ko。加载模块# 加载驱动模块 insmod quectel_cmux.ko # 查看内核日志确认加载状态 dmesg | tail -30逻辑说明make -C指定内核源码目录M$(pwd)告诉内核构建系统当前目录是外部模块ARCH和CROSS_COMPILE根据目标平台调整。加载后驱动会尝试匹配 EC20 的 USB 接口如果匹配成功dmesg里会看到类似quectel_cmux: probe success的输出。参数说明如果编译报错找不到头文件检查/path/to/kernel/source是否正确以及是否执行过make modules_prepare。交叉编译工具链前缀要和内核编译时一致否则会出现符号版本不匹配。3.3 激活 CMUX 并创建虚拟串口驱动加载后物理 AT 口会被 CMUX 驱动接管。接下来需要发送ATCMUX0激活模组的 CMUX 功能。这一步通常由驱动自动完成也可以手动通过picocom或minicom发送。激活成功后系统会出现/dev/ttyGSM0到/dev/ttyGSM3等虚拟串口节点。# 查看生成的虚拟串口节点 ls -l /dev/ttyGSM* # 用 AT 命令测试 DLCI 1 通道 echo -e AT\r /dev/ttyGSM1 cat /dev/ttyGSM1 逻辑说明/dev/ttyGSM0通常是控制通道不建议应用层直接操作/dev/ttyGSM1对应 DLCI 1用来跑 AT 指令。echo写入 AT 命令后cat会读取模组返回的OK。如果没有任何返回说明 CMUX 通道没建立成功需要检查驱动日志和模组固件版本。参数说明不同驱动版本虚拟串口命名可能不同有的用/dev/ttyGSM*有的用/dev/gsmtty*。以dmesg和ls /dev实际输出为准。如果节点没出现检查ATCMUX0是否发送成功以及模组是否支持 CMUX 功能。3.4 用 PPP 拨号验证 DLCI 2 通道AT 通道通了之后下一步验证 PPP 拨号。把 DLCI 2 对应的虚拟串口交给pppd# 启动 PPP 拨号使用 ttyGSM2 作为 Modem 口 pppd call quectel-ppp /etc/ppp/peers/quectel-ppp配置示例/dev/ttyGSM2 115200 noauth debug defaultroute usepeerdns connect /usr/sbin/chat -v -f /etc/ppp/chat-quectel逻辑说明pppd通过ttyGSM2发送 AT 拨号命令建立 PPP 连接后系统会多出一个ppp0网络接口。chat脚本负责发送ATD*99#等拨号指令。如果拨号失败先确认ttyGSM2能单独收发 AT 命令再检查 APN 配置。参数说明115200是虚拟串口波特率实际物理串口波特率由 CMUX 驱动协商虚拟串口上这个值通常不影响实际速率。defaultroute表示拨号成功后添加默认路由usepeerdns表示使用运营商下发的 DNS。4. Android 侧集成 CMUXHAL 对接与权限配置的坑4.1 Android 内核差异与驱动适配Android 底层也是 Linux 内核但 tty 子系统和权限模型有差异。移远驱动包在 Android 上通常需要额外适配init.rc和ueventd.rc确保虚拟串口节点权限正确。常见做法是在init.rc里添加# 创建虚拟串口节点并设置权限 on boot chmod 0660 /dev/ttyGSM0 chmod 0660 /dev/ttyGSM1 chown system radio /dev/ttyGSM0 chown system radio /dev/ttyGSM1逻辑说明Android 的radio组负责通信相关操作应用层通过Radio权限访问串口。如果权限不对RIL或上层应用会报Permission denied。ueventd.rc里还要配置节点创建时的默认权限否则每次重启权限都会丢。参数说明chmod 0660表示所有者和组可读写其他用户无权限。chown system radio把所有者设为 system组设为 radio。具体用户和组名根据 Android 版本和厂商定制可能不同以实际系统为准。4.2 RIL 层如何对接 CMUX 虚拟串口Android 的 RILRadio Interface Layer通常通过rild守护进程与模组通信。如果 CMUX 驱动创建了/dev/ttyGSM1作为 AT 通道需要修改rild的启动参数或init.rc里的服务定义把设备节点指向虚拟串口。# init.rc 中 rild 服务配置示例 service ril-daemon /system/bin/rild class main socket rild stream 660 root radio socket rild-debug stream 660 radio system user root group radio cache inet misc audio log oneshot逻辑说明rild启动后会打开配置的串口设备。如果 CMUX 驱动在rild之后才加载rild会找不到设备。常见做法是在rild启动前确保 CMUX 驱动已加载且虚拟串口已创建。可以通过init.rc里的on property触发顺序控制。参数说明oneshot表示服务只启动一次退出后不自动重启。如果rild反复重启检查串口节点是否存在以及权限是否正确。4.3 SELinux 策略不解决它应用层永远打不开串口Android 5.0 以后 SELinux 默认强制模式。CMUX 虚拟串口节点需要添加file_contexts和te规则否则即使权限是0660应用层依然会被 SELinux 拦截。# file_contexts 中添加 /dev/ttyGSM[0-9]* u:object_r:radio_device:s0 # radio.te 中添加 allow radio radio_device:chr_file { open read write ioctl };逻辑说明file_contexts给设备节点打上 SELinux 标签te规则允许radio域访问该标签的设备。如果缺少这些规则dmesg或logcat里会看到avc: denied日志。用audit2allow工具可以根据拒绝日志生成规则但建议手动确认最小权限集。参数说明u:object_r:radio_device:s0是自定义标签需要确保没有和已有标签冲突。chr_file表示字符设备open read write ioctl是串口操作必需的权限。5. CMUX 驱动避坑指南五个让调试时间翻倍的典型问题5.1 现象加载驱动后物理串口消失虚拟串口也没出现原因CMUX 驱动接管物理串口后如果ATCMUX0激活失败物理串口不会自动恢复虚拟串口也不会创建。常见原因是模组固件不支持 CMUX或者驱动匹配到了错误的 USB 接口。解决先卸载驱动模块rmmod quectel_cmux确认物理串口恢复。然后检查 EC20 固件版本是否支持 CMUX用ATCMUX?测试模组是否返回支持。如果模组不支持需要升级固件或换用其他复用方案。5.2 现象虚拟串口能打开但写入 AT 命令无返回原因DLCI 通道没建立成功或者虚拟串口和 DLCI 的映射关系不对。有的驱动版本/dev/ttyGSM1对应 DLCI 0而不是 DLCI 1。解决查看驱动源码或文档确认映射关系。用cat /dev/ttyGSM0逐个测试找到能返回OK的节点。如果所有节点都没返回检查ATCMUX0是否真的发送到了模组可以用逻辑分析仪抓物理串口波形。5.3 现象PPP 拨号成功但网络不通ping 外网超时原因CMUX 复用后PPP 通道的 MTU 可能被限制或者路由表被其他接口覆盖。常见于同时有 WiFi 和 4G 的场景。解决检查ifconfig ppp0的 MTU 值尝试调小到 1400 或 1280。用ip route确认默认路由是否指向ppp0。如果 WiFi 优先级更高需要调整路由 metric 或临时关闭 WiFi 验证。5.4 现象Android 上应用层打开虚拟串口报 Permission denied原因SELinux 策略缺失或权限配置不完整。即使chmod 0660正确SELinux 仍可能拦截。解决抓取logcat和dmesg中的avc: denied日志用audit2allow生成规则但手动审查确保只开放必要权限。同时确认init.rc里的chown和chmod在节点创建后执行。5.5 现象长时间运行后 CMUX 通道断连AT 命令超时原因GSM 07.10 协议有保活机制如果驱动没有定期发送保活帧模组侧可能主动断开 DLCI。另外物理串口波特率过高或流控未开启也会导致数据丢失。解决检查驱动是否支持保活定时器必要时在应用层定期发送AT心跳。确认物理串口开启了硬件流控RTS/CTS波特率不要超过模组支持的上限。EC20 的 AT 口通常支持 115200 或 921600但 CMUX 模式下建议先用 115200 验证稳定性。6. 验证 CMUX 稳定性的三个进阶技巧6.1 用压力脚本跑 24 小时并发测试光跑通不够工业场景要的是长期稳定。我一般会写一个脚本同时向多个虚拟串口发 AT 命令统计返回成功率和延迟#!/bin/bash # CMUX 并发压力测试向 ttyGSM1 和 ttyGSM2 同时发 AT 命令 for i in $(seq 1 10000); do echo -e AT\r /dev/ttyGSM1 echo -e AT\r /dev/ttyGSM2 sleep 0.1 done逻辑说明这个脚本简单粗暴但能暴露通道串台和丢数据问题。跑完后检查dmesg有没有frame error或timeout日志。如果成功率低于 99%说明 CMUX 参数需要调整比如增大帧长度或降低波特率。参数说明sleep 0.1控制发送频率实际测试可以根据业务场景调整。如果模组返回ERROR检查是不是 AT 命令发太快导致模组缓冲区溢出。6.2 抓包分析 GSM 07.10 帧当问题难以复现时抓物理串口波形是终极手段。用逻辑分析仪接在 EC20 的 USB 串口 TX/RX 上或者用内核的tty抓包工具# 开启 tty 抓包记录物理串口数据 cat /dev/ttyUSB2 /tmp/cmux_raw.bin 然后用 Wireshark 的 GSM 07.10 解析器分析cmux_raw.bin能看到每一帧的 DLCI、控制字段和载荷。如果发现大量重传或校验错误说明物理链路质量有问题需要检查 USB 线缆或电源稳定性。6.3 对比内核自带 n_gsm 与移远驱动的差异如果你用的是较新内核可以对比n_gsm和移远驱动的行为差异。n_gsm是内核社区维护的通用实现移远驱动针对 EC20 做了优化。我一般会先跑n_gsm如果稳定就不折腾移远驱动如果n_gsm在 EC20 上有兼容性问题再换移远驱动。# 使用 n_gsm 绑定物理串口 ldattach 27 /dev/ttyUSB2 # 查看生成的 gsmtty 设备 ls /dev/gsmtty*逻辑说明ldattach 27中的 27 是N_GSM0710的 line discipline 编号。绑定成功后会出现/dev/gsmtty*节点。如果n_gsm能正常工作说明模组 CMUX 功能没问题移远驱动的价值主要在 Android 适配和特定固件兼容性上。踩了这么多坑我最大的习惯是每次调 CMUX 之前先用dmesg -w开着日志窗口任何异常第一时间看内核输出。另外物理串口线一定要用带屏蔽的优质线劣质线在 921600 波特率下丢包率能到 10% 以上这种问题查起来最费时间。希望帮到你。本文还有配套的精品资源点击获取