Home Assistant
Home Assistant
Controller & Devices
Cameras
Components
Lighting
Interfaces and Expansion
Applications
Media Playback
Dashboard
Chain Switch ESPHome Component
Chain Switch is a slide switch input node in the M5Stack Chain series, supporting both slider mode and switch mode. The device can output 12-bit slide position data and is equipped with a programmable RGB LED for intuitive status feedback.
Note
To use Chain series nodes, a compatible host is required for UART communication and control, such as the Chain DualKey host, or an Atom series device paired with the Atomic ToChain Base.
1. Component Overview
| Item | Information |
|---|---|
| Expansion module | Chain Switch (U227) |
| Main functions | Provides slide switch input |
| Communication interface | Chain Bus / UART |
| ESPHome components | m5_chain_base, m5_chain_switch (external components) |
| ESPHome version requirement | 2026.9.0 or later |
2. Component Details
Include External Components
Configuration Example
- Configure the host UART pins (using the Chain DualKey as an example)
uart:
- id: chain_uart_right
tx_pin: GPIO6
rx_pin: GPIO5
baud_rate: 115200
- id: chain_uart_left
tx_pin: GPIO47
rx_pin: GPIO48
baud_rate: 115200- Include the external components
external_components:
- source: github://m5stack/esphome@feat-m5-chain
components: [m5_chain_base, m5_chain_switch]
refresh: 0s- Add the Chain Switch
m5_chain_switch:
id: chain_switch
uart_id: chain_uart_right
chain_index: 1
update_interval: 250msNote
Set the correct index according to the actual position of the Chain.
- Add Chain Switch sensors
sensor:
- platform: m5_chain_switch
m5_chain_switch_id: chain_switch
id: chain_switch_adc
name: "Chain Switch ADC"
type: adc_12
- platform: m5_chain_switch
m5_chain_switch_id: chain_switch
name: "Chain Switch ADC 8bit"
type: adc_8
binary_sensor:
- platform: m5_chain_switch
m5_chain_switch_id: chain_switch
name: "Chain Switch Status"- Add the Chain Switch light
output:
- platform: m5_chain_switch
id: chain_switch_red
m5_chain_switch_id: chain_switch
channel: rgb_red
- platform: m5_chain_switch
id: chain_switch_green
m5_chain_switch_id: chain_switch
channel: rgb_green
- platform: m5_chain_switch
id: chain_switch_blue
m5_chain_switch_id: chain_switch
channel: rgb_blue
light:
- platform: rgb
name: "Chain Switch Light"
red: chain_switch_red
green: chain_switch_green
blue: chain_switch_blue3. Reference Example
After the Chain Switch expansion module is connected, you can view the corresponding Sensor and Light entities on the device page:
Dashboard card example
Page Tools