草稿
入门
从启动到在家庭 App 里看到 KNX 设备。
运行环境
KMBridge 为全静态单文件程序，直接运行于 ARMv5 与 ARM64 Linux 设备，无外部系统库依赖。安装包见下载。
启动
knx-matter-bridge --data-path /var/lib/knx-bridge
配置与授权都放在数据目录里（standalone.db 与 future.key）。网页端口缺省为 8080，可以用 --web-port 指定。
首次登录
在同一网络的电脑或手机上打开 http://kmbridge.local:8080。同一网络里有多台时，登录页列出全部，点一台即可换过去。打不开时见开始配置，或在路由器的设备列表里找到网桥的 IP，访问 http://<网桥地址>:8080。
网桥在别的网段时：同一台交换机上、网段不同的网桥会直接出现在列表里，并注明电脑要加哪个网段的地址；隔着路由器或 VLAN 的按 IP 访问，网络管理员放行 UDP 5620（网桥的发现报文）的组播或广播转发后也能列出。
首次进入需初始化管理员账号（密码至少 8 位），并同意使用条款。
联网（可选）
「系统 → 网络」中的“允许访问互联网”总开关出厂默认关闭。关闭状态下，KNX、Matter、HomeKit 与本地网页完全在局域网内运行。在线激活、检查更新、远程访问与 AI 服务须开启该开关；数据传输明细参见隐私政策。
激活授权（可选）
未激活时以社区版运行：最多支持 40 台设备，不包含生态原生桥接、AI 助手、ETS 工程导入、高级自动化及远程运维功能。
- 在线激活：在「系统 → 授权」输入购买时收到的激活码。
- 离线激活：设备无法联网时，选择「无法联网？离线激活」生成离线激活请求包，提交至技术支持获取授权码；网关全程无需连接外网。
连接 KNX
在「KNX」页的「连接」里选择连接方式（UDP 隧道、TCP 隧道或组播路由），填写 KNX IP 接口的地址。原生直连需要专用硬件。
添加设备
三种方式任选：
- 在「设备」页导入 ETS 工程（需要授权）；
- 手动添加；
- 先在「KNX → 勘探」里扫描总线，再按读出的设备与接线添加。
如需评估功能，可在「设备」页导入预置演示设备。
加入家庭 App
- Matter：在「Matter」页打开配对窗口，然后在 Apple 家庭、Google Home 等 App 中添加 Matter 设备，扫描二维码或输入配对码。
- HomeKit：打开 iPhone / iPad 的家庭 App，点「添加配件」，扫描二维码或手动输入配对码。HomeKit 需要 Plus 或 Pro Max 授权。
保持更新
在「系统 → 维护 → 固件升级」检查更新或上传升级包。若新版本启动异常，系统将自动回滚至历史版本。