【免费下载链接】EchoMuseAlexa replacement and controller for Echo Dot 2nd Generation device.项目地址https://gitcode.com/gh_mirrors/ec/EchoMuse点击查看免费下载EchoMuse 是一个把二手Echo Dot 2 代改造成 Home Assistant 本地语音助手的开源项目没有 Alexa、没有亚马逊云你的话术全程留在局域网内。那么躺在你书架上的 Dot 和运行在电脑里的控制器到底是怎么说话的答案藏在三条 WebSocket 通道和一套Capability能力协商协议里——本文带你用大白话看懂 EchoMuse 的设备与控制器通信机制。一、先认识对话双方设备端与控制器端EchoMuse 由两个独立部署的组件组成见 CLAUDE.md角色位置职责设备端device/运行在被改造的 Echo Dot 上采集麦克风、播放声音、驱动 LED 灯环与按键、本地唤醒词打分控制器端controller/运行在你的服务器 / Home Assistant 插件中管理设备、唤醒词检测、与 Assist 语音管线对接、提供 Web 仪表盘控制器并不主动找上门。设备启动后通过mDNS 广播服务名_emcontroller._tcp.local发现控制器然后由设备主动拨出三条 WebSocket 连接。这三条通道各司其职互不越权。二、三条 WebSocket 通道各走各的车道完整契约见 docs/device-controller-interface.md。三个平面plane的职责如下通道路径载荷格式方向用途/controlJSON 文本双向注册握手、LED 控制、麦克风开停、按键事件、配置下发、WiFi 管理/data二进制双向麦克风 PCM 上行扬声器与音乐 PCM 下行/shell/{device_id}原始二进制按需拨出Root shell 代理仅在控制器下发shell_open指令后才打开打个比方/control是指挥调度频道说人话的 JSON/data是音频专用管道跑 PCM 裸数据追求低延迟/shell则是维修通道平时锁着门管理员要修东西才开门。三个细节值得注意心跳保活控制器每 20 秒发送一次 WebSocket ping若 30 秒内没有 pong 应答就断开重连。按需才开/shell平面在控制器明确要求前不会建立避免不必要的攻击面。双协议并存三条通道都有明文ws://和加密wss://TLS两种形态配合后文的令牌认证。/data通道上的二进制帧首字节就是帧类型号。有意思的是帧号按方向命名空间隔离——0x04在两个方向上含义完全不同这是刻意设计源码注释见 device/internal/client/data.go方向帧号含义控制器 → 设备0x02/0x03语音 PCM 数据块 / 语音流结束控制器 → 设备0x04/0x05音乐 PCM 数据块 / 音乐流结束仅当设备声明了audio_mix设备 → 控制器0x01麦克风 PCM 块16 kHz 单声道设备 → 控制器0x07私有监听会话音频仅当控制器声明了listen_session三、注册握手设备如何自报家门/control通道一建立设备立刻发送一条register消息——这是整场对话的开场白构造逻辑见 device/internal/client/control.go。简化后的长这样{ type: register, device_id: 稳定设备标识, version: v2.18.0, capabilities: [mic, speaker, leds, oww_trigger, ...], board: biscuit, base_os: emos, pairing: true }其中capabilities数组就是协商的核心信号设备逐条列出自己实现了哪些功能。固件里这个列表由capabilities()函数统一产出device/internal/client/control.go代表性能力包括Capability含义通俗版mic/speaker能上行麦克风流 / 能播放扬声器音频led_anim能按一份动画规格在本地渲染 LED 灯效而非逐帧接收oww_shadow能在本地给唤醒词打分并只报告oww_trigger能基于本地唤醒检测采取行动与上一项刻意分开下文细说audio_mix能把音乐放在独立音频平面、混在语音下方压低播放而非暂停oww_local_only能私有监听唤醒词未命中前一个字节都不上传ambient_light仅当环境光传感器真实可读时才声明条件能力pairing主人长按按键 5 秒时能主动发起配对请求控制器收到注册后回一条ack表示登记通过。注意ack里还带着一个features数组——那是控制器自己的能力清单协商是双向的这一点后面单独讲。四、为什么用 Capability 协商而不是比版本号这是 EchoMuse 兼容性设计的灵魂。设备固件、控制器、emOS 三方独立发版现实中必然出现新固件配老控制器或反向的组合。如果靠比对版本号决定功能开关控制器就得内置整个发版历史而且一遇到开发者构建版就失灵。于是项目立下两条铁律均由 controller/tests/test_capabilities.py 用测试钉死按能力协商不按版本协商。控制器读取Device.capabilities逐项功能做开关。仪表盘上设备不具备的能力对应的控件会显示为禁用并说明原因绝不会变成一个点了没反应的哑按钮。退化到旧行为绝不退化成错误答案。双方都忽略未知的 JSON 字段和未知消息类型新字段缺失时存NULL 而不是 0——一台测不了的设备绝不能被显示成测出来是零。两个最能说明为什么要拆细的例子oww_shadow与oww_trigger是两条能力不是同一条。早期固件只发布了打分上报shadow没有据此起动会话的代码。若控制器把会打分误当成会触发就会放弃自己的唤醒检测、坐等一个永远不会来的触发——表现为一台打分满分却永远不应答的神秘故障。ambient_light是条件能力。只有硬件上真有可读的传感器才上报一个永远出不了数据的传感器实体比没有实体更糟。而控制器端如何消费这些字符串每个能力对应Device类上的一个属性门property gate例如led_anim_capable、audio_mix_capablecontroller/em_controller.py。项目还有一条防呆机制控制器检查的每个字符串必须都是设备能发出来的反之亦然——任何一边的拼写错误都会让功能静默失效测试会直接抓出双向错拼。五、双向协商ack里的features与配置下发协商不止设备报、控制器听。ack消息携带的features当前包括ble_adverts_data、listen_session、output_chain、ble_connect是控制器的能力清单读法和设备清单完全一样缺什么就是控制器做不了什么。为什么必须双向一个真实教训BLE 广播数据从/control平面迁移到了/data平面的0x06帧后老控制器看不懂新帧会静默丢弃两端都没有报错——所有广播就这样无声消失了。凡是迁移消息就必须靠双方各自声明能力来对齐新增消息则可以不管。协商之后就是日常运维配置下发config push。控制器在连接建立时和每次配置变更时推送config消息字段采用 camelCase遵循部分更新语义——非零/非 nil 字段生效零/nil 字段忽略所以false和未设置靠指针类型区分。所有改动即时生效无需重启设备。可下发的键涵盖 VAD 阈值、唤醒词模型、AEC/AGC、EQ 均衡、LED 场景、限幅器、barge-in打断参数等几十个完整清单见 docs/device-controller-interface.md 的 Config push 一节。六、安全层TLS 与X-EM-Token令牌三条通道在安全上有统一规则详见 docs/device-controller-interface.md 的 Link auth TLS每次拨号都从设备凭证文件重新读取并携带X-EM-Token请求头——推送新凭证后下一次重连自动生效无需重启。持有 CA 证书的设备只走wss://TLS服务器身份固定为 DNS 名echomuse-controller永不使用 IP控制器换地址也不受影响。判定逻辑在em_linkauth.decidecontroller/em_linkauth.py令牌错误一律拒绝已存令牌的凭证却未出示只在首次出示前的窗口内放行凭证推送本身就走这条通道之后拒绝。/data和/shell只能来自该设备当前/control连接的同一地址与同一协议等于把三条通道绑成一个整体。七、核心要点回顾设计点一句话总结三条通道JSON 指挥/control、二进制音频/data、按需 shell/shell各走各的车道能力协商设备用capabilities数组自报功能控制器按字符串逐项开关绝不比版本号双向对齐ack.features是控制器的能力清单消息迁移必须双方都声明才能切换优雅退化未知字段忽略、缺失存 NULL、缺能力的控件禁用并说明原因安全兜底TLS X-EM-Token全覆盖凭证重连即生效/data//shell绑定控制面地址测试钉契约controller/tests/test_capabilities.py 双向校验能力字符串杜绝静默错拼想继续深挖推荐按这条路线阅读协议全文 docs/device-controller-interface.md → 监听与隐私模型 docs/listening.md → 语音全链路 docs/voice-pipeline.md → 仪表盘前端 controller/static/dashboard.jsx 与 Web API controller/em_api.py。理解了这个设备 ↔ 控制器接口契约你就掌握了 EchoMuse 扩展到 Echo Show 8 等新硬件的全部钥匙。赞分享【免费下载链接】EchoMuseAlexa replacement and controller for Echo Dot 2nd Generation device.项目地址https://gitcode.com/gh_mirrors/ec/EchoMuse点击查看免费下载相关推荐Universe 内部通信协议全解析VNC 像素通道与 Rewarder WebSocket 控制通道Universe 内部通信协议全解析VNC 像素通道与 Rewarder WebSocket 控制通道 Universe 是一套用于在大量游戏、网站等真实应用人工智能强化学习AI AgentWebSocket子协议终极指南如何实现自定义协议处理和协商机制WebSocket子协议终极指南如何实现自定义协议处理和协商机制 WebSocket技术作为实时通信的基石为Web应用提供了全双工通信能力。而子协议Sub后端通信OpenClaw Gateway 架构深度解析WebSocket 控制平面、握手协议与设备配对OpenClaw Gateway 架构深度解析WebSocket 控制平面、握手协议与设备配对 本文基于仓库文档 architecture.md https:人工智能大模型LLM 网关AI Agent即时通讯创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考