系列导读:第 4 篇 / 共 7 篇。这是整套流程里最容易翻车的一步,建议边看边操作。
本篇关键词:固件格式 / .bin .pac .mbn / QPYcom 烧录 / Download FW
一、先搞清楚一件事:出厂固件不是 QuecPython 固件
模组出厂通常烧录的是标准 AT 固件——它能收发 AT 命令,但不认识 Python 语法。
想用 QuecPython 开发,必须手动把模组刷成 QuecPython 专用固件。这一步不可跳过,也不能"用 AT 命令切过去"。
判断依据:如果第 5 篇里你在 REPL 输入
print('hello world')却报语法错误,八成就是还在 AT 固件上。
二、下载固件:先选对格式
访问移远固件下载页,按模组型号筛选后下载。
不同系列固件的文件格式不同,选错格式 QPYcom 会直接拒绝加载:
| 模组系列 | 固件格式 |
|---|---|
| BG95 | .mbn |
| M / N 系列 | .bin |
| U / G 系列 | .pac |
| BC25 | .lod |
| A 系列 | .blf |
| E 系列 | .binpkg |
| 新格式固件 | 统一选 .bin |
记不住怎么办? 两个办法:① 看下载页给你的文件后缀,直接用它;② 如果下载页同时提供多种格式,新格式统一选
.bin。
固件和型号是强绑定的。EC200U 的固件烧不进 EC600M,烧错轻则失败,重则让模组进入异常状态(需要重新烧录才能恢复)。
三、烧录四步
开始前确认:模组已连接电脑、已开机、QPYcom 能正常识别端口。
第 1 步:创建固件项目
打开 QPYcom → 切到下载页面 → 点击 “创建” 新建固件项目。
- 项目名称自定义(建议写成「型号_固件版本」,方便以后回滚)
- 项目配置会持久化保存,下次烧同样的固件直接选项目即可
第 2 步:选择固件
在项目里选择固件文件。按上一节的格式表选,新格式统一 .bin。
第 3 步:设置下载模式
点击 “Download script” 右侧的下拉箭头 → 选择 Download FW。
这一步是最常见的错误点:默认是
Download script(下载脚本),不切到Download FW就会把固件当脚本传,结果当然是失败。
第 4 步:开始烧录
点击 “Download FW” 按钮,等待进度条走完。弹窗提示 “下载成功” 即完成。
烧录期间:
- 不要拔 USB、不要断电、不要关闭 QPYcom
- 通常几十秒到几分钟,视固件大小和串口速率而定
四、烧完怎么验证
两个快速验证动作:
- 看端口:烧录后模组会重启,
Quectel USB REPL Port重新出现; - 进 REPL 敲一行:
print('hello world')→ 返回hello world就说明 QuecPython 固件已在运行(详细步骤见第 5 篇)。
五、烧录失败排查表
| 现象 | 原因 | 处理 |
|---|---|---|
| 提示格式不支持 / 加载失败 | 固件格式与型号不匹配 | 对照格式表重新下载 |
| 点击下载没反应 | 下载模式还停在 Download script |
下拉切到 Download FW |
| 进度条卡住不动 | 串口被占用 / 线材不稳 | 关掉占用软件、换线换口重试 |
| 烧到一半失败 | 供电不足或中途断连 | 用带独立供电的 USB 口,别用 HUB |
| 烧完端口消失 | 模组进入下载模式未重启 | 断电重新上电,或按 PWRKEY 重启 |
| 反复失败 | 模组处于异常状态 | 尝试按住 BOOT/下载键再上电,进入强制下载模式 |
保命提示:烧录前记下当前固件版本。万一新固件有问题,可以烧回旧版本,不至于抓瞎。
六、常见问题
Q1:可以跳过烧录,直接用 AT 固件跑 Python 吗?
A:不行。QuecPython 依赖专用固件里的 Python 虚拟机(VM),AT 固件里没有。
Q2:烧录会清掉模组里已有的文件吗?
A:会。所以已有的用户脚本请先备份到 PC(文件传输方法见第 6 篇)。
Q3:同一块板子反复烧不同固件,会损坏吗?
A:正常操作不会,Flash 寿命远大于你的调试次数。但烧错型号的固件可能导致无法启动,需要进强制下载模式救回来。
Q4:QPYcom 的"固件合并"是干什么的?
A:把多个分区的固件合成一个包,量产或批量升级时用,个人开发用不上。
下一篇
第 5 篇:REPL 上手指南——三条命令验证你的开发板
烧完固件,第一件事就是打开 REPL 敲 hello world。这篇讲 REPL 是什么、怎么进、报错了怎么办。