透传网关模式接入

本模式适用于两种场景的设备：

支持TCP/IP协议栈的设备，设备可以直接与物联网平台进行通信，但希望直连边缘节点实现近端管理的设备。
不支持TCP/IP协议栈的设备，无法直接同物联网平台通信，需要通过网关连接边缘节点实现近端管理的设备。

IoTEdge支持透传IoTDA报文的能力详情，如表表1。

设备直连边缘节点

设备通过原生MQTT协议或集成IoT Device SDK、IoT Device SDK Tiny直连边缘节点，边缘节点将设备上报的数据透传给物联网平台，并将平台下发的命令透传给设备。

请参考以下流程完成设备接入：

在设备接入服务完成设备的产品模型（也称Profile）、编解码插件的开发，并进行自助测试。

对于设备通过边缘节点上报至物联网平台的数据，云端物联网平台要能够解析设备上报的数据。
具体请参考“设备接入服务”的开发指南中产品开发的指导。
- Profile是用来描述设备能力的文件，通过JSON的格式定义了设备的基本属性、上报数据和下发命令的消息格式。定义Profile，即在物联网平台构建一款设备的抽象模型，在设备上报数据时，平台能够根据定义的Profile理解该款设备支持的属性信息。
- 编解码插件开发要根据设备上报数据的格式来判断，如果设备上报的“数据格式”为“二进制码流”，则该产品模型下需要进行编解码插件开发。
进行设备接入物联网平台的设备侧开发。
1. 根据设备自身情况选择合适的接入方式，可以选择原生MQTT协议接入、或者集成IoT Device SDK、IoT Device SDK Tiny接入。具体请参考“设备接入服务”的开发指南中设备侧开发的指导。
  1. 采用原生MQTT协议接入，请参考“设备接入服务”的开发指南中使用MQTT Demo接入的指导。
  2. 通过集成SDK接入，请参考“设备接入服务”的开发指南中IoT Device SDK使用指南的指导。
2. 将设备接入的IP地址修改为需要连接的边缘节点本地的IP地址。
  
  通过MQTT协议的设备接入边缘节点的端口地址是7883，并且需要下载证书文件进行认证。

在“IoT边缘控制台”添加设备。

访问IoT边缘，单击“管理控制台”进入IoT边缘控制台。
选择左侧导航栏的“边缘节点 > 节点管理”，选择您的边缘节点名称，进入节点详情页。
（可选）选择“应用模块 > 模块管理”页签，部署边缘应用。
为了保证设备能够正常在线，请您先部署步骤2中的应用，直连场景下不需要部署其他应用，具体操作请参考部署应用。

选择左侧导航栏“边缘设备”页签，单击左上角的“添加边缘设备”按钮，按照表1填写参数后，单击“确认”。

图1 添加边缘设备

表1 添加边缘设备
参数名称	说明
所属产品	选择要添加的产品名称。只有在设备接入服务里创建了产品，此处才可以选择具体的产品。如没有，请先创建产品。
设备标识码	设备唯一物理标识，如IMEI、MAC地址等，用于设备在接入物联网平台时携带该标识信息完成接入鉴权。 MQTT设备：通过注册成功后生成的“设备ID”（与设备标识码一一对应）和“设备密钥”接入平台。
设备名称	自定义。
模块ID	不填。添加边缘设备的什么时候填写模块ID？
password	自定义设备密钥。

添加设备成功，请保存好设备ID和密钥，用于设备接入平台认证。
图2 设备ID和密钥

参考使用MQTT.fx调测文档，使用MQTT.fx工具接入IoT边缘平台。

完成添加设备后，可以在设备列表中查看设备状态，并管理边缘设备。

也可以单击“设备ID”跳转至“设备接入服务控制台”进行设备管理。

表2 操作说明
操作名称	说明
配置	查看边缘设备的原有配置，或者修改边缘设备的配置。
删除	删除边缘设备。说明：若您已在“设备接入服务控制台”删除边缘设备，请前往“IoT边缘控制台”继续删除该设备，否则“IoT边缘服务”将继续对此设备计费。
管理子设备	查看边缘设备详情，以及注册子设备，具体操作可参考网关与子设备管理。

