QuecPython 快速上手 ④:固件烧录——把模组变成 QuecPython 开发板

系列导读:第 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

:light_bulb: 记不住怎么办? 两个办法:① 看下载页给你的文件后缀,直接用它;② 如果下载页同时提供多种格式,新格式统一选 .bin。

:warning: 固件和型号是强绑定的。EC200U 的固件烧不进 EC600M,烧错轻则失败,重则让模组进入异常状态(需要重新烧录才能恢复)。


三、烧录四步

开始前确认:模组已连接电脑、已开机、QPYcom 能正常识别端口。

第 1 步:创建固件项目

打开 QPYcom → 切到下载页面 → 点击 “创建” 新建固件项目。

  • 项目名称自定义(建议写成「型号_固件版本」,方便以后回滚)
  • 项目配置会持久化保存,下次烧同样的固件直接选项目即可

第 2 步:选择固件

在项目里选择固件文件。按上一节的格式表选,新格式统一 .bin。

第 3 步:设置下载模式

点击 “Download script” 右侧的下拉箭头 → 选择 Download FW。

:warning: 这一步是最常见的错误点:默认是 Download script(下载脚本),不切到 Download FW 就会把固件当脚本传,结果当然是失败。

第 4 步:开始烧录

点击 “Download FW” 按钮,等待进度条走完。弹窗提示 “下载成功” 即完成。

烧录期间:

  • 不要拔 USB、不要断电、不要关闭 QPYcom
  • 通常几十秒到几分钟,视固件大小和串口速率而定

四、烧完怎么验证

两个快速验证动作:

  1. 看端口:烧录后模组会重启,Quectel USB REPL Port 重新出现;
  2. 进 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:把多个分区的固件合成一个包,量产或批量升级时用,个人开发用不上。


下一篇

:backhand_index_pointing_right: 第 5 篇:REPL 上手指南——三条命令验证你的开发板

烧完固件,第一件事就是打开 REPL 敲 hello world。这篇讲 REPL 是什么、怎么进、报错了怎么办。