跳到主要内容

拓展接口

萤火虫T1 有两个 5P-PIN 拓展接口:一个在上方,一个在左侧。接口上的信号脚直连 ESP32-S3 的 GPIO,另有 1 个可由软件开关的 5V 输出脚(PIN1)。上方那个偏重驱动灯光类负载,左侧那个偏重接 I2C / SPI / UART 外设。

两个 5PIN 分工不同

上方接口主推灯带、大功率调光;左侧接口主推传感器、模块等外设总线。

VCC 要自己开

PIN1 由 GPIO43 控制的 P-MOS 开关:高阻态关断、低电平导通。电池供电时还要先用 pm 打开 VCC。

信号脚直连 MCU

中间的 GPIO 直接连到芯片,没有额外驱动电路,电平是 3.3V——别往上怼 5V 信号。

硬件介绍​

萤火虫T1 目前的两个拓展接口,一个是 5PIN 接口(上方),另一个是 5PIN 接口(左侧)。

5P-PIN(上)​

引脚功能控制端口
PIN1VCC输出(5V)GPIO43(高阻态关断,低电平接通)
PIN2GPIOGPIO14
PIN3GND直连GND
PIN4GND直连GND(与 PIN3 同一个网络)
PIN5GPIOGPIO13

说明:

  • PIN1 是由一个 P-MOS 管控制的输出端口,给 GPIO43 低电平才会导通并输出 VCC 电压;保持高阻态则关断(GPIO43 的用法见下面的「VCC 输出怎么开」)
  • PIN3 & PIN4 是连在一起的一个端口,目的是为了加大触点的电流承载能力
  • PIN2 & PIN5 是两个直连 MCU 的 GPIO 引脚,主要用来输出控制信号
  • PIN5(GPIO13)就是 ws2812 模块写死的数据线,灯带插在这里就能直接用 WS2812 炫彩灯(ws2812)

注意:

  • VCC 在使用电池供电时,需要通过电源管理(pm)主动的打开“VCC输出”,才有5V输出
  • 显示屏面为“正面”,5P-PIN 的顺序为正面“从左往右”

萤火虫T1 5P-PIN 拓展接口示意图

5P-PIN(左侧)​

引脚功能控制端口
PIN1VCC输出(5V)GPIO43(高阻态关断,低电平接通)
PIN2GND直连GND
PIN3GPIOGPIO42
PIN4GPIOGPIO15
PIN5GPIOGPIO16

说明:

  • 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常见用途
上方PIN214通用 GPIO / PWM
上方PIN513灯带数据线(ws2812 模块固定用它)
左侧PIN342通用 GPIO / 外设信号
左侧PIN415通用 GPIO / 外设信号
左侧PIN516通用 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 输出」
用推挽输出驱动 GPIO43P-MOS 关不干净 → 必须 Pin(43, Pin.OPEN_DRAIN)
引脚顺序数反了上方是正面从左往右,左侧是正面从上往下,都以显示屏面为「正面」
5V 模块的信号线直接接 GPIOGPIO 是 3.3V 电平,不承受 5V → 5V 器件要么换成 3.3V 版本,要么加电平转换
大功率负载直接吃 PIN1PIN1 是给外设供电用的,大电流负载要考虑接口与线材的载流能力,必要时外接电源
灯带插上不亮确认插的是上方 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/。

Agent 入口(即将上线)

入口链接会放在这里。上线后点一下,就能直接开始描述你想要的应用。