本文介绍腾讯云联名LoRaWAN评估板的详细使用教程，包括硬件配置、软件开发、数据解析及功能测试等内容。通过实际案例演示如何快速实现物联网项目的搭建。
点击上方【腾讯云IoT】，关注我们并设星标
共建物联网产业生态
腾讯云联名(意法半导体、瑞兴恒方、深圳智芯云)的TSC_WL_EVK LoRaWAN评估板发布后，很多小伙伴已经拿到了此次联合发布的评估板并成功接入了腾讯云物联网开发平台IoT Explorer。关于上传真实的现场温湿度，下面以智芯云基于意法半导体的HTS221温湿度传感器的E53扩展板为例，从开箱到接入进行完整操作演示，悄咪咪地告诉你此次还增加了下传数据控制灯开关和调节亮度功能测试演示。
现在就来手把手的教大家如何接入以及进行最基本的功能开发。
在开始之前，先说明一下此实例中的一些项目配置和软件安装参考了Github上的TencentOS Tiny定制开发板EVB_WL快速入门指南文档https://github.com/Tencent/TencentOS-tiny/blob/master/doc/26.TencentOS_tiny_EVB_WL_Quick_Start.md此实例中提供的工程和软件包仅用于帮助使用者尽快上手，最终版本更新以TencentOS Tiny团队在Github或者相近代码库中的更新为准哦。
接下来我们分两个步骤进行一个最基本的功能开发：
一、检查评估板可用性，下载对应工程文件进行基本配置。二、在腾讯云物联网开发平台IoT Explorer上新建项目并进行配置。一、检查评估板可用性，下载对应工程文件进行基本配置
1. 检查评估板可用性大家收到的评估板包含了TSC_WL_EVK板子x1、micro USB数据线x1、2.54mm间距40p排针x1、470~510MHz SMA LoRa天线x1、PCB隔离座x4，如下图所示。开发者需要自行准备的工具包含ST-LINK或J-LINK调试器x1，连接板子的杜邦线x4，调试用的电脑x1 (安装MDK-KEIL开发工具，建议5.26以上版本)。
选配了E53温湿度传感器扩展板才会有真实数据哦。扩展板插入到主板的E53接口就行了(注意方向)。
首先我们需要给板子焊上几个排针(最少需要焊接SWD口的5口排针)，如下图所示：
连接ST-LINK到评估板上(如果调试器有3.3V供电接口，那可以先不接Micro USB线)，如下图：
连接ST-LINK到电脑的USB接口上，检查供电是否正常，如下图：
2. 评估板对应的原理图
3. 评估板对应的接口示意图
4. 下载评估板对应的工程文件 从https://gitee.com/SmartChipCloud/loranode开源代码仓库中下载工程包。5. 安装KEIL器件库包在安装有MDK-KEIL的电脑上将上面下载的STM32WLxx系列的器件库包(Keil.STM32WLxx_DFP.1.0.2_OEM.pack)安装到KEIL中。
6. 检查评估板是否上锁在ST官网下载并安装stm32cubeprog，使用ST-LINK连接评估板的SWD接口，注意杜邦线保持可靠连接，且stm32cubeprog目前只支持ST-LINK。接好后打开stm32cubeprogammer并点击右上角的Connect连接按钮，注意右下角的连接器件的状态和下方提示，如果下方没有提示Data read failed, 可以直接跳到第7进行项目配置。
点击选择左侧的OB图标按钮，并按图中的流程进行解锁：
成功后点击Disconnect断开连接：
7. 硬件SWD接口连接检查下载并解压缩工程包以后，在 \board\RHF0M0E5_STM32WLE5xx\KEIL\lorawan目录下用KEIL打开TencentOS_Tiny.uvprojx项目工程文件(下载的工程包解压缩后保存在硬盘的位置上最好不要有中文目录)。
打开工程后，点击Option按钮打开项目选项窗口，选择调试器为ST-Link(或者J-link)，然后点击其右侧的Settings按钮。
取消勾选Check version on startup避免每次打开自动检查ST-LINK的版本，然后在Target Com下方的Port选项中选择SW模式，点击确定返回项目选项窗口后，重新点击ST-Link Debugger右侧的Settings进入查看，此时右侧的SW Device列表下面应该会出现一个SWD设备编号，如下图所示。这时，硬件已经完全检查完毕。
8. 实例工程配置在KEIL项目工程窗口中选择打开APP目录下的Commissioning.h文件，修改框选的两种长度的KEY为自己定义的密钥，一个长度为32bytes，一个长度为16bytes，长度相同的Key应设置为相同值。如下图：
设置好以后点击KEIL的Build按钮，看看下方状态栏是否有提示错误信息。
如果没有编译错误，此时可以点击下载烧录按钮将编译好的固件烧录到TSC_WL_EVK评估板上。
二、在腾讯云物联网开发平台上新建项目并进行配置
在腾讯云上注册一个开发账号，并在物联网开发平台上新建一个项目。腾讯云登录界面如下：
物联网开发平台网址(https://console.cloud.tencent.com/iotexplorer)及新建项目连接如下图：
1. 产品开发点击新建项目按钮后，输入项目名称和描述，并点击保存。
保存后，点击项目列表中的产品框，进入产品开发界面。
在产品开发界面下，点击新建产品按钮。
输入产品名称信息，选择“设备”，“密钥认证”，“LoRaWAN”通信方式，“自定义透传”数据协议，然后点击保存。
保存后，点击打开刚才新建的产品。
在数据模板页面下，点击导入JSON模板，复制并粘贴以下预先准备好的参考代码，并点击导入。
{ "version": "1.0", "profile": { "ProductId": "4TLSPG4R3C", "CategoryId": "1" }, "properties": [ { "id": "humidity", "name": "湿度", "desc": "", "mode": "r", "define": { "type": "int", "min": "0", "max": "100", "start": "0", "step": "1", "unit": "%" }, "required": false }, { "id": "temperature", "name": "温度", "desc": "", "mode": "r", "define": { "type": "int", "min": "-100", "max": "155", "start": "0", "step": "1", "unit": "摄氏度" }, "required": false }, { "id": "PowerSwitch", "name": "开关", "desc": "开关", "mode": "rw", "define": { "type": "bool", "mapping": { "0": "关", "1": "开" } }, "required": false }, { "id": "BrightNess", "name": "亮度", "desc": "亮度", "mode": "rw", "define": { "type": "int", "min": "10", "max": "100", "start": "80", "step": "10", "unit": "%" }, "required": false }, { "id": "period", "name": "上报周期", "desc": "", "mode": "rw", "define": { "type": "int", "min": "5", "max": "20", "start": "10", "step": "1", "unit": "秒" }, "required": false } ], "events": [], "actions": []}
导入完成后，如下图所示。(也可以自己通过新建功能方式替代导入)点击下一步按钮。
LoRaWAN设备的特性不适合进行JSON数据的传输，在设备开发标签中，可以进行设备的原始数据解析(原始数据和JSON数据格式转换)功能配置并测试。
可以参考下图的参数进行数据解析的调试，把参考代码拷贝分别拷贝到上行数据解析和下行数据解析的输入框中，在下方模拟调试窗口中可以手工输入数据并点击运行看解析结果是否正确。设备上行数据模拟调试结果如下图：
上行数据解析参考代码function RawToProtocol(fPort, bytes) { var data = { "method": "report", "clientToken" : new Date(), "params" : {} }; data.params.temperature = bytes[0]; data.params.humidity = bytes[1]; data.params.period = bytes[2]; data.params.PowerSwitch = bytes[3]; data.params.BrightNess = bytes[4]; return data;}温度，湿度为只读数据，正常不会出现在下发数据包里。
LoRaWAN协议中的FPort，Mode我们固定为2和0，小伙伴们可以自行修改，注意设备固件进行相应的修改。
增加DATA[5]数据，bit0,1,2用于标记下行数据的有效性。因为物联网开发平台是把所有数据全部发送，而腾讯连连小程序只发送修改过的数据。
下行数据解析参考代码function ProtocolToRaw(obj) { var data = new Array(); data[0] = 2;// fport=2 data[1] = 0;// unconfirmed mode data[2] = obj.params.period; data[3]= (obj.params.PowerSwitch); data[4]= (obj.params.BrightNess); data[5]=0; if (obj.params.hasOwnProperty("period")) data[5]+= 1; if (obj.params.hasOwnProperty("PowerSwitch")) data[5]+= 2; if (obj.params.hasOwnProperty("BrightNess")) data[5]+= 4; return data;}
调试完毕后点击提交按钮进入下一步交互开发页面。
此处可以进行一些交互开发中的配置，例如自定义产品图片中可以修改设备在后续腾讯连连界面下显示的设备图片等。
在交互开发的面板编辑界面，可以对设备在腾讯连连中的一些UI进行设置和调整，如下图：
点击下一步可以进入设备调试的界面。
我们在这里点击新建设备按钮添加刚才我们编译好的评估板对应的产品，在弹出的窗口中输入设备名称，DevEUI和AppKey。此处DevEUI为刚才在KEIL工程中输入的16bytes设备编号，AppKey为输入的32bytes的设备密钥。本截图的示意DevEUI和AppKey仅为演示用途。
点击保存后，在设备列表中会出现刚才新建的设备名称，如下图：
点击设备名称右方的调试按钮，可以进入在线调试的界面，如下图：
此时给刚才下载烧录好固件的TSC_WL_EVK评估板通电，等待片刻，可以在设备在线调试右侧的窗口中看到板子上传上来的数据，如下图：
如果是通过micro USB线缆连接到TSC_WL_EVK评估板上，并安装了CH340 USB转串口的驱动程序，可以在电脑的串口通信助手中看到板子打印出来的调试信息，如下图如果显示end node joined，则表示入网成功啦！
2. 数据开发现在我们可以在数据开发界面新建一个数据流控制逻辑，进行一个模拟高温高湿报警的设定。点击物联网开发平台页面左侧的数据开发菜单，点击右方的新建数据流。
输入数据流名称，如下图：
在数据流编辑界面，我们拖入设备数据、数据过滤和公众号推送三个流程框并将他们连接起来，如下图：
点击设备数据按钮，在右侧进行设备数据的设置，选中设备的温度信息，如下图：
点击数据过滤按钮，在右侧进行数据过滤的设置，这里我们选择温度大等于50摄氏度的条件，然后点击确定：
点击公众号推送按钮，在右侧输入推送的标题和内容，还可以把报警时实时的温度信息输入进去，并点击确定，如下图：
条件都设定好以后，我们点击界面上的启用按钮启动报警功能。
还可以自己增加湿度报警，推送APP等等。
返回到产品开发的设备调试界面，点击刚才创建的设备的二维码，如下图：
用微信搜索并打开腾讯连连的小程序，在腾讯连连的小程序中扫描弹出的二维码并进行绑定，如下图：
绑定设备成功后会在腾讯连连小程序中看到我们建立的设备，如下图(P.S新版腾讯连连UI升级后，更好看实用了~)：
点击设备名称，我们可以进去查看设备实时更新的数据状态，如下图：
3. 高温高湿报警、开关、亮度测试在没有E53温湿度传感器扩展板的时候，我们是在设备固件中模拟温度湿度变化。现在可以测试真实数据，还可以给传感器扩展板加热加湿来触发报警消息，也可以在数据开发中把报警温度设置成容易触发的数值。 开关和亮度可以直接在腾讯连连里测试。需要注意只有等到设备发送下一个上报数据时，开关和亮度设置才会下传给设备，有兴趣的小伙伴可以尝试把设备修改成Class C来增强实时性。
4. LoRa网关管理是不是以为有评估板就能直接接入腾讯云了？想多了，哪有什么岁月静好(直接接入)，其实是有人负重前行(腾讯社区网络)。控制台里点击网络管理->LoRa网关管理，腾讯已经在深圳部署了很多免费LoRa网关，全覆盖，在深圳的小伙伴可又享受一波福利了。
暂时没有覆盖到的区域可以自己添加，也为社区网络做出贡献，利人利己。添加步骤也简单，如下三步：第一步当然是自己准备好LoRa网关，市场上有很多商用的。如果想更迅速的接入腾讯物联网，可以采用腾讯云合作伙伴开发的低成本单通道网关，已经设置好接入腾讯云的参数。只用上电把WiFi连上就可以了。
第二步硬件准备好后，在控制台：点击添加网关，输入一下参数。名称：自定义GwEUI: 建议的方式是在网关MAC地址中间添加“FFFF”以保证唯一性。是否公开：这个嘛，随意~其他信息尽量准确。
第三步稍等片刻，就能看到网关由离线变为在线了。
简单总结一下：LoRaWAN节点设备需要网关才能接入腾讯云，腾讯社区LoRa网关给大家提供了便利，专注于设备开发。
LoRaWAN设备不适合采用物联网平台常用的MQTT协议进行JSON数据传输，腾讯物联网开发平台提供原始数据和JSON数据格式转换的方式来帮助LoRaWAN设备更方便的接入物联网平台。
LoRaWAN ClassA设备实时性相对弱，适合对实时性要求不高但对功耗要求苛刻的应用场景。
STM32WL SoC使用TecentOS Tiny，内置LoRaWAN协议栈，极大程度的方便的设备开发。
持续关注腾讯云IoT可获更多干货内容！▲
腾讯云联名评估板已上架到合作伙伴智芯云微信小商店网关板和E53传感器板不日上架指导文档：[1] 腾讯云物联网开发平台IoT Explorer：
https://cloud.tencent.com/product/iotexplorer
[2] TencentOS Tiny：
https://github.com/Tencent/TencentOS-tiny
[3] TencentOS Tiny定制开发板EVB_WL快速入门指南文档：
https://github.com/Tencent/TencentOS-tiny/blob/master/doc/26.TencentOS_tiny_EVB_WL_Quick_Start.md
[4] 开源代码仓库中下载工程包网址：
https://gitee.com/SmartChipCloud/loranode
//////////
▲加IoT小助手微信进腾讯连连官方合作群(请备注腾讯连连)ღ项目合作，可关注此公众号，在菜单栏点击「联系我们」获取合作联系方式！往期推荐
官方标准蓝牙协议LLSync发布，BLE接入&Wi-Fi配网更快人一步！腾讯云物联网平台重磅升级：聚合内部能力，辅助更多产业通用版、代码开源和应用SDK三大版本齐亮相，腾讯云发布腾讯连连App服务全新腾讯云物联网市场重磅升级！腾讯云率先布局全链路5G产品矩阵，助推“万物智联”腾讯云物联网助力微信支付收款音箱，日均消息吞吐量达十亿级腾讯云物联网开发平台新功能重磅上线，全面助力5G应用！它来了、它来了……微信支付带着腾讯云IoT来了腾讯连连重构消费物联新生态国内首批可信物联网云平台认证公布，腾讯云上榜还可以通过视频号了解最新动态☟
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
