拓展接口
萤火虫T1 有两个 5P-PIN 拓展接口:一个在上方,一个在左侧。接口上的信号脚直连 ESP32-S3 的 GPIO,另有 1 个可由软件开关的 5V 输出脚(PIN1)。上方那个偏重驱动灯光类负载,左侧那个偏重接 I2C / SPI / UART 外设。
上方接口主推灯带、大功率调光;左侧接口主推传感器、模块等外设总线。
PIN1 由 GPIO43 控制的 P-MOS 开关:高阻态关断、低电平导通。电池供电时还要先用 pm 打开 VCC。
中间的 GPIO 直接连到芯片,没有额外驱动电路,电平是 3.3V——别往上怼 5V 信号。
硬件介绍
萤火虫T1 目前的两个拓展接口,一个是 5PIN 接口(上方),另一个是 5PIN 接口(左侧)。
5P-PIN(上)
| 引脚 | 功能 | 控制端口 |
|---|---|---|
| PIN1 | VCC输出(5V) | GPIO43(高阻态关断,低电平接通) |
| PIN2 | GPIO | GPIO14 |
| PIN3 | GND | 直连GND |
| PIN4 | GND | 直连GND(与 PIN3 同一个网络) |
| PIN5 | GPIO | GPIO13 |
说明:
- PIN1 是由一个 P-MOS 管控制的输出端口,给 GPIO43 低电平才会导通并输出 VCC 电压;保持高阻态则关断(
GPIO43的用法见下面的「VCC 输出怎么开」) - PIN3 & PIN4 是连在一起的一个端口,目的是为了加大触点的电流承载能力
- PIN2 & PIN5 是两个直连 MCU 的 GPIO 引脚,主要用来输出控制信号
- PIN5(
GPIO13)就是ws2812模块写死的数据线,灯带插在这里就能直接用 WS2812 炫彩灯(ws2812)
注意:
- VCC 在使用电池供电时,需要通过电源管理(pm)主动的打开“VCC输出”,才有5V输出
- 显示屏面为“正面”,5P-PIN 的顺序为正面“从左往右”

