返回资讯中心
外部精选
软件工程
#开发者实时流

开发者用蓝牙直连让已停产的 Amazon Echo Button 接入 Home Assistant

来源标题:Amazon Echo Button for Home Assistant

一款自定义集成让亚马逊已停产的 Echo Button 无需 Echo 设备、Alexa 应用或亚马逊账户,直接通过经典蓝牙接入 Home Assistant。它把按钮变成带彩色按压反馈和可控 RGB LED 的开关,支持短按与长按事件触发自动化。使用需 Home Assistant 2026.11 或更新版本,以及支持经典蓝牙的主机适配器。

Hacker News 最新dsquared12026/11/16 · 昨天20 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

让 Amazon Echo Button 重获新生——这款 2017 年推出、已被 Amazon 停产的圆形发光 Alexa 游戏抢答按钮。这个自定义集成把它变成一个带彩色按压反馈的开关,配有可控的 RGB LED,并且能发出短按 / 长按事件供自动化使用。

它通过 Home Assistant 主机的 BlueZ,直接用经典蓝牙(Classic Bluetooth)与按钮通信。整个过程不涉及 Echo、Alexa app 或 Amazon 账号,也不经过云端。

demo.mp4

功能

每个按钮都会提供以下内容:

此外还有一个 echo_button.play_animation 动作,用于自定义灯光动画(颜色、时长、渐变、重复次数)。

<button> 来自按钮的蓝牙名称,例如 EchoBtn2V8 会生成 switch.echobtn2v8_toggle。

Home Assistant 主机上需要有一个经典蓝牙适配器(Bluetooth 2.1 或更新版本,支持 BR/EDR)。Raspberry Pi 4/5 的内置蓝牙、Intel 笔记本/NUC 的适配器,或者现代的 USB dongle 都可以。ESPHome 和 Shelly 的蓝牙代理不行:它们只支持 Bluetooth LE,而 Echo Button 需要经典蓝牙。

Home Assistant 2026.11 或更新版本(开发和测试基于 2026.11.1)。

一个 Echo Button:型号 H5V83Y(以 2 只装出售,也列为 XC56PY)。

安装

HACS(推荐)

在 HACS 中打开 ⋮ 菜单 → Custom repositories。

添加 https://github.com/ddagunts/ha-echo-button,类型选 Integration。

在 HACS 中找到 Amazon Echo Button,下载并重启 Home Assistant。

手动安装

把 custom_components/echo_button 复制到 Home Assistant 的 config/custom_components/ 文件夹(例如通过 Samba share 或 Terminal & SSH 附加组件),然后重启 Home Assistant。

如果按钮已经与某个 Echo 配对,先把这个 Echo 断电;否则它会抢占按钮。你也可以在 Alexa app 中忘记该按钮。

Settings → Devices & services → Add integration → Amazon Echo Button。

按住按钮直到它发出橙色光。这需要 5–20 秒;期间如果出现蓝色或绿色闪烁,要继续按住。然后松开。

选择 Submit。配对大约需要 15–25 秒。

每个按钮重复一次。如果某个按钮之前已与此主机配对过(例如你重置了它之后),集成会删除旧配对并重新配对。

在集成卡片上选择 Configure,设置开/关颜色和反馈时长(默认 2000 ms;设为 0 可关闭反馈)。

按钮每次按下时总会先闪一下自己的短蓝光。这是固件内置的,目前无法更改;反馈颜色会在它之后紧接着出现。

automation:

  • alias: Echo Button toggles the lamp triggers:
  • trigger: state entity_id: switch.echobtn2v8_toggle to: ["on", "off"] actions:
  • action: "light.turn_{{ trigger.to_state.state }}" target: entity_id: light.living_room_lamp

长按时运行场景:

  • alias: Echo Button long press triggers:
  • trigger: state entity_id: event.echobtn2v8_button conditions:
  • condition: state entity_id: event.echobtn2v8_button attribute: event_type state: long_press actions:
  • action: scene.turn_on target: entity_id: scene.good_night

把 LED 用作状态灯(车库门打开时显示琥珀色):

  • alias: Garage open indicator triggers:
  • trigger: state entity_id: cover.garage_door actions:
  • if: "{{ trigger.to_state.state == 'open' }}" then:
  • action: light.turn_on target: { entity_id: light.echobtn2v8_led } data: { rgb_color: [255, 140, 0], brightness: 150 } else:
  • action: light.turn_off target: { entity_id: light.echobtn2v8_led }

门铃响时闪三次红光:

  • alias: Doorbell flash triggers:
  • trigger: state entity_id: binary_sensor.doorbell to: "on" actions:
  • action: echo_button.play_animation target: { entity_id: light.echobtn2v8_led } data: repeat: 3 steps:
  • { color: "#ff0000", duration: 300 }
  • { color: "#000000", duration: 300 }

echo_button.play_animation

字段

说明

steps

1–41 个步骤。每个步骤包含一个颜色([r, g, b] 或 "#rrggbb")、一个以毫秒为单位的时长(1–65535),以及一个可选的 fade: true,表示渐变进入该步骤的颜色。

repeat

序列播放的次数(1–255)。默认 1。

动画结束后,LED 会恢复为 LED 实体的颜色(或关闭)。如果在物理按压之后立即开始渐变,渲染可能出错,因为按钮自身的按压闪光会干扰。按压反馈通过用短的固定颜色步骤构建渐变来避免这个问题。

“未找到处于配对模式的 Echo Button”:按钮必须发出橙色光,而不是闪烁蓝色或绿色。如果它始终不变橙色,取出电池 30 秒,确保附近没有已开机的 Echo,然后再次按住。

配对失败:非常旧的适配器(Bluetooth 2.0,2008 年之前)无法完成按钮所需的“Secure Simple Pairing”。请使用较新的适配器。

连接状态一直不亮:只能有一个主机占用该按钮。确保没有 Echo 或其他电脑连接着它,然后按一下按钮;它会自行重新连接。

调试日志:把以下内容加入 configuration.yaml,并在提交 issue 时附上诊断信息下载(设备页面 → ⋮ → Download diagnostics):

logger: logs: custom_components.echo_button: debug

工作原理

Echo Button(蓝牙名 EchoBtn…,Cypress CYW20735)是一个经典蓝牙设备。它提供串口(RFCOMM 2)、HID,以及 RFCOMM 4 上的 Alexa Gadgets 通道(SDP class 0x1201,外加 Amazon 的 UUID 6088d2b3-983a-4eed-9f94-5ad1256816b7)。按压事件只从通道 4 输出:串口和 HID 通道都保持静默。

这个集成直接连接 RFCOMM 通道 4,不先询问按钮的 SDP 服务器:在突然断开之后(例如适配器被拔掉),按钮可能会长时间拒绝 SDP,而通道 4 仍然可用。一些 Python 构建(包括 Home Assistant 的)缺少 AF_BLUETOOTH socket,因此 socket 是通过 libc 创建的。仍然使用 BlueZ 的 D-Bus API 来查找持有配对信息的适配器,并获知按钮的蓝牙链路何时建立。帧使用 Alexa Gadgets 经典帧格式:

F0 02 00 <seq> <payload, F0/F1/F2 escaped as F2 xx> <checksum hi lo> F1

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →