43 极物科技 | KNX设备 - Web添加与管理指南

极物科技 | KNX设备 - Web添加与管理指南前言KNX 是全球唯一的开放式楼宇自动化国际标准ISO/IEC 14543-3历经三十余年生态沉淀全球数百家厂商、上万种设备在同一总线上互联互通其双绞线总线与去中心化架构不依赖任何中央节点以“稳定、可靠、快速响应”著称是别墅大宅与商用空间智能控制的首选底座。极物科技是国内少有的拥有 KNX、DALI 全套软硬件自主研发能力的厂商自研 KNX 主机内置双路 DALI配套鸿蒙、苹果、安卓三端原生 APP深度接入 Apple HomeKit 与小度生态更支持主机远程调试与远程 WEB 运维从 ETS 工程 XML 一键导入到 APP 免编程调试让国际标准的强大能力以极简方式落地。一句话概述本文回答XML导入之外如何手工添加和管理KNX设备帮助工程人员补录设备、调整组地址并规范设备命名。本文聚焦于极物主机KNX设备的Web添加与管理涵盖八类设备的手动添加流程、组地址绑定规则、设备列表管理、参数修改与删除操作以及设备命名规范建议。1. 设备模型总览极物主机将总线上的KNX设备抽象为八类设备模型每类模型由若干功能地址组成设备类型功能地址项典型总线设备按键面板按键、事件、背光灯、状态灯总线面板、智能开关面板人体感应传感器触发地址人体红外、存在感应继电器灯具控制地址、状态地址继电器模块、开关模块窗帘电机行程控制/查询/开关、角度控制/查询、停止、升降窗帘驱动器、百叶驱动器环境设备开关/模式/风速/设定温度各含控制查询、环境温度空调网关、地暖温控、新风调光灯亮度控制、开关、状态调光执行器彩色灯RGB/色温控制与状态LED调光调色驱动DALI双色温灯亮度色温经DALI网关DALI DT8 灯具 每台设备由设备名称唯一标识控制报文通过name字段寻址每台设备归属一台KNX网关报文从对应网关收发。2. 手动添加设备2.1 添加流程进入Web管理界面设备管理页选择设备类型页签点击添加设备填写设备名称、选择归属网关按功能项绑定组地址启用设备并保存。2.2 继电器灯具示例配置项值说明设备名称客厅灯全局唯一归属网关knx-gateway-1报文收发通道控制地址1/1/1开关指令写入的组地址状态地址1/1/101状态反馈读取的组地址启用是关闭后设备不参与收发控制与状态的分工控制地址只写不读下发开关指令状态地址只读不写总线设备回读应答。两者分离是KNX工程的标准做法——即使执行器重启主机也能通过状态地址回读恢复真实状态。每台继电器设备在主机内部的模型大致如下脱敏示意/* 继电器灯具的设备模型脱敏示意 */typedefstructrelay_light_s{charname[128];/* 设备名称全局唯一控制报文的寻址依据 */chargateway[128];/* 归属网关报文从哪台网关收发 */uint16_tid;/* 数字ID同类设备内递增 */charenable[8];/* 启用/停用停用后不参与收发 */uint32_tticker;/* 定时器节拍驱动周期状态查询 */uint8_tstatus;/* 缓存的当前状态 */uint16_tga_control;/* 控制组地址只写 */uint16_tga_status;/* 状态组地址只读 */structlist_headlist;/* 挂入全局设备链表 */}relay_light_t; 从这个模型能直观看到两条主线name/id对上对外寻址ga_control/ga_status对上总线上的一对组地址——Web页面上填写的每一项配置最终都落到这几个字段上。2.3 窗帘电机示例窗帘设备的功能地址最丰富功能项说明行程控制写入0~100百分比定位行程查询读取当前行程位置行程开关开/关/停基本控制角度控制百叶叶片角度0~100角度查询读取当前角度停止立即停止运行升降升降启动控制普通帘只需绑定行程类地址百叶帘/香格里拉帘需补齐角度类地址。2.4 环境设备示例空调类环境设备最多可绑定9个功能地址4组控制查询加环境温度查询。支持部分绑定纯空调绑定开关/模式/风速/设定温度全套纯地暖只绑定开关设定温度或模式新风绑定开关风速。主机按实际绑定的功能项生成控制界面未绑定的功能自动隐藏兼容不同暖通设备的差异化能力。3. 设备列表管理3.1 列表功能设备列表页支持查看设备状态在线/离线、当前值修改设备名称与组地址绑定启用/停用设备删除设备。列表查询返回的数据结构示意{frame_driver:gernel_relay_light,frame_type:update,relay_light_list:[{name:客厅灯,id:1,enable:on,status:1,address_s:1/1/1,address_status_s:1/1/101,knx_router_name:knx-gateway-1},{name:客厅-沙发背景-筒灯-01,id:2,enable:on,status:0,address_s:1/1/2,address_status_s:1/1/102,knx_router_name:knx-gateway-1}]}字段与Web页面一一对应address_s是控制组地址、address_status_s是状态组地址、knx_router_name是归属网关——第三方系统也可以直接消费这份列表做设备台账同步。3.2 设备ID机制每台设备在添加时自动分配数字ID该ID在同一类设备内递增且全局唯一。对外接口中面板类设备使用dev_id寻址其余设备使用name寻址。ID在导入XML时按解析顺序重新编排。⚠️注意删除设备后其ID不会立即复用新增设备继续递增编号避免历史控制报文误命中。4. 设备命名规范建议设备名称是控制报文的寻址依据命名质量直接决定工程的可维护性。推荐命名模板[区域]-[位置]-[类型]-[序号] 示例 客厅-沙发背景-筒灯-01 主卧-窗帘-纱帘 二楼-书房-空调命名原则原则说明全局唯一同类设备名称重复会导致报文命中错误设备区域前缀便于列表检索与批量定位面向业主APP界面直接显示该名称使用业主熟悉的语言避免特殊字符不建议使用 #、/ 等与协议解析相关的字符预留扩展同类设备保持序号连续后期增补不冲突5. 设备与场景的关系设备添加完成后即可被场景引用KNX原生场景总线设备自身的场景号由面板/执行器实现主机场景在极物主机上编排多设备动作触发方式包括APP、面板按键、传感器联动、定时等。场景编排与APP免编程调试的完整流程见《极物科技 | KNX场景 - 主机场景与APP免编程调试》。6. 注意事项组地址冲突同一组地址绑定到多台设备时报文会同时分发给所有绑定设备请确保组地址按一址一责规划。状态地址优先凡执行器支持状态反馈的务必绑定状态地址否则主机只能盲发指令无法感知真实状态。删除前解绑场景删除设备前先检查场景引用避免场景中残留失效设备。启停代替删除调试期的临时设备建议停用而非删除保留配置便于恢复。导入与手工并用XML导入会重置设备列表手工补录的设备请在导入后重新检查必要时先导出备份配置。7. 相关文档《极物科技 | KNX智能控制系统 - 快速接入指南》《极物科技 | KNX工程 - ETS导出XML一键导入指南》《极物科技 | KNX继电器模块 - 对接与控制》《极物科技 | KNX窗帘电机 - 行程与角度控制对接》《极物科技 | KNX未知设备 - 自动识别与管理机制》关于极物科技ZEEWO极物科技Zeewo致力于为用户提供智能控制系统及硬件产品。我们以总线系统为技术底座以**“稳定、可靠、快速响应”**为产品底线是国内少有的拥有 KNX、DALI 全套软硬件自主研发能力的厂商之一。我们的核心能力系统架构自研极物 OS支持多协议无界融合KNX/DALI/CAN/RS485/IP。核心硬件带双路 DALI 的 KNX 主机、超薄全金属定制面板、各类智选传感器及网关。生态互联深度融入 Apple HomeKit、Matter、小度、HomeAssistant 及纯血鸿蒙生态。调试交付独家支持 ETS 导出 XML 直接导入进行 APP 免编程调试支持远程 WEB 运维。我们的市场覆盖服务网点已覆盖全国核心城市含长三角、珠三角、成渝等并以高品质的方案深耕家居生活、酒店民宿、企业办公、疗愈康养、餐馆会所等多个细分领域。(如果您在开发或落地中遇到技术问题欢迎通过官网或后台私信与我交流探讨)