基于唯传LoRa网关和体验板接入物联网平台（联通用户专用）

场景说明

LoRa（Long Range Radio）是当前应用较广的一种物联网无线接入技术，它最大的特点就是在同样功耗条件下比其他无线接入方式传播的距离更远，实现了低功耗和远距离的统一，它在同样的功耗下比传统的无线射频通信距离扩大3-5倍。而LoRaWAN是为LoRa远距离通信网络设计的一套通讯协议和系统架构。

本示例为通过登录唯传科技官网，购买LoRa网关和体验板，接入物联网平台，实现数据上报和命令下发。

对接LoRa Server

在设备管理服务中创建LoRa Server的产品模型并注册LoRa Server设备。

1. 登录物联网平台控制台，点击右上角“进入设备管理服务”。
2. 单击页面左下角的切换左侧菜单，选择“产品模型”，单击“新增产品模型”，选择“手动创建”。
3. 在弹框页面里填写关键参数信息后，单击“确定”。

   

   参数名称	说明
   产品名称	自定义，如“wxLoraServer”。
   型号	自定义，如“TestModel”
   设备类型	固定配置为“loraServer”
   厂商名称	自定义，如“TestManuName”
   协议类型	选择“MQTT”

4. 在设备管理服务中选择“ 设备 > 设备注册”。
5. 选择页签“单个注册”，单击“创建”，填写关键参数后，单击“确定”。

   

   参数名称	说明
   产品模型	选择3中创建的LoRa Server的产品模型，如“wxLoraServer”
   设备标识码	该参数实际未使用，可自定义设置，如“test_lora”
   设备ID	由系统自动生成，无需配置
   密钥	可自定义设置，如“12345678”
   确认密钥	可自定义设置，如“12345678”

6. 注册设备成功后，将平台返回的“设备ID”和“密钥”保存，通过线下的方式将设备id和密钥提供给唯传，唯传对LoRa Server进行配置。

   

7. 在设备管理服务中选择“ 设备 > 所有设备”，确认上一步注册的LoRa Server设备状态为“在线”，则LoRa Server对接成功。

   

创建LoRa网关

在设备管理服务中创建LoRa的产品模型，并以子设备的方式在LoRa Server下创建LoRa网关。

1. 登录物联网平台控制台，点击右上角“进入设备管理服务”。
2. 单击页面左下角的切换左侧菜单，选择“产品模型”，单击“新增产品模型”，选择“手动创建”。
3. 在弹框页面里填写关键参数信息后，单击“确定”。

   

   参数名称	说明
   产品名称	自定义，如“loraGateway”
   型号	自定义，如“TestGatewayModel”
   设备类型	固定配置为“LoRaGateway”
   厂商名称	自定义，如“TestGatewayManuName”
   协议类型	选择“LoRaWAN”

4. 在设备管理服务中选择“ 设备 > 所有设备”，单击设备标识码为“test_lora”的设备进入“设备详情”页。
5. 选择“子设备”页签，单击右上角的“添加”按钮添加子设备。
6. 在弹框页面里填写关键参数后，单击“确定”。

   

   参数名称	说明
   选择产品	选择3中创建的LoRa网关的产品模型， 如“loraGateway”
   设备名称	自定义，如“test_lora_gateway”
   设备标识码 (GatewayEUI)	填写LoRa网关的gatewayEUI，从LoRa网关上获取。
   接入码	在LoRa Server上注册LoRa网关使用的接入码，由唯传科技提供。

   说明：

   新注册的LoRa网关处于未激活状态。如果LoRa网关是MQTT协议，接入网络2分钟后，LoRa网关变为在线状态；如果LoRa网关是UDP协议，则一直处于未激活状态。

创建LoRaWAN设备

在设备管理服务中创建LoRaWAN的产品模型，以子设备的方式在LoRa Server下创建LoRaWAN设备。

1. 登录物联网平台控制台，点击右上角“进入设备管理服务”。
2. 单击页面左下角的切换左侧菜单，选择“产品模型”，单击“新增产品模型”，选择“手动创建”。
3. 在弹框页面里填写关键参数后，单击“确定”。

   

   参数名称	说明
   产品名称	自定义，如“loraNode”
   型号	自定义，如“TestNodeModel”
   设备类型	非LoRaGateway的其他类型
   厂商名称	自定义，如“TestNodeManuName”
   协议类型	选择“LoRaWAN”

4. 在设备管理服务中选择“ 设备 > 所有设备”，单击已注册的LoRa Server设备进入“设备详情”页。
5. 选择“子设备”页签，单击右上角的“添加”按钮添加子设备。
6. 在弹框页面里填写关键参数后，单击“确定”。

   

   参数名称	说明
   产品模型	选择3中创建的产品名称，如“loraNode”。
   设备名称	自定义，如“test_lora_node”。
   设备标识码 (DevEUI)	填写LoRaWAN设备的devEUI，在体验板上获取。
   接入码	在LoRa Server上注册LoRaWAN设备使用的接入码，由唯传科技提供。
   设备工作模式	选择classA。
   appEUI	购买loRaWAN设备时提供的产品参数单上获取。
   激活方式	选择OTAA。
   AppKey	购买loRaWAN设备时提供的产品参数单上获取。

   说明：

   新注册的设备处于未激活状态，当上报数据后变为在线状态。

调试应用

1. 将体验板连接到电脑上，并且放在LoRa网关附近。接线方式如下图所示，串口线的白、绿、红、黑依次对应串口 TX、RX、电源，地线对应体验板上的TXD0、RXD0、3V3 以及 GND。

   

2. 访问sscom，下载最新版本的串口调试工具。

   

3. 获取PC与开发板连接的实际端口号。
   1. 选择“控制面板 > 硬件和声音 > 设备管理器 ”
   2. 在“端口”子菜单下，找到连接设备的串口号，如COM4。
      

      说明：

      如果没有找到COM端口，请安装驱动精灵，下载对应的驱动。

4. 设置参数。

   

   • Port：选择3获取的与开发板连接的端口号，如COM4。
   • Baud rate：9600。
   • Data bits：8。
   • Stop bits：1。
   • Parity：配置为None。
   • Flow control：配置为None。

5. 输入AT+STATUS=?查询入网状态，如果返回“STATUS:3”表示入网成功。

   

   说明：

   如果返回其他值表示入网失败，具体请联系唯传科技提供技术支持。

6. 入网成功后，发送上报数据的A命令AT+LRSEND=<port>,<confirm>,<len>,<data>，其中<port>为端口，<confirm>为是否需要网关回复确认，<len>为发送数据的长度，<data>为发送的数据。

   

7. 在设备管理服务中选择“ 设备 > 所有设备”，单击设备标识码为test_lora的设备进入“设备详情”页。
8. 选择“子设备”页签，在子设备列表单击设备名称为“test_lora_node”的设备进入子设备详情，查看对应上报的数据。
9. 应用调用下发命令接口，下发请求到物联网平台，携带expireTime参数为0，其中“fport”为设备上报的数值。消息样例如下：

   {
     "serviceId" : "RawData",
     "method" : "RawData",
     "expireTime" : 0,
     "body" : {
       "data": "test001", 
       "fport": 45
     }
   }

   响应示例：

   Status Code:201 Created

   Content-Type:application/json
   {  
    "commandId" : "string" }
   }

10. 在设备管理服务中“设备 > 所有设备 > 子设备”中查看设备接收到的命令。