功耗低、性能好、联网快——基于移芯EC618平台的合宙低功耗4G-Cat.1系列模组,支持标准AT/LuatOS/C-SDK多样化开发方式,可满足用户不同开发需求。其中C-SDK仓库提供给客户自己编译,版本自由度较高,FOTA远程升级应用只需做好版本管理——不仅支持使用自己的服务器,还支持使用合宙IoT云平台来升级模组,为不方便搭建服务器的客户提供免费便捷的服务。
合宙IoT云平台:https://iot.openluat.com/本文分享基于合宙IoT服务器的CSDK FULL-OTA全量升级示例,文末【阅读原文】可获取差分升级、模组文档等最新开发资料。
1
FULL-OTA测试准备
FULL-OTA远程升级是对整包进行升级,在下载到的CSDK仓库内找到 “/project/example_full_ota” ,本教程将以此example为例。
注意:CSDK的原始版本必须为V0002及以上。
GITEE仓库链接:
https://gitee.com/openLuat/luatos-soc-2022
1.1 生成1.0.0版本的binpkg文件:
首先需要先将代码中的 "PROJECT_KEY",更改成自己在合宙IoT云平台上的PROJECT_KEY。
#define PROJECT_VERSION "1.0.1" //使用合宙iot升级的话此字段必须存在,并且强制固定格式为x.x.x, x可以为任意的数字
#define PROJECT_KEY "47pzTpR9bxS04TiMJQ72RVg9tbtmQ8vw" //修改为自己iot上面的PRODUCT_KEY,这里是一个错误的,使用合宙iot升级的话此字段必须存在
#define PROJECT_NAME "example_full_ota" //使用合宙iot升级的话此字段必须存在,可以任意修改,但和升级包的必须一致
打开用合宙IoT服务器升级的代码部分,默认没版本号打印,这里在下面一行加了打印,如下所示:
#if 1
const char remote_domain [ ] = "iot.openluat.com";
const char ota_file_name[200];
char imei[16] = {0};
luat_mobile_get_imei(0, imei, 15);
snprintf_(ota_file_name, 200, "api/site/firmware_upgrade?project_key=%s&imei=%s&device_key=&firmware_name=%s_LuatOS_CSDK_EC618&version=%s", PROJECT_KEY, imei, PROJECT_NAME, PROJECT_VERSION);
#endif
LUAT_DEBUG_PRINT("file name %s", ota_file_name);
然后保存编译,生成1.0.0版本的binpkg文件(可以手动修改文件名作为区分)。
1.2 生成1.0.1版本的binpkg文件:
对代码进行修改,修改完成后build生成1.0.1 binpkg,然后保存编译,生成1.0.1版本的binpkg文件(可以手动修改文件名作为区分)。
2
生成升级包
本节使用合宙LuaTools生成升级包,注意:LuaTools需要2.2.0及以上版本。
2.1 制作升级包:合宙LuaTools下载:
https://wiki.luatos.com/pages/tools.html
运行LuaTools,进入选项及工具->SOC差分/整包升级包制作工具。
在工具窗口的新版固件栏选择要升级的binpkg,然后设置输出路径并填入用户标识(即:固件新版本号),点击开始执行,即可生成对应的升级包。
2.2 更改后缀名:
在本地对应路径中找到生成的.sota升级包文件,将其后缀名更为.bin备用。
3
上传升级包
升级包生成成功后需要上传到服务器中,打开合宙IoT云平台iot.openluat.com并登录:
3.1 点击我的项目-固件列表,然后创建固件:
3.2 创建固件相关设置:
在创建固件窗口,选择上文中后缀改为.bin的升级包,点击上传;系统会自动生成对应固件版本名称和版本号。
3.3 点击确定,固件上传成功:
3.4 添加指定设备imei:
因为升级全部设备一栏选择了【否】,所以接下来需要指定设备,将待升级设备的imei添加即可。
3.5 烧录测试升级:
然后只需要使用烧录工具烧录基础版本(1.0.0)的binpkg:
等待样例通过URL请求升级包的方式测试FOTA升级,升级成功标志除升级接口正确返回外,还可通过升级前后不同的打印内容来辅助判断是否升级成功。
如下显示说明升级成功:
这里做测试的旧版本所打印的version=1.0.0,更新成功到新版本的打印变成了1.0.1。如在升级成功后再次请求同一升级包,由于不匹配会提示升级包校验错误,不予升级。
后台升级日志的查询结果如下:
4
注意事项及技术支持
全量升级操作相对简单,但对文件大小及版本等有一定要求。使用过程中如有疑问,可通过合宙技术服务论坛获得专业解答:
合宙技术服务论坛
chat.openluat.com
FULL-OTA注意事项
文件大小:
生成的ap.bin大小不能超过1984KB,生成的升级包不能超过1472KB。
设置要点:
LuaTools需要2.2.0及以上版本;进入选项及工具—SOC差分/整包升级包制作工具,新版固件选择要升级的binpkg,用户标识可以填版本号,也可以不填,看自己的代码对升级版本是否有控制。如果用合宙IOT升级服务,则必须填写版本号!
选好输出路径,点生成,在输出目录下生成相应的xxx.sota文件为升级包,更新后缀为.bin上传至服务器即可升级。
流量消耗:
升级一次流量1MB~1.5MB之间,注意流量消耗。
版本要求:
CSDK的原始版本必须是V0002及以上,V0001升级到V0002也不行,因为涉及到了bootloader修改。
最新资料:
通过air780e.cn或文末【阅读原文】链接,获取模组最新开发资料。
感谢新老朋友们的关注与支持
合宙与你共同成长
更多超值新品筹备中
- 合宙技术交流QQ群 -
- 合宙技术交流微信群 -
加合宙客服报企业名称入群
全部0条评论
快来发表一下你的评论吧 !