文档

设备接入引导

更新时间:

当您希望将设备接入阿里云物联网平台,实现设备集中管理、收集和数据分析、远程控制、保障设备数据安全等能力时,请根据本文的设备接入流程引导,选择设备使用协议并进行云端和设备端开发。

前提条件

开通物联网平台服务

说明

免费开通后,您可先试用物联网平台服务,试用流程,请参见阿里云免费试用的物联网平台产品。物联网平台服务的计费标准,请参见计费概述

接入说明

设备接入物联网平台,需要完成以下操作:

操作

说明

云端产品开发

在物联网平台控制台,依次进行创建产品、添加物模型功能、添加自定义Topic、创建设备、配置业务功能(例如:设备标签、设备影子、设备OTA升级等功能)等操作,定义设备认证方式,完成产品功能开发和设备注册。

设备端开发

设备端获取设备证书,使用SDK接入物联网平台。设备端可以使用Link SDK、开放协议的自研SDK、AT模组、云云对接SDK的接入方式实现设备连接物联网平台。

不同类型设备接入物联网平台支持的接入协议、SDK和具体流程不同。物联网平台支持的设备类型和对应协议如下表所示,对应SDK和完整接入流程说明,请参见下文的接入流程

设备类型

支持的接入协议

直连设备

MQTT、CoAP、HTTPS

网关设备(直连方式)和非直连子设备

MQTT

LoRa设备

MQTT

中国移动和中国联通的NB-IoT设备

MQTT、CoAP

云网关设备

MQTT、JT/T 808、GB/T 32960、SL 651、中国电信NB-IoT

无法使用物联网平台支持的协议直接接入的设备

云云对接支持的私有协议

说明

网关设备和云网关设备区别:

  • 网关设备:使用MQTT协议且可以挂载子设备的直连设备,通过设备密钥方式进行设备身份认证后接入物联网平台。

  • 云网关设备:支持使用MQTT协议、JT/T 808协议、GB/T 32960协议、中国电信NB-IoT协议的云网关接入设备。

    • MQTT协议、JT/T 808协议、GB/T 32960协议和SL 651协议的云网关设备,使用自定义证书信息进行设备身份认证。

      • 使用MQTT协议云网关可以将存量设备在无需做改造的情况下迁移到阿里云企业物联网平台。

      • 使用JT/T 808协议云网关接入的设备,适用于道路运输车辆卫星定位系统车载终端与阿里云企业物联网平台之间的通信。

      • 使用GB/T 32960协议云网关可以将电动汽车设备接入物联网平台,实现电动汽车远程服务和系统管理。

      • 使用SL 651协议云网关将遥测站设备接入物联网平台,用于水文监测数据的采集与传输。

    • 中国电信NB-IoT的云网关设备,是通过直连方式接入中国电信AEP平台中已完成开发的NB-IoT设备。

接入协议说明

image

MQTT协议

认证方式

  • 直连设备和网关子设备:采用物联网平台的设备证书信息ProductKey(产品信息唯一标识)、DeviceName(设备名称)、DeviceSecret(设备密钥)进行认证。

  • MQTT协议云网关设备:采用标准的MQTT协议规范的UserName作为身份信息进行认证,支持使用自定义证书、自定义设备认证方式、自定义通信Topic能力、设备端和服务端证书OCSP能力、设备和服务端双向安全认证等能力。

设备身份信息说明

设备

说明

直连设备

  • 可以通过物联网平台控制台或云端API创建设备,获取设备证书信息。具体内容,请参见创建设备RegisterDevice

  • 可以通过设备上线时采用的一型一密注册方式创建设备,获取设备证书信息。具体内容,请参见一型一密

网关子设备

支持网关设备代理子设备接入物联网平台。网关设备与物联网平台建连后,子设备复用相同的连接和物联网平台通信。具体内容,请参见网关与子设备

云网关设备

  • 一方认证:需要提前在物联网控制台批量导入UserName信息创建设备,设备建连时物联网平台校验设备身份信息。

  • 三方认证:物联网平台调用自定义的FC函数或HTTPS服务进行认证,认证成功后自动创建设备身份。

使用说明

MQTT协议规范和使用说明,请参见使用MQTT协议

HTTPS协议

支持HTTPS协议,推荐采用TLS协议1.3版本加密接入阿里云物联网平台。

认证方式

采用物联网平台的设备证书信息ProductKey(产品信息唯一标识)、DeviceName(设备名称)、DeviceSecret(设备密钥)进行认证。

设备身份信息说明

通过物联网平台控制台或云端API创建设备,获取设备证书信息。具体内容,请参见创建设备RegisterDevice

