文档

设备集成

更新时间:
一键部署

背景介绍

当一个单租户应用需要与设备通信时,我们建议应用与设备之间通过物联网平台进行数据交换和设备控制。单租户应用的运行实例归属买家,而设备在买家购买之前,设备注册在物联网平台的归属,必然是卖家的。这里需要解决的问题是,如何让买家的应用实例能够发现和控制买家买到的设备。关于单租户的应用实例,它在被部署的时候,会由平台为其分配一个AppKey。这个AppKey是这个应用实例的权限表示,应用会拿这个AppKey去控制设备。所以,我们需要有一个授权流程,将卖家的设备授权给买家的这个应用实例(即,通过一个授权流程,可以让这个AppKey可以有权限控制这些设备)。

流程介绍

为了完成设备集成链路,需要完成如下四步:应用配置、应用开发、卖家授权、买家授权。

应用配置

应用在配置时,就需要指定该应用相关的设备类别信息。如下图所示:image.png

图中,需要ISV用户指定“软硬模式”。目前支持“软硬一体”和“软硬分离”两种。前者需要用户指定具体的产品(在物联网平台中创建的硬件产品);后者需要用户指定相关的物模型信息。ISV用户应该根据自己对设备的控制方法和实际场景选择。

应用开发

平台提供设备控制相关的API,应用通过AppKey对这些API进行调用。对于单租户应用,这个AppKey以及相应的AppSecret,请务必从应用所运行的环境变量中获取。关于API信息,请参考:https://help.aliyun.com/document_detail/114866.html

卖家授权

这里的卖家,指的是硬件的卖家。卖家将设备销售给卖家后,需要将设备授权给买家。授权页面如下图所示:区域①:买家的阿里云UID。

区域②:卖家现有的设备。

区域③:销售给买家的设备。

B1BFA9BB-90FD-4673-A39F-B54B63CBB11F.png

买家授权

卖家授权仅完成了设备向买家的授权,并没有授权到这个买家到应用。这一步,买家授权,就是要将已经授权给这个买家到设备,授权到买家账户下的具体某一个应用(即AppKey)。这一步是在买家入口完成,如下图所示:image.png