极物科技 | KNX调光灯 - 亮度控制对接前言KNX 生态的强大在于“广”全球数百家厂商的灯具、窗帘、暖通、传感设备都遵循同一套组地址模型即插即用、互联互通。在此基础上极物主机将八类 KNX 设备统一抽象为一套简洁的 UDP 控制接口第三方系统无需了解 KNX 报文细节即可完成对接。本文给出该接口在具体设备上的字段定义、报文示例与工程实施建议。一句话概述本文给出KNX调光灯对接极物主机的完整UDP协议——亮度百分比控制、开关控制与状态上报以及调光/继电器混布工程的编排策略。1. 协议总览项目值传输协议UDP端口2155数据格式JSONUTF-8通信模型主机上报状态update 第三方下发控制requestname寻址数据点亮度为1byte百分比DPT 5.0010~1002. 保活报文每5秒一次{frame_type:keeplive}3. 状态上报报文调光灯状态变化时主机主动推送{frame_type:update,frame_qn:5,frame_driver:gernel_dim_light,driver_data:{action:on,object:dim_light,name:餐厅-吊灯}}字段值说明frame_drivergernel_dim_light调光灯驱动标识固定值driver_data.name字符串灯具名称唯一标识driver_data.actionon/off亮/灭亮度0视为ondriver_data.objectdim_light对象类型固定值4. 控制报文4.1 开关控制{frame_type:request,frame_qn:1,frame_driver:gernel_dim_light,driver_data:{name:餐厅-吊灯,action:on,object:dim_light}}4.2 亮度控制{frame_type:request,frame_qn:2,frame_driver:gernel_dim_light,driver_data:{name:餐厅-吊灯,action:dim,value:60}}action说明value含义on/off开/关恢复记忆亮度—dim调光0~100百分比亮度5. 组地址绑定模型功能项DPT说明开关控制1.0011bit开/关亮度控制5.0010~100开关状态1.001回读亮度状态5.001回读当前亮度只绑开关、不绑亮度的调光执行器也能工作按开关模型控制但要实现APP滑条调光亮度控制地址必绑。6. 渐变调光的实现要点KNX调光执行器一般自带渐变参数在ETS中配置主机侧下发的只是目标值主机下发 value60 ──→ 执行器按自身斜率渐变到60%常见1~3秒工程建议场景渐变时间建议日常开关0.5~1s快而不生硬场景切换2~3s氛围过渡睡眠/唤醒5s以上模拟日出日落应急全关0立即⚠️ 渐变期间状态地址会连续上报多个中间值第三方系统应做节流例如500ms合并一次避免UI滑条抖动。7. 调光与继电器混布工程实际项目常是调光开关混合负载推荐分层策略主灯调光 ── 餐厅-吊灯 value60 筒灯继电器── 餐厅-筒灯 on/off 灯带调光 ── 餐厅-灯带 value40 晚餐场景 吊灯60 筒灯开 灯带40 ← 场景统一编排各设备按自身能力执行不要把调光灯并入继电器统一开关组地址——调光灯失去亮度语义场景表现力归零。8. 常见问题现象排查滑条拖动无反应亮度控制地址未绑定或执行器为开关型亮度到0灯微亮执行器最小亮度设置0DALI驱动常见1%下限在驱动器侧调整状态不回亮度状态地址未绑主机周期Read无响应调光闪烁相位调光器与LED驱动不匹配前沿/后沿切相选错换匹配型号9. 相关文档《极物科技 | KNX继电器模块 - 对接与控制》《极物科技 | KNX彩色灯 - RGB与色温控制对接》《极物科技 | KNX协议 - APCI指令与数据点类型解析》《极物科技 | KNX场景 - 主机场景与APP免编程调试》文档说明与勘误本文示例报文与配置均取自真机联调环境其中设备名称、场景名、个体地址等均为演示数据实际使用时请按工程命名规范替换。文中端口号、报文类型与字段定义以成文时的固件版本为准若与后续版本存在差异请以主机 Web 端「系统配置 — 接口说明」页面展示的内容为准。系列文档之间通过「相关文档」小节互相引用建议按编号顺序阅读先看协议规范再看工程实战。如发现示例报文与现场不一致欢迎在评论区留言指正我们会持续核对并修订本文。本文由极物福州研发团队整理。