上行面：遥测与检索上报
验证状态：本页为接入视角新写（20 号票）。事实取材自 MQTT 清单层生成页（源码归纳口径，provenance 见页头）与机构手册已核验场景正本，本页自身不做二次核验、未联调。
用途与场景
设备作为独立 MQTT 客户端向平台上行的两条数据面：遥测（telemetry，状态 / 数据入库）与检索（retrieve，文件索引查询 + 被触发的固件 / 文件上报）。这是接入动线的第二步——身份就绪后，设备侧的常态职责就是这两条上行 + 保活（保活见 QoS 与在线状态）。
上行遥测（iot telemetry 谓词族）
- 设备以
device/{deviceNo}/iot/telemetry/v1发布遥测（谓词族形状{identity}/{id}/iot/telemetry/v1，identity ∈ device/server/user）——契约行见MQTT 主题清单 · 谓词族，命中后与静态 telemetry 主题同名汇入（静态 topic 表，字段级见 yaml 详解 · telemetry）。 - 遥测由中心消费入库，是历史检索面（GPS / 电池 / 执法记录仪数据索引）的供给侧；信封
sub区分 status（默认）/ data——消费链与语义见MQTT 消费者与设备业务 · mqtt-bridge。 - webrtc / ptt 通道有同构遥测谓词族（
{identity}/{id}/{webrtc|ptt}/telemetry/v1），见媒体通道族。
上行检索（iot retrieve 谓词族）
- 设备以
device/{deviceNo}/iot/retrieve/v1发布检索请求——契约行见MQTT 主题清单 · 谓词族；字段级契约见 yaml 详解 · retrieve（params.items的检索词汇表、应答结构等以该页为准，本页不复述）。 - 中心按
params.items检索词汇表检索（ice / firmware / dms / ptt / upload/*，未知项静默忽略），应答投递到请求reply指定的 topic、data 以检索项为键——设备触发固件 / 文件上报时，reply固定为自身 deliver topic（device/{deviceNo}/iot/deliver/v1），落点见下行面。 - 请求信封（
id/token/reply/params）与应答键（id/status/replyNumber/data|error）见设备服务接口规范；消费者逐类语义（信封解包、replyNumberMax 钳制、在线副作用）见MQTT 消费者。
分类信息上报（report-category-info）
- 静态 topic
server/center-server/iot/v1/report-category-info（上行 · 遥测）：按信息类别（如 GPS_INFO / BATTERY_INFO）上报分类统计数据，由中心入库——契约行见静态 topic 表，字段级见 yaml 详解 · report-category-info。 - 已核验叙事是 Web 代报：Web 位置追踪页把从设备读到的 GPS / 用户配置数据转发到该 topic（机构手册读取设备配置（get-configs）的调用关系节）；该 topic 无谓词族通配形状，设备是否直接发布此静态 topic 缺证。
行为规则（一句话点名）
- 未命中任何路由分支的 topic 一律被网关丢弃并留痕——见MQTT 主题清单页首路由说明。
reply与来源 topic 相同的报文被回环守卫丢弃——见MQTT 消费者。- 中心技术异常以固定文案应答、不回传原始异常——见机构手册触发设备固件与文件上报（retrieve）的错误与边界节。
已知缺口
- 设备遥测的权威载荷 schema 无真源：清单层口径为「源码归纳，无 schema 真源」，演进后须以源码为准重新核对（provenance 见主题清单页头）。
- 设备对 retrieve 应答的后续行为（下载、校验、上传、升级与失败重试）属设备固件职责，机构正本已标「设备侧断链」——本章下行面继承该口径。
upload/<category>的 category 权威枚举缺证（Web 为自由文本输入）——机构正本缺口，见触发设备固件与文件上报（retrieve）。
目录