Alink JSON 与 UDP 无线终端接入
本文依据已有操作手册整理为线上操作参考。原文标为预期或未执行的操作,仍须按实际环境验证。本篇为补充参考,存在适用限制,原手册中的缺项状态继续保留。
完成设备上报、下行实收、FMQX演示回复、独立状态、实际历史和停止恢复。
**开始前准备:**具有产品、设备、模型、发布、控制与历史权限;本地应用、单节点FMQ和FMQX网页版可用,本设备连接参数已获取
开始前先了解
本篇适合以Alink JSON标准封套上报的UDP设备。完成创建、发布、十样本、下行实收、演示回复、独立状态、历史刷新和停止恢复。账号需产品、设备、模型、发布、控制与历史权限。
Alink上报的id是消息编号,每条新消息保持唯一;params是属性对象,键为物模型标识。它与JSON数组的固定元素id含义不同。
FMQX本地15023向FMQ的127.0.0.1:8889发送,每个数据报携带clientId。恢复或源端点改变后先上报登记返回地址,再控制。
FMQX网页版扮演演示终端,自动回复后由操作员人工独立上报属性状态;不证明物理执行器动作或自动连续遥测。
一、创建独立资源
新建独立产品,先以对象样例生成两字段,再保存本篇正式协议。再次验收复用已有资源。
向导对象样例json
{
"FastBee_temperature": 20,
"FastBee_setpoint": 30
}向导仅先生成两个字段。
1. 选择新建独立产品
**操作位置:*物联网→设备接入→*接入来源 操作步骤:选择新建产品,填写本篇名称;再次验收直接复用保留产品。

本图补拍创建入口;没有重复提交创建,后续设备与历史沿用本篇资源。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 接入来源 | 首次创建独立资源,复验使用保留资源。 必填 · 填写: 新建产品 |
| 产品/设备名称 | 以精简业务名定位本篇。 必填 · 填写: FastBee_Alink无线 |
2. 用对象样例生成两字段
**操作位置:*设备接入→*采集数据 **操作步骤:**新建本篇产品,解析对象样例。

先生成普通对象字段,再保存正式Alink JSON。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 接入来源 | 首次创建独立资源,复验使用保留资源。 必填 · 填写: 新建产品 |
| 产品/设备名称 | 以精简业务名定位本篇。 必填 · 填写: FastBee_Alink无线 |
| 向导对象样例 | 向导先解析普通对象生成两个字段,产品详情再改Alink JSON。 必填 · 填写: {"FastBee_temperature":20,"FastBee_setpoint":30} |
3. 核对字段类型和单位
**操作位置:*设备接入→*采集字段 **操作步骤:**核对两个固定标识、整数、℃。

正式Alink上报params键与模型标识一致。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 字段/类型/单位 | 两个整数℃字段,标识与params键一致。 必填 · 填写: FastBee_temperature/FastBee_setpoint;整数;℃ |
4. 填写独立设备编号
**操作位置:*设备接入→*添加设备 **操作步骤:**填写本篇编号与名称。

保留该设备供再次验收。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 设备标识 | 平台编号与本会话使用的设备身份一致。 必填 · 填写: FastBee_AlinkUDP_Tutorial_01 |
| 产品/设备名称 | 以精简业务名定位本篇。 必填 · 填写: FastBee_Alink无线 |
5. 核对初始接入概况
**操作位置:*设备接入→*确认 操作步骤:核对1台、2字段后创建。

初始JSON/MQTT,下一步改本篇正式格式。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 初始概况 | 1台、2字段;向导初始JSON/MQTT,之后保存正式协议。 必填 · 填写: 1台、2字段 |
二、配置模型和协议并发布
6. 保存正式Alink JSON与传输
操作位置:产品管理→产品信息 操作步骤:选择Alink JSON、UDP与WIFI后保存。

正式配置与本篇连接和报文一致。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 数据格式 | 正式采用Alink JSON;上报为id/version/method/params对象。 必填 · 填写: Alink JSON |
| 传输方式 | 按本篇选择,不能只改连接端口。 必填 · 填写: UDP |
| 联网方式 | 本篇WIFI,实际端点单独配置。 必填 · 填写: WIFI |
7. 保存可写设定与历史
**操作位置:*产品管理→功能定义→*设定 操作步骤:补Setpoint,取消只读、历史开启后修改。

