【产品应用】LoRa网关与二次开发终端的神仙搭配

LoRa项目开发时间紧？驱动开发困难？二次开发终端ZSL420提供了丰富的API接口，与LoRa网关搭配可以快速实现无线数据转MQTT，有效降低产品成本、缩小开发周期，快速投入市场。

ZLGLinkSDK二次开发简介ZLGLink SDK包是广州致远电子开发的LoRa智能组网二次开发包。该SDK主要包含有芯片外设demo、LoRa裸驱动demo、ZLGLink智能组网协议demo。提供eclipse和keil两种开发环境。支持本地升级与远程无线升级。丰富的示例demo可以帮助开发者快速上手，缩短LoRa终端的开发周期。表1ZLGLink智能组网协议demo简介

序号	Demo类别	说明
1	burst_report	突发上报型应用，主动组网，MCU低功耗
2	period_report	分时上报型应用，主动组网，MCU低功耗
3	period_wake	周期唤醒型应用（主机可空中唤醒休眠终端），主动组网，MCU低功耗
4	lpuart_wake	低功耗串口唤醒型应用（低功耗串口唤醒休眠终端），主动组网，MCU低功耗
5	join_white	入网白名单型应用（主机过滤非白名单入网设备），主动组网，MCU低功耗
6	period_wake_burst_report	按键唤醒型应用（休眠终端支持主机空中唤醒和终端按键唤醒），主动组网，MCU低功耗

表2常用ZLGLinkAPI简介

序号	API	说明
1	aw_ntl_dev_type_set()	通过该接口可以设置主机、从机和中继等设备类型，以区分星型网络中不同的设备
2	aw_ntl_dev_work_mode_set()	根据不同的功耗需求，可以通过该接口设置从机的工作模式（一般模式，周期唤醒模式和深度休眠模式）
3	aw_ntl_dev_networking_create()	手动创建网络接口，根据用户指定通信信道创建网络
4	aw_ntl_dev_networking_auto_create()	自动创建网络接口，主机自动选择空闲信道创建网络
5	aw_ntl_dev_networking_joined_enable()	主机允许从机入网接口
6	aw_ntl_dev_networking_join()	从机发起入网接口
7	aw_ntl_sendto()	数据发送接口
8	aw_ntl_recvfrom()	数据接收接口

 MQTT客户端采集二次开发终端温度数据

MQTT客户端向终端发布温度采集指令，终端在接收到温度采集指令后上报温度数据，MQTT客户端采集终端温度数据示意图，如图1所示。图1MQTT客户端采集终端温度数据示意图1. 网关配置

网关配置主要包括协议转换配置，MQTT配置和网关ZLGLink配置三个部分。

1.1 协议转换配置

打开网关的网页配置页面，左边栏选择【协议转换】，在转换选择页面里选择【ZLGLink转MQTT】，然后点击【保存】，网关自动重启，如图2所示。

图2 选择ZLGLink转MQTT

1.2MQTT配置

左边栏选择【网络配置】，在网络配置里选择【MQTT】标签页。

在【基本配置】里配置网关需要连接的MQTT服务器的地址、端口号、MQTT用户名、密码和客户端ID。

在【订阅主题】里配置网关订阅的主题和服务质量。

在【发布主题】里配置网关发布消息的主题和服务质量，如图3所示。

图3配置MQTT

1.3 ZLGLink配置 左边栏选择【ZLGLink配置】标签页。在【基本配置】里配置ZLGLink的基本配置参数。在【组网控制】里使能自组网并允许入网，如图4所示。

图4ZLGLink配置

2. ZLGLink终端二次开发配置

2.1 从机应用选择使用ZLGLink SDK中的突发上报从机demo并设置温度采集指令，如图5所示。

图5 从机应用选择

2.2 在网关开启允许入网功能后ZSL420-EVB Demo板通过按键SW1开启入网，如图6所示。

图6从机入网到网关

2.3 MQTT客户端配置

配置MQTT客户端需要连接的MQTT服务器的地址、端口号、MQTT用户名、密码和客户端ID。本文以MQTT.fx客户端上位机做演示，如图7所示。

图7配置MQTT客户端

2.4.成果展示

MQTT客户端订阅主题客户端数据主题：pubtopic/+；

MQTT客户端向终端（0x0001）发布温度采集指令主题：subpotic/addr0x0001，温度采集指令“Get Temperature”；网关接收后下发至终端（0x0001），终端再将温度数据上报给网关，MQTT客户端就能收到ZSL420-EVB Demo板温度数据，如图8所示。

图8MQTT客户端采集LoRa终端温度数据