极物科技 | KNX工程 - ETS导出XML一键导入指南
前言
KNX 是全球唯一的开放式楼宇自动化国际标准（ISO/IEC 14543-3），历经三十余年生态沉淀，全球数百家厂商、上万种设备在同一总线上互联互通；其双绞线总线与去中心化架构不依赖任何中央节点，以"稳定、可靠、快速响应"著称，是别墅大宅与商用空间智能控制的首选底座。
极物科技是国内少有的拥有 KNX、DALI 全套软硬件自主研发能力的厂商：自研 KNX 主机内置双路 DALI，配套鸿蒙、苹果、安卓三端原生 APP，深度接入 Apple HomeKit 与小度生态，更支持主机远程调试与远程 WEB 运维；从 ETS 工程 XML 一键导入到 APP 免编程调试，让国际标准的强大能力以极简方式落地。
一句话概述：本文回答"如何把ETS里的KNX工程搬到极物主机"，让组地址规划成果一键转化为可直接控制的设备。
本文聚焦于 极物主机对ETS导出XML的一键导入机制，涵盖ETS导出操作、组地址命名规范、设备自动生成规则、未知设备兜底处理及导入结果校验，是极物APP免编程调试流程的基础。
1. 为什么需要XML一键导入
传统KNX工程的集成路径是：KNX调试工程师在ETS中完成组地址规划 → 集成商在主机侧手工逐条录入设备与组地址 → 联调核对。一个中等规模工程（几百个组地址）的录入核对工作往往耗时数天，且极易出错。
极物主机的做法是把组地址表当作唯一数据源：
text
ETS 组地址规划 ──导出XML──► 极物主机自动解析 ──► 设备模型自动生成 ──► APP直接可用- 组地址怎么规划，主机就怎么生成设备，零手工录入；
- 命名即语义，导入后的设备名称直接继承组地址命名；
- 不认识的组地址进入未知设备列表，数据永不丢失。
2. ETS侧操作：导出组地址XML
在ETS（5.x/6.x均支持）中完成组地址规划后：
- 打开工程，进入组地址视图；
- 顶部菜单选择导出功能（Export Group Addresses）；
- 格式选择 XML，保存文件；
- 得到形如
项目名.xml的导出文件。
导出的XML中每条组地址记录包含两个关键信息：
xml
<GroupAddress Name="客厅面板#BT#1" Address="1/0/1" ... />- Name：组地址名称------极物主机靠它识别设备；
- Address：组地址（主组/中组/子组）------主机靠它收发总线报文。
⚠️ 注意：请导出"组地址"XML而非整个工程备份文件，两者格式不同，主机仅识别组地址导出格式。
3. 组地址命名规范（导入解析的核心）
极物主机的自动解析建立在一套结构化命名规范 上。组地址名称使用 # 分隔为三段：
text
设备名称#类型标识#序号
示例：
客厅面板#BT#1 → 面板设备"客厅面板"的第1个按键
客厅灯#RL → 继电器灯具"客厅灯"的控制地址
主卧窗帘#行程控制 → 窗帘"主卧窗帘"的行程控制地址3.1 类型标识总表
| 类型标识 | 含义 | 生成设备与绑定项 |
|---|---|---|
| BT | 按键 | 面板 → 按键对象 |
| BE | 按键事件 | 面板 → 事件对象 |
| LED-S | 状态灯 | 面板 → 状态灯对象 |
| LED-B | 背光灯 | 面板 → 背光灯对象 |
| RL | 继电器控制 | 继电器灯具 → 控制地址 |
| RL-S | 继电器状态 | 继电器灯具 → 状态地址 |
| 感应器开闭 | 人体感应触发 | 传感器 → 触发地址 |
| 行程控制 | 窗帘行程控制 | 窗帘 → 行程控制地址 |
| 行程查询 | 窗帘行程反馈 | 窗帘 → 行程状态地址 |
| 行程开关 | 窗帘启停开关 | 窗帘 → 开关地址 |
| blind-angle | 百叶角度控制 | 窗帘 → 角度控制地址 |
| blind-angle-status | 百叶角度反馈 | 窗帘 → 角度状态地址 |
| 电机停止 | 停止指令 | 窗帘 → 停止地址 |
| blind-move-updown | 升降控制 | 窗帘 → 升降地址 |
| 环境开关控制 / 环境开关查询 | 开关控制/反馈 | 环境设备 → 开关地址 |
| 环境模式控制 / 环境模式查询 | 模式控制/反馈 | 环境设备 → 模式地址 |
| 环境风速控制 / 环境风速查询 | 风速控制/反馈 | 环境设备 → 风速地址 |
| 环境设定温度控制 / 环境设定温度查询 | 设定温度控制/反馈 | 环境设备 → 设定温度地址 |
| 环境环境温度查询 | 环境温度反馈 | 环境设备 → 环境温度地址 |
| 调光控制 | 亮度控制 | 调光灯 → 亮度控制地址 |
| 调光开关 | 调光开关 | 调光灯 → 开关地址 |
| 调光状态 | 亮度反馈 | 调光灯 → 状态地址 |
3.2 同名聚合规则
同名即同设备：所有名称前缀相同的组地址会聚合到同一台设备上。例如以下四条组地址导入后生成一台完整的面板设备：
text
客厅面板#BT#1 1/0/1 → 按键1
客厅面板#BT#2 1/0/2 → 按键2
客厅面板#LED-B#1 1/0/11 → 背光灯1
客厅面板#LED-S#1 1/0/21 → 状态灯13.3 解析逻辑（示意）
c
/* 组地址名称解析（示意） */
char *seg = strtok(name, "#");
while (seg) { /* 按 # 切成三段 */
...
}
/* 第一段=设备名称, 第二段=类型标识, 第三段=序号 */
if (type == "BT" || type == "BE" || type == "LED-S" || type == "LED-B")
-> 创建/复用面板设备, 绑定对应按键或灯对象
else if (type == "RL" || type == "RL-S")
-> 创建/复用继电器灯具, 绑定控制/状态地址
else if (type == "感应器开闭")
-> 创建传感器设备
else if (type == "行程控制" || ...)
-> 创建/复用窗帘设备, 绑定对应功能地址
...
else
-> 归入未知设备列表4. 主机侧操作：上传与导入
- 进入极物主机Web管理界面KNX功能页；
- 选择目标网关（导入的设备将归属该网关）；
- 上传ETS导出的XML文件；
- 主机后台解析并逐类生成设备，页面显示导入进度；
- 导入完成后进入设备列表核对。
导入过程中主机的内部动作：
- 清空既有设备列表（面板/继电器/传感器/窗帘/环境/调光等全部重建）；
- 各类设备ID计数器归零，按解析顺序重新编号；
- 每台设备自动归属到当前选择的网关并置为启用；
- 传感器设备自动配置默认离场延时（10秒）；
- 全部解析完成后统一落盘保存。
5. 导入结果校验
5.1 核对清单
| 检查项 | 方法 |
|---|---|
| 设备数量 | 各类设备数量应与ETS中同类组地址的设备数一致 |
| 设备名称 | 抽查名称是否与组地址前缀一致 |
| 组地址绑定 | 抽查控制/状态地址与ETS对照 |
| 未知设备 | 检查未知设备列表，确认均为预期外的组地址 |
5.2 典型导入问题与处理
| 现象 | 原因 | 处理 |
|---|---|---|
| 某设备未生成 | 组地址名称缺少 # 分隔 |
在ETS中改名为规范格式后重新导出导入 |
| 设备功能项缺失 | 类型标识拼写错误（如"RL_S"） | 修正类型标识后重导 |
| 设备意外合并 | 两台设备使用了相同名称前缀 | 名称前缀加房间/区域区分 |
| 未知设备过多 | 命名规范未覆盖的类型 | 逐条补录，或在ETS中规范命名 |
| 导入进度停滞 | XML文件超大（数千组地址） | 等待后台解析完成，页面会显示进度状态 |
6. 未知设备兜底机制
所有无法识别的组地址（名称不符合规范、类型未定义等）不会丢弃，而是进入未知设备列表：
- 记录原始名称与组地址；
- 该地址上的总线报文仍会被追踪记录（报文追踪中标记为 unknown 来源）；
- 后续可手工将其补录为正式设备。
这一机制保证了"先导入后规范"的渐进式工作流：即使ETS命名尚不规范，也能先完成接入，再逐步治理。详见《极物科技 | KNX未知设备 - 自动识别与管理机制》。
7. 注意事项
- 导入即重置：每次导入都会重建设备列表，导入前请确认现场设备未被上层系统引用中。
- 网关归属：导入前选对网关；多总线工程建议按总线分别导出、分别导入。
- 命名规范前置 ：最佳实践是在ETS规划阶段就按
名称#类型#序号命名，一次导入全部识别。 - 组地址0/0/0：协议保留地址，导入与运行阶段均不处理，规划时避开。
- 重复导入：XML内容未变化时重复导入结果一致，可放心重试。
- 大工程：数千组地址的工程导入耗时较长属正常现象，导入期间不要断电或刷新页面。
8. 相关文档
- 《极物科技 | KNX智能控制系统 - 快速接入指南》
- 《极物科技 | KNX设备 - Web添加与管理指南》
- 《极物科技 | KNX未知设备 - 自动识别与管理机制》
- 《极物科技 | KNX场景 - 主机场景与APP免编程调试》
- 《极物科技 | KNX工程 - 超大规模组地址优化与性能调优》
关于极物科技（ZEEWO）
极物科技（Zeewo）致力于为用户提供智能控制系统及硬件产品。我们以总线系统为技术底座，以**"稳定、可靠、快速响应"**为产品底线，是国内少有的拥有 KNX、DALI 全套软硬件自主研发能力的厂商之一。
我们的核心能力：
- 系统架构：自研极物 OS，支持多协议无界融合（KNX/DALI/CAN/RS485/IP）。
- 核心硬件：带双路 DALI 的 KNX 主机、超薄全金属定制面板、各类智选传感器及网关。
- 生态互联：深度融入 Apple HomeKit、Matter、小度、HomeAssistant 及纯血鸿蒙生态。
- 调试交付：独家支持 ETS 导出 XML 直接导入进行 APP 免编程调试，支持远程 WEB 运维。
我们的市场覆盖：
服务网点已覆盖全国核心城市（含长三角、珠三角、成渝等），并以高品质的方案深耕家居生活、酒店民宿、企业办公、疗愈康养、餐馆会所等多个细分领域。
(如果您在开发或落地中遇到技术问题，欢迎通过官网或后台私信与我交流探讨)