使用说明

HTTPS协议规范和使用说明,请参见使用HTTPS协议

CoAP协议

支持UDP协议,采用DTLS和对称加密两种安全模式接入阿里云物联网平台。

认证方式

采用物联网平台的设备证书信息ProductKey(产品信息唯一标识)、DeviceName(设备名称)、DeviceSecret(设备密钥)进行认证。

设备身份信息说明

通过物联网平台控制台或云端API创建设备,获取设备证书信息。具体内容,请参见创建设备RegisterDevice

使用说明

CoAP协议规范和使用说明,请参见使用CoAP协议

JT/T 808协议

云网关JT/T 808协议应用于汽车行业,支持使用自定义证书、自定义设备认证方式、自定义通信Topic能力、设备端和服务端证书OCSP能力、设备和服务端双向安全认证等能力。

认证方式

  • 一方认证:需要提前在物联网平台控制台批量导入Manufacturer ID(厂商ID)、Terminal Model(设备型号)和Terminal ID(设备ID)信息创建设备, 设备建连时物联网平台校验设备身份信息。

  • 三方认证:物联网平台调用自定义的FC函数进行认证,认证成功后自动创建设备身份。

使用说明

使用JT/T 808协议云网关接入设备的详细说明,请参见JT/T 808协议云网关概述

GB/T 32960协议

云网关GB/T 32960协议应用于汽车行业,支持使用自定义证书、自定义设备认证方式、自定义通信Topic能力、设备端和服务端证书OCSP能力、设备和服务端双向安全认证等能力。

认证方式

  • 一方认证:需要提前物联网控制台批量导入车辆VIN信息创建设备, 设备建连时物联网平台校验设备身份信息

  • 三方认证:物联网平台调用自定义的FC函数进行认证,认证成功后自动创建设备身份。

使用说明

使用GB/T 32960协议云网关接入设备的详细说明,请参见GB/T 32960协议云网关概述

SL 651协议

SL 651是国家水文局制定的用于水文监测数据通信的协议,它规定了水文监测数据采集与传输的格式、内容、传输方式等技术参数,支持通过TCP(安全性低,不推荐)和TLS两种方式将遥测站设备接入物联网平台。

认证方式

  • 一方认证:需要将遥测站地址telemetryAddress和密码password导入物联网平台,物联网平台会基于设备认证信息对设备进行认证。

  • 三方认证:物联网平台调用自定义的FC函数进行认证,认证成功后自动创建设备身份。

使用说明

使用SL 651协议云网关接入设备的详细说明,请参见SL 651协议云网关概述

其它协议

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

使用说明,请参见使用云云对接(原泛化协议)SDK

接入流程

开通物联网平台服务后,设备接入的完整流程如下图所示,主要分为云端产品开发和设备端开发。

image

云端开发

设备类型

操作流程

  • 直连设备

  • 网关设备

  • 非直连子设备

  • LoRa设备

  • 中国移动和中国联通的NB-IoT设备

  • 私有协议的设备

  1. 购买企业版实例:试用的公共实例可提供的资源规格有限,支持基础的设备接入和通信功能。

    正式商用场景,建议您购买企业版实例使用。实例类型和功能说明,请参见企业版实例不同类型和功能区别

  2. 创建产品:选择产品的节点类型认证方式,定义产品下设备的设备类型,及设备接入物联网平台使用的认证方式。

    认证方式详细说明,请参见设备安全认证

  3. (可选)配置产品功能:根据业务需求,开发产品通信功能。通信原理的详细说明,请参见什么是Topic

    • 定义物模型功能:如果设备使用物模型Topic与物联网平台通信,需要在物联网平台为设备所属产品定义物模型功能。

    • 定义设备通信Topic:如果设备使用自定义Topic与物联网平台通信,需要在物联网平台为设备所属产品定义自定义Topic类。

      添加自定义Topic类操作及通信说明,请参见使用自定义Topic通信

    • 消息解析:物联网平台定义设备消息的标准数据格式为Alink JSON。如果设备将原始数据透传到物联网平台,需要配置消息解析脚本,实现设备通信数据在设备自定义格式和JSON格式之间转换。

  4. 注册设备:根据已创建的产品,在物联网平台添加对应的设备。

    具体操作,请参见单个创建设备批量创建设备创建LoRa设备添加网关与子设备

    说明

    以下情况无需在物联网平台注册设备:

    • 使用设备密钥的一型一密免预注册认证方式。

    • 使用ID²认证方式时,未开启ID²白名单校验。

  5. (可选)配置相关业务功能:如果设备需要使用设备标签设备任务设备影子远程配置OTA升级等功能,需在物联网平台先配置,后续在设备端开发对应功能实现逻辑。

    说明

    使用云云对接SDK接入物联网平台的私有协议设备,仅支持OTA升级。

