属性类型

功能定义中的每个属性都有一个属性类型，它决定了属性的数据流向：数据从设备到平台，还是从平台到设备。在编辑属性时选择：

四种属性类型

属性类型	数据流向	典型示例
设备上报	设备 → 平台（只读）	温度、湿度、电压
云端下发	平台 → 设备（设备保存）	上报周期、阈值参数
设备云端共享	双向读写	运行模式、风机开关
云端私有	仅平台读写，不与设备交互	设备别名、备注参数

设备上报

设备采集并主动上报的数据。这类属性在设备详情中展示当前值，开启历史存储后可查询历史数据和图表分析，也是告警规则、消息规则最常用的数据源。

云端下发

由平台下发、设备接收并保存的参数。设备收到属性设置报文后保存生效（例如修改上报周期），通常不需要设备回传该值。

设备云端共享

设备与平台都可以读写的参数，双向同步：

• 平台修改该属性时，会向设备下发属性设置，设备执行后回复返回码。
• 设备上报该属性时，平台更新当前值。

适合"开关"、"模式"这类两端都需要读写的状态量。

云端私有

仅保存在平台侧，不会下发给设备。适合存放与设备相关但设备不感知的业务数据（如自定义排序、运营标记），可通过 API 读写。

属性类型对功能的影响

• 下发：只有「云端下发」和「设备云端共享」属性支持平台侧修改；在设备详情的属性页签中，其它类型属性没有下发入口。
• 历史存储与图表：对所有类型开放，但通常只对「设备上报」属性开启。
• 任务：定时任务的"属性下发"和"属性更新"同样受属性类型约束。
• Modbus 绑定：Modbus 透传设备的寄存器绑定仅支持「设备上报」和「设备云端共享」属性，见 Modbus 透传接入。

选择属性类型时建议：设备产生的数据选「设备上报」；两端都要读写的控制量选「设备云端共享」；只在平台侧维护的参数选「云端下发」或「云端私有」。