Home Assistant
Home Assistant
主控与整机
扩展模块
灯光控制
Chain DualKey ESPHome 集成
本页面介绍 Chain DualKey 主控在 ESPHome 中使用的基础组件，包括 Chain Bus、双键输入、侧边开关、电源控制和按键 RGB 灯。Chain 扩展模块的驱动配置请参考 Chain 系列 ESPHome 组件。
1. 设备简介
| 项目 | 信息 |
|---|---|
| 产品名称 | Chain DualKey |
| SKU | C147 |
| 主要功能 | Chain 扩展总线主控、双键输入和 RGB 灯控制 |
| 通信接口 | UART、ADC、GPIO |
| ESPHome 组件 | uart、adc、binary_sensor.gpio、output.gpio、light.esp32_rmt_led_strip、light.partition |
| ESPHome 版本要求 | / |
2. 组件说明
Chain Bus
左右两侧的 Chain 接口分别使用独立 UART。扩展模块的 uart_id 需要与实际连接方向一致，chain_id 从靠近 DualKey 的模块开始递增。
uart:
- id: chain_uart_right
tx_pin: GPIO6
rx_pin: GPIO5
baud_rate: 115200
- id: chain_uart_left
tx_pin: GPIO48
rx_pin: GPIO47
baud_rate: 115200按键与侧边开关
两个机械按键使用 GPIO Binary Sensor，GPIO0 和 GPIO17 为低电平有效；侧边开关使用 GPIO7 和 GPIO8。
binary_sensor:
- platform: gpio
name: "KEY 1"
pin:
number: GPIO0
inverted: true
mode: INPUT_PULLUP
- platform: gpio
name: "KEY 2"
pin:
number: GPIO17
inverted: true
mode: INPUT_PULLUP
- platform: gpio
name: "SWITCH 1"
pin: GPIO7
- platform: gpio
name: "SWITCH 2"
pin: GPIO8RGB LED 供电
GPIO40 控制两个按键 RGB LED 的供电。使用灯光组件时，应保持该引脚为高电平：
switch:
- platform: gpio
id: key_light_power
pin: GPIO40
internal: true
restore_mode: ALWAYS_ON按键 RGB 灯
DualKey 的两个按键灯连接到 GPIO21。使用 partition 将灯带拆分为两个独立的 Light 实体。
light:
- platform: esp32_rmt_led_strip
id: key_light_raw
internal: true
pin: GPIO21
num_leds: 2
chipset: WS2812
rgb_order: GRB
restore_mode: ALWAYS_OFF
- platform: partition
name: "Key Light 1"
id: key_light_1
segments:
- id: key_light_raw
from: 0
to: 0
- platform: partition
name: "Key Light 2"
id: key_light_2
segments:
- id: key_light_raw
from: 1
to: 1电池与总线状态
DualKey 的电池、VBUS 和充电状态可使用 ADC 组件读取。ADC 引脚和衰减参数应按硬件版本配置。
sensor:
- platform: adc
pin: GPIO10
name: "ADC Battery"
update_interval: 1s
- platform: adc
pin: GPIO2
name: "ADC VBUS"
update_interval: 1s
- platform: adc
pin: GPIO9
name: "ADC Charge"
update_interval: 1s3. 参考案例
4. 相关链接
Page Tools