UDP 客户端接入与数据流程
使用真实 UDP 设备 GUI 完成接入、上行、客户端详情统计、平台下发、设备实收、断开重连和清理。
页面导读
阅读方法
先确认入口、权限和目标对象，再按编号完成操作。每一步都包含预期结果；详细字段和选项收在可展开的参考表中。
截图说明
截图来自原始操作手册。公开版会隐藏真实节点地址、连接地址和凭据；示例中的状态、时间和数据不代表当前生产环境。
开始前准备
| 项目 | 说明 |
|---|---|
| 能做什么 | 按协议完成设备接入、上行、客户端详情统计、平台下发、设备实收、断开重连和清理。 |
| 从哪里进入 | 登录 FMQ 控制台后进入设备 → 客户端。 |
| 需要权限 | 具备客户端查看和测试指令权限。 |
| 完成效果 | 能通过真实设备 GUI 和客户端详情确认每个协议的数据闭环。 |
操作步骤
1. 进入UDP客户端页面
操作位置： 设备→客户端
登录后进入设备 → 客户端，点击协议筛选并使用搜索框定位本次设备会话。
图：① 协议筛选与搜索用于定位当前设备；列表显示协议、状态、节点、远端地址、最后活跃和操作入口。
截图重点说明
| 标注 | 参数 | 必填 | 推荐值 / 示例 | 参数作用 |
|---|---|---|---|---|
| P1 | 节点筛选 | 必填 | 按当前协议会话操作示例：节点筛选 | 节点筛选用于完成当前客户端页面的定位、观察或状态操作。；页面或设备 GUI 显示与操作对应的真实结果。 |
| P2 | 客户端搜索 | 必填 | 按当前协议会话操作示例：客户端搜索 | 客户端搜索用于完成当前客户端页面的定位、观察或状态操作。；页面或设备 GUI 显示与操作对应的真实结果。 |
2. 定位UDP目标会话
操作位置： 设备→客户端
在搜索框输入设备 Client ID，确认在线行后点击追踪或直接点击该行打开详情。
图：① Client ID 是单台设备的定位键；② 在线状态与最后活跃时间一起判断会话是否仍在工作。
截图重点说明
| 标注 | 参数 | 必填 | 推荐值 / 示例 | 参数作用 |
|---|---|---|---|---|
| P1 | 客户端搜索 | 必填 | 按当前协议会话操作示例：客户端搜索 | 客户端搜索用于完成当前客户端页面的定位、观察或状态操作。；页面或设备 GUI 显示与操作对应的真实结果。 |
3. 打开UDP详情并开启采集
操作位置： 设备→客户端
打开客户端详情，确认追踪、最近消息和消息流向已开启，再依次打开总览、订阅、最近消息、消息流向、最近异常和最近离线记录页签。
图：① 详情总览先确认状态和节点；② 追踪采集开启后，后续上行才会进入统计和最近消息。
4. UDP设备 GUI 发送上行数据
操作位置： LinkPilot 协议调试工作台
在 LinkPilot 的真实协议工作台中保持会话已连接，发送一条包含设备身份和温度值的合法 JSON 上行报文。
图：① LinkPilot 显示会话已连接；② 通信时间线记录本次设备上行帧；③ 协议端口为 MQTT 1883、TCP 8888 或 UDP 8889。
5. 查看UDP详情统计和上报流程
操作位置： 设备→客户端
在总览中查看读取/写入字节、上行/下行消息计数、错误数和平均延迟；在最近消息中核对方向、时间、Topic 或地址、payload 预览，再查看消息流向、最近异常和最近离线记录。
图：① 读取字节/消息计数证明设备数据进入客户端详情；② 最近消息核对上行方向和 payload；消息流向、异常和离线页签用于继续排查。
6. 平台向UDP设备下发指令并确认实收
操作位置： LinkPilot 协议调试工作台
在发送测试指令页填写 JSON payload，MQTT 选择 Topic、QoS 和 Retain；TCP/UDP 使用当前会话目标，点击发送测试指令。随后回到 LinkPilot GUI 查看设备实际收到的下行帧。
图：① LinkPilot 时间线显示平台下行实际到达设备；② MQTT 下行使用 1883 连接和订阅主题；③ TCP/UDP 显示会话收到的原始字节。
7. UDP设备断开并观察离线状态
操作位置： LinkPilot 协议调试工作台
在 LinkPilot GUI 主动断开会话，回到 FMQ 客户端列表刷新并查看离线状态、最近离线时间和原因。
图：① 会话状态变为已断开；② 断开动作会在真实 GUI 的交互时间线中留下记录。
8. UDP设备重连并确认恢复
操作位置： LinkPilot 协议调试工作台
在 LinkPilot GUI 执行重新连接动作，回到平台刷新客户端详情，核对在线状态和最后活跃时间重新更新。
图：① 重连后 GUI 显示已连接，连接信息保留当前协议端口 8889。
9. 清理UDP临时会话
操作位置： 设备→客户端
删除 LinkPilot 临时会话，回到 FMQ 客户端列表按 Client ID 搜索并刷新，确认当前筛选结果为空。
图：① 刷新列表；② 当前 Client ID 不再出现，表示临时会话已清理。
截图重点说明
| 标注 | 参数 | 必填 | 推荐值 / 示例 | 参数作用 |
|---|---|---|---|---|
| P1 | 客户端搜索 | 必填 | 按当前协议会话操作示例：客户端搜索 | 客户端搜索用于完成当前客户端页面的定位、观察或状态操作。；页面或设备 GUI 显示与操作对应的真实结果。 |
客户端列表与详情
完整参考
| 字段/控件 | 用途说明 | 默认/推荐/示例 | 选项说明 | 作用与影响 | 生效条件 |
|---|---|---|---|---|---|
| 必填 客户端搜索 | 客户端搜索用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：客户端搜索 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 节点筛选 | 节点筛选用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：节点筛选 | 全部节点：不限制运行节点。；在所有节点的客户端会话中查找目标。当前节点：只查看当前控制台连接节点。；缩小结果范围，便于核对节点归属。 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 刷新列表 | 刷新列表用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：刷新列表 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 协议筛选 | 协议筛选用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：协议筛选 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 状态筛选 | 状态筛选用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：状态筛选 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 分页 | 分页用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：分页 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 追踪 | 追踪用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：追踪 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 打开详情 | 打开详情用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：打开详情 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 断开连接 | 断开连接用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：断开连接 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：需要 |
| 必填 刷新详情 | 刷新详情用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：刷新详情 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 总览 | 总览用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：总览 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 订阅主题 | 订阅主题用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：订阅主题 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 最近消息 | 最近消息用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：最近消息 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 JSON / 原文 / HEX | JSON / 原文 / HEX用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：JSON / 原文 / HEX | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 消息流向 | 消息流向用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：消息流向 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 发送测试指令 | 发送测试指令用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：发送测试指令 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 Payload 类型 | Payload 类型用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：Payload 类型 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 格式化 | 格式化用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：格式化 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 发送测试指令 | 发送测试指令用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：发送测试指令 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 最近异常 | 最近异常用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：最近异常 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 最近离线记录 | 最近离线记录用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：最近离线记录 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
| 必填 关闭详情 | 关闭详情用于完成当前客户端页面的定位、观察或状态操作。 | 默认：当前页面状态推荐：按当前协议会话操作示例：关闭详情 | 不适用 | 页面或设备 GUI 显示与操作对应的真实结果。 | 范围：当前协议会话发布：不需要 · 重启：不需要 · 重连：不需要 |
结果验证
UDP客户端闭环完成
UDP平台观察到断开状态
常见问题
UDP 设备在 FastBee 上怎么完成一次完整的接入验证？
进入设备 → 客户端定位 UDP 会话并开启追踪，用 LinkPilot（UDP 端口 8889）发送上行 JSON，在详情统计与最近消息中核对，再从平台下发并在设备 GUI 确认实收，最后验证断开与重连。
UDP 下行指令需要像 MQTT 一样填 Topic 吗？
不需要。TCP/UDP 的测试指令直接使用当前会话目标；只有 MQTT 才需要填写 Topic、QoS 和 Retain。
UDP 设备离线后怎么确认原因并恢复？
在客户端列表刷新查看离线状态与最近离线记录（UDP 超时是可能原因之一），然后在 LinkPilot 执行重新连接，回到平台确认在线状态和最后活跃时间重新更新。
生产操作提示
截图和示例用于说明操作位置与判断方法，不代表当前生产状态。涉及发布、启停、重绑、重试或删除时，应先确认目标环境、影响范围和恢复方案，并由授权人员执行。
蜂信物联（FastBee） · FMQ 操作手册