JSON 数组与 UDP 无线终端接入

本文依据已有操作手册整理为线上操作参考。原文标为预期或未执行的操作，仍须按实际环境验证。本篇为补充参考，存在适用限制，原手册中的缺项状态继续保留。

完成设备上报、下行实收、FMQX演示回复、独立状态、实际历史和停止恢复。

**开始前准备：**具有产品、设备、模型、发布、控制与历史权限；本地应用、单节点FMQ和FMQX网页版可用，本设备连接参数已获取

开始前先了解

本篇适合使用UDP数据报、每报携带设备编号和data数组的无线终端。完成创建、发布、十个可区分样本、下行实收、FMQX演示回复、独立状态、历史刷新以及停止恢复。账号需有产品、设备、模型、发布、控制与历史权限。

FMQX网页版扮演演示终端。它自动回复指令后，由操作员人工独立上报状态；不证明物理执行器动作。UDP的已连接表示本地端点已打开，设备每次上报携带身份后，FMQ登记返回地址。

本篇FMQX本地端口15022向同机FMQ的127.0.0.1:8889发送；下行返回此源端点。跨机器使用管理员提供的可达地址，防火墙和地址映射须允许回包。恢复或源地址变化后先上报，再控制。

一、创建独立资源

新建独立产品，先以对象样例生成两字段，再保存本篇正式协议。再次验收复用已有资源。

向导对象样例json

text

{

  "FastBee_temperature": 20,

  "FastBee_setpoint": 30

}

先生成两个整数℃字段，再改正式JSON数组/UDP。

1. 选择新建独立产品

**操作位置：*物联网→设备接入→*接入来源 操作步骤：选择新建产品，填写本篇名称；再次验收直接复用保留产品。

选择新建独立产品

本图补拍创建入口；没有重复提交创建，后续设备与历史沿用本篇资源。

截图重点说明

字段 / 控件	说明
接入来源	本篇选择新建产品，复验直接复用保留资源。必填 · 填写：`新建产品`
产品／设备名称	名称精简，便于定位本篇资源。必填 · 填写：`FastBee_数组无线`

2. 用对象样例生成两字段

**操作位置：*设备接入→*采集数据 **操作步骤：**新建独立产品，展开对象样例并解析。

用对象样例生成两字段

先解析对象；本篇正式JSON数组/UDP在产品详情修改。

截图重点说明

字段 / 控件	说明
接入来源	本篇选择新建产品，复验直接复用保留资源。必填 · 填写：`新建产品`
产品／设备名称	名称精简，便于定位本篇资源。必填 · 填写：`FastBee_数组无线`
向导对象样例	先用对象解析两字段，之后改正式JSON数组/UDP。必填 · 填写：`{"FastBee_temperature":20,"FastBee_setpoint":30}`

3. 核对字段、类型和单位

**操作位置：*设备接入→*采集字段 **操作步骤：**核对两标识、整数和℃。

核对字段、类型和单位

对象路径先生成字段，设备数组元素id仍与模型标识一致。

截图重点说明

字段 / 控件	说明
字段、类型、单位与路径	对象样例生成两个整数℃字段，标识逐字一致。必填 · 填写：`FastBee_temperature；FastBee_setpoint；整数；℃`

4. 填写独立设备编号

**操作位置：*设备接入→*添加设备 **操作步骤：**填写本篇设备编号和名称。

填写独立设备编号

每个UDP数据报使用同一clientId。

截图重点说明

字段 / 控件	说明
设备标识	每个UDP报文clientId与本编号一致，不使用会话id代替。必填 · 填写：`FastBee_ArrayUDP_Tutorial_01`
产品／设备名称	名称精简，便于定位本篇资源。必填 · 填写：`FastBee_数组无线`

5. 核对初始接入概况

**操作位置：*设备接入→*确认 操作步骤：核对1台、2字段后创建。

核对初始接入概况

初始JSON/MQTT真实保留，接下来改正式JSON数组/UDP。

截图重点说明

字段 / 控件	说明
初始接入概况	向导初始JSON/MQTT；1台设备、2字段，后续修改正式格式。必填 · 填写：`1台、2字段`

二、配置正式协议并发布

6. 保存正式JSON数组与UDP

**操作位置：*产品管理→*产品信息 操作步骤：选择JSON数组、UDP和WIFI，保存。

保存正式JSON数组与UDP

设备按UDP数据报收发，不填写MQTT主题。

截图重点说明

字段 / 控件	说明
数据格式	正式采用JSON数组。必填 · 填写：`JSON 数组`
传输方式	选择UDP，每个数据报带设备身份，不使用MQTT主题。必填 · 填写：`UDP`
联网方式	本篇为WIFI，仍需独立配置UDP地址和端口。必填 · 填写：`WIFI`

