逆向哈曼卡顿SoundSticks5 BLE协议，本地接入Home Assistant。含卡片Lovelace，可预设

neqq3

【自定义集成】哈曼卡顿 SoundSticks 5 BLE控制本地接入 Home Assistant


大家好，最近入手了 Harman Kardon SoundSticks 5。


由于 SoundSticks 5 目前没有现成的 Home Assistant 集成，而已有的蓝牙音箱接入方案大多集中在 A2DP 音频播放层面，只能解决“让 HA 播放声音”的问题。对于 SoundSticks 5 本身的灯光、EQ、设备设置等功能，目前没有成熟的本地控制方案。
因此尝试分析官方 App 与音箱之间的 BLE 通信协议，并开发了这个 Home Assistant 自定义集成。
并且还能做到官方APP无法实现的保存预设功能，可以通过自动化调用自己保存的预设。

---

目前支持功能


设备控制

• Home Assistant Bluetooth 自动发现
• BLE 本地连接控制
• 设备状态读取
• RSSI 信号强度
• GATT 连接管理
• 异常重试与状态同步
  

灯光控制

• 灯光开关
• 亮度调节（0-100）
• 多种灯效切换
• 灯效速度调节
• 当前灯效颜色读取
• 灯效颜色重置
  

媒体控制

• 播放 / 暂停
• 上一曲 / 下一曲
• 音量控制
• 歌曲名称、歌手信息读取
  

音效设置

支持七段 EQ：

• 125Hz
• 250Hz
• 500Hz
• 1000Hz
• 2000Hz
• 4000Hz
• 8000Hz
  

支持 EQ 重置。


其他设置

• Feedback Sound 开关
• 自动关闭配置
• 剩余时间读取
• 诊断信息
  

---

配套 Home Assistant Lovelace 卡片


除了集成本身外，本项目还提供了配套的 Lovelace 自定义卡片。


卡片针对 SoundSticks 5 的外观设计进行了适配，可以直接控制：

• 播放控制
• 音量
• 灯效
• EQ
• 设备设置
• 预设场景
  

---

与普通蓝牙音频接入的区别


目前 Home Assistant 已经有不少方式可以接入蓝牙音箱，例如 Bluetooth Speaker、Music Assistant 等。

这些方案主要解决的是：

“如何让 Home Assistant 播放声音”。


而本项目解决的是：

“如何让 Home Assistant 控制 SoundSticks 5”。


区别在于：

• 控制音箱灯光
• 修改 EQ 参数
• 读取设备状态
• 控制官方 App 中的部分设置
• 通过 HA 实现自动化联动
  

---

安装方式


支持 HACS 安装。安装集成时，Lovelace卡片的文件也在其中。


HACS → 集成 → 自定义仓库


需要HA中有可用的蓝牙适配器。

游客，如果您要查看本帖隐藏内容请回复

安装完成后：

1. 重启 Home Assistant

2. 唤醒 SoundSticks 5

3. 在“设置 → 设备与服务”中完成配置

一般来说，蓝牙已经在HA中完成配置的话，会自动发现。直接点击提交即可自动完成接入。



配置完成后，自定义卡片中会自动出现本集成配套的卡片。点击添加即可。

---

已知限制


目前主要测试设备：

• Harman Kardon SoundSticks 5
  

由于不同地区版本、SKU 和固件版本可能存在差异，欢迎其他用户测试反馈。


目前未实现：

• 固件升级
• OTA
• 恢复出厂
• 设备解绑
• 音频流传输
  

---

项目说明


本项目为个人开发的非官方 Home Assistant 集成。


与 Harman Kardon / HARMAN International 不存在授权、合作或商业关系。


协议分析基于官方 App 与设备通信过程，不上传用户数据。


欢迎拥有 SoundSticks 5 的用户测试反馈，一起完善不同固件版本的兼容性。


本项目逆向后的文档和用于复现和测试的代码都已经开源，项目地址在

游客，如果您要查看本帖隐藏内容请回复

sorrypqa

这集成不错，只是音箱的外观和我的审美不符

zuozhehao

这个大佬啊

tanbobo

这集成不错

penguinmm

开拓了思路，回家研究下B&O，感谢楼主！

xujunwei

宝华韦健 飞艇可以DLAN自动发现，但是控制、显示啥都没有

是阿蛋

感谢大佬分享

nuaawmy

谢谢分享

501175635

感谢楼主分享，学习下

Andychao2025

需然我没有这个音箱，特来支持一下