功能定义

功能定义（物模型）用来描述不同设备的能力，包括属性、事件和命令，从而加快设备接入和应用开发。功能定义对设备类型中的所有设备都有效。

在设备类型详情中点击「功能定义」页签进行编辑：

属性

属性是设备的能力参数，分为四种属性类型：

• 设备上报：设备采集并上报的数据，如温度、湿度。
• 云端下发：平台下发、设备保存的参数，如上报周期。
• 设备云端共享：设备可读写、平台也可读写的参数，如运行模式。
• 云端私有：仅平台读写，不与设备交互的参数，如设备别名。

每个属性包含属性标识符（唯一key）和属性名称，并需选择属性类型（决定数据流向）。数据类型支持：

数据类型	说明
integer / decimal	整型 / 小数，可配置小数位数、取值范围
string	字符串
bool	布尔型，可自定义真值/假值文本（如"运行"/"停止"）
enum	枚举型，配置枚举项与描述
array / object	数组 / 对象（JSON 结构）
map_point / map_circle / map_polygon	地理坐标 / 地理圆形围栏 / 地理多边形围栏
coords_point / coords_3d_point	平面坐标 / 三维坐标
daily_timer / daily_timer_range	每日定时器 / 每日定时区间

扩展选项可为属性配置单位（如 ℃、%）、小数位数、是否历史存储等。开启历史存储的属性才能查询历史数据和图表分析。各数据类型的取值格式与附加选项的完整说明请浏览 数据类型参考。

历史存储与单位

• 历史存储：开启后属性值会存入时序数据库，支持历史查询、图表分析和导出。
• 单位：展示在属性值旁边，App 和看板会引用单位文案。

事件

事件是设备在运行中主动上报的通知，如"滤网更换提醒"、"故障上报"。每个事件包含事件标识符、事件名称和事件参数（出参结构）。

命令

命令是平台下发、设备执行的动作，如"重启"、"恢复出厂设置"。每个命令包含命令标识符、命令名称、入参和出参结构。命令下发的说明请浏览 设备事件与命令。

导入功能

如果另一个设备类型已定义了类似的功能，可以使用「导入功能」从其它设备类型复制功能定义，避免重复配置。功能定义修改后新版本对新增数据生效，属性的历史数据按版本保留。