7. 保存可写设定与历史

**操作位置：*产品管理→功能定义→*设定 操作步骤：补Setpoint，取消只读，历史开启后修改。

保存可写设定与历史

设定16～35℃、步长1，可写且保存历史。

截图重点说明

字段 / 控件	说明
模型翻译	温度与设定补齐英文名称。必填 · 填写：`Temperature／Setpoint`
模型标识	data数组元素id与模型标识逐字一致。必填 · 填写：`FastBee_temperature／FastBee_setpoint`
模型类别	两字段均为属性。必填 · 填写：`属性`
只读数据	温度勾选、设定取消。必填 · 填写：`温度只读；设定可写`
历史存储	两属性均开启。必填 · 填写：`勾选`
图表显示／实时监测	温度开启，设定关闭。必填 · 填写：`温度开；设定关`
分享权限	本篇保持关闭。必填 · 填写：`不勾选`
数据类型／范围／单位／步长	整数，温度-40～100℃，设定16～35℃，步长1。必填 · 填写：`整数；℃；步长1`
修改	补齐必填项后保存。必填 · 填写：`修改`

8. 保存只读温度与历史

**操作位置：*产品管理→功能定义→*温度 操作步骤：补Temperature，保持只读与历史后修改。

保存只读温度与历史

温度-40～100℃，图表和实时监测开启。

截图重点说明

字段 / 控件	说明
模型翻译	温度与设定补齐英文名称。必填 · 填写：`Temperature／Setpoint`
只读数据	温度勾选、设定取消。必填 · 填写：`温度只读；设定可写`
历史存储	两属性均开启。必填 · 填写：`勾选`
图表显示／实时监测	温度开启，设定关闭。必填 · 填写：`温度开；设定关`
分享权限	本篇保持关闭。必填 · 填写：`不勾选`
数据类型／范围／单位／步长	整数，温度-40～100℃，设定16～35℃，步长1。必填 · 填写：`整数；℃；步长1`
修改	补齐必填项后保存。必填 · 填写：`修改`

9. 确认发布产品

**操作位置：*产品管理→*发布确认 **操作步骤：**核对保存结果，点击确定。

确认发布产品

提交发布后继续核对实际接入回执。

截图重点说明

字段 / 控件	说明
发布／确定	保存模型和正式格式后发布，确认弹窗后核对回执。必填 · 填写：`确定发布`

10. 确认节点已应用

**操作位置：*产品管理→*接入配置同步 **操作步骤：**展开节点结果。

确认节点已应用

APPLIED、成功1、失败0，仍需实际收发。

截图重点说明

字段 / 控件	说明
接入配置同步	核对实际节点已应用、失败原因为空。必填 · 填写：`APPLIED；成功1、失败0`

温度只读-40～100℃，设定可写16～35℃，步长1。两字段历史开启；APPLIED后再完成真实上下行。

三、打开UDP端点

正式FMQX配置json

text

{

  "schemaVersion": 3,

  "groups": [

    {

      "id": "FastBee_tutorial_FastBee_ArrayUDP_Tutorial_01",

      "name": "FastBee_数组UDP教程",

      "sortOrder": 55,

      "isSystem": false

    }

  ],

  "sessions": [

    {

      "id": "FastBee_import_FastBee_ArrayUDP_Tutorial_01",

      "groupId": "FastBee_tutorial_FastBee_ArrayUDP_Tutorial_01",

      "name": "FastBee_数组无线",

      "protocol": "UDP",

      "transport": "UDP",

      "host": "127.0.0.1",

      "port": 8889,

      "clientId": "FastBee_ArrayUDP_Tutorial_01",

      "autoReconnect": false,

      "tcpLineMode": false,

      "udpLocalPort": 15022,

      "udpTargetAddress": "127.0.0.1",

      "udpTargetPort": 8889,

      "jsonDevice": {

        "format": "JSON_ARRAY",

        "responseRoute": "",

        "initialState": {

          "FastBee_temperature": 29,

          "FastBee_setpoint": 30

        }

      }

    }

  ]

}

本篇v2使用udpLocalPort15022、udpTargetAddress及udpTargetPort8889；首次错误配置保留在内部材料，不作为正式配置。

11. 导入本篇v2会话

**操作位置：*FMQX网页版→*配置文件 操作步骤：选择导入配置，导入下方正式JSON。

导入本篇v2会话

使用本篇独立UDP会话。

截图重点说明

字段 / 控件	说明
导入配置	使用本篇v2独立分组与会话；原错误配置留在内部材料。必填 · 填写：`FastBee_连接配置_v2.json`

