快速启动

在开始之前，请准备下列软硬件：

硬件：

• 一块 QuecPython_EC2X_EVB 开发板 (以该开发板为例，更多开发板介绍参见下文开发板列表)
• USB 数据线 (USB-A TO USB-C)
• PC (Windows10)

软件：

• 下载安装 USB驱动，用于开发调试QuecPython模组
• 下载调试工具 —— QPYcom - QuecPython全栈式开发调试工具
• 获取下载 QuecPython 固件和相关软件资源
• 安装Python语言的 文本编辑器，例如 VSCode

设备上手：

根据使用的设备参考上文的开发板列表完成设备的上电开机（包括天线安装、SIM卡安装、连接电源、开机等）

打开QuecPython官网驱动下载链接，进入页面后在驱动栏选择与自己模组型号和电脑系统匹配的驱动，不同平台的模组所需要的驱动程序不一致，需要根据模组型号去下载对应的驱动包。

例如，左侧筛选栏选择EG912U，可以筛选出该型号的USB驱动QuecPython_USB Driver Win10_U_G)点击下载按钮下载驱动:

驱动安装

下载后解压驱动压缩包，找到"setup.exe" 或者是"setup.bat"，双击运行即可，安装完之后打开设备管理器就可以看到设备管理器中端口的黄色感叹号消失了，说明安装成功，能够正常通信。

QuecPython 支持下列两种开发工具，可以任选一种

1.安装 QPYcom

使用QuecPython进行开发需要用到专用的开发调试工具 —— QPYcom，包括但不限于调试代码、分析日志、文件传输、烧录固件、合并固件等。

访问此处下载 QPYcom。

注意:该工具无需安装，解压即用。

2.安装 VSCode 插件

编辑Python代码一般会用到专用于Python或者兼容多种语言的IDE，可以有效提升开发效率，这里推荐 VSCode

针对VScode，QuecPython推出专用插件实现代码提示、代码补全和串口调试等功能，安装方法见下图。

在VSCode中点击侧边栏插件市场，在插件市场中搜索 “QuecPython”，根据搜索结果下载该插件即可

在VSCode插件商店网站 搜索“QuecPython”，根据搜索结果下载该插件后会自动打开VSCode并安装

获取固件

模组在出厂时通常烧录有标准 AT 固件或 QuecOpen 固件，如需基于 QuecPython 对模块进行开发，需要手动为其重新烧录专门的 QuecPython 固件。

官网固件下载地址：https://developer.quectel.com/resource-download?cid=15

根据模组型号在左侧栏中过滤并选择对应的固件下载即可。

烧录固件

• Step1：创建项目

首先确保模组连接正常并已开机，打开QPYcom工具进入下载页面，点击"创建"项目，新建要下载的固件项目，项目名称自定义，配置完成后持久化保存

• Step2：选择固件

选择要下载到模组的固件(根据要下载的模组型号选择对应的固件，若为新格式固件则所有模组型号都选择.bin文件即可）

其中BG95系列选择官网下载固件包解压后mbn结尾的文件，M/N系列选择官网下载固件包解压后的bin文件，U/G系列模组选择解压后的PAC文件，BC25选择lod文件，A系列选择blf文件，E系列选择binpkg文件

• Step3：设置下载模式

单击“Download script”右侧的下拉选择箭头，选择"Download FW"

• Step4：开始烧录固件

点击"Download FW"后，开始下载固件,下载过程会有进度条和进度百分比显示，等待下载完毕会有弹窗提示下载成功

REPL全称为Read-Eval-Print-Loop (交互式解释器)，可以在REPL中进行QuecPython程序的调试

运行 QPYcom 工具后，选择正确的串口（波特率无需指定）并打开，即可开始 Python 命令行交互。

• Step1：进入交互页面

进入交互页面首先需要打开USB交互口，以EC600N/M系列模组举例，打开QPYcom工具，端口选择连接Quectel USB REPL Port，选择“交互”界面。

• Step2：打开串口

点击“打开串口”按钮，在交互界面输入print(‘hello world’)，按回车后可以看到执行的结果信息

>>> print('hello world')
hello world

注意：工具交互页面输入时需要输入英文字符，中文字符将会被屏蔽

编写第一个脚本文件

创建helloworld.py文件输出“hello world”，打印“hello world”，编写脚本如下所示：

print("hello world")

通过QPYcom将上面编辑好的文件下载到模组中去并运行

PC与模组间的文件传输

下载方法一:

• Step1：打开串口

首先选择模组的交互口,点击"打开串口"按钮

• Step2：通过工具按钮下载

可以通过文件页面右侧上面的 "+","-" 按钮来上传和删除文件

• Step3：通过拖拽形式下载

也可以通过拖拽的方式将文件页面左侧显示的本地文件直接拖拽到右侧模组中去（也可以拖拽文件夹）

• Step4：下载进度和结果

下载过程中会在状态栏显示下载文件名和下载进度

下载方法二:

• Step1：创建项目

根据需求，创建用户项目（点击"创建"按钮）,步骤同上文烧录固件

• Step2：配置要下载的文件

选择需要下载到模块的用户脚本(在"用户脚本"区域通过右键菜单添加)

• Step3：设置下载模式

左击下拉选择箭头，选择"下载脚本"，即"Download Script"

• Step4：开始下载脚本

点击"下载脚本"开始下载脚本，下载过程中有进度条提示

执行脚本文件

• Step1：下载脚本

将要执行的脚本文件下载到模组中去,具体步骤参考上文

• Step2：通过repl执行脚本

打开串口之后，在QPYcom交互页面输入以下代码执行脚本文件

import example
example.exec("/usr/helloworld.py") # filePath为要执行的脚本文件路径

• Step3：通过GUI工具执行脚本

或者通过QPYcom文件页面 执行 按钮执行脚本文件,在工具的文件页面选择要执行的脚本文件然后点击 "▷"按钮

执行结果如图

停止程序运行

如何停止正在运行的程序,根据运行的脚本文件类型有以下方法: