README.md 5.8 KB

功能模块介绍

iot服务器fota功能演示

1、main.lua:主程序入口;

2、netdrv_device.lua:网卡驱动设备,可以配置使用netdrv文件夹内的四种网卡(单4g网卡,单wifi网卡,单spi以太网卡,多网卡)中的任何一种网卡;

3、update.lua:使用合宙iot服务器进行远程升级功能模块,简单升级演示;

4、tcp_iot文件夹:通过tcp服务器下发升级指令(指令格式使用json字符串,包含是否升级参数),控制设备启动air_srv_fota功能模块,使用合宙iot服务器进行升级;

5、air_srv_fota.lua:合宙服务器升级功能模块;

6、psm_power_fota.lua:低功耗fota功能模块,此场景是针对psm状态下升级没完成就进入休眠导致升级失败的情况写的一个例子。需要注意的是此场景与上面两种场景不能同时使用;

系统消息介绍

1、"IP_READY":某种网卡已经获取到ip信息,仅仅获取到了ip信息,能否和外网连通还不确认;

2、"IP_LOSE":某种网卡已经掉网;

用户消息介绍

1、"RECV_DATA_FROM_SERVER":socket client收到服务器下发的数据后,通过此消息发布出去,给其他应用模块处理;

2、"SEND_DATA_REQ":其他应用模块发布此消息,通知socket client发送数据给服务器;

演示功能概述

1、此demo演示了三种场景:

(1) fota升级简单演示:使用合宙iot服务器进行远程升级功能模块,简单升级演示;

(2) tcp服务器下发升级指令:通过tcp服务器下发升级指令(指令格式使用json字符串,包含是否升级参数),控制设备使用fota功能模块;

(3) psm低功耗fota:低功耗fota功能模块,此场景是针对psm状态下升级没完成就进入休眠导致升级失败的情况写的一个例子;

2、netdrv_device:配置连接外网使用的网卡,目前支持以下四种选择(四选一)

(1) netdrv_4g:4G网卡

(2) netdrv_wifi:WIFI STA网卡

(3) netdrv_eth_spi:通过SPI外挂CH390H芯片的以太网卡

(4) netdrv_multiple:支持以上三种网卡,可以配置三种网卡的优先级

演示硬件环境

1、Air780EPM V1.3版本开发板一块+可上网的sim卡一张+4g天线一根+网线一根:

  • sim卡插入开发板的sim卡槽

  • 天线装到开发板上

  • 网线一端插入开发板网口,另外一端连接可以上外网的路由器网口

2、TYPE-C USB数据线一根 + USB转串口数据线一根,Air780EPM V1.3版本开发板和数据线的硬件接线方式为:

  • Air780EPM V1.3版本开发板通过TYPE-C USB口供电;(外部供电/USB供电 拨动开关 拨到 USB供电一端)

  • TYPE-C USB数据线直接插到核心板的TYPE-C USB座子,另外一端连接电脑USB口;

演示软件环境

1、Luatools下载调试工具

2、Air780EPM V2012版本固件)

3、PC端浏览器访问合宙TCP/UDP web测试工具

演示核心步骤

1、搭建好硬件环境

2、PC端浏览器访问合宙TCP/UDP web测试工具,点击 打开TCP 按钮,会创建一个TCP server,将server的地址和端口赋值给tcp_iot_main.lua中的SERVER_ADDR和SERVER_PORT两个变量

4、demo脚本代码netdrv_device.lua中,按照自己的网卡需求启用对应的Lua文件

  • 如果需要单4G网卡,打开require "netdrv_4g",其余注释掉

  • 如果需要单WIFI STA网卡,打开require "netdrv_wifi",其余注释掉;同时netdrv_wifi.lua中的wlan.connect("茶室-降功耗,找合宙!", "Air123456", 1),前两个参数,修改为自己测试时wifi热点的名称和密码;注意:仅支持2.4G的wifi,不支持5G的wifi

  • 如果需要以太网卡,打开require "netdrv_eth_spi",其余注释掉

  • 如果需要多网卡,打开require "netdrv_multiple",其余注释掉;同时netdrv_multiple.lua中的ssid = "茶室-降功耗,找合宙!", password = "Air123456", 修改为自己测试时wifi热点的名称和密码;注意:仅支持2.4G的wifi,不支持5G的wifi

5、Luatools烧录内核固件和修改后的demo脚本代码

6、使用Luatools制作升级包,先把新旧版本分别生成量产文件,然后再制作升级包,工具上栏 luatOS->固件工具->差分包/整包升级包制作,将制作好的升级包配置到合宙iot服务器自己项目下,或上传到自建服务器上面;

7、烧录成功后,自动开机运行

8、可以看到升级过程如下,不管是什么场景下升级,基本都是如下日志情况:

--没有升级之前可以看到如下打印
I/user.fota 脚本版本号 001.000.000 core版本号 V2010

I/user.fota_task_func recv IP_READY 1
I/user.开始检查升级

I/user.升级包下载成功,重启模块


--升级之后可以看到如下打印
I/user.fota 脚本版本号 001.000.001 core版本号 V2012
--升级重启之后还是会检查升级,所以会有如下打印属于正常情况,其中"code": 27 是合宙iot服务器返回的状态码,意思是已经是最新版本了。
I/user.fota -9 {"code": 27, "msg": "\u5df2\u662f\u6700\u65b0\u7248\u672c"}
I/user.使用合宙服务器,接下来解析body里的code
I/user.已是最新版本 1.设备的固件/脚本版本高于或等于云平台上的版本号 2.用户项目升级配置中未添加该设备 3.云平台升级配置中,是否升级配置为否
I/user.fota 4


9、对于psm休眠状态下的升级的场景,可以通过iot平台查看是否成功,在iot平台的升级日志页面搜索模组的imei,可以看到有两条升级结果“成功”和“已是最新版本”。模组升级成功后会自动进入psm休眠状态。可以通过电流查看休眠情况。