12. 核对本地与远端端口方向

操作位置：FMQX网页版→连接配置 操作步骤：核对本地15022、远端127.0.0.1:8889，广播关闭后保存。

核对本地与远端端口方向

15022属于FMQX；8889属于FMQ，二者不可互换。

截图重点说明

字段 / 控件	说明
本地监听地址	FMQX绑定的本地网卡地址，0.0.0.0表示本机可用接口。必填 · 填写：`0.0.0.0`
本地端口	FMQX发送源端口及接收下行端口；须未被占用。必填 · 填写：`15022`
远端目标地址	FMQ UDP监听所在机器地址。本篇同机。必填 · 填写：`127.0.0.1`
远端目标端口	FMQ UDP监听端口，与本地端口用途不同。必填 · 填写：`8889`
启用广播	本篇明确单播到FMQ。必填 · 填写：`关闭`
连接超时	单位毫秒，不代表UDP已完成服务端握手。必填 · 填写：`5000毫秒`
自动重连	本篇关闭，使用手动停止恢复。必填 · 填写：`关闭`
测试连接／保存配置	保存端点后仍需完成真实上下行。必填 · 填写：`测试连接；保存配置`

13. 打开本地UDP端点

**操作位置：*FMQX网页版→*数组无线 **操作步骤：**点击连接，确认已连接及远端8889。

打开本地UDP端点

已连接仅表示端点打开，上报后才能确认运行时识别与下行地址。

截图重点说明

字段 / 控件	说明
连接／断开	连接表示FMQX本地UDP端点已打开，需上报登记返回地址。必填 · 填写：`已连接／已断开`

四、发送十个不同样本

一个完整UDP数据报json

text

{

  "clientId": "FastBee_ArrayUDP_Tutorial_01",

  "data": [

    {

      "id": "FastBee_temperature",

      "value": 20

    },

    {

      "id": "FastBee_setpoint",

      "value": 30

    }

  ]

}

温度逐条20～29，设定保持30；每个数据报均带clientId，数组元素id保持模型标识。

14. 准备第一条完整上报

**操作位置：*FMQX网页版→*发送数据 **操作步骤：**按图填写完整报文，核对身份、字段及目标地址后发送。

准备第一条完整上报

本图补拍完整发送表单，未重发旧样本；实际发送与处理结果见随后的独立记录。

截图重点说明

字段 / 控件	说明
clientId设备身份	每个数据报均携带编号；不能只在首次报文提供身份。必填 · 填写：`FastBee_ArrayUDP_Tutorial_01`
data数组	固定id对应物模型，value填写整数。必填 · 填写：`data=[{id,value},{id,value}]`
远端目标地址	FMQ UDP监听所在机器地址。本篇同机。必填 · 填写：`127.0.0.1`
远端目标端口	FMQ UDP监听端口，与本地端口用途不同。必填 · 填写：`8889`
Text／发送	每次发送一个完整UTF-8 JSON数据报。必填 · 填写：`Text；发送`

15. 发送十个不同数据报

**操作位置：*FMQX网页版→*发送数据包 操作步骤：Text逐条发送温度20～29、设定30，每条带完整clientId及data数组。

发送十个不同数据报

02:37:49～02:37:58十条；每条独立等待平台接收。

截图重点说明

字段 / 控件	说明
clientId设备身份	每个数据报均携带编号；不能只在首次报文提供身份。必填 · 填写：`FastBee_ArrayUDP_Tutorial_01`
data数组	固定id对应物模型，value填写整数。必填 · 填写：`data=[{id,value},{id,value}]`
远端目标地址	FMQ UDP监听所在机器地址。本篇同机。必填 · 填写：`127.0.0.1`
远端目标端口	FMQ UDP监听端口，与本地端口用途不同。必填 · 填写：`8889`
Text／发送	每次发送一个完整UTF-8 JSON数据报。必填 · 填写：`Text；发送`

每次发送一个完整Text报文，逐条等平台收到。实测02:37:49.521～02:37:58.561，十条温度20～29，设定30；不要照搬MQTT的裸数组或主题。

五、下发32并独立回报

16. 从平台下发设定32

**操作位置：*设备详情→*运行状态 **操作步骤：**从当前30将设定调整32并点击发送。

从平台下发设定32

该图显示操作入口；指令实收和回复在随后两图单独核对。

截图重点说明

字段 / 控件	说明
设定滑块／发送	先下发32，停止恢复后下发34。必填 · 填写：`32／34`

17. 将控制目标调整为32

**操作位置：*设备详情→*运行状态 **操作步骤：**将设定滑块移至32，核对浮层目标后点击右侧发送。