设定16~35℃、步长1,图表和监测关闭。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 模型翻译 | 补齐英文名称。 必填 · 填写: Temperature/Setpoint |
| 模型标识 | params对象的键与此标识逐字一致。 必填 · 填写: FastBee_temperature/FastBee_setpoint |
| 模型类别 | 两个字段均为属性。 必填 · 填写: 属性 |
| 只读数据 | 温度勾选、设定取消。 必填 · 填写: 温度只读;设定可写 |
| 历史存储 | 两字段均开启。 必填 · 填写: 勾选 |
| 图表显示/实时监测 | 温度开启,设定关闭。 必填 · 填写: 温度开;设定关 |
| 分享权限 | 本篇关闭。 必填 · 填写: 不勾选 |
| 范围/单位/步长 | 温度-40~100℃,设定16~35℃,整数步长1。 必填 · 填写: 整数;℃;步长1 |
| 修改 | 补必填项后保存。 必填 · 填写: 修改 |
8. 保存只读温度与历史
**操作位置:*产品管理→功能定义→*温度 操作步骤:补Temperature,保持只读、历史和图表监测后修改。

温度-40~100℃、步长1。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 模型翻译 | 补齐英文名称。 必填 · 填写: Temperature/Setpoint |
| 只读数据 | 温度勾选、设定取消。 必填 · 填写: 温度只读;设定可写 |
| 历史存储 | 两字段均开启。 必填 · 填写: 勾选 |
| 图表显示/实时监测 | 温度开启,设定关闭。 必填 · 填写: 温度开;设定关 |
| 分享权限 | 本篇关闭。 必填 · 填写: 不勾选 |
| 范围/单位/步长 | 温度-40~100℃,设定16~35℃,整数步长1。 必填 · 填写: 整数;℃;步长1 |
| 修改 | 补必填项后保存。 必填 · 填写: 修改 |
9. 确认发布产品
**操作位置:*产品管理→*发布确认 **操作步骤:**核对保存结果,点击确定。

提交后继续核对实际APPLIED及真实收发。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 发布/确定 | 正式配置保存后发布,继续核对APPLIED。 必填 · 填写: 确定发布 |
10. 确认接入节点已应用
**操作位置:*产品管理→*接入配置同步 **操作步骤:**核对APPLIED和空失败原因。

成功1、失败0,继续设备闭环。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 接入配置同步 | 以实际节点回执判断是否应用。 必填 · 填写: APPLIED;成功1、失败0 |
保存后发布,确认快照1845已APPLIED,再做真实收发。核对实际应用结果后继续。
三、导入并连接FMQX网页版
本篇正式连接配置json
{
"schemaVersion": 3,
"groups": [
{
"id": "FastBee_tutorial_FastBee_AlinkUDP_Tutorial_01",
"name": "FastBee_AlinkUDP教程",
"sortOrder": 55,
"isSystem": false
}
],
"sessions": [
{
"id": "FastBee_import_FastBee_AlinkUDP_Tutorial_01",
"groupId": "FastBee_tutorial_FastBee_AlinkUDP_Tutorial_01",
"name": "FastBee_Alink无线",
"protocol": "UDP",
"transport": "UDP",
"host": "127.0.0.1",
"port": 8889,
"clientId": "FastBee_AlinkUDP_Tutorial_01",
"autoReconnect": false,
"tcpLineMode": false,
"udpLocalPort": 15023,
"udpTargetAddress": "127.0.0.1",
"udpTargetPort": 8889,
"jsonDevice": {
"format": "ALINK_JSON",
"responseRoute": "",
"initialState": {
"FastBee_temperature": 29,
"FastBee_setpoint": 30
}
}
}
]
}UTF-8 JSON。密码等凭据由管理员单独提供,导入文件不附带密码。
11. 导入独立FMQX会话
**操作位置:*FMQX网页版→*配置文件 **操作步骤:**导入下方本篇JSON配置。

不借用其他教程会话。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 导入配置 | 导入本篇独立会话和分组,凭据由管理员单独提供。 必填 · 填写: FastBee_连接配置.json |
12. 核对正式连接参数
**操作位置:*FMQX网页版→*连接配置 **操作步骤:**按相邻参数填写,保存本篇会话。

