一、概述
1、文档面向的对象：开发人员、技术经理
2、文档编写目的：在南向对接的进程中，项目人员，或开发人员可以根据此文档通过云云对接的方式将设备接入到物联网平台。
3、术语解释：
IoT 平台：即物联网平台，涵盖了从设备连接、设备开发到设备运营管理、数据分析的统一物联设备管理平台。在 IoT 平台中定义了统一的设备接入标准，以及统一的数据管理及交换标准，确保不同厂商不同种类的终端设备在平台上得以集中管理并且提供统一的数据交换功能，并通过平台连接各种业务相关的异构系统、应用以及数据源，满足平台各系统之间无缝共享和交换数据的需要。
物联平台设备统一协议：物联网平台的目的是将各个厂商不同协议的设备、各种异构系统通过统一的管理平台，进行集中化的管理。为了实现统一的管理，物联网平台提供了统一的设备协议。设备可以直接通过实现该协议连接上物联网平台，以实现设备上云的功能。设备协议基于 MQTT 设计。其中涵盖了设备上线、激活、数据收集上报以及反向控制等相关功能。其协议核心思路是将硬件设备功能转换成为基于数据类型、值的一系列数据属性后将其进行上报，以便平台能够进行统一的收集、存储，已完成平台统一展现、管理、分析等相关功能。
协议转换器–XAgent：
由于各个厂商、设备大多都有其自有的协议甚至业务系统，为了在物联网平台能够进行统一的管理，需要进行协议转换。转换的目的是为了异构协议，转换为物联平台设备统一协议。为了实现该目的，物联网平台提供了统一的协议转换开发工具，也称之为 XAgent。XAgent 框架是物联网平台提供的一个插件开发模式的框架，它能够让厂商的设备保留自定义协议情况下接入物联网平台。它需要厂商自行开发 PTP 插件，用于连接设备，解析数据，上报数据到物联网平台和接收到来自物联网平台的数据等。PTP Protocol Transfer Process，协议转换处理的简称。
XAgent 框架提供以下功能:
- 提供 XAgent api 接口，帮助 PTP 插件与物联网平台进行数据交互。
- 为开发者提供向设备接收和发送数据的能力。
二、接入方式说明
云云接入方式是通过现有第三方云平台、业务系统将设备接入到物联网平台的一种设备接入方式。采用这种方式对接，原设备端不用改造，只需在第三方云平台、业务系统中做统一的对接即可将现有设备按统一的物模型接入物联网平台。
为此，物联云平台提供XAgent SDK用于云云对接的设备接入。XAgent SDK 集成说明请参考《XAgent SDK集成说明》。
三、开发相关文档及文档说明
开始对接前，请先阅读如下文档：
1、物联网平台创建产品、添加网关授权，参考《四、设备接入平台步骤详解》
2、XAgent SDK集成说明请参考《XAgent SDK集成说明》
3、XAgent SDK 和Demo 请参考《XAgent SDK & Demo下载》
四、设备接入平台步骤详解
1、平台登陆
（1）打开物联云平台。
（2）账号密码登陆（如无，请联系物联云平台项目管理人员获取）
2、创建产品
- 产品创建具体步骤可参照《创建产品》；
- 产品创建成功后，可以在产品详情中查看和复制产品ID（也称 PRODUCT_ID）
3、添加设备（此版本中需要把设备预导入到产品中）
（1）操作路径：产品信息页面 –> 设备调试 –> 添加设备
4、添加网关授权
（1）操作路径：设备中心 –> 网关授权 –> 添加证书
（2）证书名称填写标准：具有标识性的即可，如：项目-使用者-创建者
（3）选择产品：重要！把网关授权添加到产品，产品才能被使用
（4）添加完后，即可得到 Cid & Ckey, 外部授权重要，需要妥善保管
5、填写配置文档（重要！以项目为维度做记录）
把平台上创建的相关信息，都请补充到该表格，并进行妥善保管，后续开发和维护需要使用！
| 信息项 | 配置值 | |
|---|---|---|
| 配置说明基本信息 | 项目名 | |
| 厂商名称 | ||
| 开发管理平台 | 登陆地址 | |
| 登陆账号 | ||
| 登陆密码 | ||
| 平台接入 | 产品名称 | |
| 产品ID | ||
| 授权证书ID（CID） | ||
| 授权证书密钥（CKEY） | ||
| 连接器类型 | ||
| 开发配置信息 | 云端CM服务器地址 | 公有云为：mqtt.xlink.cn |
