故障排除
无法访问 Web Interface
检查设备 IP 地址：KNX Bridge 的 IP 地址显示在设备标签上，也可在路由器的 DHCP 客户端列表中查到。尝试在浏览器中打开 http://<ip-address>/app/。
检查网络连通性：确保您的电脑与 KNX Bridge 处于同一本地网络。如果桥接器通过 Ethernet 连接，请检查网线和交换机。如果使用 Wi-Fi，请确认桥接器已成功加入网络。
尝试重启：如果设备无法访问，请重启 KNX Bridge 后重新连接。如果问题持续，请进入 安全模式。
应用中 KNX 设备无响应
核对组地址配置：在 Web Interface 中打开 Group Monitor，触发 KNX 设备。确认有报文出现，且组地址正确。
检查 KNX 总线连接：在 Web Interface 的 KNX 部分，应显示物理地址（例如 15.15.255）。如果状态显示已断开，请检查桥接器接线端子 ④ 上的 KNX TP 总线接线。
检查 ETS 编程：如果您导入了 ETS 项目，请确认 Accessory Manager 中的组地址与 ETS 项目中的一致。必要时重新导入 .knxproj 文件。
Matter 或 HomeKit 配对失败
确认当前启用的生态系统：KNX Bridge 同一时间只能运行一种模式，即 Apple HomeKit 或 Matter。请前往 System Settings 确认当前启用的是哪一个，配对前先禁用另一个。
使用正确的配对代码：HomeKit 配对代码显示在 System Settings → Apple HomeKit。对于 Matter，请使用启用 Matter 后显示的二维码。
移除后重新配对：如果之前的配对卡住，请在 System Settings 中点击 Remove Pairing，再从智能家居应用重新开始配对流程。
各平台具体说明请前往完整的 配对指南。
ETS 项目加载失败（HTTP 503）
当桥接器正在重启或 ETS 项目仍在处理时，会出现此错误。请等待 30 秒，刷新页面，再重新尝试导入。如果问题持续，请通过 System Settings → Restart 重启设备后重试。
DALI 总线显示为已断开
请检查 DALI 电源是否已连接并通电。如果使用 KNX Bridge 的内置 DALI 电源，请在 System Settings → DALI 中启用 DALI 电源选项。
没有可用的固件更新
如果固件更新按钮变灰或显示锁定信息，您的设备可能被安装商锁定在特定固件版本。请联系 info@atios.ch 申请解锁。
固件更新后 Apple Home 出现问题
症状包括设备显示为 “Matter Accessory 1, 2, 3...” 而非原名、所有房间合并为一个、大部分配件消失，或升级后 Matter 二维码消失。
固件安装后完整等待 2 分钟：在确认窗口关闭前重启会让固件回退到上一个版本。在等待期间，Reset Button 处于变灰状态。请前往 固件更新。
检查您的固件版本：打开 Web Interface，前往 System → About。如果低于 2.4.50，请更新至最新稳定版。房间合并和配件改名的问题已在 2.4.50 修复。
症状持续则重新配对：从 Apple Home 中移除桥接器，然后重新配对。在 2.4.50 及以上版本中，名称和房间会正确恢复。
Apple Home 中 RGBW 灯带没有颜色控制
大多数 LED 灯带驱动器不支持 DT8，即便灯带本身支持 RGBW 也是如此。没有 DT8，颜色控制就无法暴露给 Matter 或 HomeKit。
使用支持 DT8 的驱动器：经验证可用的型号包括 Sunricher SRP-2309。非 DT8 的多通道驱动器（例如 Eldoled 720d）无法通过桥接器映射到 RGBW 颜色控制。
暂不支持 RGBWAF：仅支持 RGBW（不含琥珀色、不含白色与琥珀色之间的渐变）。后续固件可能会增加相关支持。
颜色格式为 HSV：在 KNX 侧，HSV 数据点映射到 DALI 上的 XY。没有单独的调光地址，亮度已包含在 HSV 中。
Web Interface 中的配置变更未在 Apple Home 或 Google Home 中生效
桥接器需要明确保存并重启，才能将变更推送到 Matter 或 HomeKit 控制器。
保存配置：在 Web Interface 中点击 Save Configuration。如不执行此步骤，您的更改只会保存在内存中，下次重启会丢失。
重启桥接器：System Settings → Reboot。重启会强制与 Matter 或 HomeKit 控制器重新同步。
重启后问题仍然存在：请检查您是否最近切换过协议（HomeKit ↔ Matter）。切换会清除配对，必须在 Apple Home 或 Google Home 中移除并重新配对桥接器，变更才会生效。
获取更多帮助
如果您仍然需要帮助，请联系 info@atios.ch。