SDK介绍和下载
LoRaWAN SDK是新华三物联网根据多年来在LoRaWAN网络使用过程中积累的经验总结,推出的用于帮助生态合作伙伴能够更好的使用LoRaWAN网络来接入新华三物联网平台的配套工具。
了解第三方LoRaWAN终端接入新华三物联网平台相关介绍,请点击这里。
使用说明
LoRaWAN SDK内部架构如下图所示
图: SDK架构图
新华三LoRaWAN SDK基于LoRaWAN官方SDK进行扩展,LoRaWAN Alliance定义了LoRaWAN的物理层和MAC层协议,但未定义更上层的协议内容,新华三LoRaWAN SDK在支持官方SDK提供的物理层和MAC层协议的基础上,扩展了网络层(上图中的 OasisNet)的功能(参考 Oasis网络扩展)。同时支持了模组封装模块的适配框架(上图中的 LoRaWAN Adapt Level),方便第三方LoRaWAN模块融入新华三LoRaWAN SDK(参考第三方模组接入适配),并提供新华三平台扩展功能(上图中的 oasis模块,参考平台扩展)和 main.c案例(参考案例)。
在 windows环境开始使用新华三LoRaWAN SDK,请单击这里。
在 linux环境开始使用新华三LoRaWAN SDK,请单击这里。
功能列表
下表列出了新华三LoRaWAN SDK支持的功能和规划的功能
表:新华三LoRaWAN SDK功能表
分类 | 功能 | 描述 | 实现情况 |
---|---|---|---|
系统 | 无系统 | 提供非嵌入式操作系统的SDK环境 | 已实现 |
FreeRTOS | 提供基于FreeRTOS操作系统的SDK环境 | 暂未实现 | |
开发板 | STM32 NucleoL073开发板 | 提供基于STM32的NucleoL073开发板的SDK用例,详情请 查看这里。 | 已实现 |
物理层&MAC | 官方SDK集成 | 集成官方LoRaWAN SDK,提供基于SPI的芯片控制和MAC协议,详情请查看这里,并提供群登模组Acsip S78F接入案例,请查看这里。 | 已实现 |
第三方模组适配 | 提供第三方模组通过UART方式,并基于AT指令的适配,详情请查看这里,并提供光宝模组WSL305S接入案例,请查看这里。 | 已实现 | |
退避检测 | 提供发包前信道RSSI检测或CAD检测。 | 暂未实现 | |
网络扩展 | 入网探测 | 基于新华三信道组规划提供终端入网探测功能,详情请查看这里。 | 已实现 |
发包缓存 | 提供网络层发包缓存功能,详情请查看这里。 | 已实现 | |
智能调速 | 根据新华三对LoRa网络的经验,提供智能调速策略控制,详情请查看这里。 | 已实现 | |
ADR开关 | 提供对MAC层ARD功能进行开启和关闭,可以更好的适配用户固定速率和智能调速需求,详情请查看这里。 | 已实现 | |
链路检测 | 提供对LoRaWAN网络链路进行检测。 | 暂未实现 | |
平台扩展 | 保活 | 提供和新华三物联网平台保活功能,详情请查看这里。 | 已实现 |
重启 | 提供在新华三物联网平台对设备进行重启功能,详情请查看这里。 | 已实现 | |
配置 | 提供在新华三物联网平台对设备进行网络扩展控制和平台扩展功能配置,并和平台保持配置同步,详情请查看这里。 | 已实现 | |
升级 | 提供LoRaWAN官方SDK和新华三物联网平台私有升级协议实现。 | 暂未实现 | |
案例 | Class A | 基于新华三LoRaWAN SDK提供class A终端应用案例,详情请查看这里。 | 已实现 |
Class C | 基于新华三LoRaWAN SDK提供class C终端应用案例。 | 暂未实现 | |
光宝模组串口升级 | 提供光宝模组WSL305L 本地xmodem升级固件案例。详情请查看这里。 | 已实现 |
下载
新华三LoRaWAN SDK代码已经开源,并托管在github平台,下载点击这里。 下载最新的代码使用
git clone https://github.com/h3c-iot/oasis-lorawan-demo.git
下载完成后,快速使用参考SDK快速体验。