上行配置如何绑定属性

从设备采集上来的每一个数据，都必须绑定到平台的模型属性上，才能被解析、入库和展示。这一步在**事件模型（和功能模型）的"上行配置"**里完成，用 @ 来选择要绑定的属性。

这是新手最容易踩坑的一步——绑定方式有个关键细节，本文重点讲清楚。

为什么要绑定

设备返回的原始数据（比如某个寄存器读回来的值）本身平台并不知道它是"温度"还是"湿度"。上行配置的作用，就是告诉平台：这个采集回来的值，请存到哪个模型属性上。

进入 基础信息 → 产品配置 → 物模型 → 事件模型，新增或编辑一个事件模型，选择协议指令后，下方会出现 下行配置 和 上行配置 两个选项卡：

配置	作用	支持的配置值方式
下行配置	定义采集请求的参数（寄存器地址、数据类型等）	固定值、`@属性绑定`、`#脚本引用`
上行配置	定义采集结果映射到哪个模型属性	仅支持 `@属性绑定`

在上行配置的 配置值（value） 列，填入 @属性字段 即可把该采集结果绑定到对应属性。

重要：不能手动输入 @temperature

绑定属性时，不能直接手动敲 @temperature 这样的文字。必须：

如果只是手打了 @temperature 文字而没有从下拉里选，看起来一样，但绑定不会生效，采集数据会绑不上、数据出不来。

正确操作示意：

输入 @  →  弹出下拉：temperature / humidity / switch_status  →  ↑↓ 或鼠标选中 temperature  →  显示 @temperature（生效）

以温湿度传感器为例，物模型里已定义 temperature、humidity 两个属性，事件模型的上行配置这样绑定：

事件模型	上行配置 - value	说明
温度采集	`@temperature`	输入 `@` 后从下拉选择 temperature
湿度采集	`@humidity`	输入 `@` 后从下拉选择 humidity

绑定完成并配置好采集器后，采集回来的温度值会自动写入 temperature 属性，可在运行展板、数据中心看到。

功能模型 / 事件模型的下行配置也可以用 @ 绑定属性（除固定值、#脚本 外），操作方式完全一样——输入 @ 后从下拉选择，同样不能手打。

例如控制开关时，下行配置 value 填 @switch_status，界面上就能通过该属性的字典（开=1/关=0）下拉来控制设备。

Q：我明明填了 @temperature，为什么采不到数据？ 最常见的原因就是手动打字填的 @temperature，没有从下拉里选。删掉重填，输入 @ 后等下拉出现，再用鼠标或 Enter 选择。

Q：输入 @ 没有弹出下拉？ 确认物模型里已经先定义了属性。下拉列出的是当前产品物模型中已有的属性，没有属性自然没有候选项，需先到"属性模型"里新增属性。

Q：上行配置能不能填固定值或脚本？ 不能。上行配置的配置值只支持 @属性绑定。固定值和 #脚本引用 只在下行配置里支持。