本地端点参数与真实验证一致;账号凭据由管理员提供。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 本地监听地址 | FMQX绑定网卡;0.0.0.0为本机接口。 必填 · 填写: 0.0.0.0 |
| 本地端口 | FMQX源端口及下行返回端口。 必填 · 填写: 15023 |
| 远端目标地址 | FMQ UDP监听地址。 必填 · 填写: 127.0.0.1 |
| 远端目标端口 | FMQ UDP入口,不与本地端口互换。 必填 · 填写: 8889 |
| 启用广播 | 本篇明确单播到FMQ。 必填 · 填写: 关闭 |
| 连接超时 | 单位毫秒。端点可达仍需完整上下行验证。 必填 · 填写: 5000毫秒 |
| 自动重连 | 本篇关闭,手工验证停止恢复。 必填 · 填写: 关闭 |
| 测试连接/保存配置 | 保存后复用本篇会话;测试连接不代替业务闭环。 必填 · 填写: 测试连接;保存配置 |
13. 连接本篇设备端点
**操作位置:*FMQX网页版→*本篇会话 **操作步骤:**点击连接并核对端点、已连接状态。

已连接还需完整上下行验证。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 连接/断开 | 核对本篇端点后打开,结束关闭。 必填 · 填写: 已连接/已断开 |
四、发送十个不同Alink样本
第一条完整Alink报文json
{
"clientId": "FastBee_AlinkUDP_Tutorial_01",
"id": "FastBee_AlinkUDP_Tutorial_01_sample_1",
"version": "1.0",
"method": "thing.event.property.post",
"params": {
"FastBee_temperature": 20,
"FastBee_setpoint": 30
}
}温度逐条20~29,设定30;每条id不同,params键不变。
14. 准备第一条完整上报
**操作位置:*FMQX网页版→*发送数据 **操作步骤:**按图填写完整报文,核对身份、字段及目标地址后发送。

本图补拍完整发送表单,未重发旧样本;实际发送与处理结果见随后的独立记录。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| clientId设备身份 | 上报顶层clientId与本设备编号一致,UDP每报携带。 必填 · 填写: FastBee_AlinkUDP_Tutorial_01 |
| Alink消息id | 每条新样本/独立状态使用不同编号;不得重用下行id作为新属性id。 必填 · 填写: FastBee_AlinkUDP_Tutorial_01_sample_1…10 |
| version/method/params | version1.0,属性method为thing.event.property.post,params是对象。 必填 · 填写: 1.0;thing.event.property.post;params对象 |
| 远端目标地址 | FMQ UDP监听地址。 必填 · 填写: 127.0.0.1 |
| 远端目标端口 | FMQ UDP入口,不与本地端口互换。 必填 · 填写: 8889 |
| JSON/Text/发送 | 完整UTF-8 JSON,逐条等平台接收后继续。 必填 · 填写: 完整报文;发送 |
15. 发送十个不同样本
**操作位置:*FMQX网页版→*发送记录 **操作步骤:**温度20~29、设定30,十个新id逐条发送。

逐条核对平台,实际历史十个温度齐全。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| Alink消息id | 每条新样本/独立状态使用不同编号;不得重用下行id作为新属性id。 必填 · 填写: FastBee_AlinkUDP_Tutorial_01_sample_1…10 |
| version/method/params | version1.0,属性method为thing.event.property.post,params是对象。 必填 · 填写: 1.0;thing.event.property.post;params对象 |
| clientId设备身份 | 上报顶层clientId与本设备编号一致,UDP每报携带。 必填 · 填写: FastBee_AlinkUDP_Tutorial_01 |
| JSON/Text/发送 | 完整UTF-8 JSON,逐条等平台接收后继续。 必填 · 填写: 完整报文;发送 |
本次实际入站2026-10-13T02:52:42.004+08:00~2026-10-13T02:52:51.037+08:00,十条源输入与实际消费及历史逐一对应。完整JSON不要照搬裸对象或JSON数组。每次复验使用新id和新时间窗。
五、下发32并独立回报
16. 从平台下发设定32
**操作位置:*设备详情→*运行状态 **操作步骤:**当前30调整至32,点击发送。

该图显示操作入口,随后核对独立实收与回复。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 设定滑块/发送 | 先32,停止恢复后34;实物遵循允许范围。 必填 · 填写: 32/34 |
17. 将控制目标调整为32
**操作位置:*设备详情→*运行状态 **操作步骤:**将设定滑块移至32,核对浮层目标后点击右侧发送。

