眼动模块串口接线指南：P1/P2/P8/P12/P15/P16引脚怎么选？软硬串口一文讲清
【免费下载链接】eye-tracking-module源师兄扩展项目: 眼动模块 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/eye-tracking-module
眼动模块（eye-tracking-module）是源师兄组织出品的经典扩展模块：它通过串口通信控制小圆屏上的眼睛状态——眨眼、看向上下左右、清屏变色，效果生动又有趣。这篇文章是一份完整的眼动模块串口接线指南，帮你讲清 P1、P2、P8、P12、P15、P16 六个引脚到底怎么选，以及软件串口和硬件串口的区别，让新手也能一次接线成功。
一、为什么接眼动模块要先看串口引脚？
眼动模块本体没有"程序"，它只负责把屏幕上的眼睛画出来；真正发指令的是你的开发板。两者之间靠的是UART 串口（一条 TX 发送线 + 一条 RX 接收线）：
- 开发板 → 眼动模块：告诉它"眨眼""向右看"
- 眼动模块 → 开发板：（可选）反馈状态
模块说明见 config.json："通过串口控制眼动模块的眼睛状态"。所以接线的第一步，就是确定开发板用哪个引脚当 TX/RX。
二、软件串口 vs 硬件串口：哪个更快？
这是新手最容易懵的地方，其实一句话就能分清：
| 对比项 | 硬件串口（UART2） | 软件串口（SoftUART） |
|---|---|---|
| 速度 | ⚡ 快，由硬件芯片完成 | 靠 CPU 模拟，速度慢一些 |
| 引脚 | 固定（UART2 专用脚） | ✅ 灵活，P1/P2/P8/P12/P15/P16 都能用 |
| CPU 占用 | 低，稳定不丢数据 | 高，程序复杂时可能丢字节 |
| 适合场景 | 追求稳定、指令多 | 硬件串口被占用，或想自由走线 |
在 library/CircularScreenExtend.py 中，SUART(tx)函数封装了两种模式：
- 传入引脚号（如
SUART(15)）→ 自动创建软件串口，其中接收脚固定为Pin(0)，你传入的引脚作为发送脚 - 传入
"None"→ 使用硬件串口 UART(2)，速度最快、最稳
💡选择口诀：能用硬件串口就用硬件串口；走线方便、或引脚冲突时用软件串口。
三、P1/P2/P8/P12/P15/P16 六个引脚怎么选？
在积木块编辑器里，"眼动模块"下拉菜单恰好提供这 6 个选项，定义见 blocksdef.js。它们的区别其实很简单：
这 6 个引脚在积木模式下都是软件串口，功能完全等价，选哪个取决于你把线接到了哪里。
| 引脚 | 模式 | 选择建议 |
|---|---|---|
| P1 / P2 | 软件串口 | 靠板边，走线短，推荐优先尝试 |
| P8 / P12 | 软件串口 | 中部引脚，避开冲突时使用 |
| P15 / P16 | 软件串口 | 靠板边，适合模块放在板子另一侧时 |
三步接线法（最快配置方法）
- 接电源：将眼动模块的 VCC 与 GND 接到开发板对应的电源引脚（按模块规格书确认电压）。
- 交叉接线：开发板的TX → 模块的 RX，模块的TX → 开发板的 RX。软件串口下，开发板侧接收脚对应代码中的
Pin(0)。 - 选中相同引脚：积木块里的引脚下拉项，必须和你实际接的 TX 引脚一致（比如线接在 P15，就选 P15）。
四、积木编辑器里怎么操作？
拖出"眼动模块"积木后，你会看到两个下拉框（见 category.json 中的块定义）：
- 引脚下拉框：P1 / P2 / P8 / P12 / P15 / P16 —— 选择你实际接线的 TX 引脚
- 状态下拉框：
- 🎨 屏幕块：清屏、白色、红色、蓝色、绿色、黄色、橙色
- 👁️ 眼睛块：眼睛、眨眼、向上看、向下看、向左看、向右看、左下看、右下看
积木底层会调用 library/CircularScreenExtend.py 中的clear_screen_command（清屏变色）和show_pic_command（显示眼睛图片）等函数，通过串口把指令帧（含校验和）发给模块。
五、眼动模块接线常见坑
❌模块没反应、屏幕不亮
- 引脚下拉框选的和你实际接的 TX 不一致（最常见！）
- TX / RX 没交叉，接成了直连
- 电源或地线没接好
❌眼睛闪烁、指令时灵时不灵
- 软件串口被复杂程序"拖慢"，丢字节了 → 改用硬件串口（代码中用
SUART("None")）或简化主循环 - 线太长、接触不良 → 缩短杜邦线
❌接完直接烧坏？
- 先接信号线、后通电；通电顺序和电压等级务必对照模块规格书检查
六、总结
- 眼动模块靠UART 串口收指令，接线核心就三件事：电源、交叉信号线、引脚选择一致
- 积木模式下的 P1/P2/P8/P12/P15/P16 均为软件串口，功能等价，按走线方便选
- 追求稳定高速 → 代码里用硬件串口 UART2
- 选错引脚是"没反应"的头号原因，对线再运行！
按照这份眼动模块串口接线指南操作，你的小眼睛很快就能眨起来 👀
【免费下载链接】eye-tracking-module源师兄扩展项目: 眼动模块 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/eye-tracking-module
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
