KNX 驱动功能设计

KNX 驱动用于接入 KNX 楼宇自动化系统。KNX 是全球领先的开放式楼宇控制标准，广泛应用于照明、遮阳、暖通、安防等场景。一个 KNX 系统由挂在总线上的各类设备（面板、传感器、执行器）组成，通过组地址相互通信。

平台通过 KNXnet/IP Tunneling（隧道模式）经 IP 接口/路由器接入 KNX 总线，订阅组地址报文获取设备状态、向组地址发送报文控制设备。

KNX 的核心寻址机制是组地址，采用 x/y/z 三级格式（如 1/1/3）。它代表的不是某个物理设备，而是一个功能逻辑——多个设备可以收发同一组地址。

例如：组地址 1/1/1 表示「会议室灯光开关」，墙上面板发送这个组地址，灯具执行器订阅它，于是面板一按灯就亮。解耦是 KNX 的精髓：发送方不需要知道谁在接收。

与组地址（功能）相对，物理地址 x.y.z 标识总线上的具体设备（如 1.1.5 表示 1 区 1 线 5 号设备）。用于设备寻址与诊断，一个实例下的 KNXBranch（域/线）配置约束了合法的物理地址范围。

KNX 数据有标准化的数据点类型（Datapoint Type），定义了值的格式与含义。例如 1.001 是开关（bool）、5.001 是百分比（0-100%）、9.001 是温度（°C）。本驱动维护一个 DPT 注册表，决定报文字节如何解析为平台值：

DPT 注册表初始来自 init-file/pointType.txt（约 146 条），并可通过 4 个 API 在线增删改。

KNX 总线上的通信是事件驱动的：当某个设备状态变化（如面板被按下、传感器读数变化），它会向对应组地址发送一个报文（Telegram），总线上的所有订阅者都会收到。平台只需订阅关心的组地址，即可近实时获得变化值。

KNX 工程通常用 ETS（Engineering Tool Software）设计。ETS 可导出组地址列表为 CSV（UTF-16LE 编码）。本驱动的 importPointApi 接收该 CSV，自动解析并批量创建点位。

平台订阅关心的组地址后，当总线对应设备状态变化，报文经 KNX IP 接口推送到平台，KnxClient.parseValue 按 DPT 将报文字节转换为平台值并上报。这是被动接收，无需主动轮询。

平台下发控制（issuePointValueBatch → KnxManager.writeValue）时，KnxPointService.writeKnx 向目标组地址发送报文，总线上的执行器收到后执行动作。值的读写权限由点位的 channelType（如 CR----）中的 R/W 字母决定。

调用路径前缀：POST /driver/api/knx/{mapping}。