将设备连接到边缘节点上。
验证设备上报的数据能在“IoT边缘控制台”中查看。
1. 设备上电，并向物联网平台上报数据。
2. 访问IoT边缘，单击“管理控制台”进入IoT边缘控制台。
3. 选择左侧导航栏的“边缘节点 > 节点管理”，选择您的边缘节点名称，进入节点详情页。
4. 选择“边缘设备”页签，单击“管理子设备”查看对应设备的状态。如果状态为“在线”，则表示设备已经成功接入物联网平台。
  图3 管理子设备
5. 返回“边缘设备”页签，单击对应的“设备ID”进入设备详情页，在详情页中查看“最近上报数据”，如果能正常解析和显示对应的数据，则表示设备上报数据成功。
  
  如果需要查看所有上报的历史数据，则可以在设备详情的“历史数据”中进行查看。

设备通过网关连接边缘节点

设备通过一些简单的近场通信协议如ZigBee、ZWave、Bluetooth或者是其他的一些非IP有线方式传输协议如串口、并口等接入网关，网关通过集成IoT Device SDK连接边缘节点，边缘节点透传网关上报的数据，以及将平台的命令下发给网关。

请参考以下流程完成设备接入：

在设备接入服务完成网关、设备的产品模型（也称Profile）、编解码插件的开发，并进行自助测试。
对于通过边缘节点上报至物联网平台的网关和设备的数据，云端物联网平台要能够解析。
- Profile是用来描述设备能力的文件，通过JSON的格式定义了设备的基本属性、上报数据和下发命令的消息格式。定义Profile，即在物联网平台构建一款设备的抽象模型，在设备上报数据时，平台能够根据定义的Profile理解该款设备支持的属性信息。
- 编解码插件开发要根据设备上报数据的格式来判断，如果设备上报的“数据格式”为“二进制码流”，则该产品模型下需要进行编解码插件开发。
具体操作请参照“设备接入服务”的开发指南中产品开发的指导。
进行网关接入物联网平台的设备侧开发。
1. 在网关集成IoT Device SDK接入平台。目前IoT Device SDK支持C、Java两个版本。实际开发中，请根据开发时使用的语言、平台，选用合适的SDK集成。具体请参照“设备接入服务”开发指南中IoT Device SDK使用指南的指导。
2. 将网关接入的IP地址修改为需要连接的边缘节点本地的IP地址。
  
  通过MQTT协议的网关接入边缘节点的端口地址是7883。
在“IoT边缘控制台”添加网关。物联网平台中，网关也是作为一个设备注册。具体请参照3。
将网关连接到边缘节点上。
将子设备连接到网关。
验证设备上报的数据能在“IoT边缘控制台”中查看。
1. 设备上电，并向物联网平台上报数据。
2. 访问IoT边缘，单击“管理控制台”进入IoT边缘控制台。
3. 选择左侧导航栏的“边缘节点 > 节点管理”，选择您的边缘节点名称，进入节点详情页。
4. 选择“边缘设备”页签，单击对应的“设备ID”跳转至“设备接入服务控制台”进入设备详情页。
5. 选择“子设备”页签，在设备列表中查看对应设备的状态。如果状态为“在线”，则表示设备已经成功接入物联网平台。
  图4 查看设备状态
  
  子设备的状态表示子设备接入网关的状态，由网关上报到物联网平台进行状态的刷新；如果网关不能正常上报子设备的状态信息到物联网平台，则展示的子设备状态不会刷新。例如：某子设备通过网关接入到物联网平台，子设备状态为在线状态，如果此时网关与物联网平台断开连接，则网关不能上报子设备的状态到物联网平台，该子设备的状态会一直显示在线。
6. 单击“查看”具体的子设备，可以查看子设备的设备详情、历史上报数据、查看操作记录。