将控制目标调整为32

补拍时当前值已为34；浮层32才是待发送目标。本次补拍没有再次点击发送。

截图重点说明

字段 / 控件	说明
设定滑块／发送	先下发32，停止恢复后下发34。必填 · 填写：`32／34`

18. 确认32命令真实收到

**操作位置：*FMQX网页版→*接收记录 **操作步骤：**核对目标32、params数组与命令id。

确认32命令真实收到

02:38:06.119真实接收143字节。

截图重点说明

字段 / 控件	说明
真实接收记录	核对命令id、params数组和32／34目标。必填 · 填写：`143字节；32／34`

19. 核对32演示回复

**操作位置：*FMQX网页版→*发送记录 **操作步骤：**核对同id、code200、data32与次数1。

核对32演示回复

FMQX演示回复，仍需人工独立属性状态，不证明物理动作。

截图重点说明

字段 / 控件	说明
FMQX演示自动回复	核对同id、code200、data对象、请求摘要及演示次数。必填 · 填写：`executionCount1／2`

执行后的独立29／32状态json

text

{

  "clientId": "FastBee_ArrayUDP_Tutorial_01",

  "data": [

    {

      "id": "FastBee_temperature",

      "value": 29

    },

    {

      "id": "FastBee_setpoint",

      "value": 32

    }

  ]

}

回复data对象后，人工发送完整身份封套和data数组，不把回复当成属性上报。

20. 独立回报29与32

**操作位置：*FMQX网页版→*发送数据 **操作步骤：**演示回复后另发完整属性报文，温度29、设定32。

独立回报29与32

本图补拍独立属性状态发送框，未再次发送；实际状态时间及结果以随后平台和历史记录为准。

截图重点说明

字段 / 控件	说明
clientId设备身份	每个数据报均携带编号；不能只在首次报文提供身份。必填 · 填写：`FastBee_ArrayUDP_Tutorial_01`
data数组	固定id对应物模型，value填写整数。必填 · 填写：`data=[{id,value},{id,value}]`
远端目标地址	FMQ UDP监听所在机器地址。本篇同机。必填 · 填写：`127.0.0.1`
远端目标端口	FMQ UDP监听端口，与本地端口用途不同。必填 · 填写：`8889`
Text／发送	每次发送一个完整UTF-8 JSON数据报。必填 · 填写：`Text；发送`

21. 独立上报后确认当前32

**操作位置：**FMQX发送数据／设备运行状态 操作步骤：人工发29／32封套，再刷新平台当前值。

独立上报后确认当前32

02:38:06.965独立属性入站，当前32，实际历史同值。

截图重点说明

字段 / 控件	说明
clientId设备身份	每个数据报均携带编号；不能只在首次报文提供身份。必填 · 填写：`FastBee_ArrayUDP_Tutorial_01`
data数组	固定id对应物模型，value填写整数。必填 · 填写：`data=[{id,value},{id,value}]`
当前值	独立属性上报后刷新核对，不能用待发目标代替。必填 · 填写：`32；最终34`
Text／发送	每次发送一个完整UTF-8 JSON数据报。必填 · 填写：`Text；发送`

六、停止恢复后验证34

22. 停止UDP收发

**操作位置：*FMQX网页版→*数组无线 **操作步骤：**停止发送并断开本地端点。

停止UDP收发

灰色已断开代表FMQX端点关闭，不能据此要求TCP式离线事件。

截图重点说明

字段 / 控件	说明
连接／断开	连接表示FMQX本地UDP端点已打开，需上报登记返回地址。必填 · 填写：`已连接／已断开`

23. 恢复并先上报登记返回地址

**操作位置：*FMQX网页版→*数组无线 **操作步骤：**复用15022重新打开，先发完整29／32封套。

恢复并先上报登记返回地址

02:38:13.588恢复属性更新UDP返回地址，再发新控制。

截图重点说明

字段 / 控件	说明
clientId设备身份	每个数据报均携带编号；不能只在首次报文提供身份。必填 · 填写：`FastBee_ArrayUDP_Tutorial_01`
连接／断开	连接表示FMQX本地UDP端点已打开，需上报登记返回地址。必填 · 填写：`已连接／已断开`
Text／发送	每次发送一个完整UTF-8 JSON数据报。必填 · 填写：`Text；发送`

恢复先上报29／32json

text

{

  "clientId": "FastBee_ArrayUDP_Tutorial_01",

  "data": [

    {

      "id": "FastBee_temperature",

      "value": 29

    },

    {

      "id": "FastBee_setpoint",

      "value": 32

    }

  ]

}

