Lutron 智能网桥:灯光与窗帘控制
Lutron Smart Bridges: Light and Shade Control
**最近验证:** 2026-09-14,在 Lutron Smart Bridge 2(固件 8.28.0,非 Pro 版)上验证
当新的发现(discovery)识别出带 HomeKit/HAP 的 Lutron 智能网桥,且用户要求控制灯光或窗帘时,使用本指南。
**Last verified:** 2026-09-14 on a Lutron Smart Bridge 2 (firmware 8.28.0, non-Pro)
Use this guide when fresh discovery identifies a Lutron Smart Bridge with
HomeKit/HAP and the user asks to control lights or shades.
1. 重新发现网桥,经 Home Link CONNECT 代理使用其广播的 HAP 端点。不要假设有 LIP/telnet 或网页访问。
2. 使用有维护的 HAP 客户端。如果发现结果广播了 `ff=1`,选择 `PairSetupWithAuth`;普通的 `PairSetup` 可能在 M2 阶段以 `kTLVError_Authentication` 失败。把整个配对(pair-setup)交换保持在一条持久的代理 TCP 连接上。
3. 配对(pairing)需要八位 HomeKit 设置码。通过经批准的凭据存储持久化配对材料;如果是文件存储,要求权限模式为 `0600`。
4. 控制时,经代理打开加密的 HAP 会话,枚举配件,读写特征值(characteristic)。失败的批量写入按设备重试。
5. HAP 可能暴露的是通用设备名,而非 Lutron 应用中的房间名。如果用户想要房间映射,逐个开关设备来识别。
1. Re-discover the bridge and use its advertised HAP endpoint through the Home
Link CONNECT proxy. Do not assume LIP/telnet or web access.
2. Use a maintained HAP client. If discovery advertises `ff=1`, select
`PairSetupWithAuth`; plain `PairSetup` can fail at M2 with
`kTLVError_Authentication`. Keep the entire pair-setup exchange on one
persistent proxied TCP connection.
3. Pairing requires the eight-digit HomeKit setup code. Persist pairing material
through approved credential storage; if file-backed, require mode `0600`.
4. For control, open an encrypted HAP session through the proxy, enumerate
accessories, and read or write characteristics. Retry failed batch writes per
device.
5. HAP may expose generic device names instead of Lutron app room names. If the
user wants room mapping, identify devices one at a time by toggling them.