产品开发

更新时间:2018-11-26 21:58:12

重要说明

设备管理从本期版本后将实现统一接入,新用户将使用统一接入后的设备管理,统一接入的相关文档见地址,老用户遵循下面的文档说明。

   *新用户定义:指2018年11月30日以后(含11月30日)使用工业互联网平台的用户。
   *老用户定义:指2018年11月30日之前使用工业互联网平台的用户。年11月26日之前使用工业互联网平台的用户。

产品创建

在进行产品定义前,需要先创建一个新的产品,这里需要注意的是,产品的定义为一系列具备相同“属性”,"事件"和“服务”的设备的统一抽象,如某型号注塑机,某型号空气压缩机等。
从平台左侧的导航栏中选择设备管理->产品开发菜单,进入产品开发页面。

image | left

进入产品开发页面后,您将看到您所创建的所有产品列表,如果尚未创建任何产品,则将看到一个空的产品列表。

image | left

如需新建产品模型,可以点击上图中列表右上侧的“新增产品”按钮开始新增产品模型定义。
新增产品的第一步为填写产品的一些静态基础信息。用户根据向导选择和填入相关信息:

image.png | left | 826x458

  • 产品名称:开发者给产品的命名,可以为产品本身的型号,或可以标识产品特性的一段文字描述。

  • 产品类型:

    • 直连设备:泛指设备本身具备上网能力,可以自行上报或帮助别的无法联网的设备上报属性,事件和接收云端服务调用的设备。可以是一个本身具备联网能力的工控机,嵌入式工控板,DTU数传设备。
    • 网关:特指运行阿里云IoT边缘计算网关平台的设备。
  • 产品行业:选择产品所属的行业。

  • 硬件平台:选择产品开发所用的硬件平台。

  • 操作系统:选择该产品所使用的软件操作系统。

  • 联网方式:根据产品实际情况选择产品的联网方式。

  • 是否接入网关:根据产品实际情况选择产品的联网方式。

    • 是:选择了接入网关,那么需要对设备协议进行选择
      • 设备协议:有自定义、Modbus和OPC UA
        • 自定义:默认
        • Modbus:
        • OPC UA:
    • 否:
  • 新字段:如部分产品有特殊的需要标识的字段,可以通过新字段选项为产品定义特殊的静态字段。

  • 产品描述:一段话对新建产品进行描述。
    在完成产品静态属性的填写后,选择“提交”按钮,完成产品的新建。

image | left

完成产品新建以后,您可以选择稍后对产品进行编辑,也可以立即点击“编辑改产品”按钮对产品的属性,事件,服务三大要素进行编辑。

产品定义

点击“编辑该产品”按钮,进入产品详情页。

image | center

在产品详情页中,可以看到在新建产品时编辑的相关内容,以及系统自动为产品分配的一个唯一“ProductKey”。同时,可以看到“编辑”,“新增”按钮,下面分别介绍按钮的功能。
“编辑”按钮:点击后出现如下弹窗,用户可以对“产品名称”字段进行编辑,以及增加自定义字段。

image | center

“新增”按钮:产品的属性,事件,服务等特性,均通过此按钮进行新增。下面将重点介绍新增过程。
点击“新增”按钮,弹出新增自定义功能窗口,在界面中可以选择新增“属性”,“事件”,“服务”。

新增属性

image | center

新增功能页面-定义属性

功能类型:选择当前要定义的功能为“属性”,“事件”还是“服务”
功能名称:用于对功能的概括性描述的名称,可以为中文。“属性”,“事件”,“服务”三者意义相同。
标识符:由英文,数字下划线组成的功能标识,此标识主要用于将来对设备属性的引用,较为重要。“属性”,“事件”,“服务”三者意义相同。
数据类型:对于“属性”类功能的描述,需要选择“属性”的数据类型。如果将来设备上传的属性类型和定义的类型不同,将会导致属性解析失败,属性数据将不会被接收存储。
取值范围:定义属性的最大最小值。如果实际上报的属性没有落在此区间,属性值将被判定为无效,不会被记录。
单位:选择属性的单位名称,如“米”,“千瓦时”等。
读写类型:此处的读写类型中读写的主体为云端平台。
描述:对属性进行一个较为详细的描述。

新增事件

image | center

新增功能页面-定义事件

与新增“属性”不同,对于事件的定义增加了如下特性的定义:
事件类型:平台将事件分为三个类型,其中“告警”,“故障”两个类型将会被平台统计。
输出参数:此处的输出主体为端设备/系统,如报警时所携带的具体的报警描述。即通过事件上报带到平台的参数的定义。参数定义类似属性定义,可以参考属性定义。

image | center

事件参数定义

服务定义

image | center

新增功能页面-定义服务(异步)

与事件定义类似,服务定义中增加了如下新的特性:
调用方式:定义服务的调用返回模式。“异步”调用,表示云端发出对服务的调用,而不等待和响应调用的反馈。“同步”则表示云端会在调用后等待设备端返回调用结果,直到等待超时。
输入参数:定义在服务调用时,由云端传递给边缘侧的参数。
输出参数:定义在同步调用中,由设备反馈的调用结果中所携带的参数。

image | center

新增功能页面-定义服务(同步)

完成产品定义后,在产品详情中可以看到定义出的产品各功能。

image | left

完成产品定义的后的产品详情

模型导入/导出

在"产品开发"中,提供了对产品模型的导入及导出功能,实现对产品的快速的建模功能,比如从其他账号中导入模型。操作步骤解释如下。

image | center

导入物模型

首先,单击“导入物模型”按钮,进行页面。然后,将产品对应的物模型TSL定义(JSON内容格式)复制到编辑框中。

image | center

点击"确定"按钮后,新的功能定义就会被添加到模型定义中。

image | left

需要说明的是,导入的模型会覆盖原有模型定义。并且,模型导入功能目前只支持标准物模型(即不包括modbus 、OPCUA的驱动配置信息)。

模型导出

通过单击“模型导出”按钮,首先可以查看到“物模型”定义已经“扩展物模型定义”(modbus/OPCUA的配置定义)。然后,可以通过“导出物模型”按钮对物模型TSL文件进行下载(JSON格式)。

image | center

results matching ""

    No results matching ""