QuecPython BG&EG 系列核心板介绍

2025-05-06

快速开始

支持的模组列表

功能列表

基本描述

QuecPython BG&EG 系列核心板(PH-7(C4-P02))是专门针对 QuecPython 制造的、最小功能的核心开发板。核心板采用 2.54mm 排针方式设计，提供 38PIN 插针，含功能引脚以及使能控制引脚。主要针对客户开发、调试、以及量产设备提供支持与便利。该系列核心板适用 BG95 全系列、EG915UEUAB、EG915ULAAB、EG912UGLAA等EG系列，包含，但不仅仅包含以上模组型号。

核心板渲染图

开发板的功能主要组件、接口布局见下图。

  • 充电与 USB：插入 Type-C 接口连接USB时，默认开启充电功能，且无法关闭，不使用充电功能无需理会。
  • GNSS：GNSS功能依模组型号而定，以BG95为例，核心板默认使用有源天线，且已默认开启对有源天线的供电。
  • SD & SIM 卡槽。
  • 38 Pin 插针引脚。
  • 天线接口。

资料下载

开发板资源

开发板主要管脚布局见下图

快速入门

硬件准备

以下是开发板上手之后的硬件准备步骤

  • Step1：硬件准备

    开始之前需要准备以下配件

    1. 开发板
    2. USB 数据线 (USB-A TO USB-TypeC)
    3. PC (Windows10)
    4. SIM 卡
    5. 4G 天线

  • Step2：天线&SIM卡安装

安装开发板配套的天线,安装位置为 MAIN 天线座位置,并将 SIM 卡插入开发板上的 SIM 卡座。

  • Step3：开发板连接

使用 USB Type-C 数据线连接开发板的 Type-C/Micro USB 接口和电脑 USB 口即可完成供电。

开发板PWR灯常亮即为正常供电。

  • Step4: 开发板开机

将开发板上丝印为GND和PWR的排针短接后上电自动开机，开机后开发板NET灯闪烁，开发板已正常开机。

驱动安装

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

出现 Mobile ECM Network Adapter 或 CDC Ethernet Control Modle (ECM) 等设备未被识别属于正常现象，不影响固件烧录和后续开发，无需理会。

  • 右键打开【我的电脑】——选择【管理】——选择【设备管理器】,然后在设备管理器中选择 【端口】，按照步骤打开页面后如图所示能刷新出Quectel USB 名称开头的串口则USB驱动安装成功。

工具安装

  • QPYcom获取

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

打开QuecPython工具下载页面，根据操作系统选择对应的工具进行下载。

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

  • VSCode插件

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

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

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

固件烧录

固件获取

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

官网固件下载地址

面对官网种类众多的固件，如何选择合适的固件包，首先需要知道使用的模组的型号，模组型号可以通过模组的镭雕或者发送AT指令来获得。

在获取到模组型号之后根据模组的型号去官网下载该模组对应的固件即可,固件的名称一般为QPY_OCPU_版本号_模组型号_FW，没有特殊需求默认下载最新版本即可。

点击下载列的下载按钮即可下载，下载成功后会得到一个固件名称命名的压缩包文件(zip包)

从官网下载的固件包为压缩包格式，固件压缩包下载到本地后，需进行解压。解压后可获得两个文件，其中 .bin 格式的是 QuecPython 固件本体，.md 格式的是更新日志。

请务必将压缩包内容解压至一个不包含中文、空格和其他特殊字符的路径下，否则下载工具可能无法正常识别到固件，同时下载工具路径也不可包含中文、空格和其他特殊字符。

固件烧录

  • Step1：创建项目

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

  • Step2：选择固件

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

如果是老版本固件，固件文件格式不一定以bin结尾，其中BG95系列选择官网下载固件包解压后mbn结尾的文件，EG91XU系列模组选择解压后的PAC文件

  • Step3：设置下载模式

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

  • Step4：开始烧录固件

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

其中BG95系列需要打开DM串口后再点击"Download FW"，直接点击会提示打开串口

REPL调试

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

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

  • Step1：进入交互页面

打开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与模组间的文件传输

下载方法一:

image-2021081301
  • Step1：打开串口

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

  • Step2：通过工具按钮下载

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

  • Step3：通过拖拽形式下载

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

  • Step4：下载进度和结果

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

下载方法二:

image-2021081301
  • Step1：创建项目

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

  • Step2：配置要下载的文件

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

  • Step3：设置下载模式

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

  • Step4：开始下载脚本

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

运行脚本文件

  • Step1：下载脚本

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

  • Step2：通过repl执行脚本

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

import example
example.exec("/usr/helloworld.py") # filePath为要执行的脚本文件路径
  • Step3：通过GUI工具执行脚本

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

执行结果如图

停止程序运行

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

程序名是否
为main.py		 程序中是否
包含了死循环		 程序中是否
使用了多线程		 停止步骤
✓ ✓ ✓ （1）按 Ctrl + A 键进入 RAW 模式
（2）按 Ctrl + D 键重启 QuecPython 虚拟机
（3）按 Ctrl + B 键回到普通交互模式
（4）若以上方法无效，请重新烧录固件
✗ （1）按 Ctrl + C 键打断程序运行
（2）若以上方法无效，请重新烧录固件
✗ ✓ （1）按 Ctrl + A 键进入 RAW 模式
（2）按 Ctrl + D 键重启 QuecPython 虚拟机
（3）按 Ctrl + B 键回到普通交互模式
（4）若以上方法无效，请耐心等待程序运行结束
✗ （1）按 Ctrl + C 键打断程序运行
（2）若以上方法无效，请重新烧录固件
✗ ✓ ✓ （1）按 Ctrl + D 键重启 QuecPython 虚拟机
（2）若以上方法无效，请直接重启模块
✗ （1）按 Ctrl + D 键重启 QuecPython 虚拟机
（2）若以上方法无效，请直接重启模块
✗ ✓ （1）按 Ctrl + C 键打断程序运行
（2）若以上方法无效，请重新烧录固件或直接重启模块
✗ （1）按 Ctrl + C 键打断程序运行
（2）若以上方法无效，请重新烧录固件或直接重启模块