极物科技 | KNX报文追踪 - 功能总览与使用指南
前言
工程品质是 KNX 国际标准三十年立足全球的根基，而可观测性是品质的前提。
报文追踪把"看不见的总线"变成"看得见的证据"：每一次收发都有记录、每一次异常都有据可查。本文围绕报文追踪的接收链路、发送链路、容量管理与过滤机制展开，逐项说明其实现方式与排障用法。
一句话概述 ：本文介绍极物主机内置的"总线行车记录仪"------RX/TX双向报文追踪，远程就能看清总线上每一帧的来龙去脉，是报文追踪与调试集群（73~78）的支柱页。
1. 报文追踪是什么
报文追踪在主机内部对KNX收发报文做旁路式记录（不影响正常收发），维护两条独立链路：
| 链路 | 记录内容 | 回答的问题 |
|---|---|---|
| RX链路（接收） | 从总线/knxd/网关收到的每一帧 | "总线说了什么？谁在说话？" |
| TX链路（发送） | 主机主动发出的每一帧 | "主机干了什么？指令发出去没？" |
双链对照是核心价值：只看RX无法判断主机是否回应，只看TX无法判断总线是否收到------双向都有，一条指令的完整生命周期才闭环。
2. 开启与关闭
追踪默认关闭（零开销出厂态），调试时经Web界面开启：
text
Web管理界面 → KNX诊断 → 报文追踪
[开启追踪] / [关闭追踪]
追踪容量设置（每链最大条目数，默认200条）
[清空记录]💡 建议：远程排障时开启，定位完成后关闭------追踪虽是旁路记录，长期开启仍占用内存与记录维护开销，且旧记录会被新记录滚动淘汰（容量机制见第75篇）。
3. 追踪记录字段详解
每条记录包含以下字段：
| 字段 | 示例 | 说明 |
|---|---|---|
| 序号（ID） | 1024 | 全局递增，RX/TX共用一个序列，按ID可还原全局时序 |
| 方向 | RX / TX | 接收/发送 |
| 时间戳 | 14:23:05.312 | 毫秒级精度 |
| 组地址 | 1/1/1 | 已换算的三级表示 |
| APCI类型 | 读 / 写 / 响应 | 指令语义 |
| 数据值 | 1 / 50 / 22.5 | 解析后的业务值 |
| 模块来源 | 场景控制 / 继电器 / 周期查询 | 主机侧发起模块（仅TX有意义） |
| 设备名称 | 客厅灯 | 命中设备时的关联名称 |
模块来源字段是排障利器：同样一条"写1/1/1"的TX记录，来源是"场景控制"还是"周期查询"还是"APP控制"，指向完全不同的排查路径。
4. Web查看流程
text
① 登录远程WEB管理界面
② 开启追踪，复现问题（面板按键/触发场景/等待周期查询）
③ 打开RX/TX链路列表
④ 按组地址/方向/APCI筛选目标报文
⑤ 对照设备配置判断卡点：
RX有、TX无 → 主机没响应：查设备绑定/映射表
TX有、RX无响应 → 总线侧没回：查执行器/地址/DPT
都没有 → 报文根本没到：查物理层/通道5. 一次完整的追踪诊断示例
现象：APP控制"客厅灯"无反应。
text
TX#1024 14:23:05.312 写 1/1/1 值1 来源:APP控制 ← 指令已发出
RX#1025 14:23:05.358 写 1/1/101 值1 (客厅灯状态) ← 执行器回报状态
（状态已同步，若APP仍显示未开 → 第三方客户端问题）若记录是：
text
TX#1024 14:23:05.312 写 1/1/1 值1 来源:APP控制 ← 指令已发出
（无后续RX） ← 总线侧无动作
→ 排查：1/1/1是否为该执行器正确地址 / ETS对象DPT / 执行器供电6. 追踪与其他诊断工具的配合
| 工具 | 分工 |
|---|---|
| 报文追踪（本篇） | 主机视角的双向记录，远程可用 |
| knxtool | 现场旁路注入/监听，验证独立于主机的总线行为 |
| Wireshark | IP链路层抓包，查组播/隧道网络问题 |
| 个体地址过滤 | 噪声隔离，让追踪记录聚焦目标设备 |
7. 相关文档
- 《极物科技 | KNX报文追踪 - 接收与发送链路解析》
- 《极物科技 | KNX报文追踪 - 容量管理与记录定位》
- 《极物科技 | KNX调试 - 常见报文异常案例分析》
- 《极物科技 | KNX调试 - Web远程调试与现场排障实战》
文档说明与勘误
- 本文示例报文与配置均取自真机联调环境，其中设备名称、场景名、个体地址等均为演示数据，实际使用时请按工程命名规范替换。
- 文中端口号、报文类型与字段定义以成文时的固件版本为准；若与后续版本存在差异，请以主机 Web 端「系统配置 --- 接口说明」页面展示的内容为准。
- 系列文档之间通过「相关文档」小节互相引用，建议按编号顺序阅读，先看协议规范再看工程实战。
- 如发现示例报文与现场不一致，欢迎在评论区留言指正，我们会持续核对并修订本文。
本文由极物福州研发团队整理。