JSON 与 MQTT 温控器接入
本文依据已有操作手册整理为线上操作参考。原文标为预期或未执行的操作，仍须按实际环境验证。
先了解产品、设备和收发主题，再使用温控器示例核对上报、控制、状态和历史。
**开始前准备：**已登录平台并具备产品、设备和控制权限；已有本文温控器时复用已有产品、设备和FMQX网页版会话；接入地址、端口和认证资料由部署管理员提供；本文127.0.0.1仅适用于同机环境。
先了解这条接入流程
本教程用温控器说明四件事：设备上报温度、平台查看实时与历史数据、平台调温、设备回报实际状态。JSON是消息内容格式，MQTT是设备收发消息的连接方式。
首次接入先完成配置；已有相同配置的设备可以从上报温度开始。示例沿用已有产品、设备和连接，首次配置部分使用当时真实页面说明。
复制模板前先替换这些参数
本篇代码使用普通模板名；截图保留实际历史资源。请先完成以下核对，再保存为UTF-8文件或发送报文。
- temperature、setpoint分别是温度与设定温度的模板属性标识；首次生成物模型可沿用，复用已有产品时须替换为该产品真实标识，并同步修改所有报文和initialState键。
- demo-device是设备编号模板。将clientId中的设备编号、每个收发主题中的设备编号和TCP上报的clientId一起替换为平台该设备编号；MQTT身份中的产品号、租户号也须替换为当前设备连接参数。
- 连接文件中的host、port及监听方向须改为当前环境实际地址；127.0.0.1表示运行FMQX的本机。涉及MQTT时同步核对产品号、用户名、订阅主题和responseRoute，密码仅在连接页面安全填写。
- 分组、会话及订阅id是导入文件内部引用；如需改名，groupId必须与对应分组id一致。先核对再导入，不要在保留会话上重复创建同名连接。
- 代码块是按既有无密码资产或原代码改写的客户模板，尚未证明本版模板已成功导入。历史截图、发送时间和业务通过范围仍以各步骤记录为准；不要将模板名当作旧证据中的实际资源名。
一、首次配置与连接
向导识别字段用的消息样例json
{"temperature":26.5,"setpoint":30}仅用于让向导识别温度和设定温度；完成配置后再发送下面的测试值。 此处使用可替换的客户模板名；导入或发送前按本节替换清单核对。
1. 选择新建产品
**操作位置：*物联网→*设备接入 操作步骤：选择 新建产品，填写产品名称 FastBee_温控器。
选择新建产品并填写名称
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 接入来源 | 新建产品用于首次接入一种设备；已有产品用于再加同型号设备。 必填 · 填写： 新建产品 |
| 产品名称 | 同一种设备型号共用一个产品。 必填 · 填写： FastBee_温控器 |
**预期结果（未执行）：**新建产品已选中，名称为FastBee_温控器；本步尚未创建产品。
2. 进入接入信息页
**操作位置：*设备接入→*选择接入来源 **操作步骤：**点击 下一步，完善信息，进入填写消息样例和接入方式的页面。
进入完善接入信息
**预期结果（未执行）：**进入完善接入信息页，显示已填写的产品名。
3. 导入上报样例
**操作位置：*设备接入→*完善接入信息 **操作步骤：**在 从 JSON 样例生成字段 中粘贴下方样例，点击 解析并预览。
粘贴JSON样例并解析为两个字段
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| JSON 样例 | 填写设备实际要上报的 JSON 对象，用来识别字段。 必填 · 填写： {"FastBee_temperature":26.5,"FastBee_setpoint":30} |
| 解析并预览 | 将 JSON 样例中的字段解析到采集点表，随后检查类型和路径。 必填 · 填写： 解析并预览 |
**预期结果（未执行）：**页面显示2个字段；协议与设备编号随后填写，当前没有保存产品或设备。
4. 选择 JSON 和 MQTT
**操作位置：*设备接入→*配置接入 **操作步骤：**数据格式选择 JSON，传输方式选择 MQTT。
本篇是普通 JSON 对象通过 MQTT 接入。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 数据格式 / 传输 | 本篇使用 JSON 对象，通过 MQTT 连接收发。 必填 · 填写： JSON / MQTT |
**预期结果（未执行）：**本篇是普通 JSON 对象通过 MQTT 接入。
5. 核对采集字段
**操作位置：*设备接入→*采集点表 **操作步骤：**核对两个 标识符、数据类型和 JSON 路径 与下方说明一致。
温度用小数，设定温度用整数；两者单位均为 ℃。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 标识符 | 与 JSON 键一致，区分大小写。 必填 · 填写： FastBee_temperature / FastBee_setpoint |
| 字段名称 | 页面显示的名称。 必填 · 填写： FastBee_温度 / FastBee_设定温度 |
| 数据类型 | 温度保留小数；设定温度使用整数。 必填 · 填写： 小数 / 整数 |
| 单位 | 填写计量单位。 必填 · 填写： ℃ |
| JSON 路径 | 填写取值路径；$ 表示整个 JSON 对象。 必填 · 填写： $.FastBee_temperature / $.FastBee_setpoint |
**预期结果（未执行）：**温度用小数，设定温度用整数；两者单位均为 ℃。
6. 填写设备编号
**操作位置：*设备接入→*设备 操作步骤：填写设备编号 FastBee_MQTT_Tutorial_01，设备名称使用温控器名称。
新接入时使用唯一编号；已存在的本文设备可直接复验。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 设备编号 | 每台设备独立的编号，连接认证和收发主题都使用它。 必填 · 填写： FastBee_MQTT_Tutorial_01 |
**预期结果（未执行）：**新接入时使用唯一编号；已存在的本文设备可直接复验。
7. 确认并创建接入配置
**操作位置：*设备接入→*确认接入配置 **操作步骤：**确认 配置预检通过，点击 创建并接入。
检查产品、协议、设备数量和采集字段数均正确。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 创建并接入 | 检查预检通过后保存并发布接入配置。 必填 · 填写： 创建并接入 |
**预期结果（未执行）：**检查产品、协议、设备数量和采集字段数均正确。
8. 允许调节设定温度
**操作位置：*产品管理→温控器→*功能定义 **操作步骤：**编辑设定温度，取消 只读数据、保留 历史存储，设置范围后保存。
温度保持只读；设定温度范围 16～35℃、步长 1。编辑时补齐英文名称。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 只读数据 | 勾选后只接收上报；取消后该属性可在设备运行状态中控制。 必填 · 填写： 温度开启；设定温度关闭 |
| 历史存储 | 开启后保存属性上报值，供历史查询。 必填 · 填写： 两个字段均开启 |
| 图表展示 / 实时监测 | 本篇仅温度启用这两项；设定温度关闭，保留控制入口。 必填 · 填写： 温度开启；设定温度关闭 |
| 范围 / 步长 | 限制控制数值的可选范围与每次调整幅度。 必填 · 填写： 温度 -40～125 / 0.1；设定温度 16～35 / 1 |
| 英文名称 | 修改物模型时按页面要求补齐英文名称。 必填 · 填写： Temperature / Setpoint |
**预期结果（未执行）：**温度保持只读；设定温度范围 16～35℃、步长 1。编辑时补齐英文名称。
9. 发布并确认生效
**操作位置：*产品管理→*温控器 **操作步骤：**保存物模型后发布产品，确认接入配置显示 已生效。
仅保存不代表接入服务已使用新配置；此处已收到生效回执。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 发布 / 已生效 | 保存字段后发布产品，接入配置显示已生效才继续连接设备。 必填 · 填写： 已生效 |
**预期结果（未执行）：**本步截图记录原批次发布回执；本篇首次配置为历史示例，本轮未重新执行此发布动作。当前运行结果见后续调温与独立状态核对步骤。
10. 复制设备连接参数
**操作位置：*设备管理→温控器→*基本信息 **操作步骤：**点击 认证信息，在连接参数中复制 Client ID、密码和收发主题。
本文工具与接入服务在同一台电脑，地址为 127.0.0.1:1883；接入地址由部署管理员提供。其他电脑不能照抄此地址。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| Host / IP | 设备能够访问的 MQTT 接入地址。 必填 · 填写： 127.0.0.1（本文同机演示） |
| Port | MQTT 监听端口。 必填 · 填写： 1883 |
| Client ID | 完整复制客户端 ID；不要点随机生成。 必填 · 填写： S&FastBee_MQTT_Tutorial_01&872&1 |
| Username | 复制设备连接参数中的用户名。 必填 · 填写： admin |
| Password | 从平台复制该设备的连接密码；无需填写平台登录密码。 必填 · 填写： 从设备连接参数复制，不在手册中公开 |
| 订阅主题 | 平台下发指令时，设备在此主题接收。 必填 · 填写： /872/FastBee_MQTT_Tutorial_01/function/get |
| 认证信息 | 设备详情基本信息中的入口，点击后打开连接参数抽屉。 必填 · 填写： 认证信息 |
**预期结果（未执行）：**本文工具与接入服务在同一台电脑，地址为 127.0.0.1:1883；接入地址由部署管理员提供。其他电脑不能照抄此地址。
**温控器连接JSON模板（不含密码）**json
{
"groups": [
{
"name": "接入教程",
"id": "tutorial_group",
"sortOrder": 50,
"isSystem": false
}
],
"schemaVersion": 3,
"sessions": [
{
"subscriptions": [
{
"qos": 1,
"topic": "/872/demo-device/function/get",
"active": true,
"id": "platform_downlink"
},
{
"qos": 1,
"topic": "S&demo-device&872&1/function/get",
"active": false,
"id": "legacy_default"
}
],
"host": "127.0.0.1",
"transport": "TCP",
"username": "admin",
"protocol": "MQTT",
"id": "tutorial_mqtt",
"name": "温控器",
"clientId": "S&demo-device&872&1",
"port": 1883,
"autoReconnect": false,
"groupId": "tutorial_group",
"jsonDevice": {
"responseRoute": "/872/demo-device/property/post",
"format": "JSON",
"initialState": {
"temperature": 27.4,
"setpoint": 30
}
},
"qos": 1
}
]
}保存为温控器连接.json；密码在FMQX连接页面填写。 此处使用可替换的客户模板名；导入或发送前按本节替换清单核对。
11. 导入温控器示例连接
**操作位置：*FMQX 网页版→*更多操作 **操作步骤：**将下方配置保存为 UTF-8 JSON 文件，选择 导入配置。
配置文件不含密码。更换自己的产品时，同时替换产品号、设备编号、租户号及收发主题。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 导入配置 | 导入下方示例 JSON 文件，建立具备真实状态执行能力的温控器示例连接。 必填 · 填写： 温控器连接.json |
**预期结果（未执行）：**配置文件不含密码。更换自己的产品时，同时替换产品号、设备编号、租户号及收发主题。
12. 填写密码并连接
**操作位置：*FMQX 网页版→温控器→*连接配置 **操作步骤：**首次接入时复制当前设备密码并保存，点击 连接，等待 已连接。
不要点击随机生成客户端 ID；图中凭据已经安全保存，不公开显示。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| Host / IP | 设备能够访问的 MQTT 接入地址。 必填 · 填写： 127.0.0.1（本文同机演示） |
| Port | MQTT 监听端口。 必填 · 填写： 1883 |
| Client ID | 完整复制客户端 ID；不要点随机生成。 必填 · 填写： S&FastBee_MQTT_Tutorial_01&872&1 |
| Username | 复制设备连接参数中的用户名。 必填 · 填写： admin |
| Password | 从平台复制该设备的连接密码；无需填写平台登录密码。 必填 · 填写： 从设备连接参数复制，不在手册中公开 |
| MQTT Version | 选择设备与服务均支持的 MQTT 版本。 必填 · 填写： 3.1.1 |
| Keep Alive | 连接存活检查周期，单位秒。 必填 · 填写： 60 |
| Clean Session | 本文新会话开启；重连后仍需确认正确主题已订阅。 必填 · 填写： 开启 |
| TLS / SSL | 是否使用加密连接，需要与服务端监听方式一致。 必填 · 填写： 本篇本地 1883 关闭 |
| 连接超时 / 重连间隔 | 超时单位毫秒；重连间隔仅自动重连开启后使用。 必填 · 填写： 5000 / 3000 |
| 自动重连 | 本篇关闭，便于显式观察断开和再次连接。 必填 · 填写： 关闭 |
| 连接 / 断开 | 开始或停止当前设备连接，不删除产品与历史数据。 必填 · 填写： 连接 |
**预期结果（未执行）：**本文本轮复用保留凭据，未重新填写密码；不要点击随机生成客户端ID。
13. 确认下行订阅主题
**操作位置：*FMQX 网页版→通信→*订阅 **操作步骤：**确认订阅列表含平台给出的 订阅主题，QoS 使用 1。
有效主题为 /产品号/设备编号/function/get。示例中的旧默认条目已停用，请勿启用或用它替代正确主题。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 订阅主题 | 平台下发指令时，设备在此主题接收。 必填 · 填写： /872/FastBee_MQTT_Tutorial_01/function/get |
| QoS | MQTT 消息交付等级。本文选择 1，发送记录可看到服务端确认。 必填 · 填写： 1 |
**预期结果（未执行）：**有效主题为 /产品号/设备编号/function/get。示例中的旧默认条目已停用，请勿启用或用它替代正确主题。
二、上报十条温度
先发送31.1，再把温度每次增加0.1，直到32.0，共十条；设定温度始终保持30。每条单独发送，便于核对顺序。
14. 发送第一条31.1℃温度
**操作位置：*FMQX 网页版→通信→*发布消息 **操作步骤：**在本设备上报主题中填写温度 31.1、设定30的JSON，点击 发送。
可见首条31.1、设定30、正确上报主题、18:13:09发送卡及编辑框。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 上报 Topic | 设备向平台报告属性时使用的主题。 必填 · 填写： 按实施方案填写 · 示例：/872/FastBee_MQTT_Tutorial_01/property/post |
| QoS | MQTT 消息交付等级。本文选择 1，发送记录可看到服务端确认。 必填 · 填写： 按实施方案填写 · 示例：1 |
| 消息内容 | 使用 JSON 格式，数字不要加引号，字段键与物模型一致。 必填 · 填写： {"FastBee_temperature":31.1,"FastBee_setpoint":30} |
15. 继续发送其余九条温度
**操作位置：*FMQX 网页版→通信→*发送 **操作步骤：**在首条之后，把温度依次改为31.2、31.3，直到 32.0；设定保持30，每次点击 发送。
可见发送计数10，末尾31.8、31.9和32及设定30；画面并非展示所有十条明细。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 消息内容 | 使用 JSON 格式，数字不要加引号，字段键与物模型一致。 必填 · 填写： 按实施方案填写 · 示例：{"FastBee_temperature":31.1,"FastBee_setpoint":30} |
| 温度序列 | 首条31.1已经发送，本步继续其余九条，合计十条。 必填 · 填写： 31.2、31.3、31.4、31.5、31.6、31.7、31.8、31.9、32.0 · 示例：31.1、31.2、31.3、31.4、31.5、31.6、31.7、31.8、31.9、32.0 |
三、查看实时与历史数据
实时页面显示设备最新上报值；历史页按设备、属性和时间范围查询已经保存的记录。示例截图各自保留真实时点的数据，查询自己的设备时请使用本次上报时段。
16. 查看平台实时温度
**操作位置：*设备管理→温控器→*运行状态 **操作步骤：**让设备再上报一个新温度后回到平台，等待 温度 更新为最新值。
平台温度更新为29.9℃，设定温度仍为31℃。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 实时温度 | 设备实际新上报的温度；每次测试以当前上报值为准。 必填 · 填写： 29.9℃ |
17. 查询并复核历史记录
**操作位置：*数据中心→*历史数据 **操作步骤：**选择本设备、所需属性及上报时段后点击 查询；刷新页面后用相同条件重查。
选定设备与属性后，历史表显示对应上报时间和数值。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 设备 / 属性 | 只查询当前示例设备及目标温度字段。 必填 · 填写： 按实施方案填写 · 示例：FastBee_温控器 / FastBee_设定温度 |
| 设备 / 字段 | 按本设备及属性查询，日期使用2026-10-15。 必填 · 填写： FastBee_温控器 / FastBee_设定温度 |
四、调温并回报实际状态
待下发值表示准备发送的目标。发出指令后，要继续看设备收到的消息和执行后的实际上报，再回到平台核对当前值。
18. 将设定温度调到32℃
**操作位置：*设备管理→温控器→*运行状态 **操作步骤：**在 设定温度 滑块选择 32，核对待下发值后点击发送图标。
当前31℃，滑块提示待下发32℃。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 待下发设定温度 | 设备收到并执行后，再检查实际状态回报。 必填 · 填写： 32℃ |
19. 确认设备实际收到指令
**操作位置：*FMQX 网页版→温控器→*接收内容 **操作步骤：**展开最新接收消息，核对 设定温度 的下行值为 32。
设备实际收到设定温度32℃的完整下行。
20. 独立上报设备实际状态
**操作位置：*FMQX 网页版→温控器→*发布消息 **操作步骤：**设备执行后，在上报主题发送实际温度 27.4、设定 32的属性JSON。
执行后的独立属性上报：温度27.4℃、设定32℃。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 上报 Topic | 设备向平台报告属性时使用的主题。 必填 · 填写： 按实施方案填写 · 示例：/872/FastBee_MQTT_Tutorial_01/property/post |
| 消息内容 | 使用 JSON 格式，数字不要加引号，字段键与物模型一致。 必填 · 填写： {"FastBee_temperature":27.4,"FastBee_setpoint":32} |
21. 核对平台回显32℃
**操作位置：*设备管理→温控器→*运行状态 **操作步骤：**回到平台查看 当前值，确认设定温度更新为 32。
平台当前设定温度已更新为32℃。
设备执行后的独立属性上报json
{"temperature":27.4,"setpoint":32}填写设备实际温度和设定值。执行应答与属性上报承担不同用途，应分别核对。 此处使用可替换的客户模板名；导入或发送前按本节替换清单核对。
五、查看温度曲线
22. 进入统计查看温度曲线
**操作位置：*设备管理→温控器→*设备统计 **操作步骤：**打开 设备统计，等待所选时段的温度曲线加载；更换日期后再点查询。
打开设备统计后，温度曲线自动显示。
六、需要时恢复连接
连接中断时，保留原会话配置后重新连接，并检查订阅是否恢复。下面使用一次独立的真实恢复示例说明按钮和连接状态。
23. 需要重连时先断开会话
**操作位置：*FMQX 网页版→*温控器 **操作步骤：**需要重连时点击 断开，保留连接配置并确认 已断开。
保留会话配置，状态显示已断开。
24. 恢复保留的同一会话
**操作位置：*FMQX 网页版→*温控器 **操作步骤：**选中保留会话，点击 连接 并等待 已连接，随后检查本设备订阅。
同一保留会话恢复为已连接。
七、结束测试
25. 结束测试并保留配置
**操作位置：*FMQX 网页版→*温控器 **操作步骤：**停止收发后点击 断开，确认 已断开，保留连接配置以便下次继续。
本轮结束，温控器会话已断开并保留配置。
字段与参数参考
设备接入向导
| 字段 / 控件 | 填写说明 |
|---|---|
| 接入来源 | 新建产品用于首次接入一种设备；已有产品用于再加同型号设备。 必填 · 填写： 新建产品已有产品：复用已有协议和物模型；复用已有协议和物模型。新建产品：为新型号创建设备接入配置；为新型号创建设备接入配置。复制产品：以已有产品为起点修改配置；以已有产品为起点修改配置。使用模板：从预置能力或型号开始；从预置能力或型号开始。 |
| 产品名称 | 同一种设备型号共用一个产品。 必填 · 填写： FastBee_温控器 |
| JSON 样例 | 填写设备实际要上报的 JSON 对象，用来识别字段。 必填 · 填写： {"FastBee_temperature":26.5,"FastBee_setpoint":30} |
| 解析并预览 | 将 JSON 样例中的字段解析到采集点表，随后检查类型和路径。 |
| 数据格式 / 传输 | 本篇使用 JSON 对象，通过 MQTT 连接收发。 必填 · 填写： JSON / MQTT |
| 标识符 | 与 JSON 键一致，区分大小写。 必填 · 填写： FastBee_temperature / FastBee_setpoint |
| 字段名称 | 页面显示的名称。 必填 · 填写： FastBee_温度 / FastBee_设定温度 |
| 数据类型 | 温度保留小数；设定温度使用整数。 必填 · 填写： 小数 / 整数 |
| 单位 | 填写计量单位。 必填 · 填写： ℃ |
| JSON 路径 | 填写取值路径；$ 表示整个 JSON 对象。 必填 · 填写： $.FastBee_temperature / $.FastBee_setpoint |
| 设备编号 | 每台设备独立的编号，连接认证和收发主题都使用它。 必填 · 填写： FastBee_MQTT_Tutorial_01 |
| 创建并接入 | 检查预检通过后保存并发布接入配置。 |
| 下一步，完善信息 | 进入接入信息页，继续填写消息样例和选择接入方式。 |
产品功能定义
| 字段 / 控件 | 填写说明 |
|---|---|
| 只读数据 | 勾选后只接收上报；取消后该属性可在设备运行状态中控制。 必填 · 填写： 温度开启；设定温度关闭修改后须发布。 |
| 历史存储 | 开启后保存属性上报值，供历史查询。 必填 · 填写： 两个字段均开启修改后须发布。 |
| 图表展示 / 实时监测 | 本篇仅温度启用这两项；设定温度关闭，保留控制入口。 必填 · 填写： 温度开启；设定温度关闭修改后须发布。 |
| 范围 / 步长 | 限制控制数值的可选范围与每次调整幅度。 必填 · 填写： 温度 -40～125 / 0.1；设定温度 16～35 / 1修改后须发布。 |
| 英文名称 | 修改物模型时按页面要求补齐英文名称。 必填 · 填写： Temperature / Setpoint修改后须发布。 |
产品发布
| 字段 / 控件 | 填写说明 |
|---|---|
| 发布 / 已生效 | 保存字段后发布产品，接入配置显示已生效才继续连接设备。 |
设备连接参数
| 字段 / 控件 | 填写说明 |
|---|---|
| 认证信息 | 设备详情基本信息中的入口，点击后打开连接参数抽屉。 |
| Host / IP | 设备能够访问的 MQTT 接入地址。 必填 · 填写： 127.0.0.1（本文同机演示）平台：设备详情 → 连接参数；网络地址由部署管理员确认。 |
| Port | MQTT 监听端口。 必填 · 填写： 1883平台：设备详情 → 连接参数；网络地址由部署管理员确认。 |
| Client ID | 完整复制客户端 ID；不要点随机生成。 必填 · 填写： S&FastBee_MQTT_Tutorial_01&872&1平台：设备详情 → 连接参数；网络地址由部署管理员确认。 |
| Username | 复制设备连接参数中的用户名。 必填 · 填写： admin平台：设备详情 → 连接参数；网络地址由部署管理员确认。 |
| Password | 从平台复制该设备的连接密码；无需填写平台登录密码。 必填 · 填写： 从设备连接参数复制，不在手册中公开平台：设备详情 → 连接参数；网络地址由部署管理员确认。 |
FMQX 连接与订阅
| 字段 / 控件 | 填写说明 |
|---|---|
| 导入配置 | 导入下方示例 JSON 文件，建立具备真实状态执行能力的温控器示例连接。 修改后须重连。 |
| MQTT Version | 选择设备与服务均支持的 MQTT 版本。 必填 · 填写： 3.1.1修改后须重连。3.1：较早版本，按设备支持情况选择；较早版本，按设备支持情况选择。3.1.1：本文已验证版本；本文已验证版本。5.0：设备和接入服务均支持时选择；设备和接入服务均支持时选择。 |
| Keep Alive | 连接存活检查周期，单位秒。 必填 · 填写： 60修改后须重连。 |
| Clean Session | 本文新会话开启；重连后仍需确认正确主题已订阅。 必填 · 填写： 开启修改后须重连。 |
| TLS / SSL | 是否使用加密连接，需要与服务端监听方式一致。 必填 · 填写： 本篇本地 1883 关闭修改后须重连。 |
| 连接超时 / 重连间隔 | 超时单位毫秒；重连间隔仅自动重连开启后使用。 必填 · 填写： 5000 / 3000修改后须重连。 |
| 自动重连 | 本篇关闭，便于显式观察断开和再次连接。 必填 · 填写： 关闭修改后须重连。 |
| 连接 / 断开 | 开始或停止当前设备连接，不删除产品与历史数据。 修改后须重连。 |
| 订阅主题 | 平台下发指令时，设备在此主题接收。 必填 · 填写： /872/FastBee_MQTT_Tutorial_01/function/get修改后须重连。 |
FMQX 通信
| 字段 / 控件 | 填写说明 |
|---|---|
| 上报 Topic | 设备向平台报告属性时使用的主题。 必填 · 填写： /872/FastBee_MQTT_Tutorial_01/property/post |
| QoS | MQTT 消息交付等级。本文选择 1，发送记录可看到服务端确认。 必填 · 填写： 10：不等待消息确认；不等待消息确认。1：等待确认，设备仍需配合业务结果核对；等待确认，设备仍需配合业务结果核对。2：按双方支持情况使用两阶段交付；按双方支持情况使用两阶段交付。 |
| 消息内容 | 使用 JSON 格式，数字不要加引号，字段键与物模型一致。 必填 · 填写： {"FastBee_temperature":31.1,"FastBee_setpoint":30} |
| 接收内容 / 执行应答 | 对照相同指令编号，核对收到的设定温度和执行应答中的状态值。 |
设备运行状态
| 字段 / 控件 | 填写说明 |
|---|---|
| 数据采集当前值 | 核对最新上报的数值与更新时间。 |
| 设定温度 / 指令发送 | 把滑块调至目标温度，点击指令发送；收到实际状态回报后再核对当前值。 |
历史数据
| 字段 / 控件 | 填写说明 |
|---|---|
| 设备 / 属性 | 只查询当前示例设备及目标温度字段。 必填 · 填写： FastBee_温控器 / FastBee_设定温度 |
| 时间范围 / 明细 | 查询包含设备发送时刻的时间窗口，按更新时间核对数值。 |
连接保留与恢复
| 字段 / 控件 | 填写说明 |
|---|---|
| 连接 / 保存的会话 | 结束时断开连接，保留配置；再次验证时选择接入教程分组下的对应连接。 |
遇到问题先检查哪里
| 看到什么现象 | 可能原因 | 先检查哪里 | 如何恢复 |
|---|---|---|---|
| 连接失败 | 连接资料或设备身份不匹配。 | 对照平台当前设备连接参数核对地址、端口、客户端标识和认证信息。 | 修正后重连保留会话。 |
| 已发送但平台没有新值 | 上报主题、字段或当前设备不一致。 | 先看发送卡中的主题与数字，再看平台是否选中了同一设备。 | 修正后发送一个能区分的新值，等待页面更新。 |
| 已下发但设备没有变化 | 下行订阅未恢复，或设备未执行。 | 查看真实接收卡；再核对设备实际状态和独立属性回报。 | 恢复订阅后重新发起一条指令并检查实际结果。 |
| 历史查不到新记录 | 查询对象、属性或时间范围不匹配，或该属性未启用存储。 | 核对当前设备、属性存储开关和本次上报时段。 | 用相同条件刷新重查，并保留实际发送时间。 |