系列导读:第 2 篇 / 共 7 篇。上一篇讲完了硬件准备与上电,这一篇解决"插上板子电脑没反应"的问题。
本篇关键词:USB 驱动 / 设备管理器 / 串口识别 / 黄色感叹号
一、为什么一定要装驱动
模组通过 USB 虚拟出多个串口,每个口干不同的活:
| 串口 | 用途 |
|---|---|
| Quectel USB AT Port | 发 AT 命令,做模组基础调试 |
| Quectel USB REPL Port | QuecPython 交互调试(第 5 篇的重点) |
| Quectel USB Modem / NMEA Port | 拨号、GNSS 数据输出 |
这些口不是 Windows 自带的通用驱动能识别的,必须装移远提供的 USB 驱动。没装驱动 = 设备管理器里一堆黄色感叹号 = QPYcom 里找不到端口。
二、下载:型号必须对得上
- 打开移远官网,进入 QuecPython 资源下载 页面;
- 找到 驱动 板块;
- 按你的模组型号选择对应驱动(型号怎么看:板子丝印 / 屏蔽罩激光刻字 /
ATI命令查询)。
不同型号所需驱动不同,必须精确匹配。随便下一个"看起来差不多"的驱动,典型症状是设备能识别但端口报错,或者干脆识别不出来。
详细的型号—驱动对应关系,可参考 QuecPython 文档中心 → 驱动安装 章节。
三、安装:三步搞定
- 解压下载的驱动压缩包;
- 在解压目录里找
setup.exe(或setup.bat),双击运行; - 按向导一路"下一步",等待安装完成。
安装过程中如果 Windows 弹出驱动签名提示,选择"仍要安装"。
四、验证:黄色感叹号消失才算成功
安装完成后,重新插拔一次 USB 线,然后:
右键「此电脑」→ 管理 → 设备管理器 → 端口(COM 和 LPT)
判断标准很简单:
端口列表里能看到 Quectel USB ...开头的设备,且没有黄色感叹号 → 安装成功,可以正常通信
仍有黄色感叹号,或设备出现在"其他设备"里 → 安装失败,见下一节排查
小技巧:驱动装好后,以后连接开发板时系统会自动识别串口设备,不用重复安装。建议记一下你的 REPL 口是 COM 几,QPYcom 里选端口时要用。
五、装不上?按这个顺序排查
| 现象 | 原因 | 处理 |
|---|---|---|
| 设备管理器完全没变化 | 用的是充电线,或板子没开机 | 换数据线;长按 PWRKEY 开机 |
| 出现在「其他设备」下,带黄色感叹号 | 驱动没装成功 / 型号不匹配 | 重装对应型号驱动;卸载设备后重新插拔再装 |
| 装了驱动但端口时有时无 | USB 供电不足或线材接触不良 | 换 USB 口(优先主板后置口)、换线 |
| 端口正常但 QPYcom 打不开 | 端口被别的软件占用 | 关掉串口助手、其他 IDE、Arduino 等占用程序 |
| 64 位系统提示驱动不兼容 | 装了错误架构的驱动 | 重新下载对应版本 |
一个暴力但有效的办法:设备管理器里右键有问题的设备 → 卸载设备 → 勾选"删除驱动程序软件" → 拔线 → 重装驱动 → 再插线。这能清掉残留的错误驱动缓存。
六、常见问题
Q1:COM 口号每次插拔都变,正常吗?
A:正常,Windows 会重新分配。可以在设备管理器里手动指定固定 COM 号,方便后续脚本化操作。
Q2:一台电脑能同时接多块开发板吗?
A:可以,会有多组 Quectel 端口。选端口时按下图/设备管理器里的顺序对应好,别搞混。
Q3:Linux / macOS 需要装驱动吗?
A:多数情况下内核自带 CDC-ACM 驱动,插上就能在 /dev/ttyACM* 或 /dev/ttyUSB* 看到设备,一般无需额外安装。
下一篇
第 3 篇:工具选型——QPYcom 还是 VSCode 插件?
两个工具都能写代码,但定位完全不同。一篇讲清怎么选、怎么装。