设备管理

    产品是一个JSON格式的文件。它是物理空间中的实体，如传感器、车载装置、楼宇、工厂等在云端的数字化表示，从属性、功能和事件三个维度，分别描述了该实体是什么，能做什么，可以对外提供哪些信息。定义了这三个维度，即完成了产品功能的定义。

    产品将产品功能类型分为三类：属性、功能、和事件。定义了这三类功能，即完成了产品的定义。

    产品数据格式

    您可以在产品的物模型中编辑的属性、功能、事件、标签。

    产品的属性、功能、事件JSON字段结构如下：

    所有数据类型对应的valueType的JSON结构如下：

    添加产品

    1. 登录物联网管理平台。
    2. 在左侧导航栏，选择设备管理 > 产品。
    3. 在产品管理页面产品列表中，单击产品所对应的操作按钮。
    4. 在跳转的页面中，填写产品的基本信息，然后填写产品所对应的属性数据并选择产品所对应的消息协议、连接协议。

    参数描述
    型号ID唯一标识符，在属性中具有唯一性。可包含英文、数字、下划线，长度不超过32个字符，例如PowerComsuption。不填写将由系统自动生成。
    型号名称为型号命名。例如，test。支持中文、英文字母、数字、下划线（_）、连接号（-）、@符号和英文圆括号，长度限制4~30，一个中文汉字算2位。
    分类目录为产品分类，能更方便的管理产品。类似于分组。
    所属机构设备所属的机构，一个平台存在多个部门同时操作，能保证用户操作的产品是自己所在的机构下的产品。
    消息协议不同厂商不同的设备所用的消息传输协议不同，平台定义好消息协议后平台将根据所设定的消息协议格式进行解析设备所上报的数据。
    连接协议1. MQTT：MQTT是一个基于客户端-服务器的消息发布/订阅传输协议。MQTT协议是轻量、简单、开放和易于实现的，这些特点使它适用范围非常广泛。在很多情况下，包括受限的环境中，其在，通过卫星链路通信传感器、偶尔拨号的医疗设备、智能家居、及一些小型化设备中已广泛使用。
    2. MQTT TLS：MQTT使用UDP上的数据报TLS协议来进行加密。
    3. CoAP：Coap（Constrained Application Protocol）是一种在物联网世界的类web协议，它的详细规范定义在 RFC 7252。COAP名字翻译来就是“受限应用协议”，顾名思义，使用在资源受限的物联网设备上。物联网设备的ram，rom都通常非常小，运行TCP和HTTP是不可以接受的。
    4. CoAP DTLS：CoAP使用UDP上的数据报TLS协议（DTLS）来进行加密。
    设备类型标识该型号所属的设备类型。
    说明输入文字，对该属性进行说明或备注。长度限制为100字。
    扩展描述选择消息协议和连接协议过后会有其他配置信息显示，设备注册时将携带配置中的参数及数据，平台验证上报数据中所传的数据是否正确。
    1. 点击产品的查看→选择物模型， 添加属性定义：在属性定义表格右上角有个添加按钮，点击按钮将弹出会话框。设置参数完成后，单击保存。

    产品属性信息0 产品属性信息2

    属性参数设置说明如下表。

    参数描述
    属性标识唯一标识符，在属性中具有唯一性。即Jetlinks JSON格式中的id的值，作为设备上报该属性数据的Key，平台根据该标识符校验是否接收数据。可包含英文、数字、下划线，长度不超过32个字符，例如PowerComsuption。
    属性名称属性的名称，例如网关SN。支持中文、大小写字母、数字、短划线和下划线，且必须以中文、英文或数字开头，不超过32个字符。
    数据类型1. int32：32位整型。需定义取值范围、步长和单位符号。
    2. float：单精度浮点型。需定义取值范围、步长和单位符号。
    3. double：双精度浮点型。需定义取值范围、步长和单位符号。
    4. enum：枚举型。定义枚举项的参数值和参数描述，例如1-加热模式、2-制冷模式等。
    5. bool：布尔型。采用0或1来定义布尔值，例如0-关；1-开。
    6. text：字符串。需定义字符串的数据长度，最长支持2048字节。
    7. date：时间戳。默认格式为String类型的UTC时间戳，单位：毫秒。可自定义格式，例如yyyy-MM-dd。
    8. object：JSON对象。定义一个JSON结构体，新增JSON参数项，例如定义灯的颜色是由Red、Green、Blue三个参数组成的结构体。 miniui版本不支持结构体嵌套。
    9. array：数组。需声明数组内元素的数据类型，可选择int32、float、double、text或object。需确保同一个数组元素类型相同。数组内可包含1-128个元素。
    10. file：文件。需声明文件元素类型，可选择URL、base64、binary(二进制)。
    11. password：密码。上报时如果属性为密码将进行加密或者是隐秘的方式进行显现或者处理。
    备注：出参类型为object添加JSON对象。为array时选择元素类型，如果元素类型为object，添加JSON对象。填写元素个数。
    精度控制所需的小数位数。
    单位单位可选择为无或根据实际情况选择。
    是否只读读写：请求读写的方法支持GET（获取）和SET（设置）。
    只读：请求只读的方法仅支持GET（获取）。
    描述输入文字，对该属性进行说明或备注。长度限制为100字。
    • 添加功能定义：在功能定义表格右上角有个添加按钮，点击按钮将弹出会话框。设置参数完成后，单击确认。

    功能参数设置说明如下表。

    参数描述
    功能标识唯一标识符，在功能中具有唯一性。即Jetlinks JSON格式中的id的值，作为设备上报该属性数据的Key，平台根据该标识符校验是否接收数据。可包含英文、数字、下划线，长度不超过32个字符，例如PowerComsuption。
    功能名称功能的名称，例如CPU使用率。支持中文、大小写字母、数字、短划线和下划线，且必须以中文、英文或数字开头，不超过32个字符。
    是否异步异步：服务为异步调用时，云端执行调用后直接返回结果，不会等待设备的回复消息。
    同步：服务为同步调用时，云端会等待设备回复；若设备没有回复，则调用超时。
    输入参数设置该服务的入参，可选。
    单击添加参数，在弹窗对话框中添加服务入参。
    出参类型1. int32：32位整型。需定义取值范围、步长和单位符号。
    2. float：单精度浮点型。需定义取值范围、步长和单位符号。
    3. double：双精度浮点型。需定义取值范围、步长和单位符号。
    4. enum：枚举型。定义枚举项的参数值和参数描述，例如1-加热模式、2-制冷模式等。
    5. bool：布尔型。采用0或1来定义布尔值，例如0-关；1-开。
    6. text：字符串。需定义字符串的数据长度，最长支持2048字节。
    7. date：时间戳。默认格式为String类型的UTC时间戳，单位：毫秒。可自定义格式，例如yyyy-MM-dd。
    8. object：JSON对象。定义一个JSON结构体，新增JSON参数项，例如定义灯的颜色是由Red、Green、Blue三个参数组成的结构体。 miniui版本不支持结构体嵌套。
    9. array：数组。需声明数组内元素的数据类型，可选择int32、float、double、text或object。需确保同一个数组元素类型相同。数组内可包含1-128个元素。
    10. file：文件。需声明文件元素类型，可选择URL、base64、binary(二进制)。
    11. password：密码。上报时如果属性为密码将进行加密或者是隐秘的方式进行显现或者处理。
    备注：出参类型为object添加JSON对象。为array时选择元素类型，如果元素类型为object，添加JSON对象。填写元素个数。
    描述输入文字，对该功能进行说明或备注。长度限制为100字。
    • 添加事件定义：在事件定义表格右上角有个添加按钮，点击按钮将弹出会话框。设置参数完成后，单击确认。

    产品事件信息

    事件参数设置说明如下表。

    JSON对象参数设置说明如下表。

    参数描述
    参数标识唯一标识符，在JSON对象中具有唯一性。即Jetlinks JSON格式中的id的值，作为设备上报该属性数据的Key，平台根据该标识符校验是否接收数据。可包含英文、数字、下划线，长度不超过32个字符，例如PowerComsuption。
    参数名称参数的名称，例如SN。支持中文、大小写字母、数字、短划线和下划线，且必须以中文、英文或数字开头，不超过32个字符。
    数据类型1. int32：32位整型。需定义取值范围、步长和单位符号。
    2. float：单精度浮点型。需定义取值范围、步长和单位符号。
    3. double：双精度浮点型。需定义取值范围、步长和单位符号。
    4. enum：枚举型。定义枚举项的参数值和参数描述，例如1-加热模式、2-制冷模式等。
    5. bool：布尔型。采用0或1来定义布尔值，例如0-关；1-开。
    6. text：字符串。需定义字符串的数据长度，最长支持2048字节。
    7. date：时间戳。默认格式为String类型的UTC时间戳，单位：毫秒。可自定义格式，例如yyyy-MM-dd。
    8. file：文件。需声明文件元素类型，可选择URL、base64、binary(二进制)。
    9. password：密码。上报时如果属性为密码将进行加密或者是隐秘的方式进行显现或者处理。
    备注：object和array类型miniui暂不支持。
    最大长度限制参数的最大数
    描述输入文字，对该事件进行说明或备注。长度限制为100字。
    • 添加标签定义：在标签定义表格右上角有个添加按钮，点击按钮将弹出会话框。设置参数完成后，单击确认。

    事件参数设置说明如下表。

    参数描述
    标签标识唯一标识符，在事件中具有唯一性。即Jetlinks JSON格式中的id的值，作为设备上报该属性数据的Key，平台根据该标识符校验是否接收数据。可包含英文、数字、下划线，长度不超过32个字符，例如PowerComsuption。
    标签名称事件的名称，例如用电量数据上报。支持中文、大小写字母、数字、短划线和下划线，且必须以中文、英文或数字开头，不超过32个字符。
    数据类型数据上报：指设备监测到某些数值的改变时上传改变后的数值，例如温度计监测到温度变化。
    事件上报：事件监控功能为您提供上报自定义事件的接口，方便您将业务产生的异常事件采集上报到云监控，通过对上报的事件配置报警规则来接收报警通知。
    出参类型1. int32：32位整型。需定义取值范围、步长和单位符号。
    2. float：单精度浮点型。需定义取值范围、步长和单位符号。
    3. double：双精度浮点型。需定义取值范围、步长和单位符号。
    4. enum：枚举型。定义枚举项的参数值和参数描述，例如1-加热模式、2-制冷模式等。
    5. bool：布尔型。采用0或1来定义布尔值，例如0-关；1-开。
    6. text：字符串。需定义字符串的数据长度，最长支持2048字节。
    7. date：时间戳。默认格式为String类型的UTC时间戳，单位：毫秒。可自定义格式，例如yyyy-MM-dd。
    8. object：JSON对象。定义一个JSON结构体，新增JSON参数项，例如定义灯的颜色是由Red、Green、Blue三个参数组成的结构体。 miniui版本不支持结构体嵌套。
    9. array：数组。需声明数组内元素的数据类型，可选择int32、float、double、text或object。需确保同一个数组元素类型相同。数组内可包含1-128个元素。
    10. file：文件。需声明文件元素类型，可选择URL、base64、binary(二进制)。
    11. password：密码。上报时如果属性为密码将进行加密或者是隐秘的方式进行显现或者处理。
    备注：出参类型为object添加JSON对象。为array时选择元素类型，如果元素类型为object，添加JSON对象。填写元素个数。
    是否只读是否允许修改已经创建好的标签
    描述输入文字，对该事件进行说明或备注。长度限制为100字。
    1. 所有信息以及属性、功能、事件、标签全部补充完成后单击单击即可。

    后续操作步骤

    产品列表信息

    1. 在产品列表中单击该型号的编辑按钮，可以修改基本信息。
    2. 在产品列表中单击该型号的发布按钮，将该产品注册到注册中心，添加设备时将会查询到该产品。
      • 产品发布后,状态将变为已发布状态，已发布的产品或者是已绑定设备的产品将不支持删除。
    3. 在产品列表中单击该型号的删除按钮，将物理删除该产品。
      • 已发布状态的产品将不显示删除按钮。
      • 取消发布后如果产品已关联设备，点击删除按钮时将提示：删除失败:该型号已绑定实例,无法删除。
    4. 在产品列表中单击该型号的下载按钮，可以将该产品的配置信息导出成一个json文件，文件内容为JSONString形式保存。
    5. 在产品列表中单击该型号的快速导入按钮，可以将导出的产品配置json文件导入至平台内，如果平台内存在相同ID主键的型号将会去修改相同主键的产品信息，反之就在平台内新增一条新的产品信息。

    产品分类

    添加

    1. 登录物联网管理平台。
    2. 在产品分类管理页面设备列表中，单击新增操作按钮。
    3. 在弹出对话框中，填写所需的基本信息即可。设置参数完成后，单击保存。

    编辑产品分类信息 编辑产品分类

    添加子分类

    查看子分类 查看子分类

    添加设备

    1. 登录物联网管理平台。
    2. 在左侧导航栏，选择设备管理 > 设备。
    3. 在设备管理页面设备列表中，单击设备所对应的添加设备操作按钮。
    4. 在弹出对话框中，填写设备所需的基本信息即可。设置参数完成后，单击保存。

    设备参数设置说明如下表。

    参数描述
    设备ID唯一标识符，在设备中具有唯一性。可包含英文、数字、下划线，长度不超过32个字符，例如PowerComsuption。不填写将由系统自动生成
    设备名称设备的名称，例如XXX门锁。支持中文、大小写字母、数字、短划线和下划线，且必须以中文、英文或数字开头，不超过32个字符。
    产品产品中发布后的产品在此处就能选择。新创建的设备将继承该产品定义好的属性、功能、事件。
    所属机构设备所属的机构，一个平台存在多个部门同时操作，能保证用户操作的设备是自己所在的机构下的设备。
    说明输入文字，对该事件进行说明或备注。长度限制为100字。

    设备管理

    设备列表信息

    设备信息说明如下表。

    在设备列表中，单击设备对应的查看按钮，进入设备详情页。

    设备认证后的基本信息2

    设备信息说明如下表。

    参数描述
    查看设备实例信息查看设备基本信息，包括产品信息、扩展信息、标签信息等内容。
    查看设备运行状态在设备激活并上线后运行状态页签下，查看设备当前状态、产品配置的属性、事件等信息。
    如果是事件可查看事件所上报的数据详情信息。
    查看设备日志设备行为、上行消息、下行消息等消息内容，点击详情内容可查看具体日志的详细内容。

    设备信息说明如下表。

    参数描述
    ID唯一标识符，在设备中具有唯一性，例如PowerComsuption。
    型号设备的名称，例如XXX门锁。支持中文、大小写字母、数字、短划线和下划线，且必须以中文、英文或数字开头，不超过32个字符。
    状态设备的当前状态。当前状态分为：未激活、在线、离线。

    设备关联产品以后,在设备查看页面也将显示产品信息，说明如下表。

    参数描述
    设备名称产品中发布后的产品在此处就能选择。新创建的设备将继承该产品定义好的属性、功能、事件。
    分类目录为产品分类，能更方便的管理产品。类似于分组。
    消息协议不同厂商不同的设备所用的消息传输协议不同，平台定义好消息协议后平台将根据所设定的消息协议格式进行解析设备所上报的数据。
    连接协议1. MQTT：MQTT是一个基于客户端-服务器的消息发布/订阅传输协议。MQTT协议是轻量、简单、开放和易于实现的，这些特点使它适用范围非常广泛。在很多情况下，包括受限的环境中，其在通过卫星链路通信传感器、偶尔拨号的医疗设备、智能家居、及一些小型化设备中已广泛使用。
    2. MQTT TLS：MQTT使用UDP上的数据报TLS协议来进行加密。
    3. CoAP：Coap（Constrained Application Protocol）是一种在物联网世界的类web协议，它的详细规范定义在 RFC 7252。COAP名字翻译来就是“受限应用协议”，顾名思义，使用在资源受限的物联网设备上。物联网设备的ram，rom都通常非常小，运行TCP和HTTP是不可以接受的。
    4. CoAP DTLS：CoAP使用UDP上的数据报TLS协议（DTLS）来进行加密。
    设备类型标识该型号所属的设备类型。
    描述产品填写的说明或备注。

    运行状态

    1. 记录展示设备当前状态以及用户自定义的产品内的属于以及事件信息。
    2. 展示设备上报事件的详情不同设备类型配置的设备属性、事件不同所展示的内容都有所不同。

    日志管理

    设备日志信息

    1. 展示设备行为、上行消息、下行消息等消息内容，点击详情内容可查看具体日志的详细内容。
    2. 日志详情内容将显示设备行为、上行消息、下行消息等消息内容的详细内容。

    设备影子

    1. 在设备列表页，选择相应设备，点击查看按钮进入设备详情页面。

    1. 点击设备影子选项卡。

    设备影子

    1. 编辑设备影子配置，格式为json。

    1. 在协议包中获取设备影子配置。

    分组

    新建分组

    可对分组名称进行编辑。

    解绑所有设备

    添加地理位置属性

    添加子分组

    删除

    在相应分组上点击删除按钮即可删除分组。

    新增

    1. 进入系统: 设备管理-产品。 在新建产品时选择设备类型为网关设备。

    新增网关设备

    1. 进入系统： 设备管理-网关。 设备类型为网关设备的设备将自动在此展示（注：新建产品必须要有设备）。

    1. 选择需要绑定的网关，点击绑定子设备按钮。

    绑定子设备

    1. 在绑定子设备页面，选择需要绑定的子设备并保存。

    解绑子设备

    选择需要解绑子设备的网关，点击解绑按钮。

    解绑子设备

    地理位置

    1. 物模型中添加地理位置。通过标签添加地理位置类型属性。


    添加地理位置属性 2. 在产品详情页面点击应用配置按钮。

    1. 在设备详情页将出现地理位置标签，编辑可设置坐标。

      编辑地理位置1

      点击编辑按钮进入标签编辑页面。

      在地图界面选择坐标。

      编辑地理位置3

    2. 进入系统: 设备管理-地理位置。 可在地图上查询到设备位置。