先让FMQ重新登记本端返回地址，再从平台下发34。

24. 确认恢复34真实收到

**操作位置：*FMQX网页版→*接收记录 **操作步骤：**平台下发34，核对新id、params数组34。

确认恢复34真实收到

02:38:13.920实收新命令，恢复后下行可达。

截图重点说明

字段 / 控件	说明
真实接收记录	核对命令id、params数组和32／34目标。必填 · 填写：`143字节；32／34`
设定滑块／发送	先下发32，停止恢复后下发34。必填 · 填写：`32／34`

25. 核对34演示回复次数2

**操作位置：*FMQX网页版→*发送记录 **操作步骤：**核对同id、code200、data34及次数2。

核对34演示回复次数2

02:38:13.921回复，平台executionConfirmed=false。

截图重点说明

字段 / 控件	说明
FMQX演示自动回复	核对同id、code200、data对象、请求摘要及演示次数。必填 · 填写：`executionCount1／2`

恢复后的独立29／34状态json

text

{

  "clientId": "FastBee_ArrayUDP_Tutorial_01",

  "data": [

    {

      "id": "FastBee_temperature",

      "value": 29

    },

    {

      "id": "FastBee_setpoint",

      "value": 34

    }

  ]

}

FMQX演示回复后人工独立发送，再刷新实时与历史。

26. 独立回报29与34

**操作位置：*FMQX网页版→*发送数据 **操作步骤：**恢复后的演示回复之后，另发温度29、设定34的完整属性报文。

独立回报29与34

本图补拍独立属性状态发送框，未再次发送；实际状态时间及结果以随后平台和历史记录为准。

截图重点说明

字段 / 控件	说明
clientId设备身份	每个数据报均携带编号；不能只在首次报文提供身份。必填 · 填写：`FastBee_ArrayUDP_Tutorial_01`
data数组	固定id对应物模型，value填写整数。必填 · 填写：`data=[{id,value},{id,value}]`
远端目标地址	FMQ UDP监听所在机器地址。本篇同机。必填 · 填写：`127.0.0.1`
远端目标端口	FMQ UDP监听端口，与本地端口用途不同。必填 · 填写：`8889`
Text／发送	每次发送一个完整UTF-8 JSON数据报。必填 · 填写：`Text；发送`

27. 独立上报后确认当前34

**操作位置：**FMQX发送数据／设备运行状态 **操作步骤：**人工发29／34完整数据报，刷新核对。

独立上报后确认当前34

02:38:14.603独立状态，最后温度29、设定34。

截图重点说明

字段 / 控件	说明
clientId设备身份	每个数据报均携带编号；不能只在首次报文提供身份。必填 · 填写：`FastBee_ArrayUDP_Tutorial_01`
data数组	固定id对应物模型，value填写整数。必填 · 填写：`data=[{id,value},{id,value}]`
当前值	独立属性上报后刷新核对，不能用待发目标代替。必填 · 填写：`32；最终34`
Text／发送	每次发送一个完整UTF-8 JSON数据报。必填 · 填写：`Text；发送`

七、查询历史并刷新

28. 设置十样本查询

**操作位置：*数据中心→*历史数据 **操作步骤：**选本设备、温度、2026-10-13 02:37:48～02:38:00。

设置十样本查询

日期输入横向截断，完整值按相邻参数填写。

截图重点说明

字段 / 控件	说明
设备与字段	选择本篇数组无线的温度或设定。必填 · 填写：`FastBee_数组无线；温度／设定`
日期与起止时间	日期2026-10-13；温度02:37:48～02:38:00，设定02:38:00～02:38:23。必填 · 填写：`2026-10-13；02:37:48～02:38:00／02:38:00～02:38:23`
高级筛选／查询／刷新	刷新后重选相同设备、字段、时间，等加载结束。必填 · 填写：`查询并刷新重查`

29. 逐行核对20到29

**操作位置：*数据中心→*历史数据 **操作步骤：**等待查询完成，核对十个值和时间。

逐行核对20到29

20～29齐全，实际存储逐条唯一同值。

截图重点说明

字段 / 控件	说明
高级筛选／查询／刷新	刷新后重选相同设备、字段、时间，等加载结束。必填 · 填写：`查询并刷新重查`

30. 查询设定状态

**操作位置：*数据中心→*历史数据 **操作步骤：**改选设定温度，02:38:00～02:38:23。

查询设定状态

覆盖独立32、恢复32与最终34。

截图重点说明

