产品文档

设备接入服务

2024-04-25 03:22:07

产品管理

物联网平台中的产品为某一类设备的集合,对某一类具有相同功能的设备进行定义,例如功能相同的路灯、电表、洗衣机,不同型号相同功能的设备也可以归属为同一产品。

产品管理

您可以在物联网平台平台【设备管理】—>【产品】模块,对产品进行创建、查询、编辑、删除等操作。
image.png

创建产品

点击物联网平台平台【设备管理】模块中的【产品】,可以进入产品管理页,点击【创建产品】按钮即可创建新的产品。
创建产品

创建产品需要填写产品基本信息档案信息等,点击【创建】按钮,即可创建产品。
录入产品信息

基本信息添加规则说明

  • 名称:仅支持30个以内的汉字、英文、数字、下划线(_)、连字符(-)、点(.)、空格。

  • 产品编码:产品唯一标识信息,创建后不可修改。

  • 节点类型:支持直连设备、网关设备、非直连终端设备和边缘节点四种节点类型。节点类型描述:

直连设备 即一般可直接联网的设备,可通过基站、路由器直接入物联网平台,本身不能挂载子设备。
网关设备 这类设备可以直接接入物联网平台;同时具有子设备管理模块,可以代理非直连终端设备,维持与非直连终端设备的拓扑关系。
边缘节点 计算力更强的连接代理设备,可通过边缘应用管理非直连设备,或执行其他计算任务,例如AI推理。
非直连终端设备 这类设备不具有独立MQTT连接能力,不能直接接入物联网平台,需要依赖网关设备设备接入物联网平台,如蓝牙设备等。

  • 连网方式:支持蜂窝(2G/3G/4G),以太网,Wi-Fi三种方式。 注:当节点类型为非直连设备时,不支持网络连接,可以选择(RS485、HPLC、ZigBee、其他)通讯协议接入连接代理设备。

  • 通信协议:MQTT、HTTPS

  • 制造商信息:**填写产品制造商名称及制造商ID

  • 描述:**用于对产品进行描述

  • 是否开启影子服务:选择是否开启设备影子服务

  • 是否需要支持lua脚本:选择是否支持产品lua脚本

  • 传输协议:目前支持json、protobuf传输协议

档案信息 请参考 <产品档案> 章节内容。

创建产品后,需要对新创建的产品进行功能定义,需定义产品的属性、事件、方法。
产品功能定义

查询产品

在菜单栏选择 【设备管理】 -> 【产品】,即可进入产品页,产品将设备按节点接入类型分为四类:直连设备、网关设备、非直连终端设备和边缘节点。在产品列表页,您可以通过选择产品名称产品编码节点类型对展示的列表进行筛选。
查询产品

编辑产品

在菜单栏选择 【设备管理】 -> 【产品】,在产品列表页,您可以通过编辑按钮,进行产品基本信息的修改。
编辑产品

注:对于已经创建发布的产品,产品编辑功能仅支持产品名称、制造商、产品描述、设备影子服务、lua脚本选择、传输协议、产品档案信息修改。

删除产品

在菜单栏选择 【设备管理】 -> 【产品】,即可进入产品页,在产品列表页,您可以通过 删除 按钮,进行产品删除操作。
删除产品

产品档案

物联网平台平台中的产品信息支持通过产品档案的方式进行维护,可以维护产品对应的信息,如设备厂商、生产日期、颜色等。您可在 【档案管理】 -> 【档案列表】 中对全局产品档案进行管理,若档案列表中没有定义全局产品档案,则此处不显示。
产品档案

在档案管理模块中,支持新增档案,目前支持新增全局产品档案、全局设备档案、产品设备档案。

  • 全局产品档案

用于对全部产品声明的专有属性信息。支持在产品创建中是否必填此档案信息。
全局产品档案

档案名称:仅支持64个以内的汉字、英文、数字、下划线(_)、连字符(-)、点(.)、空格,并且开头和结尾只能包含汉字、英文、数字。
档案编码:仅支持64个以内的汉字、英文、数字、下划线(_)、连字符(-)、点(.)、空格,并且开头和结尾只能包含汉字、英文、数字。
数据类型:目前支持string、bool、int、double 四种数据类型。

  • 全局设备档案

用于对全部设备声明的专有属性信息。支持在设备创建中是否必填此档案信息。
全局设备档案

