故障排除
无法打开 Web Interface
检查设备的 IP 地址：KNX Bridge 的 IP 地址印在设备标签上，也可以在路由器的 DHCP 客户端列表中查到。在浏览器中打开 http://<ip-address>/app/ 试试。
检查网络连接：确保你的电脑与 KNX Bridge 处在同一个本地网络中。如果 Bridge 通过以太网连接，请检查网线和交换机。如果使用 Wi-Fi，请确认 Bridge 已成功连入网络。
重启试试：如果无法访问设备，请重启 KNX Bridge 后再连接。如果问题依旧，请进入安全模式启动。
App 中的 KNX 设备没有反应
检查组地址配置：在 Web Interface 中打开 Group Monitor，然后触发该 KNX 设备。确认出现了报文，并且组地址正确。
检查 KNX 总线连接：Web Interface 的 KNX 页面中应显示物理地址（例如 15.15.255）。如果状态显示为未连接，请检查 Bridge 端子 ④ 上的 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，然后在智能家居 App 中重新开始配对。
各平台的具体步骤请见完整的配对指南。
ETS 项目加载失败（HTTP 503）
Bridge 正在重启或 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 按钮呈灰色。请见固件更新。
检查固件版本：打开 Web Interface，进入 System → About。如果版本低于 2.4.50，请更新到最新的稳定版。房间合并和配件改名的问题已在 2.4.50 中修复。
症状仍在就重新配对：从 Apple Home 中删除 Bridge，然后重新配对。在 2.4.50 及更高版本中，名称和房间会正确恢复。
Apple Home 中 RGBW 灯带没有颜色控制
大多数 LED 灯带驱动器不支持 DT8，即使灯带本身支持 RGBW 也一样。没有 DT8，颜色控制就无法提供给 Matter 或 HomeKit。
请使用支持 DT8 的驱动器，例如 Atios DALI LED Strip Driver（AMD-PWM100）。不支持 DT8 的多通道驱动器（例如 Eldoled 720d）无法通过 Bridge 映射为 RGBW 颜色控制。
暂不支持 RGBWAF：目前只支持 RGBW，琥珀色和白光/琥珀色渐变都不支持。以后的固件可能会加入支持。
颜色格式为 HSV：在 KNX 一侧，HSV 数据点映射到 DALI 的 XY。没有单独的调光地址，亮度包含在 HSV 中。
Web Interface 中的配置更改没有同步到 Apple Home 或 Google Home
Bridge 需要明确保存并重启，才能把更改推送到 Matter 或 HomeKit 控制器。
保存配置：在 Web Interface 中点击 Save Configuration。不做这一步，更改只保存在内存中，下次重启就会丢失。
重启 Bridge：System Settings → Reboot。重启会强制与 Matter 或 HomeKit 控制器重新同步。
重启后问题依旧：检查你最近是否切换过协议（HomeKit ↔ Matter）。切换协议会清除配对，必须先在 Apple Home 或 Google Home 中删除 Bridge 并重新配对，更改才会生效。
获取更多帮助
如果仍需帮助，请联系 info@atios.ch。