serial-display-module图片显示完全教程用show_pic快速切换屏幕图片ID【免费下载链接】serial-display-module源师兄扩展项目: 串口屏模块 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/serial-display-module源师兄的 serial-display-module 串口屏模块让你通过串口轻松控制外接显示屏实现文字与图片显示。本文以图片显示为核心手把手教你用show_pic函数快速切换屏幕图片 ID只需两个参数、三步积木操作新手也能一次点亮串口屏。一、串口屏模块能做什么serial-display-module 是源师兄生态下的一个扩展模块定位非常清晰通过串口控制显示屏显示图片和文字见模块配置 config.json。它支持两大常用场景功能对应函数用途文字显示show_text在屏幕指定控件位置输出文本图片显示show_pic在屏幕指定控件位置切换图片页面跳转go_to_page控制屏幕跳转到指定页面按键交互get_button_state等读取屏幕按键状态、按压次数整个模块文件结构一目了然serial-display-module/ ├── library/ │ └── screen_extend.py # 核心串口通信库图片/文字/页面/按键 ├── blocksdef.js # 图形化积木块定义 ├── category.json # 积木分类与默认参数 └── config.json # 模块元信息二、show_pic 怎么用两个参数就搞定show_pic的完整实现在核心库 screen_extend.py 中函数签名只有两个参数show_pic(bid, pid)bid控件ID屏幕上图片显示控件的位置编号即图片显示在哪里pid图片ID要显示的图片编号即显示哪张图片 简单理解bid 管位置pid 管内容。把 pid 换成另一个数字图片就瞬间切换这就是快速切换屏幕图片的全部秘密。调用后模块会自动生成如下串口指令代码来自积木代码生成器 blocksdef.jsfrom screen_extend import show_pic from screen_extend import SUART suart_1 SUART(1) suart_1.write(show_pic(1, 1)) # 控件ID1 显示图片ID1三、积木编辑器里 3 步配置图片显示在积木分类串口屏 → 基础中找到端口外接屏幕 | 控件ID → 显示图片ID积木默认参数定义见 category.json第 1 步选择屏幕端口下拉菜单可选 P1、P2、P5、P8、P11P16 或硬串口决定模块通过哪条串口与屏幕通信。第 2 步填写控件 ID输入屏幕设计工具中图片显示控件的 ID 编号。第 3 步填写图片 ID输入目标图片的 ID 编号即可切换显示对应图片。三个参数填齐后串口屏就会按指令刷新出新图片 ✅四、图片 ID 支持多大ID 编码机制详解细心的同学会发现 screen_extend.py 中定义了四组字节表pos_num_1 ~ pos_num_4第 1 组09第 2 组1019第 3 组2029第 4 组3040⚠️ 也就是说bid 和 pid 的有效范围是 040。超出这个范围编号将无法正确编码屏幕也不会响应——这是新手最容易踩的坑之一。五、切换不同屏幕端口SUART 软串口如果屏幕没接在默认串口上可以通过软串口切换。SUART函数定义见 screen_extend.py其tx参数指定发送引脚如SUART(8)表示 8 号脚发送积木下拉菜单中的 P1P16 选项正是对应不同引脚组合按实际接线选择即可。六、常见问题速查FAQ问题现象可能原因解决办法屏幕无任何反应端口选错 / 接线错误确认下拉菜单端口与实际接线一致图片切换不生效bid 与 pid 填反记住bid 是控件位置pid 是图片编号显示空白或错图ID 超出 040 范围回到屏幕设计工具核对控件与图片 ID只切换图片想跳页面用错了函数改用go_to_page跳转页面七、延伸和这些积木配合更好用显示文字show_text积木可在图片旁同步输出说明文本页面跳转go_to_page积木可在 N 秒后跳转到指定页面实现图片轮播效果按键检测get_button_state、get_button_press_num等积木见 screen_extend.py可读取用户触摸操作让图片显示互动起来掌握show_pic(bid, pid)这两个参数你就完成了串口屏图片显示的核心功。配合页面跳转与按键读取一个简单的图文交互小屏就能快速搭建出来 【免费下载链接】serial-display-module源师兄扩展项目: 串口屏模块 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/serial-display-module创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
