企业官网建设流程全解析

源师兄扩展屏图片显示教程：如何用软串口快速输出自定义图像的完整步骤

【免费下载链接】software-serial-module源师兄扩展项目: 软串口模块 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/software-serial-module

💡 一句话说明：本教程带你使用源师兄软串口扩展模块，通过软串口向“源师兄外接扩展屏”发送自定义图像和文字，3 步完成扩展屏图片显示。

本项目是源师兄组织的软串口模块，config.json 中明确它的定位是“通过串口控制显示屏显示图片和文字”。安装后，积木编辑器里会多出一个青色的软串口分组，其中只有两个积木块——“初始化引脚”和“发送”，就足够完成扩展屏的图片显示任务。

软串口模块是什么：先认识这 2 个积木块

模块在 blocksdef.js 中注册了两个积木定义：

底层驱动 library/SoftUART.py 封装了主控板的 SoftUART：接收线固定使用 P0，发送线则对应你在积木里选择的引脚；积木分类与默认参数由 category.json 定义。

硬件连接：扩展屏图片显示前的必要准备

🔌接线 3 步走（扩展屏不显示，十有八九出在接线）：

1. TX/RX 交叉接：主控板软串口 TX 引脚（默认 P8）→ 扩展屏 RX
2. 接收线固定：主控板 P0 固定作为接收引脚，见 library/SoftUART.py 中的rx = Pin(0)
3. 电源共地：主控板与扩展屏 VCC/GND 接好，保证共电源

⚠️ 避坑提示：如果打算发送图片，请确认 TX 引脚没有被蜂鸣器、传感器等其他外设占用，否则屏幕会花屏或不亮。

软件安装：获取并导入软串口模块

1. 在积木编辑器的扩展市场中搜索“软串口”或“扩展屏”，直接导入；
2. 也可以手动克隆源码（适合离线或二次开发）：

git clone https://gitcode.com/yuanshixiong/software-serial-module

导入成功后，左侧积木栏会出现软串口分类，里面就是“初始化引脚”和“发送”两个积木。

快速上手：3 步输出自定义图像到扩展屏

第 1 步：初始化软串口引脚

把“软串口 | 初始化引脚”拖入工作区，在下拉框里选择扩展屏实际接的引脚（按上面接线就选 P8）。

第 2 步：组装图片数据

在初始化积木下方添加“软串口 | 发送”积木：

• 显示图片→ 数据类型选字节串，填入按扩展屏协议整理好的图像字节数据；
• 显示文字→ 选字符串，默认示例就是“你好”。

第 3 步：运行验证

把程序烧录到主控板，扩展屏初始化后收到数据即刻刷新。生成的 Python 核心代码只有寥寥几行：

from SoftUART import * suart_ = SUART(8) suart_.write(image_data.encode("utf-8"))

屏幕上出现你的图像，说明软串口扩展屏图片显示链路已经打通 🎉

图片数据怎么准备：扩展屏显示协议指南

• 字节串（图片）：扩展屏使用固定显示协议，需要先把图片转换成协议规定的字节序列，再通过“软串口 | 发送”积木以字节串形式一次性发出；
• 字符串（文字）：直接填写文字，驱动会自动按 UTF-8 编码再发送（见 blocksdef.js 中的encode("utf-8")）；
• 推荐做法：先发一段短文字验证接线正常，再发完整图片，排查效率直接翻倍。

常见问题排查：屏幕不显示或乱码怎么办

核心文件速查

总结

用源师兄软串口模块做扩展屏图片显示，核心就是三步：初始化引脚 → 准备数据 → 发送。两个积木块就能让主控板持续向外接扩展屏输出自定义图像。下一步，你可以在此基础之上搭建计分板、游戏画面或状态看板等应用。

【免费下载链接】software-serial-module源师兄扩展项目: 软串口模块 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/software-serial-module