一、简述
麒麟座开发板代码例程由OneNET-基础例程、OneNET-进阶例程、OneNET-RTOS例程组成,由浅入深地演示如何接入OneNET,从最基本的上传数据点,命令接收处理,到网络维持,平台连接维持,到最后的网络错误处理,一步一步演示如何处理这些事情。
【资料图】
下面先以OneNET-基础例程为例,讲解如何接入OneNET。
二、OneNET-基础例程模块分析
1. 代码框架说明
初始化开发板外围硬件;如LED、蜂鸣器、按键等。
初始化网络模组;开发板板载GSM模组-M6312,可插拔的WIFI-ESP8266-01模组。
登录OneNET。
执行相关上下行数据处理。
2. 代码功能简述
演示如何接入OneNET,如何处理OneNET推送的数据。
不具备网络维持能力,掉网后无法处理。
3. 初始化开发板外围硬件-Hardware_Init()函数
根据不同功能所需要用到的外围硬件不同,可根据自己使用的例程查看相应的硬件驱动代码,这里以为例说明
麒麟座使用的STM32F103RET6单片机,mini板使用STM32F103C8T6单片机,都是F1系列,编程方式完全一致。
先配置单片机的中断分组,采用2:2配置;
然后初始化systick用来做阻塞延时;
然后初始化串口1和串口2,串口1用来调试打印,串口2和网络模组通信;
然后就是初始化LED,蜂鸣器,按键,主要就是GPIO的配置;
最后打印一下,提示硬件初始化完成。
4. 初始化网络模组-ESP8266_Init()函数
WIFI模组的初始化比较简单:
先初始化相关控制的GPIO。
然后先发送AT,测试通信是否OK。
然后就是设置WIFI工作模式、登录路由、连接IP。
如果是GSM模组,前两步相同,初始化控制GPIO、发送AT测试通信。然后是注册、激活网络、连接IP。
5.登录OneNET -OneNet_DevLink()函数
主要流程就是获取登录数据,然后发送出去,等待返回。
获取登录数据:
EDP_PacketConnect1(DEVID, APIKEY,256, &edpPacket)
根据devid和apikey通过sdk生成登录数据,保存在edpPacket里边。
发送:
ESP8266_SendData(edpPacket._data,edpPacket._len);
指明要发送的数据和长度即可,调用此函数就会发送到OneNET接入机。
等待结果
ESP8266_GetIPD(250):从硬件层判断时间是否收到
EDP_UnPacketRecv(dataPtr) ==CONNRESP:
EDP_UnPacketConnectRsp(dataPtr):
从软件层解析是否接入成功。
6. 执行相关上下行数据处理
上行数据
执行OneNet_SendData()函数,会调用相关上传功能。
166行,是封装一个json,把要上传的内容写在里边
170行,根据devid、json格式和json封装协议包
175行,将协议包上传。
简单看看166行的内容
其中led_status.xxx,就是我们要上传的数据,按照json格式写好即可,如果新增数据点,复制高亮三行的任意一行加以扩展,然后把箭头的buf缓存开大一点即可。
下行数据
先判断驱动层是否收到数据,有则调用OneNet_Re**taPtr)函数解析相关功能。
判断是否是下发命令,是则回复这个命令,然后做相关命令的处理
三、OneNET-RTOS例程模块分析
1. 代码框架说明
初始化开发板外围硬件;如LED、蜂鸣器、按键等。
初始化网络模组;开发板板载GSM模组-M6312,可插拔的WIFI-ESP8266-01模组。
登录OneNET。
执行相关上下行数据处理。
网络维持,网络监测、错误处理。
2.代码功能简述
完整的开发板功能体验,所有传感器数据均上传,并包含一些监测类变量;完备的网络维持、监测、错误处理机制。
后文以与OneNET通讯、网络监测、错误处理为重点进行分析。
3.初始化开发板外围硬件-Hardware_Init()函数--main.c
基本流程和基础例程类似,初始化板载硬件,单片机片内外设等。
这里多了一个功能,将登陆的devid和apikey保存在eeprom里边,可以通过串口1按照资料中的格式进行更改而无需重新下载代码。
4.初始化网络模组- NET_DEVICE_Init ()函数--net_task.c
这个函数不连接具体的ip,仅仅只是让网络模组具备网络接入能力即可。
5. 登录OneNET- -net_task.c
OneNET_GetLinkIP:获取该协议当前资源最优的接入ip和port。
OneNET_ConnectIP:连接ip和port。
OneNET_DevLink:根据devid和apikey 或者 proid和auth_info登录OneNET设备。
6.执行相关上下行数据处理--net_task.c
上行数据
在net_task.c-- NET_**_Task任务里,红框处,是定时上传的内容,这个任务以50ms周期执行一次,当累计300次-约15s时,可自行更改,触发一次上传数据的标志,箭头所指处。
然后在net_task.c--DATA_P_Task任务里判断到标志置位,执行OneNET_SendData(…)函数根据当前的data_stream值去打包一个待上传的数据包,但此时并不上传,而是放入一个单向链表里,原因稍后分析,如果上传成功,则返回值会改变onenet_info.send_data的值,如果错误,则会间隔一段时间后继续回来打包数据。
最终将数据发送出去的的是net_task.c--DATA_S_Task任务判断表头是否为空,且网络连接正常,然后获取表里数据和对应长度,吧数据发往OneNET。
简单说一下,为什么上传一包数据,分了三个步骤(触发、打包、发送),因为这样可以在其他地方方便地上传数据,只需要改变一个变量值即可,而不用调用复杂的打包、发送函数,对函数堆栈要求降低很多;然后发送作为一个单独的任务是为了网络模组稳定性,wifi和gsm发送数据的时间间隔不同,wifi可以快一点,当短时间内有很多包大小不同的数据包待上传时,发送必须要稳定,所以OneNET_SendData(…)只是打包放入链表,发送函数以一个稳定的时间间隔来一包包的发出去。
下行数据
在net_task.c-- RECV_Task任务里边,只有一个函数OneNET_CmdHandle
先是调用NET_DEVICE_Read()函数判断驱动层是否收到数据。
然后调用NET_DEVICE_GetIPD(dataPtr)判断是否具有IPD头,这里说明一下,在绝大多数网络模组里,在指令模式下,如果收到一帧网络数据,则会以IPD标识(不同网络模组这个头可能不一样),如果带有IPD头,则说明收到OneNET推来的数据,进入OneNET_RevPro(ipdPtr)函数进行处理。
处理函数里边先通过EDP_UnPacketRecv(cmd)判断推送数据的类型,以EDP为例,有连接响应、命令下发、数据转发、心跳回复等,然后各自处理即可。
最后具体说说命令下发的处理机制。
先调用EDP_UnPacketCmd(…)函数解析出uuid、uudi长度、命令、命令长度。
然后是调用EDP_PacketCmdResp(…)函数打包命令回复的内容。
然后是调用CALLBACK_Execute(...)函数处理命令,在cmd_callback.c里边可以找到处理的过程
调用CALLBACK_Find_CallBack(…)找到红框处XXX的内容,这是是命令体,后边YYY是命令值,后边会用到
然后根据命令体对应的回调函数,执行响应的动作,比如redled,
调用CALLBACK_Find_Value(…)函数找到命令参数YYY
调用CALLBACK_Str2Dec(…)函数转为数值形式,方便执行开关处理。
大家在添加自己的命令和处理内容的时候添加两个地方
命令体和命令回调对应表
然后编写命令回调函数即可。
继续回到下行数据处理上来,处理完命令之后,就是释放相关内存,然后调用NET_DEVICE_AddDataSendList(…)函数吧命令回复的内容加入链表,最后置位一下onenet_info.send_data上传一次数据,以更新OneNET设备上的数据。
7. 网络维持—net_task.c
在NET_**_Task任务里边,和数据上传一样的流程,定时发送心跳,然后等待心跳返回正确的结果,以此判断网络是否通畅
同样的,在DATA_P_Task任务里边调用OneNET_SendData_Heart()函数打包心跳数据并清除心跳标志,在DATA_S_Task任务里真正发送出去,在OneNET_RevPro()函数里边解析心跳数据,收到则置位心跳标志,然后在OneNET_Check_Heart()来检测心跳标志。
如果在规定时间内检测不到心跳标志,则会检测当前模组状态,根据状态分配错误等级,然后会进入相关错误处理。
8. 网络监测、错误处理
7中说到,心跳标志检测不到,会进入错误处理,先看看错误等级处理都干了什么:
fault.c--NET_Fault_Process
将相关标志位清零,在任务里边检查到标志位变化,会执行对应功能,错误等级为1,只是负责重新连接一下ip。
错误等级2就是走初始化流程,去重新初始化一下网络模组了。
错误等级3是复位网络模组。
错误等级4是给网络模组断电后,等待一会,再打开。
那么错误等级如何确定,下面一一截图说明
NET_FAULT_LEVEL_1的场景:
net_task.c--OS_TimerCallBack
在网络定时检测回调里,发送数据未得到回应次数超过规定次数时。
onenet.c--OneNET_CmdHandle
当收到网络模组返回的连接关闭提示时。
onenet.c-- OneNET_Check_Heart
心跳标志接收超时,且网络模组具备网络能力时。
NET_FAULT_LEVEL_3的场景:
错误2和3通畅搭配使用,在重新初始化之前,先复位一下。
net_task.c--OS_TimerCallBack
当网络断开超过规定时间时。
onenet.c-- OneNET_Check_Heart
心跳标志接收超时,且网络模组不具备网络能力时。
fault.c
在错误等级1下,在规定次数内还未连接成功时。
可以看到,在例程里边有很多地方都在保障网络的通畅性,一旦发生网络错误,则会根据响应状态制定错误处理,争取用最高效的方式重新接入OneNET。
标签:
上一篇 : 选择大城市逐梦还是小城市安稳
下一篇 : 最后一页
3月16日,盛和资源(600392)副总经理毛韶春、黄厚兵,财务总监夏兰田,董秘郭晓雷,通过上交所集中竞价交...
2022年3月15日,这是继1983年以来的第40个国际消费者权益日。中消协组织围绕共促消费公平消费维权年主题...
首批金控牌照的归属出炉,两家公司拿到许可证。3月17日,央行发布公告称,已批准中国中信金融控股有限公...
时隔半月之久,西宁市城北区逐步推动复工复产,往日的生机活力被渐渐寻回,牛肉面红油飘香、包子铺炊烟...
音乐是我生活的一部分,是我的梦想,也是我的事业。英国音乐人亚当(Adam)告诉记者,在中国的十几年里,...
Copyright © 2015-2022 时代舞蹈网版权所有 备案号: 联系邮箱: 514 676 113@qq.com