物模型定义

物模型（TSL）将物理设备抽象为「属性、事件、服务」三类功能的数字化模型。产品创建后，在产品详情中定义物模型，产品下的设备自动继承。

菜单路径：物联网 → 产品管理 → 目标产品「管理」→ 物模型定义

最小闭环教程见为产品定义物模型；数据类型、identifier 命名规则与报文校验逻辑见配置物模型（TSL）。

三类功能

功能	方向	说明	示例
属性	设备 ⇄ 平台	设备的状态或可读写的参数，支持「查看历史数据 / 远程读取 / 属性设置」	温度 temperature、开关 Power
事件	设备 → 平台	设备运行时主动上报的通告，多用于告警与状态通知	过温告警 overTemp
服务	平台 → 设备	平台远程调用的设备能力，调用记录可在设备详情回溯	远程重启 reboot、设置功率 setPower

添加属性

在 物模型定义 → 物模型属性 中单击 新增：

字段	说明
属性名称	功能展示名，如「当前温度」
属性标识 identifier	与设备报文中的字段名一致，创建后建议不再修改
模块名称	所属功能模块（缺省为默认模块），用于大型设备的功能分组
读写权限	只读（R）/ 读写（RW）；只读属性不能被属性设置
数据类型	int / float / double / bool / enum / text / struct / date / array 等，选择后按类型填写取值范围、枚举项、步长等规格
属性图标 / 单位 / 属性描述	选填，展示增强

保存后即可在设备详情「物模型」页看到该属性并查看上报数据。

添加事件

在 物模型事件 中单击 新增：

字段	说明
事件名称 / 事件标识	展示名与报文中的事件标识符
模块名称	所属功能模块
事件类型	信息 / 警告 / 故障（按平台字典）
输出参数	事件携带的参数列表（名称、标识、数据类型）
事件图标 / 描述	选填

添加服务

在 物模型服务 中单击 新增：

字段	说明
服务名称 / 服务标识	展示名与调用标识符
模块名称	所属功能模块
调用类型	同步（等待设备应答）/ 异步（立即返回，设备异步执行）
调用入参	调用时需要传入的参数列表
调用出参	设备执行后返回的参数列表

同步服务的响应依赖设备在线

同步服务会等待设备应答，设备离线或固件未实现该服务会导致调用失败；批量定时调用设备的任务只支持异步服务，见设备任务。

TSL 快速导入与导出

• 快速导入：单击 快速导入 上传 JSON 文件（UTF-8 编码），一次性导入属性 / 事件 / 服务。文件格式与平台 TSL 结构一致，最简单的方式是先在页面手工定义一份导出为模板修改。
• 物模型 TSL：单击 物模型TSL 查看当前产品完整 TSL JSON，可一键 导出 保存或交给固件工程师对照实现。

先定物模型，再写固件

推荐流程：产品创建 → 定义物模型 → 导出 TSL 交付固件 → 固件按 MQTT设备接入 对接。物模型标识符与固件字段保持一致，可省去大量联调排错时间。

与设备调试的关系

物模型定义完成后：

• 设备上报数据 → 在设备详情「物模型」页查看实时值与历史曲线，见设备管理；
• 属性设置 / 服务调用 → 在设备详情「调试」页模拟下发验证，见设备调试。