极物科技 | KNX场景 - 主机场景与APP免编程调试
前言
KNX 是全球唯一的开放式楼宇自动化国际标准（ISO/IEC 14543-3），历经三十余年生态沉淀，全球数百家厂商、上万种设备在同一总线上互联互通；其双绞线总线与去中心化架构不依赖任何中央节点，以"稳定、可靠、快速响应"著称，是别墅大宅与商用空间智能控制的首选底座。
极物科技是国内少有的拥有 KNX、DALI 全套软硬件自主研发能力的厂商：自研 KNX 主机内置双路 DALI，配套鸿蒙、苹果、安卓三端原生 APP，深度接入 Apple HomeKit 与小度生态，更支持主机远程调试与远程 WEB 运维；从 ETS 工程 XML 一键导入到 APP 免编程调试，让国际标准的强大能力以极简方式落地。
一句话概述：本文回答"KNX系统的场景到底在哪里做、怎么做才最省事"，给出"总线原生场景 + 主机场景"双引擎架构与APP免编程调试的完整打法。
本文聚焦于 极物主机KNX场景体系与APP免编程调试，涵盖双场景引擎架构、场景值触发机制、组地址绑定规则、防抖处理，以及面板触发主机场景的完整数据流。
1. 双场景引擎架构
KNX工程的场景控制存在两条实现路径，极物主机两条都支持，并让它们互相打通：
| 引擎 | 执行位置 | 编辑方式 | 适用场景 |
|---|---|---|---|
| KNX原生场景 | 总线执行器内部 | ETS编程，场景号下发 | 单一执行器的高速本地场景 |
| 主机场景 | 极物主机 | APP/Web免编程编排 | 跨设备、跨协议的联动场景 |
选型建议：
- 涉及单房间多路灯光的"一键全开/全关"，用原生场景即可，响应最快；
- 涉及灯光+窗帘+空调+音乐的跨系统联动，交给主机场景；
- 两者可以共存：主机场景的一个动作项，本身就可以是"触发某KNX原生场景"。
2. KNX原生场景的工作方式
原生场景由执行器固件实现。ETS工程中为执行器配置场景号（1~64），主机只需向场景组地址写入场景号，执行器内部完成多通道输出切换：
text
主机 → 组地址 1/2/10 写入 5（场景号）
→ 窗帘执行器：调用场景5 → 行程30%、角度50%
→ 调光执行器：调用场景5 → 亮度60%原生场景的优点是不依赖主机------即使主机离线，总线上任何面板按下场景键，执行器照常执行。缺点是修改场景内容必须回ETS重新编程。
3. 主机场景：场景值触发机制
3.1 核心概念
主机场景由三要素定义：
| 要素 | 说明 |
|---|---|
| 场景名称 | 唯一标识，APP与接口均按名称寻址 |
| 触发组地址 | 绑定一个KNX组地址，作为场景的"按钮" |
| 激活值（value） | 1~64，写入该组地址的值等于激活值时触发场景 |
关键设计：一个组地址可以挂多个场景（用不同激活值区分），一个场景也可以被多个组地址引用。这相当于把KNX的"组地址+值"组合变成了可自由扩展的"虚拟按键"。
3.2 触发匹配逻辑
主机收到总线报文后，按"组地址 + 值"双重匹配场景，核心判断逻辑（示意）：
c
// 遍历主机场景链表，比对组地址与激活值
list_for_each_entry_safe(pos, npos, &sence_master_list, list) {
if (pos->group_address == da) { // 组地址命中
if (apci == A_GroupValue_Write) { // 只响应写入，忽略读/应答
// KNX场景值从0开始，主机场景激活值从1开始，需+1对齐
if (pos->value == (value + 1)) {
if (now - pos->last_time > debounce_timer) {
sence_master_activate(pos->name); // 激活场景
pos->last_time = now;
}
}
}
}
}两个值得注意的细节：
- 值对齐规则 ：KNX DPT_Scene编号从0开始，主机场景激活值从1开始，匹配时统一 +1。工程师在ETS里把面板按键配成"发送场景号 N"，主机侧把场景激活值配成 N+1 即可对接。
- 只认写入：读报文和应答报文不触发场景，避免总线状态回读误触发。
3.3 防抖设计
同一条场景报文在总线上可能因重发、多面板连按而短时间重复到达。主机为每个场景记录最近触发时间，在防抖窗口（默认可配）内的重复报文直接丢弃，并在报文追踪中标记"未响应"，超窗后才真正激活。
这解决了工程现场最常见的"按一下面板，场景执行了两遍"问题。
4. 场景激活的下行链路
主机场景被触发后，动作如何执行？主机将场景激活请求转换为JSON指令发送给场景执行服务：
json
{
"method": "sence_by_name",
"check": "",
"user": "admin",
"object": "smart",
"params": {
"name": "回家模式",
"cmd": "active"
}
}场景执行服务按场景编排表依次（或并行）下发动作，动作目标可以是：
- KNX设备（开关/调光/窗帘/暖通）；
- DALI设备（经DALI网关）；
- 其他协议设备（CAN/RS485/IP设备）；
- 另一个KNX原生场景（场景嵌套）。
整条链路 ：面板按键 → 总线报文（组地址+场景值）→ 主机场景匹配（防抖）→ 场景执行服务 → 多协议设备动作。
5. APP免编程调试流程
传统KNX场景调试需要工程师携带笔记本回ETS修改程序；极物主机支持APP端免编程调试，现场闭环：
- 导入工程：ETS导出XML导入主机，设备与组地址自动生成（见《KNX工程 - ETS导出XML一键导入指南》）；
- 创建场景：APP场景页新建场景，命名（如"观影模式"）；
- 编排动作：从设备列表勾选设备并设定目标值------灯光亮度、窗帘行程、空调模式温度等，全部图形化操作；
- 绑定触发：为场景指定触发组地址与激活值，或直接绑定APP/面板/传感器/定时触发；
- 现场试跑：APP一键执行场景，观察各设备动作是否正确；
- 微调即生效：动作值、顺序、触发方式随时修改，无需回ETS。
调试效率对比：
| 环节 | ETS编程模式 | APP免编程模式 |
|---|---|---|
| 修改一个场景亮度 | 回ETS→改参数→下载 | APP点选，秒级生效 |
| 新增联动场景 | ETS重新编程 | APP新建即用 |
| 交付后业主自助调整 | 不可能 | 支持权限分级 |
6. 典型配置示例
需求：客厅面板长按键，触发"观影模式"------主灯调至20%、窗帘关闭、空调24℃制冷。
| 配置项 | 值 |
|---|---|
| ETS面板配置 | 按键发送场景号 3 到组地址 1/2/10 |
| 主机场景名称 | 观影模式 |
| 触发组地址 | 1/2/10 |
| 激活值 | 4（= 场景号3 + 1） |
| 动作1 | 客厅主灯 → 亮度20% |
| 动作2 | 客厅窗帘 → 行程0% |
| 动作3 | 客厅空调 → 制冷/24℃ |
面板按下后，报文追踪中可看到：RX 1/2/10 观影模式 场景触发 → 控制主机场景:响应，随后三台设备的TX报文依次出现。报文追踪的完整用法见《KNX报文追踪 - 总线监控与问题定位》。
用总线抓包视角看这条链路，报文序列如下（示意）：
text
① 面板按键（ETS配置：场景号3 → 组地址1/2/10）
RX 06 10 05 30 ... 29 00 B4 E0 11 0A 00 01 00 02
└ KNXnet/IP Routing Ind
└ CEMI：目的地址=1/2/10，APCI=Write，数据=0x02
（DPT场景值从0起编：面板发"场景号3" → 总线数据=3-1=0x02）
主机匹配：激活值4 == 总线值2+1 ✓ → 防抖通过 → 激活"观影模式"
② 场景动作依次下发
TX 1/1/5 1byte 0x14 客厅主灯 → 亮度20%
TX 1/3/1 1byte 0x00 客厅窗帘 → 行程0%（全关）
TX 1/4/2 1byte 0x01 客厅空调 → 模式=制冷
TX 1/4/4 2byte 0x00 0x98 客厅空调 → 设定24℃（DPT 9.001编码）
③ 状态回读（约2秒后）
RX 1/1/101 1bit 1 主灯状态=开
RX 1/3/101 1byte 0x00 窗帘状态=全关调试时对照这份序列逐条核对，缺哪帧就查哪一段------①缺是面板/ETS配置问题，②缺是场景编排问题，③缺是状态地址绑定问题。
7. 注意事项
- 激活值偏移：务必记住"主机激活值 = ETS场景号 + 1"，这是最常见的对接失误点。
- 读/应答不触发 ：调试时若场景不动作，先确认面板发送的是写入报文而非读取。
- 防抖窗口：连按无响应属于正常防抖，若现场确需快速连发，可在系统参数中调小防抖时间。
- 同名冲突：场景名称全局唯一，重名会导致接口命中错误场景。
- 原生场景优先：单一执行器内部的高速场景留在ETS做，跨系统联动才上主机场景，各取所长。
8. 相关文档
- 《极物科技 | KNX智能控制系统 - 快速接入指南》
- 《极物科技 | KNX设备 - Web添加与管理指南》
- 《极物科技 | KNX场景控制 - 场景值机制与双引擎详解》
- 《极物科技 | KNX报文追踪 - 总线监控与问题定位》
- 《极物科技 | KNX智能面板 - 按键与LED控制对接》
关于极物科技（ZEEWO）
极物科技（Zeewo）致力于为用户提供智能控制系统及硬件产品。我们以总线系统为技术底座，以**"稳定、可靠、快速响应"**为产品底线，是国内少有的拥有 KNX、DALI 全套软硬件自主研发能力的厂商之一。
我们的核心能力：
- 系统架构：自研极物 OS，支持多协议无界融合（KNX/DALI/CAN/RS485/IP）。
- 核心硬件：带双路 DALI 的 KNX 主机、超薄全金属定制面板、各类智选传感器及网关。
- 生态互联：深度融入 Apple HomeKit、Matter、小度、HomeAssistant 及纯血鸿蒙生态。
- 调试交付：独家支持 ETS 导出 XML 直接导入进行 APP 免编程调试，支持远程 WEB 运维。
我们的市场覆盖：
服务网点已覆盖全国核心城市（含长三角、珠三角、成渝等），并以高品质的方案深耕家居生活、酒店民宿、企业办公、疗愈康养、餐馆会所等多个细分领域。
(如果您在开发或落地中遇到技术问题，欢迎通过官网或后台私信与我交流探讨)