什么是云云对接(原泛化协议)SDK

阿里云物联网平台支持基于MQTT、CoAP和HTTP协议的通信,其他类型协议,如消防协议GB/T 26875.3-2011、Modbus等暂不支持。在特定场景下,设备无法直接接入阿里云物联网平台时,您可使用云云对接SDK,快速构建桥接服务,搭建设备或平台与阿里云物联网平台的双向数据通道。

说明

仅支持在以下地域使用云云对接SDK:华东2(上海)、华北2(北京)、华南1(深圳)、德国(法兰克福)和美国(弗吉尼亚)。

服务架构

云云对接SDK是协议自适应的框架,用以构建与阿里云物联网平台进行高效双向通信的桥接服务。

网桥

适用场景

  • 由于网络环境或者硬件限制,设备无法直接接入阿里云物联网平台。

  • 设备只支持某种类型协议,而阿里云物联网平台目前不支持该协议。

  • 设备与其接入服务器(网桥Server)之间已有通信网络,您希望在不修改设备和协议的情况下,将设备接入阿里云物联网平台。

  • 设备已接入到您的服务器,需进一步升级服务。

    • 复用阿里云物联网平台的能力,例如OTA升级功能。

    • 将设备纳入基于阿里云物联网平台的解决方案。

    • 其他业务需要的处理逻辑。

主要功能

云云对接SDK使网桥Server,具备与阿里云物联网平台通信的能力。

基础功能:

  • 基于配置文件的静态配置管理能力。

  • 设备连接管理能力。

  • 上行通信能力。

  • 下行通信能力。

    说明

    下行通信不支持同步方式,包括同步服务调用和RRPC通信。

进阶功能:

  • 基于接口的动态配置管理能力。

  • 已封装属性、事件、标签数据上报接口;属性、事件批量上报接口;属性设置接口;服务调用接口。

名词解释

名词

描述

设备

真实物联网场景设备,该设备无法直接使用阿里云物联网平台所支持的协议直接与云端通信。

网桥Server

设备接入服务器。该服务器使用特定类型协议与设备通信,使用云云对接SDK与阿里云物联网平台通信。

原始协议

设备与网桥Server之间使用的特定类型协议。云云对接SDK不关心原始协议的具体定义和实现。

原始身份标识符

设备与网桥Server使用原始协议通信时的唯一标识符。云云对接SDK接口参数中,用originalIdentity表示设备的原始身份标识符。

设备证书

在阿里云物联网平台注册设备后,获得的设备证书信息(ProductKey、DeviceName、DeviceSecret)。在云云对接的场景下,不将设备证书烧录到设备上;而是配置云云对接SDK文件devices.conf ,由网桥将设备原始身份标识符originalIdentity映射到设备证书信息。

网桥证书

在阿里云物联网平台注册网桥设备后,获得的网桥设备证书信息(ProductKey、DeviceName、DeviceSecret),用于在云端标识网桥的身份。

开发和部署

  1. 在阿里云物联网平台控制台,创建产品和设备,获取网桥设备证书信息。

    具体操作,请参见创建产品单个创建设备批量创建设备

    在配置云云对接SDK时,需配置网桥设备证书信息。

    说明

    网桥是个虚拟概念,您可使用任意设备的证书信息作为网桥的证书信息。

  2. 配置云云对接SDK。

    具体操作,请参见基础用法进阶用法

    说明

    目前,仅提供Java语言的云云对接SDK,支持JDK 1.8及以上版本。

  3. 部署已开发完成的桥接服务。

    • 可使用阿里云ECSSLB等服务,以高度可扩展的方式部署至阿里云。

    • 也可直接部署到本地环境中,以保证可信通信环境。

    以基于阿里云云服务器ECS为例,上线流程如下。

    网桥