补拍时当前值已为34;浮层32才是待发送目标。本次补拍没有再次点击发送。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 设定滑块/发送 | 先32,停止恢复后34;实物遵循允许范围。 必填 · 填写: 32/34 |
18. 确认32命令真实收到
**操作位置:*FMQX网页版→*接收记录 **操作步骤:**核对正式命令id、params对象和32。

2026-10-13 02:53:06.073真实收到;不要混用早先命令。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 真实接收记录 | 核对命令id、params对象和目标32/34。 必填 · 填写: 32/34;params对象 |
19. 核对32演示回复
**操作位置:*FMQX网页版→*发送记录 **操作步骤:**核对同id、code200、data32和次数。

本次演示次数1,仍需独立属性状态。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| FMQX演示回复 | 核对同id、code200、data对象、请求摘要和实际执行次数。 必填 · 填写: executionCount1/2 |
执行后的独立29/32状态json
{
"clientId": "FastBee_AlinkUDP_Tutorial_01",
"id": "FastBee_FastBee_AlinkUDP_Tutorial_01_after32",
"version": "1.0",
"method": "thing.event.property.post",
"params": {
"FastBee_temperature": 29,
"FastBee_setpoint": 32
}
}使用新属性id,method保持property.post,params为对象。
20. 独立回报29与32
**操作位置:*FMQX网页版→*发送数据 **操作步骤:**演示回复后另发完整属性报文,温度29、设定32。

本图补拍独立属性状态发送框,未再次发送;实际状态时间及结果以随后平台和历史记录为准。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| clientId设备身份 | 上报顶层clientId与本设备编号一致,UDP每报携带。 必填 · 填写: FastBee_AlinkUDP_Tutorial_01 |
| Alink消息id | 每条新样本/独立状态使用不同编号;不得重用下行id作为新属性id。 必填 · 填写: FastBee_AlinkUDP_Tutorial_01_sample_1…10 |
| version/method/params | version1.0,属性method为thing.event.property.post,params是对象。 必填 · 填写: 1.0;thing.event.property.post;params对象 |
| 远端目标地址 | FMQ UDP监听地址。 必填 · 填写: 127.0.0.1 |
| 远端目标端口 | FMQ UDP入口,不与本地端口互换。 必填 · 填写: 8889 |
| JSON/Text/发送 | 完整UTF-8 JSON,逐条等平台接收后继续。 必填 · 填写: 完整报文;发送 |
21. 刷新确认当前32
**操作位置:*设备详情→*运行状态 **操作步骤:**独立上报后刷新平台。

2026-10-13T02:53:06.878+08:00独立状态,实际历史同值。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 当前值 | 独立属性上报后刷新核对,不用待发目标替代。 必填 · 填写: 32;最终34 |
下行命令、演示回复与独立属性状态分别核对,不能只看发送成功。
六、停止恢复后验证34
22. 停止本篇收发
**操作位置:*FMQX网页版→*本篇会话 **操作步骤:**停止发送并断开。

保留会话和业务资源。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 连接/断开 | 核对本篇端点后打开,结束关闭。 必填 · 填写: 已连接/已断开 |
23. 恢复本篇端点
**操作位置:*FMQX网页版→*本篇会话 **操作步骤:**复用原配置连接,继续新目标验证。

恢复后用新34命令和独立状态证明上下行。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 连接/断开 | 核对本篇端点后打开,结束关闭。 必填 · 填写: 已连接/已断开 |
FMQX本地15023向FMQ的127.0.0.1:8889发送,每个数据报携带clientId。恢复或源端点改变后先上报登记返回地址,再控制。
24. 确认恢复34真实收到
**操作位置:*FMQX网页版→*接收记录 **操作步骤:**下发34,核对新id、params对象。

2026-10-13 02:53:13.984真实收到。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 真实接收记录 | 核对命令id、params对象和目标32/34。 必填 · 填写: 32/34;params对象 |
| 设定滑块/发送 | 先32,停止恢复后34;实物遵循允许范围。 必填 · 填写: 32/34 |
25. 核对恢复34演示回复
**操作位置:*FMQX网页版→*发送记录 **操作步骤:**核对同id、code200、data34和次数。

