安卓设备 KNX 使用说明
适用型号 M210A · M330B · M500B 等安卓音箱 固件要求 2026-08-13 及以后 配置工具 米悦 APP 3.3.0 及以上（iOS / Android / 鸿蒙）
安卓音箱与 KNX 的对接分两个方向，在 APP 里各有一个独立入口，互不影响：
| 方向 | 作用 | 配置入口 |
|---|---|---|
| 音箱被控 | KNX 面板控制音箱播放、音量、音源 | 开发者选项 → KNX 配置 |
| 音箱主控 | 音箱屏幕上显示并控制 KNX 灯光、窗帘、空调 | 开发者选项 → KNX 界面配置 |
以前配这些要靠配地址工具走 TCP + FTP 手拷图片，现在全部在手机 APP 上完成。
1. 准备
1.1 进入配置入口
米悦 APP →设置→ 拉到底 →开发者选项。
两个 KNX 入口都在这里。
1.2 先选对设备
APP 的 KNX 页面配置的是当前选中的那台音箱。进配置前先到房间页点一下目标音箱。
「KNX 界面配置」有固件门槛，选到老设备会直接提示：
看到这个提示说明当前选的是老固件设备（如 Linux 的 M100 系列），换一台新固件的安卓音箱即可。 「KNX 配置」没有这个限制，Linux 与安卓固件都能配。
2. 音箱被控 —— KNX 面板控音箱
进入开发者选项 → KNX 配置。
2.1 总开关与接入方式
顶部两项变更后需要重启设备，APP 会引导你重启：
- KNX 启用 —— 总开关
- 接入方式 —— 四选一
| 接入方式 | 说明 |
|---|---|
| KNX 串口板（独立串口） | 走独立串口的 KNX 板 |
| KNX 串口板（复用 485 口） | 与 485 共用物理口 |
| KNXnet/IP 隧道（占网关隧道槽） | 直连 KNX/IP 网关的 3671 端口，会占用网关一个隧道槽 |
| KNXnet/IP Routing（组播，不占槽） | 走组播，不占隧道槽 |
选 KNXnet/IP 时需填网关 IP 与网关端口（留空默认 3671）。
隧道还是 Routing？ 隧道走点对点，稳定但占槽；Routing 走 UDP 组播，不占槽但丢包率略高。 网关隧道槽紧张、或一个项目里有多台音箱时，用 Routing。
2.2 组地址表
填写规则：
- 格式为主/中/子，如
13/0/0 - 留空 = 不启用该功能
- 每个输入框右侧标着该地址的 DPT 数据类型（
1bit/1byte/4bit/14byte） - 组地址改动即时生效，不用重启
出厂默认用 13/0/x 作控制、13/1/x 作状态回报：
| 功能 | 控制地址 | 状态地址 | 类型 |
|---|---|---|---|
| 播放 | 13/0/0 | 13/1/0 | 1 bit |
| 相对音量（调光式） | 13/0/1 | — | 4 bit |
| 音量控制（增/减） | 13/0/2 | — | 1 bit |
| 静音 | 13/0/3 | 13/1/3 | 1 bit |
| 音量 | 13/0/4 | 13/1/4 | 1 byte |
| 曲目切换 | 13/0/5 | — | 1 bit |
| 播放模式 | 13/0/6 | 13/1/6 | 1 byte |
| 从属模式 | 13/0/7 | 13/1/7 | 1 bit |
| SPDIF 开关 | 13/0/8 | 13/1/8 | 1 bit |
| 蓝牙开关 | 13/0/9 | 13/1/9 | 1 bit |
| 曲名 / 歌手 / 专辑 | — | 13/1/10 13/1/11 13/1/12 | 14 byte |
另有分组管理、时间、日期三项，默认留空未启用。
播放模式两侧取值不一样 控制用
0–3，状态回报用1–4，含义也不同。 做双向联动时必须分别映射，不能直接透传。详见 KNX 对接说明。
3. 音箱主控 —— 屏幕上控 KNX 设备
进入开发者选项 → KNX 界面配置。这一页配的是音箱屏幕上显示什么。
分房间和情景两组，拖拽排序 = 音箱屏上的显示顺序。保存后即时生效，无需重启。
3.1 房间与设备
点房间进去管理房内设备：
支持 8 类设备：开关、调光灯、RGB 灯、RGBW 调色灯、窗帘、卷帘、空调、传感器。
房间内拖拽只置换本房间下标位，不会影响其它房间的顺序。
3.2 设备编辑
每个字段都标注了 DPT 数据类型，按固件实际发送的帧型对准：
| 字段类型 | DPT | 长度 |
|---|---|---|
| 开关类（开/关、状态） | DPT 1 | 1 位 |
| 亮度、窗帘位置、模式、风速、场景号 | DPT 5 | 1 字节 |
| 空调设定温度、传感器温度 | DPT 9.001 | 2 字节 |
| 色温、PM2.5、湿度、AQI | DPT 9 | 2 字节浮点 |
colourtemprange不是组地址，是色温的数值范围，填数字不填地址。
地址填写时实时校验 a/b/c 三段范围，格式错了会当场标红。保存前还会做一次全量预校验， 定位到第一处错误；配置非法时设备返回 402，APP 会提示。
未保存就离开会被拦截，不用担心改了一半丢掉。
3.3 情景与背景图
情景可以配按键号和背景图。背景图三种来源：
- 相册 —— APP 自动压到 1280px / q80 再传
- URL —— 填图片地址，由设备自己去拉
- 设备已有图 —— 直接选设备里已经有的
相册和 URL 两种方式都由设备端主动下载并做 md5 校验，不经过手工拷贝。
3.4 配置结果
配完之后，音箱屏幕上就是这个样子 ——
情景页（对应上面配的情景名、背景图与顺序）：
家庭页（对应配的房间与设备）：
4. 常见问题
保存后设备没反应
先看改的是哪一类：
- 总开关 / 接入方式 —— 需要重启设备，APP 会提示
- 组地址 / 网关地址 —— 即时生效，无需重启
- 界面配置（房间/设备/情景） —— 即时生效，无需重启
KNX 配置页报错
早期固件存在一个已修复的问题：部分不支持的动作会把 401 错误劣化成 500， 导致 APP 的"固件不支持"降级失效、页面直接报错。 升级到 2026-08-13 之后的固件即可。
连不上 KNX 网关
按顺序排查：
- 接入方式选错 —— 用串口板却选了 KNXnet/IP，或反之
- 网关 IP / 端口填错 —— 默认端口是
3671 - 隧道槽被占满 —— 换成 Routing 模式试试
- 组播被网络设备拦截 —— Routing 模式下检查交换机是否开了 IGMP snooping 且未配置正确
多台音箱互相干扰
Routing 模式下，若不指定个体地址，设备会按本机 IP 派生一个，避免多台共址互丢帧。 项目里有多台音箱时，建议在网关侧为每台分配独立的 KNX 个体地址。