# 配置物模型

# 物模型概述

物模型是对设备在云端的功能描述,包括设备的属性功能事件标签。物联网平台通过定义一种物的描述语言来描述物模型,称之为TSL(即 Thing Specification Language),采用JSON格式,您可以根据TSL组装上报设备的数据。

# 功能说明

物模型是物理空间中的实体(如传感器设备、消防装置、园区、工厂等)在云端的数字化表示,从属性功能事件标签四个维度,分别描述了该实体是什么、能做什么、可以对外提供哪些信息、可以自定义补充哪些信息。定义了物模型的这四个维度,即完成了产品功能的定义。

类型 说明
属性 用于描述设备运行时具体信息和状态。例如,环境监测设备所读取的当前环境温度、智能灯开关状态、电风扇风力等级等。属性可分为读、写和上报三种类型,即支持读取、设置属性、设备上报属性。
功能 指设备可供外部调用的指令或方法。服务调用中可设置输入和输出参数。输入参数是服务执行时的参数,输出参数是服务执行后的结果。相比于属性,服务可通过一条指令实现更复杂的业务逻辑,例如执行某项特定的任务。服务分为异步和同步两种调用方式。
事件 设备运行时,主动上报给云端的信息,一般包含需要被外部感知和处理的信息、告警和故障。事件中可包含多个输出参数。例如,某项任务完成后的通知信息;设备发生故障时的温度、时间信息;设备告警时的运行状态等。事件可以被订阅和推送。
标签 设备基于业务需要,自定义补充标签信息。

# 使用说明

1.Jetlinks物联网平台通过定义一种物的描述语言来描述物模型模块和功能,称为TSL(Thing Specification Language)。
2.物模型TSL文件格式为JSON。您可以在产品/设备物模型页面,单击物模型TSL,查看或导出JSON格式的TSL。
3.物模型支持单个和批量的添加,设备会自动继承产品的物模型配置参数。

说明

设备的物模型也支持单独配置,单独配置后,设备将脱离产品物模型,修改产品物模型不会再同步到设备。

# 限制说明

设备派生物模型(自动继承的产品物模型)默认都支持增删改查,以下情况除外:

# 物模型支持的数据类型