字段 / 控件	说明
设备与字段	选择本篇数组无线的温度或设定。必填 · 填写：`FastBee_数组无线；温度／设定`
日期与起止时间	日期2026-10-13；温度02:37:48～02:38:00，设定02:38:00～02:38:23。必填 · 填写：`2026-10-13；02:37:48～02:38:00／02:38:00～02:38:23`
高级筛选／查询／刷新	刷新后重选相同设备、字段、时间，等加载结束。必填 · 填写：`查询并刷新重查`

31. 刷新后重查32到34

**操作位置：*数据中心→*历史数据 **操作步骤：**刷新重选相同条件，核对32→32→34。

刷新后重查32到34

02:38:06为32、02:38:13恢复仍32、02:38:14为34，三条独立消息。

截图重点说明

字段 / 控件	说明
高级筛选／查询／刷新	刷新后重选相同设备、字段、时间，等加载结束。必填 · 填写：`查询并刷新重查`

三条设定历史32→32→34来自执行后状态、恢复上报和新34状态。每条消息都唯一关联实际历史，重复数值不等于重复入库。刷新后重选同一设备、字段和完整时间，等加载结束。

八、结束与再次验收

停止发送并断开本篇会话，保留产品、设备、模型及历史。再次验收记录新时间窗，发送十个不同样本，核对新的下行实收、演示回复、独立状态和历史；停止恢复后再验证一轮，结束断开。

32. 结束收发并保留资源

**操作位置：*FMQX网页版→*本篇会话 **操作步骤：**停止发送并断开连接，保留业务资源及历史。

结束收发并保留资源

本篇真实会话已断开，保留产品、设备、配置与历史供再次验收。

截图重点说明

字段 / 控件	说明
停止并保留	结束停止收发、关闭本地端点，保留设备、会话和历史。必填 · 填写：`已断开；最后29／34`
连接／断开	连接表示FMQX本地UDP端点已打开，需上报登记返回地址。必填 · 填写：`已连接／已断开`

字段与参数参考

设备接入向导

字段 / 控件	填写说明
接入来源	本篇选择新建产品，复验直接复用保留资源。必填 · 填写：`新建产品`新建产品：本篇创建独立资源；本篇创建独立资源。已有产品：复验使用已保留产品；复验使用已保留产品。
产品／设备名称	名称精简，便于定位本篇资源。必填 · 填写：`FastBee_数组无线`
向导对象样例	先用对象解析两字段，之后改正式JSON数组/UDP。必填 · 填写：`{"FastBee_temperature":20,"FastBee_setpoint":30}`
字段、类型、单位与路径	对象样例生成两个整数℃字段，标识逐字一致。必填 · 填写：`FastBee_temperature；FastBee_setpoint；整数；℃`
设备标识	每个UDP报文clientId与本编号一致，不使用会话id代替。必填 · 填写：`FastBee_ArrayUDP_Tutorial_01`
初始接入概况	向导初始JSON/MQTT；1台设备、2字段，后续修改正式格式。必填 · 填写：`1台、2字段`

协议与发布生效

字段 / 控件	填写说明
数据格式	正式采用JSON数组。必填 · 填写：`JSON 数组` 修改后须发布。
传输方式	选择UDP，每个数据报带设备身份，不使用MQTT主题。必填 · 填写：`UDP` 修改后须发布。UDP：本篇数据报收发；本篇数据报收发。TCP：另一篇流式连接场景；另一篇流式连接场景。MQTT：另一篇主题消息场景；另一篇主题消息场景。
联网方式	本篇为WIFI，仍需独立配置UDP地址和端口。必填 · 填写：`WIFI` 修改后须发布。
发布／确定	保存模型和正式格式后发布，确认弹窗后核对回执。修改后须发布。
接入配置同步	核对实际节点已应用、失败原因为空。必填 · 填写：`APPLIED；成功1、失败0` 修改后须发布。

功能定义

字段 / 控件	填写说明
模型翻译	温度与设定补齐英文名称。必填 · 填写：`Temperature／Setpoint` 修改后须发布。
模型标识	data数组元素id与模型标识逐字一致。必填 · 填写：`FastBee_temperature／FastBee_setpoint` 修改后须发布。
模型类别	两字段均为属性。必填 · 填写：`属性` 修改后须发布。属性：本篇读数和设定；本篇读数和设定。功能：本篇不新增；本篇不新增。事件：本篇不新增；本篇不新增。
只读数据	温度勾选、设定取消。必填 · 填写：`温度只读；设定可写` 修改后须发布。勾选：仅展示；仅展示。不勾选：按权限可控制；按权限可控制。
历史存储	两属性均开启。必填 · 填写：`勾选` 修改后须发布。勾选：保存属性历史；保存属性历史。不勾选：不满足本篇验收；不满足本篇验收。
图表显示／实时监测	温度开启，设定关闭。必填 · 填写：`温度开；设定关` 修改后须发布。勾选：温度采用；温度采用。不勾选：设定采用；设定采用。
分享权限	本篇保持关闭。必填 · 填写：`不勾选` 修改后须发布。不勾选：按账号授权访问；按账号授权访问。勾选：分享需额外权限审查；分享需额外权限审查。
数据类型／范围／单位／步长	整数，温度-40～100℃，设定16～35℃，步长1。必填 · 填写：`整数；℃；步长1` 修改后须发布。
修改	补齐必填项后保存。修改后须发布。

