如何快速上手眼动模块：从OpenBlock接线到第一次眨眼的5分钟教程
【免费下载链接】eye-tracking-module源师兄扩展项目: 眼动模块 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/eye-tracking-module
本教程帮助新手在 5 分钟内快速上手源师兄眼动模块：通过串口把模块接入源师兄主控，再在 OpenBlock 里拖拽几个积木，就能让屏幕上的小眼睛眨眼、转动、变色，全程不需要写复杂代码。
眼动模块是什么？能做什么
眼动模块的官方定位很直白：通过串口控制眼动模块的眼睛状态（见 config.json）。它是一块圆形小屏幕，通过 UART 串口接收指令，在屏幕上显示眼睛的各种状态。
在积木库里，该扩展提供两个核心积木（分类结构见 category.json）：
- 🎨屏幕颜色积木：设置圆形屏底色，可选清屏、白色、红色、蓝色、绿色、黄色、橙色
- 👀眼睛状态积木：显示 8 种眼睛姿态——眼睛、眨眼、向上看、向下看、向左看、向右看、左下看、右下看
两个积木都可以选择串口引脚，支持 P1、P2、P8、P12、P15、P16，方便按你的实际接线灵活选择。
眼动模块接线方法：用串口连上主控
眼动模块通过UART 串口与主控通信，接线只需记住两点：
- 将模块的 TX/RX 与主控 GPIO交叉连接（TX 对 RX）
- 在积木下拉框中选择对应引脚；若使用默认硬件串口，保持默认即可
底层连接逻辑封装在 library/CircularScreenExtend.py：默认使用板载硬件串口，指定引脚时会自动创建软件串口，新手无需关心实现细节。
OpenBlock 三步编程：完成第一次眨眼
在 OpenBlock 中打开「眼动模块」积木分类（积木与代码生成逻辑定义于 blocksdef.js），三步即可出效果：
- 清屏打底：拖入屏幕颜色积木，选择「清屏」或任意底色
- 选择眨眼：拖入眼睛状态积木，选择「眨眼」
- 运行程序：屏幕上的小眼睛会依次播放睁眼、闭眼、睁眼的帧动画
眨眼效果由 CircularScreenExtend.py 中的eye_blink函数实现——按每帧 200ms 的节奏连播 8 帧，形成自然眨眼的观感。
进阶玩法：8 种眼神 + 7 种底色
除了眨眼，还可以把积木自由拼接，做出更有性格的小角色：
| 场景 | 积木组合 |
|---|---|
| 呆萌注视 | 清屏（黑）+ 眼睛 |
| 转头看人 | 向左看 → 向右看 |
| 害羞眨眼 | 清屏（橙色）+ 眨眼 |
| 思考中 | 向上看 + 清屏（白色） |
配合循环积木，还能做出「盯着你看 3 秒后眨一次眼」之类的动效。
项目文件速查
想深入了解仓库内容，可以查看这些文件：
- README.md — 项目简介：源师兄扩展项目·眼动模块
- config.json — 模块注册信息（设备名、描述）
- category.json — 积木分类与顺序
- blocksdef.js — 两个积木的定义及 Python 代码生成规则
- library/CircularScreenExtend.py — 串口指令驱动：清屏、显示图片、显示文字、眨眼动画
常见问题快速排查
- 屏幕不亮：优先检查 TX/RX 是否交叉接反，再核对积木中选定的引脚与实际接线是否一致
- 切换状态无反应：每条串口指令发送后需要约 50ms，指令之间建议加短暂延时
- 引脚被占用：可选用软件串口，把模块接到 P1、P2、P8、P12、P15、P16 等任意空闲引脚
跟着这篇 5 分钟教程，从零开始接线、拖积木，你的屏幕上很快就能出现一只会眨眼睛的小眼睛。熟练后逐步尝试 8 种眼神与 7 种底色，就能创作出更多有趣的小角色程序。
【免费下载链接】eye-tracking-module源师兄扩展项目: 眼动模块 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/eye-tracking-module
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