云网关设备

  1. 购买尊享型实例:仅尊享型企业版实例支持云网关功能。购买实例方法,请参见购买企业版实例

  2. 确认待接入设备使用的云网关协议:

    • 中国电信NB-IoT:中国电信的NB-IoT设备,需通过直连方式接入中国电信AEP平台来使用。

    • MQTT:使用自定义证书、自定义设备认证方式、自定义通信Topic的能力,可以将存量设备在无需做改造的情况下迁移到阿里云企业物联网平台。

    • JT/T 808:建议采用TLS方式接入,支持使用服务端单向认证、设备端和服务端证书OCSP能力、设备和服务端双向安全认证等能力,适用于道路运输车辆卫星定位系统车载终端与阿里云企业物联网平台之间的通信。

    • GB/T 32960:建议采用TLS方式接入,支持使用服务端单向认证、设备端和服务端证书OCSP能力、设备和服务端双向安全认证等能力,适用于电动汽车设备与阿里云企业物联网平台之间的通信。

    • SL 651:建议采用TLS方式接入,支持使用服务端单向认证、设备端和服务端证书OCSP能力、设备和服务端双向安全认证等能力,适用于遥测站设备与阿里云企业物联网平台之间的通信,用于水文监测数据采集与传输。

  3. 云端开发流程如下:

说明

开发者也可通过云端API实现物联网平台的云端管理能力,例如:产品管理、设备管理、Topic管理、服务端订阅、云产品流转、消息通信等。

云端API具体内容,请参见API列表。云端SDK使用方法,请参见云端SDK。使用示例,请参见使用OpenAPI示例

设备端开发

设备类型

接入方式

说明

  • 直连设备

  • 网关设备

  • 非直连子设备

  • LoRa设备

  • 中国移动和中国联通的NB-IoT设备

Link SDK接入

物联网平台提供了CAndroidPythonJavaiOSNode.js语言的SDK,支持各种类型设备的接入。

开放协议接入

如果提供的设备端SDK无法满足您的需求,可自行开发。例如使用开源MQTT客户端接入物联网平台。

物联网平台提供了基于多种语言的Paho-MQTT的示例,包括Paho-MQTT的AndroidJavaC(嵌入式版)C(非嵌入式版)C#PythonRustGo等语言。

可以根据Alink协议,对接开发物联网平台的各项功能。

模组接入

可以使用支持MQTT、HTTPS指令的AT模组,也可以使用通用TCP AT模组接入。

物联网平台提供了如下SDK示例:在支持MQTT的模组上集成SDK在支持TCP的广域网模组上集成SDK

私有协议的设备

云云对接SDK接入

支持设备的数据从其他物联网平台流转到阿里云物联网平台。

云网关设备

MQTT协议云网关接入

使用自定义证书信息进行设备身份认证,可以将存量设备在无需做改造的情况下迁移到阿里云企业物联网平台。

物联网平台提供了如下SDK示例:C语言的接入示例(阿里云FC认证)Java语言的接入示例(双向认证)

JT/T 808协议云网关接入

使用自定义证书信息进行设备身份认证,适用于将有道路运输车辆卫星定位系统车载终端的设备接入物联网平台。

物联网平台提供了C语言的SDK示例:接入示例(一方认证)

GB/T 32960协议云网关接入

使用自定义证书信息进行设备身份认证,适用于将电动汽车设备接入物联网平台。

物联网平台提供了使用Github开源工程的SDK示例:接入示例(一方认证)

SL 651协议云网关接入

使用自定义证书信息进行设备身份认证,适用于将遥测站设备接入物联网平台。

后续操作

设备成功接入物联网平台后,可通过设备的消息转发、数据服务、监控运维功能,管理物联网平台设备相关数据。

  • 消息转发:可以使用服务端订阅和云产品流转功能,进行设备消息转发,实现设备与服务器的消息通信,以及设备数据的流转和存储。

  • 数据服务:可以使用数据服务的存储备份、数据解析、存储管理、指标管理、SQL分析、报表分析和数据智能等功能,挖掘物联网数据中的价值。

  • 监控运维:可以使用实时监控、日志服务、在线调试等功能对设备和通信消息相关指标数据,进行监控和管理。

更多功能说明,请参见功能特性

常见问题

设备接入

设备认证

MQTT连接

CoAP连接

HTTP连接

设备移植

泛化协议接入

设备状态

其他相关问题