FMQX网页版连接

字段 / 控件	填写说明
导入配置	使用本篇v2独立分组与会话；原错误配置留在内部材料。修改后须重连。
本地监听地址	FMQX绑定的本地网卡地址，0.0.0.0表示本机可用接口。必填 · 填写：`0.0.0.0` 修改后须重连。
本地端口	FMQX发送源端口及接收下行端口；须未被占用。必填 · 填写：`15022` 修改后须重连。
远端目标地址	FMQ UDP监听所在机器地址。本篇同机。必填 · 填写：`127.0.0.1` 修改后须重连。
远端目标端口	FMQ UDP监听端口，与本地端口用途不同。必填 · 填写：`8889` 修改后须重连。
启用广播	本篇明确单播到FMQ。必填 · 填写：`关闭` 修改后须重连。关闭：本篇采用；本篇采用。开启：广播设备另行验证；广播设备另行验证。
连接超时	单位毫秒，不代表UDP已完成服务端握手。必填 · 填写：`5000毫秒` 修改后须重连。
自动重连	本篇关闭，使用手动停止恢复。必填 · 填写：`关闭` 修改后须重连。关闭：手动验证恢复；手动验证恢复。开启：需单独验证；需单独验证。
测试连接／保存配置	保存端点后仍需完成真实上下行。修改后须重连。
连接／断开	连接表示FMQX本地UDP端点已打开，需上报登记返回地址。修改后须重连。

设备上报与演示回复

字段 / 控件	填写说明
clientId设备身份	每个数据报均携带编号；不能只在首次报文提供身份。必填 · 填写：`FastBee_ArrayUDP_Tutorial_01`
data数组	固定id对应物模型，value填写整数。必填 · 填写：`data=[{id,value},{id,value}]`
Text／发送	每次发送一个完整UTF-8 JSON数据报。
真实接收记录	核对命令id、params数组和32／34目标。必填 · 填写：`143字节；32／34`
FMQX演示自动回复	核对同id、code200、data对象、请求摘要及演示次数。必填 · 填写：`executionCount1／2`

设备运行状态

字段 / 控件	填写说明
设定滑块／发送	先下发32，停止恢复后下发34。
当前值	独立属性上报后刷新核对，不能用待发目标代替。必填 · 填写：`32；最终34`

历史数据

字段 / 控件	填写说明
设备与字段	选择本篇数组无线的温度或设定。必填 · 填写：`FastBee_数组无线；温度／设定`
日期与起止时间	日期2026-10-13；温度02:37:48～02:38:00，设定02:38:00～02:38:23。必填 · 填写：`2026-10-13；02:37:48～02:38:00／02:38:00～02:38:23`
高级筛选／查询／刷新	刷新后重选相同设备、字段、时间，等加载结束。

停止与恢复

字段 / 控件	填写说明
停止并保留	结束停止收发、关闭本地端点，保留设备、会话和历史。必填 · 填写：`已断开；最后29／34`

遇到问题时先查哪里

看到什么现象	可能原因	先检查哪里	如何恢复
已连接但平台无数据	端点打开并不证明服务端已收到，或格式与身份不符。	远端8889、每报clientId、data数组、APPLIED。	修正完整报文，在新窗口逐条发送并核对实际值。
上报成功但下行收不到	源端点变化、没有新上报登记，或回包被网络阻断。	本地15022是否打开、最近上报时间、回包路径。	先独立上报，再下发新的范围内目标。
字段不更新	数组元素id误写成样本序号或MQTT裸数组。	clientId外层封套、固定模型id与整数value。	按完整示例修正后发送一个数据报。
回复成功但当前值未变	未发送独立属性状态。	回复data对象之后是否上报data数组。	人工上报状态并查询实时与历史。
断开后平台没有TCP式离线	UDP没有TCP连接断开事件，本篇登记事件均为online。	FMQX端点状态与平台离线策略。	按停止、重新打开、先上报、再控制验证恢复。
刷新历史缺值	设备、字段或完整时间窗不符。	温度02:37:48～02:38:00，设定02:38:00～02:38:23。	重选条件等加载完成，复验记录新窗口。

