IO 扩展板

RGB 灯

../../_images/io_board_rgb1.png

该扩展板集成了 4 颗 WS2812 RGB LED,支持多种自定义控制。用户可以开启或关闭灯效、调节颜色和亮度、切换显示模式,并设定变化速度。

  • 控制 RGB LED 的开关状态,使用 true 开启, false 关闭:

sudo pironman5 -re true
  • 更改颜色,输入目标的十六进制色值,例如 fe1a1a

sudo pironman5 -rc fe1a1a
  • 调整亮度(范围:0 ~ 100%):

sudo pironman5 -rb 100
  • 切换显示模式,可选项包括: solid/breathing/flow/flow_reverse/rainbow/rainbow_reverse/hue_cycle

备注

如果 RGB 模式设置为 rainbowrainbow_reversehue_cycle,将无法使用 sudo pironman5 -rc 设置颜色。

sudo pironman5 -rs breathing
  • 设置变化速度(范围:0 ~ 100%):

sudo pironman5 -rp 80

RGB 控制引脚

RGB LED 由 SPI 驱动,连接至 GPIO10 (SPI 的 MOSI 引脚)。图中两根引脚连接 RGB 到 GPIO10。如不需要此功能,可移除跳线帽。

../../_images/io_board_rgb_pin1.png

RGB OUT 扩展引脚

../../_images/io_board_rgb_out1.png

WS2812 LED 支持串联,可外接 RGB 灯带。将 SIG 引脚连接至灯带的 DIN 引脚即可。

默认配置为 4 个 RGB 灯,如需扩展数量,使用以下命令修改:

sudo pironman5 --rgb-led-count [quantity]

示例:

sudo pironman5 --rgb-led-count 12

OLED 显示屏接口

OLED 显示屏地址为 0x3C。

../../_images/io_board_oled1.png

如果屏幕未正常显示,可尝试以下步骤排查问题:

  1. 确认 OLED 显示屏的 FPC 线缆连接正确。

  2. 查看程序日志检查错误信息:

cat /var/log/pironman5/pironman5.log
  1. 检查 OLED 是否被识别:

sudo i2cdetect -y 1
  1. 如果上述方法无效,可尝试重启 pironman5 服务:

sudo systemctl restart pironman5.service

唤醒触发器

../../_images/io_board_vib.png

板载振动开关用于在 OLED 显示屏处于休眠模式时将其唤醒。检测到振动时,它会发送信号重新激活 OLED,使显示屏在空闲时保持关闭,并在检测到运动时自动唤醒。

如果移除振动开关的跳线帽,唤醒功能将被禁用。一旦 OLED 进入休眠模式,将无法再被唤醒。此选项适用于希望将相应 GPIO 引脚用于其他用途的高级用户。

备注

跳线帽安装:振动唤醒已启用。

跳线帽移除:OLED 关闭后无法唤醒,引脚可释放用于其他用途。

红外接收器

../../_images/io_board_receiver1.png
  • 型号:IRM-56384,工作频率 38KHz

  • 连接:接入 GPIO13

  • D1:接收到红外信号时闪烁

  • J8:用于启用红外功能,默认已插跳线帽。如无需使用 IR,可移除跳线帽释放 GPIO13

要启用红外接收器,请确认连接无误并安装所需模块:

  • 检查设备节点是否存在:

sudo ls /dev |grep lirc
  • 安装 lirc 模块:

sudo apt-get install lirc -y
  • 使用以下命令测试:

mode2 -d /dev/lirc0
  • 按下遥控器任意按键,终端将输出按键的编码信息。

GPIO 风扇引脚

IO 扩展板支持最多连接两颗 5V 非 CPU 风扇,两者统一控制。

J4J5 是两组风扇接口,需要将风扇连接到这里。

../../_images/io_board_fan1.png

两组 2 针风扇连接器及跳线帽默认连接至 GPIO6(风扇)和 GPIO5(风扇灯),支持 GPIO 控制。如果不需要风扇控制功能,可移除跳线帽释放引脚。

../../_images/io_board_fan_j91.png

跳线帽移除后风扇默认关闭。如需风扇开机即转动,可在下方焊盘处加锡桥接,此时风扇将在系统通电时开启、关机时关闭,但不再支持 GPIO 控制。

../../_images/io_board_fan_hanpan.png

例如,若设置为 1: 性能模式,GPIO 风扇将在温度达到 50°C 时启动。

sudo pironman5 -gm 3
  • 4: 安静模式:风扇在 70°C 启动

  • 3: 平衡模式:风扇在 67.5°C 启动

  • 2: 冷却模式:风扇在 60°C 启动

  • 1: 性能模式:风扇在 50°C 启动

  • 0: 始终开启:风扇始终转动

如风扇的控制引脚连接至其他 GPIO 引脚,可使用以下命令重新指定:

sudo pironman5 -gp 18

引脚排针

../../_images/io_board_pin_header1.png

两组直角排针用于拓展树莓派 GPIO,但需注意红外接收器、RGB LED、风扇等占用了部分引脚。可移除相应跳线帽释放引脚。

Pironman 5 MAX

树莓派 5 引脚

红外接收器(可选)

GPIO13

OLED SDA

SDA

OLED SCL

SCL

风扇(可选)

GPIO6

风扇灯(可选)

GPIO5

RGB(可选)

GPIO10