QuecPython 快速上手 ②:驱动安装——让电脑认出你的开发板

系列导读:第 2 篇 / 共 7 篇。上一篇讲完了硬件准备与上电,这一篇解决"插上板子电脑没反应"的问题。

本篇关键词:USB 驱动 / 设备管理器 / 串口识别 / 黄色感叹号


一、为什么一定要装驱动

模组通过 USB 虚拟出多个串口,每个口干不同的活:

串口 用途
Quectel USB AT Port 发 AT 命令,做模组基础调试
Quectel USB REPL Port QuecPython 交互调试(第 5 篇的重点)
Quectel USB Modem / NMEA Port 拨号、GNSS 数据输出

这些口不是 Windows 自带的通用驱动能识别的,必须装移远提供的 USB 驱动。没装驱动 = 设备管理器里一堆黄色感叹号 = QPYcom 里找不到端口。


二、下载:型号必须对得上

  1. 打开移远官网,进入 QuecPython 资源下载 页面;
  2. 找到 驱动 板块;
  3. 按你的模组型号选择对应驱动(型号怎么看:板子丝印 / 屏蔽罩激光刻字 / ATI 命令查询)。

:warning: 不同型号所需驱动不同,必须精确匹配。随便下一个"看起来差不多"的驱动,典型症状是设备能识别但端口报错,或者干脆识别不出来。

详细的型号—驱动对应关系,可参考 QuecPython 文档中心 → 驱动安装 章节。


三、安装:三步搞定

  1. 解压下载的驱动压缩包;
  2. 在解压目录里找 setup.exe(或 setup.bat),双击运行;
  3. 按向导一路"下一步",等待安装完成。

安装过程中如果 Windows 弹出驱动签名提示,选择"仍要安装"。


四、验证:黄色感叹号消失才算成功

安装完成后,重新插拔一次 USB 线,然后:

右键「此电脑」→ 管理 → 设备管理器 → 端口(COM 和 LPT)

判断标准很简单:

  • :white_check_mark: 端口列表里能看到 Quectel USB ... 开头的设备,且没有黄色感叹号 → 安装成功,可以正常通信
  • :cross_mark: 仍有黄色感叹号,或设备出现在"其他设备"里 → 安装失败,见下一节排查

:light_bulb: 小技巧:驱动装好后,以后连接开发板时系统会自动识别串口设备,不用重复安装。建议记一下你的 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* 看到设备,一般无需额外安装。


下一篇

:backhand_index_pointing_right: 第 3 篇:工具选型——QPYcom 还是 VSCode 插件?

两个工具都能写代码,但定位完全不同。一篇讲清怎么选、怎么装。