JSON 数组与 UDP 无线终端接入 ​

开始前先了解 ​

一、创建独立资源 ​

1. 选择新建独立产品 ​

截图重点说明 ​

2. 用对象样例生成两字段 ​

截图重点说明 ​

3. 核对字段、类型和单位 ​

截图重点说明 ​

4. 填写独立设备编号 ​

截图重点说明 ​

5. 核对初始接入概况 ​

截图重点说明 ​

二、配置正式协议并发布 ​

6. 保存正式JSON数组与UDP ​

截图重点说明 ​

7. 保存可写设定与历史 ​

截图重点说明 ​

8. 保存只读温度与历史 ​

截图重点说明 ​

9. 确认发布产品 ​

截图重点说明 ​

10. 确认节点已应用 ​

截图重点说明 ​

三、打开UDP端点 ​

11. 导入本篇v2会话 ​

截图重点说明 ​

12. 核对本地与远端端口方向 ​

截图重点说明 ​

13. 打开本地UDP端点 ​

截图重点说明 ​

四、发送十个不同样本 ​

14. 准备第一条完整上报 ​

截图重点说明 ​

15. 发送十个不同数据报 ​

截图重点说明 ​

五、下发32并独立回报 ​

16. 从平台下发设定32 ​

截图重点说明 ​

17. 将控制目标调整为32 ​

截图重点说明 ​

18. 确认32命令真实收到 ​

截图重点说明 ​

19. 核对32演示回复 ​

截图重点说明 ​

20. 独立回报29与32 ​

截图重点说明 ​

21. 独立上报后确认当前32 ​

截图重点说明 ​

六、停止恢复后验证34 ​

22. 停止UDP收发 ​

截图重点说明 ​

23. 恢复并先上报登记返回地址 ​

截图重点说明 ​

24. 确认恢复34真实收到 ​

截图重点说明 ​

25. 核对34演示回复次数2 ​

截图重点说明 ​

26. 独立回报29与34 ​

截图重点说明 ​

27. 独立上报后确认当前34 ​

截图重点说明 ​

七、查询历史并刷新 ​

28. 设置十样本查询 ​

截图重点说明 ​

29. 逐行核对20到29 ​

截图重点说明 ​

30. 查询设定状态 ​

截图重点说明 ​

31. 刷新后重查32到34 ​

截图重点说明 ​

八、结束与再次验收 ​

32. 结束收发并保留资源 ​

截图重点说明 ​

字段与参数参考 ​

设备接入向导 ​

协议与发布生效 ​

功能定义 ​

FMQX网页版连接 ​

设备上报与演示回复 ​

JSON 数组与 UDP 无线终端接入

开始前先了解

一、创建独立资源

1. 选择新建独立产品

截图重点说明

2. 用对象样例生成两字段

截图重点说明

3. 核对字段、类型和单位

截图重点说明

4. 填写独立设备编号

截图重点说明

5. 核对初始接入概况

截图重点说明

二、配置正式协议并发布

6. 保存正式JSON数组与UDP

截图重点说明

7. 保存可写设定与历史

截图重点说明

8. 保存只读温度与历史

截图重点说明

9. 确认发布产品

截图重点说明

10. 确认节点已应用

截图重点说明

三、打开UDP端点

11. 导入本篇v2会话

截图重点说明

12. 核对本地与远端端口方向

截图重点说明

13. 打开本地UDP端点

截图重点说明

四、发送十个不同样本

14. 准备第一条完整上报

截图重点说明

15. 发送十个不同数据报

截图重点说明

五、下发32并独立回报

16. 从平台下发设定32

截图重点说明

17. 将控制目标调整为32

截图重点说明

18. 确认32命令真实收到

截图重点说明

19. 核对32演示回复

截图重点说明

20. 独立回报29与32

截图重点说明

21. 独立上报后确认当前32

截图重点说明

六、停止恢复后验证34

22. 停止UDP收发

截图重点说明

23. 恢复并先上报登记返回地址

截图重点说明

24. 确认恢复34真实收到

截图重点说明

25. 核对34演示回复次数2

截图重点说明

26. 独立回报29与34

截图重点说明

27. 独立上报后确认当前34

截图重点说明

七、查询历史并刷新

28. 设置十样本查询

截图重点说明

29. 逐行核对20到29

截图重点说明

30. 查询设定状态

截图重点说明

31. 刷新后重查32到34

截图重点说明

八、结束与再次验收

32. 结束收发并保留资源

截图重点说明

字段与参数参考

设备接入向导

协议与发布生效

功能定义

FMQX网页版连接

设备上报与演示回复