本次演示次数2,平台executionConfirmed=false。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| FMQX演示回复 | 核对同id、code200、data对象、请求摘要和实际执行次数。 必填 · 填写: executionCount1/2 |
恢复后的独立29/34状态json
{
"clientId": "FastBee_AlinkUDP_Tutorial_01",
"id": "FastBee_FastBee_AlinkUDP_Tutorial_01_after34",
"version": "1.0",
"method": "thing.event.property.post",
"params": {
"FastBee_temperature": 29,
"FastBee_setpoint": 34
}
}演示回复后人工独立上报,再刷新平台。
26. 独立回报29与34
**操作位置:*FMQX网页版→*发送数据 **操作步骤:**恢复后的演示回复之后,另发温度29、设定34的完整属性报文。

本图补拍独立属性状态发送框,未再次发送;实际状态时间及结果以随后平台和历史记录为准。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| clientId设备身份 | 上报顶层clientId与本设备编号一致,UDP每报携带。 必填 · 填写: FastBee_AlinkUDP_Tutorial_01 |
| Alink消息id | 每条新样本/独立状态使用不同编号;不得重用下行id作为新属性id。 必填 · 填写: FastBee_AlinkUDP_Tutorial_01_sample_1…10 |
| version/method/params | version1.0,属性method为thing.event.property.post,params是对象。 必填 · 填写: 1.0;thing.event.property.post;params对象 |
| 远端目标地址 | FMQ UDP监听地址。 必填 · 填写: 127.0.0.1 |
| 远端目标端口 | FMQ UDP入口,不与本地端口互换。 必填 · 填写: 8889 |
| JSON/Text/发送 | 完整UTF-8 JSON,逐条等平台接收后继续。 必填 · 填写: 完整报文;发送 |
27. 刷新确认当前34
**操作位置:*设备详情→*运行状态 **操作步骤:**独立上报后刷新。

最后温度29、设定34,实际历史同值。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 当前值 | 独立属性上报后刷新核对,不用待发目标替代。 必填 · 填写: 32;最终34 |
七、查询历史并刷新
28. 设置温度十样本查询
**操作位置:*数据中心→*历史数据 **操作步骤:**选本篇设备、温度和完整时间。

日期输入截断时仍按完整参数填写。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 设备与字段 | 选本篇设备的温度或设定。 必填 · 填写: FastBee_Alink无线;温度/设定 |
| 日期与起止时间 | 温度和设定分别使用本篇实际窗口。 必填 · 填写: 温度2026-10-13 02:52:40~2026-10-13 02:52:52;设定2026-10-13 02:52:52~2026-10-13 02:53:23 |
| 高级筛选/查询/刷新 | 刷新后重选同一设备、字段及完整时间,等加载完成。 必填 · 填写: 查询并刷新重查 |
29. 逐行核对20到29
**操作位置:*数据中心→*历史数据 **操作步骤:**等待加载完成,核对十个值。

十条消息与实际历史唯一关联。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 高级筛选/查询/刷新 | 刷新后重选同一设备、字段及完整时间,等加载完成。 必填 · 填写: 查询并刷新重查 |
30. 查询独立设定状态
**操作位置:*数据中心→*历史数据 **操作步骤:**改选设定和对应时间窗。

用实际独立状态时间核对。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 设备与字段 | 选本篇设备的温度或设定。 必填 · 填写: FastBee_Alink无线;温度/设定 |
| 日期与起止时间 | 温度和设定分别使用本篇实际窗口。 必填 · 填写: 温度2026-10-13 02:52:40~2026-10-13 02:52:52;设定2026-10-13 02:52:52~2026-10-13 02:53:23 |
| 高级筛选/查询/刷新 | 刷新后重选同一设备、字段及完整时间,等加载完成。 必填 · 填写: 查询并刷新重查 |
31. 刷新后重查设定历史
**操作位置:*数据中心→*历史数据 **操作步骤:**刷新重选同条件,等待加载完成。

独立32和最终34与实际存储一致。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 高级筛选/查询/刷新 | 刷新后重选同一设备、字段及完整时间,等加载完成。 必填 · 填写: 查询并刷新重查 |
刷新后重选同一设备、字段和完整时间,等加载结束。按照独立状态时间核对32与34,命令回复时间不等于属性历史时间。
八、结束与再次验收
停止发送并断开本篇会话,保留产品、设备、模型及历史。再次验收记录新时间窗,发送十个不同样本,核对新的下行实收、演示回复、独立状态和历史;停止恢复后再验证一轮,结束断开。
32. 结束收发并保留资源
**操作位置:*FMQX网页版→*本篇会话 **操作步骤:**停止发送并断开连接,保留业务资源及历史。

