计算机网络 / 系统课时
设备指令和上报怎样区分
设备指令和上报怎样区分
设备通道一旦同时承载控制指令、状态上报和执行结果,最容易出现“同一个 JSON 到底是谁发给谁”的歧义。本节用统一消息信封和明确方向规则,把 command、telemetry、ack、error 分开,使设备端和平台端都能稳定路由与追踪。
学习目标
- 区分四类消息的职责、方向和生命周期
- 设计能关联请求与响应的公共字段
- 用代码验证消息类型与传输方向是否符合约定
先把方向写进协议语义
在设备场景中,最稳妥的做法不是根据字段内容猜方向,而是让消息类型本身具有明确语义。command 表示平台要求设备执行动作,通常是平台下行;telemetry 表示设备主动上报测量值或状态,通常是设备上行。
ack 用来确认某条命令已被设备接收或执行,方向通常与原始 command 相反;error 表示处理某个请求失败,应携带被拒绝消息的标识。这样即使多个消息共用一条 WebSocket 连接,接收方也能先按 type 分流,再处理业务字段。

公共信封比堆字段更重要
建议四类消息共享少量稳定字段:type 负责分流,id 唯一标识当前消息,deviceId 标识设备,ts 记录发送时间,payload 放业务数据。对于 ack 和 error,再增加 replyTo 指向原始 command.id。
不要把 status、success、action 等业务字段提升为路由依据。业务字段会随着设备型号变化,而 type 与关联字段应保持长期稳定。对于一次命令的“已收到”和“已执行”,如果确实需要区分,可在 ack.payload.stage 中使用约定值,而不要再发明多个近义消息类型。
用代码检查消息方向
下面的可运行 JavaScript 示例对四类消息执行最小校验,并输出它们在本协议中的方向。<ID>、<TIME> 是动态值占位符,实际运行时应替换为真实消息 ID 和时间戳。
const messages = [
{ type: "command", id: "<ID>", deviceId: "dev-001", ts: "<TIME>", payload: { action: "reboot" } },
{ type: "telemetry", id: "<ID>", deviceId: "dev-001", ts: "<TIME>", payload: { temperature: 26.4 } },
{ type: "ack", id: "<ID>", deviceId: "dev-001", ts: "<TIME>", replyTo: "<ID>", payload: { stage: "executed" } },
{ type: "error", id: "<ID>", deviceId: "dev-001", ts: "<TIME>", replyTo: "<ID>", payload: { code: "COMMAND_REJECTED" } }
];
function classify(message) {
// 顶层 type 决定协议路由,payload 只承载具体业务数据。
if (message.type === "command") return "platform -> device";
if (message.type === "telemetry") return "device -> platform";
if (message.type === "ack" || message.type === "error") {
// 响应必须关联原命令,否则平台无法确认它属于哪次请求。
if (!message.replyTo) throw new Error(`${message.type} requires replyTo`);
return "device -> platform";
}
throw new Error(`unsupported type: ${message.type}`);
}
for (const message of messages) {
console.log(`${message.type}: ${classify(message)}`);
}预期输出
command: platform -> device
telemetry: device -> platform
ack: device -> platform
error: device -> platform这段代码验证的是本节约定的“平台下发命令、设备返回结果”场景。如果系统还允许设备主动发起请求,就应把 source、target 或明确的请求类型纳入协议,而不是继续让 error 的方向靠猜。
处理重复与乱序
WebSocket 保证单条 TCP 连接上的字节有序,但断线重连后,应用层仍可能因为重试、补发或多实例处理遇到重复消息。平台下发 command 时应保留唯一 id;设备收到重复命令时,可基于该 ID 做幂等检查,并返回与原命令关联的 ack 或 error。
telemetry 通常不需要逐条确认,否则高频上报会产生大量反向流量。只有当业务确实要求“不丢一条”时,才应增加序号、持久化和补传机制,而不是把所有遥测都改成请求响应模式。
什么时候需要新增消息类型
新增类型应代表新的协议语义,而不是新的业务动作。比如“重启”“设置阈值”“切换模式”都可以继续放进 command.payload.action;温度、电量、信号强度也都属于 telemetry。只有当处理生命周期、可靠性或路由规则发生实质变化时,才值得增加新的顶层 type。
最终应让接收方看到 type 就知道由哪个处理器接管,看到 id 与 replyTo 就能串起一次命令及其结果。这样设备通道才能在消息种类增加后仍保持可追踪、可扩展。