QuecPython U-235 开发板介绍
支持的模组列表
功能列表
基本概述
QuecPython 铀-235 大屏开发板,集成了现有模组几乎所有功能 ,包含丰富的外设,包括外扩的Flash、WiFi、屏幕等等。
开发板当前以EC600U作为主控模组,搭载Type-C接口,开发者仅需一条USB Type-C 数据线即可轻松玩转开发板。
功能说明
- SD卡:上拉 EC600U 模块的引脚 53,即对应 QuecPython GPIO 27。
- Wi-Fi 模块:将上图中标识为“3”的开关拨到“GND”一侧,通过 Wi-Fi模块串口(上图中标识为“2”)烧录 Wi-Fi模块固件。烧录完成后,将标识为“3”开关拨至“NONE”侧并重启 Wi-Fi模块。若想使用 Wi-Fi 模块与 EC600U 模块进行通信,拉高 EC600U模块的引脚 3,将其从串口 UART 1 切换为 Wi-Fi 串口,并拉高引脚 121,为Wi-Fi 模块供电,之后,Wi-Fi 模块即可与 EC600U 模块进行通信。
- Zigbee:当 EC600U 模块的引脚 PIN3 为低电平时,图中标识“1”指示的串口功能为 UART1,当 PIN3 为高电平时,“1”指示的串口功能变为 Zigbee。
- MIC & SPK:MIC & SPK 拥有左右两个连接器接口,均可供使用。
- 外部供电:将开关拨至“5V”一侧,通过 5V外部供电接口连接外部电源,最大输入电压为 6.5 V。
- 蜂鸣器:拉高或拉低模块引脚 119 控制蜂鸣器发声。
- RS-485:RS-485 接口默认连接物理串口,并使用 UART 2 进行通信。
- MIPI:上拉 EC600U 模块的引脚 118,即对应 QuecPython GPIO 8。
- 音频:使能 PA,上拉 EC600U 模块的引脚 4,即对应 QuecPython GPIO 11。
- 屏幕: ST7701 IPS 5寸 MIPI接口 480x854分辨率 电容触摸屏,触控芯片GT911
备注 : QuecPython 方案下,GPIO 和 EC600U 系列模块引脚对应关系详情请参考控制I/O引脚
资料下载
开发板资源
铀 235 EVB 丰富的板载资源如下图所示:
以下从上图中的“EC600U模块”指示框为开端,顺时针介绍指示框中提到的开发板资源。
- EC600U 模块:为中央处理器;Flash:8 MB;RAM:16 MB。
- MIPI 屏 I/O 接口
- MIPI LED 背光模块
- 扬声器 R:右声道扬声器
- MIC:麦克风接口
- 扬声器 L:左声道扬声器
- 触摸屏 I/O 接口
- 温湿度传感器
- 5V 电源供电
- 电源供电选择开关:用于选择 USB 供电或外接电源供电的开关
- USB:用于程序代码下载和脚本调试的 USB 接口
- SIM 卡槽
- 普通按键:3 个通用按键(无默认功能)
- 蜂鸣器
- PWR 按键:用于开启或关闭 EC600U 模块的开关键
- RST 按键:用于模块复位的按键
- BOOT 按键:用于强制烧录固件的按键
- 摄像头接口:支持拍照和扫描功能
- Flash/MIPI_TE 选择开关:因为 Flash 的 SIO3 与 MIPI_TE引脚冲突,所以若需使用外部 Flash,则必须将开关切换到 SIO3 一侧。大部分的 MIPI 屏幕不使用 MIPI_TE,故该开关通常被切换至SIO3 一侧。
- 扩展 SPI Flash:该 FLASH W25Q32JWUUIQ 的内存为 4 MB。
- LTE 天线座
- Wi-Fi 模块
- WRST 按键:用于复位 Wi-Fi 模块的按键
- 普通按键 KEY1(无默认功能)
- 普通按键 KEY2(无默认功能)
- Wi-Fi 模块串口
- 触摸屏电平选择开关(1.8 V 或 3.3 V)
- 触摸屏接口
- SD 卡槽
- MIPI 屏接口
- RS-485 接口,芯片采用 SP3485EIM/TR
开发板同时开放 MIPI 接口和触摸屏接口以提高复用性。
开发板的更多资料,请访问 https://python.quectel.com/resource-download
快速入门
硬件准备
以下是开发板上手之后的硬件准备步骤
Step1:硬件准备
开始之前需要准备以下配件
- 开发板
- USB 数据线 (USB-A TO USB-TypeC)
- PC (Windows10)
- SIM 卡
- 4G 天线
Step2:天线&SIM卡安装
安装开发板配套的天线,安装位置为LTE天线座位置,并将SIM卡插入开发板上的SIM卡座。
- Step3:开发板连接
使用 USB Type-C 数据线连接开发板的 Type-C 和电脑 USB 口即可完成供电。
- Step4: 开发板开机
开发板上USB和DC的电源选择开关拨到USB处
长按PWRKEY开机,在按下PWRKEY按键之前,需保证供电电压稳定。建议从上电到按下PWRKEY按键之间的时间间隔不少于30 ms。开机后开发板NET灯闪烁,开发板已正常开机。
驱动安装
选择与模组型号匹配的驱动,该开发板搭载的模组有EC600U,以EC600U为例,在下载页面右侧选择该型号的USB驱动QuecPython_USB Driver Win10_U_G点击下载,如果开发板搭载的是其他型号同样按照以上操作即可。
下载后解压驱动压缩包,找到"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结尾,其中EC600U系列模组选择解压后的pac文件
- Step3:设置下载模式
单击“Download script”右侧的下拉选择箭头,选择"Download FW"
- Step4:开始烧录固件
点击"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与模组间的文件传输
下载方法一:

- 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文件页面 执行 按钮执行脚本文件,在工具的文件页面选择要执行的脚本文件然后点击 "▷"按钮
执行结果如图
停止程序运行
如何停止正在运行的程序,根据运行的脚本文件类型有以下方法:
程序名是否为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)若以上方法无效,请重新烧录固件或直接重启模块 |