档案名称:仅支持64个以内的汉字、英文、数字、下划线(_)、连字符(-)、点(.)、空格,并且开头和结尾只能包含汉字、英文、数字。
档案编码:仅支持64个以内的汉字、英文、数字、下划线(_)、连字符(-)、点(.)、空格,并且开头和结尾只能包含汉字、英文、数字。
数据类型:目前支持string、bool、int、double 四种数据类型

  • 设备产品档案

用于在特定产品下声明此产品的设备的专有属性信息。支持在该设备创建中是否必填此档案信息。
设备产品档案

产品:用于选择特定的产品(该产品已创建)。
档案名称:仅支持64个以内的汉字、英文、数字、下划线(_)、连字符(-)、点(.)、空格,并且开头和结尾只能包含汉字、英文、数字。
档案编码:仅支持64个以内的汉字、英文、数字、下划线(_)、连字符(-)、点(.)、空格,并且开头和结尾只能包含汉字、英文、数字。
数据类型:目前支持string、bool、int、double 四种数据类型。

固件升级

物联网平台平台提供固件升级管理功能,通过固件管理可以方便地管理物类型下的固件版本,进行固件升级任务管理。

固件管理

支持基于产品的固件管理功能,包括定义固件版本号、上传固件文件功能,固件签名以及固件的删除、修改等功能。可以通过【固件升级】—>【固件管理】模块使用固件管理服务。
固件管理

固件管理】模块支持通过产品、固件版本进行检索查询,也支持对固件进行查看编辑创建升级任务删除固件的操作。
可以在【固件管理中】点击【新增固件】按钮,进入新增固件功能。
新增固件

新增固件填写规则说明

  • 产品:选择已经在产品管理模块创建的产品。

  • 固件类型:支持firmware、app、framework、os的固件类型包,也支持自定义类型。

  • 版本号:添加可升级固件版本号,必须小于将要新增的固件的版本号。

  • 可升级固件版本:添加可升级固件版本号,必须小于将要新增的固件的版本号。可以为空,即支持所有旧固件版本。

  • 签名算法:支持SHA256、MD5算法,也可以选择不加密算法。

  • 固件签名:填写所选算法生成的固件签名。

  • 备注:填写固件摘要、版本说明等信息。

任务管理

在【任务管理】模块,可以通过产品、固件版本、任务状态对固件升级任务进行查询,也支持固件任务的进度查看启动编辑删除操作。
任务管理

可以在【任务管理】模块,点击【新增任务】按钮,新增一个固件升级任务。
新增任务

新增固件升级任务填写规则说明

  • 产品:选择已经在产品管理模块创建的产品。

  • 固件版本:选择对应产品下需要进行升级到的固件版本。

  • 任务名称:输入本次升级任务的名称。

  • 升级模式:支持立即升级任务(定时升级是指设备在接收到升级命令后立即执行升级任务)、定时升级任务(定时升级是指设备在接收到升级命令后在指定的升级时间开始执行升级任务)、闲时升级(闲时升级是一种安全和有效的方式来升级设备的固件,但同时也需要注意设备的特殊要求和固件升级的风险。闲时升级是指在设备空闲或不需要进行重要任务时进行的固件升级。这种方式是为了尽可能避免在设备在工作期间进行固件升级所带来的风险和不便。如果设备的固件需要升级,而且在升级过程中设备不能正常工作,则该设备的正常工作将被中断,这可能会对生产和业务造成严重影响。因此闲时升级可以避免这种风险,确保设备的正常运行。在进行闲时升级时,首先需要评估设备的闲时,通常选择在设备的不活动时段进行升级,比如夜间或周末)。

  • 升级范围:支持全量升级和指定特定设备升级的方式。(选择指定设备后,可以根据设备分组或批量上传设备ID的形式来圈定本次升级的范围)。

  • 用户自定义消息:随同升级任务,推送给用户展现,告知用户本次升级内容等。

创建完成【固件升级任务】后,在任务管理页面,点击【启动】按钮,启动固件升级任务。可以点击【查看任务】按钮,查看当前固件升级任务的进度及状态。

注:处于 运行 状态的任务,不支持编辑删除操作,如需要进行删除操作,请先取消升级任务;处于 取消 状态的任务,不支持 任务编辑 操作。

文档反馈

开始与售前顾问沟通

可直接拨打电话 400-098-8505转1

我们的产品专家为您找到最合适的产品/解决⽅案

在线咨询 5*8⼩时

1v1线上咨询获取售前专业咨询

点击咨询
企微服务助手

专业产品顾问,随时随地沟通