5P-PIN(左侧)
| 引脚 | 功能 | 控制端口 |
|---|---|---|
| PIN1 | VCC输出(5V) | GPIO43(高阻态关断,低电平接通) |
| PIN2 | GND | 直连GND |
| PIN3 | GPIO | GPIO42 |
| PIN4 | GPIO | GPIO15 |
| PIN5 | GPIO | GPIO16 |
说明:
- PIN1 的开关方式和上方接口完全一样,同样是
GPIO43控制的 P-MOS - PIN3-PIN5 是直连 MCU 的 GPIO 引脚,主要用来输出控制信号
注意:
- VCC 在使用电池供电时,需要通过电源管理(pm)主动的打开“VCC输出”,才有5V输出
- 显示屏面为“正面”,5P-PIN 的顺序为正面“从上往下”
VCC 输出怎么开
两个接口的 PIN1 都挂在同一条控制线上:GPIO43。源码和官方 App 都是这样写的——注意必须是 OPEN_DRAIN:
from machine import Pin
vcc_en = Pin(43, Pin.OPEN_DRAIN)
vcc_en.value(1) # 高阻态 → P-MOS 关断,PIN1 没有输出
vcc_en.value(0) # 拉低栅极 → P-MOS 导通,PIN1 输出 5V
value(1)是关断:P-MOS 是高边开关,栅极要靠外部上拉到源极电压才能可靠关断,OPEN_DRAIN的「高阻态」正好是这种状态。这也是开机默认不开 VCC 的原因——怕一上电就把外设全带起来。value(0)才是导通:把栅极拉低,Vgs 变负,P-MOS 打开,PIN1 输出 5V。- 必须用
Pin.OPEN_DRAIN。如果用默认的推挽输出把 3.3V 打到栅极上,P-MOS 关不干净,可能一直有微弱输出。 - 电池供电时还有一道保险:要先通过电源管理(pm)打开「VCC 输出」,否则 PIN1 拿不到 5V。
每个信号脚能做什么
接口上的这些 GPIO 都是普通的 3.3V 数字脚,可以当 GPIO、PWM、软 I2C / 软 SPI / 软 UART 用:
| 位置 | 引脚 | GPIO | 常见用途 |
|---|---|---|---|
| 上方 | PIN2 | 14 | 通用 GPIO / PWM |
| 上方 | PIN5 | 13 | 灯带数据线(ws2812 模块固定用它) |
| 左侧 | PIN3 | 42 | 通用 GPIO / 外设信号 |
| 左侧 | PIN4 | 15 | 通用 GPIO / 外设信号 |
| 左侧 | PIN5 | 16 | 通用 GPIO / 外设信号 |
有一点要留意:固件内部的共享 I2C 已经被占用(运动传感器(imu) 和电源管理(pm) 在用 I2C0,SCL = GPIO1、SDA = GPIO2)。所以你自己接外设时建议用 I2C(1, ...),不要用 I2C(0)。
快速开始
接一条 WS2812 灯带(上方 5PIN)
from machine import Pin
import neopixel
vcc_en = Pin(43, Pin.OPEN_DRAIN)
vcc_en.value(0) # 打开 PIN1 的 5V,给灯带供电
np = neopixel.NeoPixel(Pin(13), 48) # 上方 PIN5 = GPIO13
np[0] = (255, 0, 0)
np.write()
运行现象:灯带第一颗变红。要跑整条灯带的动效,换成 ws2812 模块更合适,见 WS2812 炫彩灯(ws2812)。
接一个 I2C 传感器(左侧 5PIN)
from machine import Pin, I2C
vcc_en = Pin(43, Pin.OPEN_DRAIN)
vcc_en.value(0) # 给传感器供电
i2c = I2C(1, scl=Pin(15), sda=Pin(16), freq=400000) # 左侧 PIN4 / PIN5
print(i2c.scan()) # 打印扫到的从机地址
运行现象:scan() 返回一个地址列表(例如 [0x68])。扫不到就先查接线与供电,SDA / SCL 接反也能扫不到。
常见坑点
| 坑 | 原因与正确做法 |
|---|---|
| 外设插上完全没反应 | PIN1 默认是关断的 → 先 Pin(43, Pin.OPEN_DRAIN).value(0) 打开 5V |
| 电池供电下 PIN1 没有 5V | 还差一步:先用电源管理(pm)打开「VCC 输出」 |
用推挽输出驱动 GPIO43 | P-MOS 关不干净 → 必须 Pin(43, Pin.OPEN_DRAIN) |
| 引脚顺序数反了 | 上方是正面从左往右,左侧是正面从上往下,都以显示屏面为「正面」 |
| 5V 模块的信号线直接接 GPIO | GPIO 是 3.3V 电平,不承受 5V → 5V 器件要么换成 3.3V 版本,要么加电平转换 |
| 大功率负载直接吃 PIN1 | PIN1 是给外设供电用的,大电流负载要考虑接口与线材的载流能力,必要时外接电源 |
| 灯带插上不亮 | 确认插的是上方 PIN5(GPIO13);另外别忘了开 PIN1 供电 |
| 和自己写的 I2C 抢端口 | 固件内部用的是 I2C0(SCL=1 / SDA=2)→ 自己接外设改用 I2C(1, ...) |
排错
| 现象 | 原因 / 处理 |
|---|---|
| 外设完全不上电 | PIN1 没打开;或电池供电时没通过 pm 打开 VCC |
| PIN1 电压只有 3.3V 左右 | P-MOS 没完全导通 → 检查是否用了 OPEN_DRAIN 且 value(0) |
i2c.scan() 扫不到设备 | 没供电、SDA/SCL 接反、或用了被固件占用的 I2C(0) |
| 灯带花屏 / 只亮前几颗 | 数据线太长或没共地;也和光绘功能抢 GPIO13,同一时间只保留一个驱动 |
| GPIO 读出来一直是 0 | 该脚没配成输入,或者被其它功能占用 → 先 Pin(n, Pin.IN) 再读 |
| 外设一插上设备就重启 | 外设电流太大把电源拉垮(PIN1 带不动)→ 给外设单独供电,只共地 |
相关模块见 WS2812 炫彩灯(ws2812)、电源管理(pm) 与 五向按键(button)。
AI 用法(即将上线)
以后你不用自己查引脚、也不用记 P-MOS 的开关极性:用自然语言描述你想接什么外设、想做什么,Agent 会照着本文档里的引脚表,直接生成能在萤火虫T1 上运行的完整程序。
比如直接对它说:
在上方接口接一条 WS2812 灯带,开机后先打开 VCC,再跑一个彩虹效果;左边接口接一个 I2C 温湿度传感器,每秒把读数显示在屏幕上。
它就会把 Pin(43, OPEN_DRAIN)、neopixel / ws2812、I2C 和显示屏接口组合成一个能跑的程序,并帮你放进 SD 卡的 /sd/apps/。
入口链接会放在这里。上线后点一下,就能直接开始描述你想要的应用。