简体中文
English
简体中文
日本語

Chain Buzzer ESPHome 组件

Chain Buzzer 是 M5Stack Chain 系列中的一款蜂鸣器输出节点。内置蜂鸣器与可编程 RGB LED,适用于声音提示、状态提醒、智能家居告警等应用场景。

注意
使用 Chain 系列节点时,需要适配的主机进行 UART 通信和控制,比如 Chain Dualkey 主机,或者 Atom 系列主机设备配合 Atomic ToChain Base

1. 组件简介

项目 信息
扩展模块 Chain Buzzer (U224)
主要功能 蜂鸣器开启和关闭
通信接口 Chain Bus / UART
ESPHome 组件 m5_chain_base, m5_chain_buzzer(外部组件)
ESPHome 版本要求 大于 2026.9.0

2. 组件说明

外部组件引入

配置示例

  • 配置主机 UART 引脚 (以 Chain Dualkey 为例)
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
  • 引入外部组件
external_components:
  - source: github://m5stack/esphome@feat-m5-chain
    components: [m5_chain_base, m5_chain_buzzer]
    refresh: 0s
  • 添加 Chain Buzzer
m5_chain_buzzer:
  id: chain_buzzer
  uart_id: chain_uart_right
  chain_index: 1

根据 Chain 的实际位置,给定正确的 index(索引)

  • 添加 Chain Buzzer 的输出
output:
  - platform: m5_chain_buzzer
    id: chain_buzzer_output
    m5_chain_buzzer_id: chain_buzzer
  - platform: m5_chain_buzzer
    id: chain_buzzer_red
    m5_chain_buzzer_id: chain_buzzer
    channel: rgb_red
  - platform: m5_chain_buzzer
    id: chain_buzzer_green
    m5_chain_buzzer_id: chain_buzzer
    channel: rgb_green
  - platform: m5_chain_buzzer
    id: chain_buzzer_blue
    m5_chain_buzzer_id: chain_buzzer
    channel: rgb_blue
  • 添加响铃文本传输语言 (RTTTL)组件
rtttl:
  output: chain_buzzer_output
  id: chain_buzzer_rtttl
  • 添加 Chain Buzzer RGB 灯
light:
  - platform: rgb
    name: Chain Buzzer RGB
    red: chain_buzzer_red
    green: chain_buzzer_green
    blue: chain_buzzer_blue

注意,完成上述实体添加后,Home Assistant 并不能直接操作蜂鸣器,需要添加相应预设脚本和模板按钮:

script:
  - id: chain_buzzer_beep_twice
    then:
      - m5_chain_buzzer.play:
          id: chain_buzzer
          frequency: 2730
          duty: 50
          time: 100ms
      - delay: 150ms
      - m5_chain_buzzer.play:
          id: chain_buzzer
          frequency: 2730
          duty: 50
          time: 100ms

button:
  # Beep once
  - platform: template
    name: "Buzzer Beep"
    icon: "mdi:bullhorn"
    on_press:
      - m5_chain_buzzer.play:
          id: chain_buzzer
          frequency: 2730
          duty: 50
          time: 120ms
  # Beep twice
  - platform: template
    name: "Buzzer Beep Twice"
    icon: "mdi:bullhorn-outline"
    on_press:
      - script.execute: chain_buzzer_beep_twice
  # Long beep
  - platform: template
    name: "Buzzer Beep Long"
    icon: "mdi:volume-high"
    on_press:
      - m5_chain_buzzer.play:
          id: chain_buzzer
          frequency: 2730
          duty: 50
          time: 1s

  # Silence a running melody or a long auto-play beep.
  - platform: template
    name: "Buzzer Stop"
    icon: "mdi:stop"
    on_press:
      - rtttl.stop:
          id: chain_buzzer_rtttl
      - m5_chain_buzzer.play:
          id: chain_buzzer
          frequency: 1000
          duty: 0
          time: 1ms

如果需要按 RTTTL 格式播放内容,可以使用 rtttl.play 动作,比如播放:

button:
  - platform: template
    name: "Ring Tone"
    icon: "mdi:cellphone-sound"
    on_press:
      - rtttl.stop:
          id: chain_buzzer_rtttl
      - rtttl.play:
          id: chain_buzzer_rtttl
          rtttl: "RingTone:d=4,o=5,b=225:8e6,8d6,4f#,4g#,8c#6,8b,4d,4e,8b,8a,4c#,4e,2a"

通过创建模板按钮,结合预设的一些铃声,可以实现在 Home Assistant 前端操作蜂鸣器

3.参考案例

Chain Buzzer 扩展模块接入后,可在设备页面查看对应的 Button、 Light 实体:

Dashboard 卡片案例

Page Tools
PDF
On This Page