一、概述
1、背景简介
IoT平台以及建设在IoT平台之上的业务应用的活力是依赖于各种设备数据的输入，因此连接能力的多样性之于IoT平台来说是至关重要的。
在此基础上，除了常见的直连设备接入、网关设备接入、边缘设备接入之外，物联平台还提供了IoT平台融合能力，用以解决存量存在于其他第三方设备平台的设备能够间接接入物联平台，进行设备数据的上报下发，为物联平台及上层业务应用提供数据基础。
经过第三方设备平台的设备数据必定是格式多样，结构相异，基于一个物联平台的定位，在物联平台需要将这些数据转化为统一的格式结构，供上层业务应用使用，使其专于业务。
2、名词解释
| 名词 | 简称 | 说明 |
|---|---|---|
二、操作步骤说明
1、创建产品
在设备接入前 ，需要在平台中创建相应的网关产品和终端产品，创建产品具体流程可参考《创建产品》。其中在创建网关产品和终端产品过程中，选择的物模型模版和填写的产品信息有一定要求，如下：
| 产品 | 创建步骤 | 注意点 |
|---|---|---|
| 网关产品 | 选择产品类目 | 需选择边缘网络分类中的LoRa网关物模型 |
| 填写产品信息 | 节点类型必须为网关设备；所属平台必须为LoRaWAN平台 | |
| 终端产品 | 填写产品信息 | 所属平台必须为LoRaWAN平台，节点类型建议选择终端，连网方式建议选择lora |
2、解析脚本配置
在创建终端产品之后，点击完成平台将会自动跳转至该产品的产品工作台中，若是创建后退出了产品工作台页面，可通过如下路径重新进入：设备中心–>产品管理–>查找到相应产品–>点击产品名称–>产品工作台。
在进入产品的工作台页面后，在左侧菜单查找到<数据解析>栏目，点击进入。数据解析栏目中默认无脚本数据，页面中配备提示语引导告知用户如何添加脚本。系统提供了两种方式，一种是选择标准的，经过验证的系统脚本模板，一种是导入.js脚本文件，用户可根据实际情况添加脚本。
在脚本添加完成后，用户可查看所选择的脚本或导入的脚本文件的内容。在选择错误或导入错误时，可重新选择或重新上传脚本文件。
3、创建LoRaWAN平台配置
在完成终端的脚本文件添加之后，需要跳转至IoT平台融合功能中完成LoRaWAN平台配置的创建。具体页面路径如下：设备中心–>IoT平台融合
在IoT平台融合栏目中，点击添加，创建平台类型为LoRaWAN平台的融合配置，创建完成后，点击新增的配置卡片，进入配置详情进行网关设备、终端的添加。
（1）网关产品
- 添加网关产品配置
在融合配置–配置详情–LoRa网关中，通过添加网关产品配置功能，选择创建产品步骤中创建的网关产品，提交表单完成创建；
- 添加网关设备：
在网关产品配置创建后，点击列表中的管理按钮，进入网关产品配置详情，创建该产品下的网关设备，平台提供单个注册和批量导入两种方式来注册设备至网关产品下；
（2）终端产品
- 添加终端产品配置：
在融合配置–配置详情–LoRa终端中，通过添加终端产品配置功能，选择创建产品步骤中创建的终端产品，选择相应的设备配置文件（设备配置文件名称一般包含设备品牌，设备类型，设备型号信息）提交表单完成创建；
- 添加终端设备：
在终端设备产品配置创建后，点击列表中的管理按钮，进入终端产品配置详情，创建该产品下的设备，平台提供单个注册和批量导入两种方式来注册设备至终端产品下；
4、LoRa网关设备配置
在LoRaWAN平台配置创建完成后，并且LoRa网关设备已就位时，需要针对LoRa网关进行服务期配置。步骤如下：
1、将LoRa网关通电通网；
2、通过LoRa网关设备后的标签，使用具有热点连接功能的设备，如手机或电脑，连接LoRa网关发出的热点，使LoRa网关与连接该热点的设备，如手机或电脑处于同一局域网下；
3、通过LoRa网关设备后的标签，获取到网关地址信息，使用同一局域网下的手机或电脑通过浏览器访问该网关地址，可进入网关设备的本地Web管理页面；
4、在网关设备的本地Web管理页面中，输入账号密码进行登录（账号密码在设备购买时，设备厂商的说明文档中会提供，默认账号为admin，密码为88888888）；
5、登录至网关设备管理页面之后，进入网关配置–>服务器相关页面，对服务器信息进行配置，配置后提交保存即可。具体数据配置及数据来源如下：
| 字段 | 所填数据 |
|---|---|
| 通信方式 | 选择UDP |
| 服务器地址 | 在LoRaWAN平台配置–>对接信息中获取 |
| 端口号 | 在LoRaWAN平台配置–>对接信息中获取 |
| 上行端口号 | 在LoRaWAN平台配置–>对接信息中获取 |
| 下行端口号 | 在LoRaWAN平台配置–>对接信息中获取 |
| 心跳包间隔 | 默认填写10s |
| 状态包间隔 | 默认填写60s |
5、设备上线验证
在云端管理台配置完成后，网关设备服务器信息配置后，下一步需要将终端通电通网。查找到网关设备、终端，进入其设备详情，查看其实时状态信息。
若设备正常上线，并且设备数据正常，则实施流程结束；
若设备不能上线，或者上线后设备数据不正常，则需要检查以下几个方面：
- 企业管理台相应产品数据解析脚本的有无和解析脚本的正确性；
- LoRaWAN平台配置中LoRa网关、LoRa终端映射配置的正确性；
确认无误后，设备仍不能上线或设备数据不正常，通过PMS提交产品、开发人员进行处理。
注意：
因为lorawan设备由于其通讯协议的特性，本身是适用于低功耗设备使用，故设备的上报周期一般会相对较长，平台无法及时感知设备的在离线状态。目前平台设定设备超过三个上报周期未上报数据，则判定该设备为离线状态，直至设备重新上报数据为止。
三、常见问题
待补充。
四、修订记录
| 修订时间 | 编写人 | 修订内容 |
|---|---|---|
| 2022-5-20 | 黄奕坚 | 起稿 |
| 2022-5-30 | 黄奕坚 | 增加创建截图 |