参数 说明 示例
int 32位整形 100
float 单精度浮点型 10.4
double 双精度浮点型 10.45
text 字符串,对应的数据长度不能超过10240字节。 你好,Jetlinks物联网平台
date 时间戳。默认格式为String类型的UTC时间戳,单位:毫秒。 1635839462000
boolen 布尔型。采用0(false)或1(true)来定义布尔值 1表示是、0表示否
enum 枚举型。定义枚举项的参数值和参数描述。 [{key:1,value:1}
array 数组。需声明数组内的元素类型、数组元素个数。需确保同一个数组元素类型相同。元素个数限制为1~512个。 [1, 2, 3, 4, 5, 6]
Object 结构体数据,支持树形结构化数据。树形数据格式为JSON 。 { "name":"烟感设备", "address":1楼}
file 文件 https://gimg2.baidu.com/image_search/src=http%3A%2…sec=1660189147&t=7e5068baf7bef3fb0664476ba4d94822
存储配置 单选下拉框,支持存储、不存储。 存储
指标配置
  • 标识:指标唯一标识。
  • 名称:为指标命名,最多可输入64个字符
  • 指标值:支持单个值和范围值填写
  • { "指标":"temp", "名称":高值, "指标值":50}
    password 密码数据 admin
    geoPoint 地址位置数据,以经纬度显示 106.551783,29.555705

    # 操作步骤

    1.登录Jetlinks物联网平台。
    2.在左侧导航栏,选择设备管理>设备,点击查看,切换至物模型tab页,并点击新增按钮。
    3.在新建抽屉中,根据设备实际情况,按照页面提示填写信息,然后单击确定

    # 属性参数说明

    标识 同一个产品内属性标识具有唯一性,不支持编辑。
    名称 为设备命名,最多可输入64个字符。
    数据类型 1. int:整数型,需定义单位符号。
    2. long:长整数型,需定义单位符号。
    3. float:单精度浮点型。需定义单位符号。
    4. double:双精度浮点型。需定义单位、精度。
    5. text:字符串。需定义字符串的数据长度。
    6. boolean:布尔型。采用true或false来定义布尔值,例如true-关;false-开。
    7. date:时间戳。默认格式为String类型的UTC时间戳,单位:毫秒。
    8. enum:枚举型。定义枚举项的参数值和参数描述,例如1-加热模式、2-制冷模式等。
    9. array:数组。需声明数组内元素的数据类型,可选择int32、float、double、text或object。需确保同一个数组元素类型相同。数组内可包含1-128个元素。
    10. object:JSON对象。定义一个JSON结构体,新增JSON参数项,例如定义灯的颜色是由Red、Green、Blue三个参数组成的结构体。
    11. file:文件。需声明文件元素类型,可选择URL、base64、binary(二进制)。
    12. password:密码。上报时如果属性为密码,将进行加密或者是隐秘的方式进行显现或者处理。
    13. geoPoint:地理位置,按经纬度格式进行定义。
    单位 单选下拉框,可选择为无或根据实际情况选择。
    精度 控制所需的小数位数。
    最大长度 单位为字节。
    来源 单选下拉框,支持设备、手动、规则。
    读写类型 单选下拉框,支持读、写、上报
    说明 备注说明,最多可输入200个字符。

    # 功能参数说明

    标识 同一个产品内功能标识具有唯一性,不支持编辑。
    名称 为功能命名,最多可输入64个字符。
    是否异步 异步:服务为异步调用时,云端执行调用后直接返回结果,不会等待设备的回复消息。
    同步:服务为同步调用时,云端会等待设备回复;若设备没有回复,则调用超时。
    输入参数 定义功能的输入参数标识、名称、数据类型。
    输出参数 1. int:位整型。需定义取值范围、步长和单位符号。
    2. long:长整数型,需定义单位符号。
    3. float:单精度浮点型。需定义单位符号。
    4. double:双精度浮点型。需定义单位、精度。
    5. text:字符串。需定义字符串的数据长度。
    6. boolean:布尔型。采用true或false来定义布尔值,例如true-关;false-开。
    7. date:时间戳。默认格式为String类型的UTC时间戳,单位:毫秒。
    8. enum:枚举型。定义枚举项的参数值和参数描述,例如1-加热模式、2-制冷模式等。
    9. array:数组。需声明数组内元素的数据类型,可选择int32、float、double、text或object。需确保同一个数组元素类型相同。数组内可包含1-128个元素。
    10. object:JSON对象。定义一个JSON结构体,新增JSON参数项,例如定义灯的颜色是由Red、Green、Blue三个参数组成的结构体。
    11. password:密码。上报时如果属性为密码,将进行加密或者是隐秘的方式进行显现或者处理。
    12. geoPoint:地理位置,按经纬度格式进行定义。

    # 事件参数说明

    标识 同一个产品内事件标识具有唯一性,不支持编辑
    名称 为功能命名,最多可输入64个字符。
    级别 单选下拉框,点击展开:普通、告警、紧急
    输出参数 object:JSON对象。定义一个JSON结构体,新增JSON参数项,例如定义灯的颜色是由Red、Green、Blue三个参数组成的结构体。
    说明
      配置的事件的触发记录,将在设备“运行状态”左侧菜单中进行显示。
    JSON对象 定义结构体的标识、名称、数据类型。

    # 标签参数说明

    标识 同一个产品内标签标识具有唯一性,不支持编辑
    名称 为标签命名,最多可输入64个字符。
    数据类型 1. int:位整型。需定义取值范围、步长和单位符号。
    2. long:长整数型,需定义单位符号。
    3. float:单精度浮点型。需定义单位符号。
    4. double:双精度浮点型。需定义单位、精度。
    5. text:字符串。需定义字符串的数据长度。
    6. boolean:布尔型。采用true或false来定义布尔值,例如true-关;false-开。
    7. date:时间戳。默认格式为String类型的UTC时间戳,单位:毫秒。
    8. enum:枚举型。定义枚举项的参数值和参数描述,例如1-加热模式、2-制冷模式等。
    9. array:数组。需声明数组内元素的数据类型,可选择int32、float、double、text或object。需确保同一个数组元素类型相同。数组内可包含1-128个元素。
    10. object:JSON对象。定义一个JSON结构体,新增JSON参数项,例如定义灯的颜色是由Red、Green、Blue三个参数组成的结构体。
    11. file:文件。需声明文件元素类型,可选择URL、base64、binary(二进制)。
    12. password:密码。上报时如果属性为密码,将进行加密或者是隐秘的方式进行显现或者处理。
    13. geoPoint:地理位置,按经纬度格式进行定义。
    标签类型 单选下拉框,支持读、写、上报