本篇真实会话已断开,保留产品、设备、配置与历史供再次验收。
截图重点说明
| 字段 / 控件 | 说明 |
|---|---|
| 停止并保留 | 停止发送、断开会话,保留业务资源与历史。 必填 · 填写: 已断开;最后29/34 |
| 连接/断开 | 核对本篇端点后打开,结束关闭。 必填 · 填写: 已连接/已断开 |
字段与参数参考
设备接入向导
| 字段 / 控件 | 填写说明 |
|---|---|
| 接入来源 | 首次创建独立资源,复验使用保留资源。 必填 · 填写: 新建产品新建产品:本篇采用;本篇采用。已有产品:复验使用已保留资源;复验使用已保留资源。 |
| 产品/设备名称 | 以精简业务名定位本篇。 必填 · 填写: FastBee_Alink无线 |
| 向导对象样例 | 向导先解析普通对象生成两个字段,产品详情再改Alink JSON。 必填 · 填写: {"FastBee_temperature":20,"FastBee_setpoint":30} |
| 字段/类型/单位 | 两个整数℃字段,标识与params键一致。 必填 · 填写: FastBee_temperature/FastBee_setpoint;整数;℃ |
| 设备标识 | 平台编号与本会话使用的设备身份一致。 必填 · 填写: FastBee_AlinkUDP_Tutorial_01 |
| 初始概况 | 1台、2字段;向导初始JSON/MQTT,之后保存正式协议。 必填 · 填写: 1台、2字段 |
协议与发布生效
| 字段 / 控件 | 填写说明 |
|---|---|
| 数据格式 | 正式采用Alink JSON;上报为id/version/method/params对象。 必填 · 填写: Alink JSON修改后须发布。 |
| 传输方式 | 按本篇选择,不能只改连接端口。 必填 · 填写: UDP修改后须发布。MQTT:主题消息;主题消息。TCP:设备主动连接;设备主动连接。UDP:每报身份与返回地址;每报身份与返回地址。 |
| 联网方式 | 本篇WIFI,实际端点单独配置。 必填 · 填写: WIFI修改后须发布。 |
| 发布/确定 | 正式配置保存后发布,继续核对APPLIED。 修改后须发布。 |
| 接入配置同步 | 以实际节点回执判断是否应用。 必填 · 填写: APPLIED;成功1、失败0修改后须发布。 |
功能定义
| 字段 / 控件 | 填写说明 |
|---|---|
| 模型翻译 | 补齐英文名称。 必填 · 填写: Temperature/Setpoint修改后须发布。 |
| 模型标识 | params对象的键与此标识逐字一致。 必填 · 填写: FastBee_temperature/FastBee_setpoint修改后须发布。 |
| 模型类别 | 两个字段均为属性。 必填 · 填写: 属性修改后须发布。属性:本篇采用;本篇采用。功能:本篇不新增;本篇不新增。事件:本篇不新增;本篇不新增。 |
| 只读数据 | 温度勾选、设定取消。 必填 · 填写: 温度只读;设定可写修改后须发布。勾选:温度采用;温度采用。不勾选:设定采用;设定采用。 |
| 历史存储 | 两字段均开启。 必填 · 填写: 勾选修改后须发布。勾选:本篇保存实际历史;本篇保存实际历史。不勾选:不满足本篇验收;不满足本篇验收。 |
| 图表显示/实时监测 | 温度开启,设定关闭。 必填 · 填写: 温度开;设定关修改后须发布。勾选:温度采用;温度采用。不勾选:设定采用;设定采用。 |
| 分享权限 | 本篇关闭。 必填 · 填写: 不勾选修改后须发布。不勾选:按账号授权;按账号授权。勾选:分享另行配置;分享另行配置。 |
| 范围/单位/步长 | 温度-40~100℃,设定16~35℃,整数步长1。 必填 · 填写: 整数;℃;步长1修改后须发布。 |
| 修改 | 补必填项后保存。 修改后须发布。 |
FMQX网页版连接
| 字段 / 控件 | 填写说明 |
|---|---|
| 导入配置 | 导入本篇独立会话和分组,凭据由管理员单独提供。 修改后须重连。 |
| 本地监听地址 | FMQX绑定网卡;0.0.0.0为本机接口。 必填 · 填写: 0.0.0.0修改后须重连。 |
| 本地端口 | FMQX源端口及下行返回端口。 必填 · 填写: 15023修改后须重连。 |
| 远端目标地址 | FMQ UDP监听地址。 必填 · 填写: 127.0.0.1修改后须重连。 |
| 远端目标端口 | FMQ UDP入口,不与本地端口互换。 必填 · 填写: 8889修改后须重连。 |
| 启用广播 | 本篇明确单播到FMQ。 必填 · 填写: 关闭修改后须重连。关闭:本篇采用;本篇采用。开启:另行验证;另行验证。 |
| 连接超时 | 单位毫秒。端点可达仍需完整上下行验证。 必填 · 填写: 5000毫秒修改后须重连。 |
| 自动重连 | 本篇关闭,手工验证停止恢复。 必填 · 填写: 关闭修改后须重连。关闭:本篇手工恢复;本篇手工恢复。开启:另行验证;另行验证。 |
| 测试连接/保存配置 | 保存后复用本篇会话;测试连接不代替业务闭环。 修改后须重连。 |
| 连接/断开 | 核对本篇端点后打开,结束关闭。 修改后须重连。 |
设备上报与演示回复
| 字段 / 控件 | 填写说明 |
|---|---|
| Alink消息id | 每条新样本/独立状态使用不同编号;不得重用下行id作为新属性id。 必填 · 填写: FastBee_AlinkUDP_Tutorial_01_sample_1…10 |
| version/method/params | version1.0,属性method为thing.event.property.post,params是对象。 必填 · 填写: 1.0;thing.event.property.post;params对象 |
| clientId设备身份 | 上报顶层clientId与本设备编号一致,UDP每报携带。 必填 · 填写: FastBee_AlinkUDP_Tutorial_01 |
| JSON/Text/发送 | 完整UTF-8 JSON,逐条等平台接收后继续。 |
| 真实接收记录 | 核对命令id、params对象和目标32/34。 必填 · 填写: 32/34;params对象 |
| FMQX演示回复 | 核对同id、code200、data对象、请求摘要和实际执行次数。 必填 · 填写: executionCount1/2 |
设备运行状态
| 字段 / 控件 | 填写说明 |
|---|---|
| 设定滑块/发送 | 先32,停止恢复后34;实物遵循允许范围。 |
| 当前值 | 独立属性上报后刷新核对,不用待发目标替代。 必填 · 填写: 32;最终34 |
历史数据
| 字段 / 控件 | 填写说明 |
|---|---|
| 设备与字段 | 选本篇设备的温度或设定。 必填 · 填写: FastBee_Alink无线;温度/设定 |
| 日期与起止时间 | 温度和设定分别使用本篇实际窗口。 必填 · 填写: 温度2026-10-13 02:52:40~2026-10-13 02:52:52;设定2026-10-13 02:52:52~2026-10-13 02:53:23 |
| 高级筛选/查询/刷新 | 刷新后重选同一设备、字段及完整时间,等加载完成。 |
停止与恢复
| 字段 / 控件 | 填写说明 |
|---|---|
| 停止并保留 | 停止发送、断开会话,保留业务资源与历史。 必填 · 填写: 已断开;最后29/34 |
遇到问题时先查哪里
| 看到什么现象 | 可能原因 | 先检查哪里 | 如何恢复 |
|---|---|---|---|
| 连接后平台不更新 | 身份、正式格式或上报地址不符。 | 本设备编号、Alink JSON、APPLIED及本篇端点。 | 修正配置,以新消息id、新时间窗发送完整封套。 |
| 有上报但无下行 | MQTT订阅错误,或UDP返回地址尚未登记。 | MQTT用本设备function/get;UDP检查本地端口与最近上报。 | 启用正确订阅,或先完整上报登记地址,再下发新目标。 |
| 重复发送仍无新历史 | 消息id复用,或查询窗口不符。 | 每条新属性id是否唯一、params是否对象。 | 使用新消息id并记录新时间,不删除旧数据掩盖问题。 |
| 回复成功但当前未变 | 尚未独立上报属性状态。 | 回复data之后有无独立property.post的params。 | 人工独立上报,再核对实时与历史。 |
| 次数从2开始 | 早先指令已演示执行并保留。 | 命令id、接收时间及实际次数。 | 分别核对,不混用早先实收与正式回复。 |
| 历史刷新后缺值 | 设备、字段或完整时间不符。 | 相邻参数给出的本篇温度和设定时间窗。 | 重选条件等加载,复验记录新窗口。 |

