极物科技 | KNX智能控制系统 - 快速接入指南
前言
KNX 是全球唯一的开放式楼宇自动化国际标准（ISO/IEC 14543-3），历经三十余年生态沉淀，全球数百家厂商、上万种设备在同一总线上互联互通；其双绞线总线与去中心化架构不依赖任何中央节点，以"稳定、可靠、快速响应"著称，是别墅大宅与商用空间智能控制的首选底座。
极物科技是国内少有的拥有 KNX、DALI 全套软硬件自主研发能力的厂商：自研 KNX 主机内置双路 DALI，配套鸿蒙、苹果、安卓三端原生 APP，深度接入 Apple HomeKit 与小度生态，更支持主机远程调试与远程 WEB 运维；从 ETS 工程 XML 一键导入到 APP 免编程调试，让国际标准的强大能力以极简方式落地。
一句话概述：本文回答"如何把一套KNX工程接入极物主机"，帮助渠道商用最短的路径完成网关对接、工程导入与设备控制。
本文聚焦于 极物主机对KNX智能控制系统的快速接入，涵盖方案架构、网关开启、ETS工程XML一键导入、设备自动生成、对外控制接口总览及基础功能演示，是KNX系列文档的入口篇。
1. 方案概述
KNX是国际上广泛应用的开放式楼宇自动化标准（ISO/IEC 14543-3），覆盖灯光、遮阳、暖通、安防等几乎全部楼宇控制场景。传统KNX工程的调试高度依赖ETS软件，交付门槛高、周期长。
极物主机的KNX接入方案围绕"降低交付门槛"设计，核心能力包括：
- KNXnet/IP 标准对接：支持与主流KNXnet/IP网关、IP路由器、以及开源knxd总线守护进程对接，隧道（Tunneling）与组播（Routing）双通道并存；
- ETS工程一键导入：ETS导出XML后直接导入，组地址自动解析，设备模型自动生成，无需逐个手工录入；
- 八类设备模型：按键面板、人体感应传感器、继电器灯具、窗帘电机、环境设备（空调/地暖/新风）、调光灯、彩色灯、DALI双色温灯具；
- 双场景引擎：既支持KNX原生场景值，也支持极物主机场景，APP免编程调试；
- 报文追踪：接收/发送双向链路全量记录，Web端可视化排查。
技术特点：
| 特性 | 说明 |
|---|---|
| 总线协议 | KNX TP1 / KNXnet/IP（ISO/IEC 14543-3） |
| 对接通道 | KNXnet/IP Tunneling（隧道）+ Multicast Routing（组播） |
| 工程导入 | ETS 导出 XML，一键导入自动生成设备 |
| 设备类型 | 面板 / 传感器 / 继电器 / 窗帘 / 环境 / 调光 / 彩色灯 / DALI |
| 对外接口 | UDP + JSON，按设备类型分端口 |
| 场景能力 | KNX场景 + 主机场景双引擎 |
| 调试能力 | 报文追踪、个体地址过滤、远程WEB运维 |
2. 系统架构
text
┌──────────┐ KNXnet/IP ┌─────────────┐ UDP/JSON ┌──────────┐
│ KNX 总线 │◄─────────────►│ 极物主机 │◄────────────►│ 控制端 │
│ 面板/模块 │ 隧道+组播 │ KNX驱动 │ 8个业务端口 │ APP/网关 │
└──────────┘ └─────────────┘ └──────────┘- 总线侧：极物主机通过KNXnet/IP与总线上的网关通讯，既能作为隧道客户端收发报文，也能加入组播路由通道，双通道互为补充；
- 主机侧：KNX驱动将总线报文解析为设备模型，再通过UDP JSON接口对上层控制端（APP、第三方网关）开放；
- 数据流：总线报文 → 组地址分发 → 设备模型更新 → 状态上报；控制指令 → 设备模型 → 组地址写入 → 总线报文。
💡 极物主机是国内少有的同时具备KNX、DALI全套软硬件自主研发能力的产品，KNX驱动与DALI驱动可同时运行，实现双总线融合（详见系列后续文档）。
3. 第一步：开启KNX网关功能
进入极物主机Web管理界面，在KNX功能页开启网关：
- 进入"KNX网关"配置页；
- 新增一条网关记录，填写名称、网关IP地址与端口（默认3671）；
- 将网关状态切换为"启用"；
- 保存后观察连接状态，显示"在线"即对接成功。
⚠️ 注意：网关IP必须与主机在同一局域网且可路由互通；启用后主机会自动建立隧道并周期保活，无需人工干预。详细的连接管理与故障排查见《极物科技 | KNX网关 - KNXnet/IP路由器对接配置》。
对接对象选型：
| 对接对象 | 说明 |
|---|---|
| KNXnet/IP 网关（IP Interface/Router） | 主流商用方案，ETS调试与主机接入可并存 |
| 开源 knxd 总线守护进程 | 自建方案，灵活可控，配合NCN5120等收发器直接挂TP1总线 |
| IP线路直达 | 仅组播模式，适合纯IP骨干的KNX工程 |
4. 第二步：导入ETS工程XML
这是极物方案的独门优势------ETS导出什么，主机就生成什么：
- 在ETS中完成组地址规划与命名；
- 菜单选择导出组地址XML文件；
- 在极物主机Web界面上传该XML；
- 主机自动解析组地址，按命名规则生成设备模型；
- 导入完成后核对设备列表。
组地址命名约定（导入解析的核心规则）：
text
设备名称#类型#序号
示例：客厅面板#BT#1、客厅灯#RL、主卧窗帘#行程控制常用类型标识：
| 类型标识 | 含义 | 生成设备 |
|---|---|---|
| BT / BE | 按键 / 按键事件 | 按键面板 |
| LED-S / LED-B | 状态灯 / 背光灯 | 按键面板 |
| RL / RL-S | 继电器控制 / 状态 | 继电器灯具 |
| 感应器开闭 | 人体感应触发 | 人体感应传感器 |
| 行程控制 / 行程查询 / 行程开关 | 窗帘行程 | 窗帘电机 |
| blind-angle / blind-angle-status | 百叶角度 | 窗帘电机 |
| 环境开关控制 / 环境模式控制 等 | 空调/地暖/新风 | 环境设备 |
| 调光控制 / 调光开关 / 调光状态 | 亮度 | 调光灯 |
⚠️ 注意：不满足命名规则的组地址会自动归入"未知设备"列表，不会丢失，可后续手工补录。详见《极物科技 | KNX工程 - ETS导出XML一键导入指南》。
5. 第三步：核对设备列表
导入完成后，在Web设备管理页核对各类设备：
- 每类设备按导入顺序自动分配ID；
- 设备名称取自组地址命名，全局唯一；
- 支持在此界面手工添加、修改、删除设备，以及绑定/调整组地址。
6. 第四步：基础控制演示
设备导入完成后，即可通过UDP JSON接口控制。极物主机按设备类型开放8个业务端口：
| 端口 | 设备类型 | 说明 |
|---|---|---|
| 2150 | 按键面板 | 按键事件上报、LED控制 |
| 2151 | 人体感应 | 触发/恢复事件上报 |
| 2152 | 继电器灯具 | 开关控制与状态上报 |
| 2153 | 窗帘电机 | 行程/角度/停止控制 |
| 2154 | 环境设备 | 空调/地暖/新风控制 |
| 2155 | 调光灯 | 亮度控制与上报 |
| 2156 | 场景 | 场景触发执行 |
| 2157 | DALI双色温灯 | 亮度+色温控制（DALI×KNX融合） |
报文通用格式：
json
{
"frame_type": "request",
"frame_qn": 1,
"frame_driver": "gernel_relay_light",
"driver_data": {
"name": "客厅灯",
"action": "on",
"object": "relay_light"
}
}| 字段 | 说明 |
|---|---|
| frame_type | request（控制下发）/ update（状态上报）/ keeplive（保活） |
| frame_qn | 报文序列号 |
| frame_driver | 驱动标识，与设备类型对应 |
| driver_data | 业务数据体，按设备类型定义字段 |
快速上手示例------打开客厅灯：
- 控制端向主机2152端口发送上述request报文；
- 主机解析后将"开"值写入"客厅灯"绑定的组地址；
- 总线上出现一条1bit写入报文，继电器吸合，灯亮；
- 状态变化经组地址回读后，主机向控制端推送update报文。
保活机制：控制端需每隔5秒向业务端口发送一次保活报文，主机据此维护客户端在线状态：
json
{
"frame_type": "keeplive"
}7. 注意事项
- 网关网络：确保主机与KNX网关在同一局域网，且3671端口未被防火墙拦截；组播模式需放行 224.0.23.12。
- 组地址0/0/0：该地址为协议保留地址，主机不处理绑定到0/0/0的任何报文，规划组地址时应避开。
- 设备命名唯一：同一类设备的名称必须唯一，名称是控制报文寻址的唯一依据（name字段匹配）。
- XML导入时机：导入会重建设备列表，请在工程稳定后操作；重复导入前建议先核对未知设备列表。
- 双通道并存：隧道与组播通道可同时开启，主机自动去重，不会重复处理同一条总线报文。
- 调试建议：首次联调时开启报文追踪功能，所有收发报文可在Web端逐条核对，详见《极物科技 | KNX报文追踪 - 功能总览与使用指南》。
8. 相关文档
- 《极物科技 | KNX网关 - KNXnet/IP路由器对接配置》
- 《极物科技 | KNX工程 - ETS导出XML一键导入指南》
- 《极物科技 | KNX设备 - Web添加与管理指南》
- 《极物科技 | KNX场景 - 主机场景与APP免编程调试》
- 《极物科技 | KNX智能控制系统 - 完全指南（系列总结）》
关于极物科技（ZEEWO）
极物科技（Zeewo）致力于为用户提供智能控制系统及硬件产品。我们以总线系统为技术底座，以**"稳定、可靠、快速响应"**为产品底线，是国内少有的拥有 KNX、DALI 全套软硬件自主研发能力的厂商之一。
我们的核心能力：
- 系统架构：自研极物 OS，支持多协议无界融合（KNX/DALI/CAN/RS485/IP）。
- 核心硬件：带双路 DALI 的 KNX 主机、超薄全金属定制面板、各类智选传感器及网关。
- 生态互联：深度融入 Apple HomeKit、Matter、小度、HomeAssistant 及纯血鸿蒙生态。
- 调试交付：独家支持 ETS 导出 XML 直接导入进行 APP 免编程调试，支持远程 WEB 运维。
我们的市场覆盖：
服务网点已覆盖全国核心城市（含长三角、珠三角、成渝等），并以高品质的方案深耕家居生活、酒店民宿、企业办公、疗愈康养、餐馆会所等多个细分领域。
(如果您在开发或落地中遇到技术问题，欢迎通过官网或后台私信与我交流探讨)