合宙Air724UG二次开发(2)：资料描述

文章目录

合宙Air724UG二次开发(2)：资料描述
- 1. 系统环境
- 2. 嵌入式4G发展现状
- 3. Air724UG二次开发资料下载
- - 3.1 固件和上层包
  - 3.2 阅读开发板使用指南和下载驱动
  - 3.3 安装编辑器
  - 3.4 安装下载开发工具
- 4 Air724UG其他资料学习
- - 4.1 Lua语法学习
  - 4.2 LuatOS-Air框架学习
  - 4.3 LuatOS-Air模块应用手册

1. 系统环境

系统：win10
使用板卡：EVB_Air724UG_A13
开发语言：类似LUA的Luat语言
本文编辑时间：20220422

说明：本文只是对合宙Air724UG二次开发(1)：开发环境的搭建的补充，这篇文章详细的介绍了这些资源在整个开发中的作用。

2. 嵌入式4G发展现状

随着2G网络逐渐退出市场，现在开发移动网络通信只能选4G网络模块。
常见的移动网络通信的方式有：

MCU利用串口+AT网络模块实现移动网络开发。优缺点：MCU+AT开发周期短，但是相对pcb设计面积、硬件成本、运行功耗都比较大。
ARM(支持USB HOME)+USB接口网络模块。优缺点：4G速度可以较快传输，4G模块一般都采用Mini PCIE接口，具有较好的通用性，但是要求ARM处理器带USB HOME功能，程序编写比较复杂，这种接口4G模块比较贵。
直接在网络模块上二次开发。优缺点：最省硬件成本，功耗和pcb体积也最小，但是由于移动网络通信芯片厂商不是主流MCU厂商，这导致二次开发往往需要学习新的语言和开发方式，开发周期较长，开发出来的产品，需要较长时间的测试，提防出现bug。

对于支持AT的网络模块，现在可选择的型号非常多，基本除了最基本的命令外，每家的AT标准个不相同，需要对照相应的手册去开发。

USB网络模块，大部分都会选择Mini PCIE接口，通过MCU的USB HOME功能，来实现数据较快传输。

二次开发需借助芯片官方的固件，截止到20220422现在当属合宙和移远两家最为火爆。合宙使用类似LUA语言的开发方式，移远使用类似MicroPython语言的方式开发，都需要学习成本，但学习后会发现，使用这类方法开发非常快和容易。

我相信随着时间的发展，嵌入式4G领域会发展的越来越好，可能会出现更好的选择和更友好的开发方式。

本文介绍使用合宙Air724UG利用LUA语言二次开发的方式。我购买的是EVB_Air724UG_A13板卡，为了演示方便，我直接上我购买的连接和图：

某宝链接和板卡图：

3. Air724UG二次开发资料下载

合宙官网有着较为详细的讲解，但是因为软件更新或者板卡型号众多，资料在有的地方叙述的有点乱。下面我们详细介绍这些资料怎样用：

官方链接：https://www.openluat.com/product_center/product_detail?id=12

讲述的内容包括：

产品特性：包括供电、温度、支持频段、接口特性、开发方式等简单介绍；
技术文档：一些获得认证的证书、规格书、开发板使用说明、固件下载链接等；通过这些就可以进入其他页面，下载固件等工具；
相关产品：就是比较几款合宙产品，然后列出每款的优缺点，让你有个比较；
相关下载：开发板的参考设计、原理图、BOM，还有pc端usb驱动；

下面详细叙述所需要的资料和步骤。

3.1 固件和上层包

点击上面那个技术文档 ---> xx系列_luat二次开发固件 --->点击阅览就会进入另一个链接，

也有可能不是一个跟你板子配套的使用指南，对于我的EVB_Air724UG_A13开发板，可以进入另外链接；这个链接主要包含两部分：

底层core固件包：这个是必须下载的，这个分很多版本，版本的区别是对外设支持情况有差异，不同版本件有对比，而且这个还支持在线免费定制，来达到最小占用空间。这个包的主要作用，是为上层脚本提供底层驱动，因此在开发前，要用工具烧录到开发板中。
Luat上层脚本包：这个是必须下载的，提供二次开发的一些模板，外设调用demo，还有库文件。在学习外设使用的时候要学demo，当自己写程序的时候，要引用这里面的库才能正常使用功能。
固件和上层包更新说明：因为固件和上层包还存在一些bug，因此官方会定期更新这些固件和上层包，在使用的时候，最好看一下这些更新的日志，提防用户编写程序的时候，由于系统bug导致错误。

点击上面那个技术文档 ---> xx系列_AT固件 --->点击阅览就会进入另一个AT开发相关的界面，这不是本文重点，因此不介绍。

3.2 阅读开发板使用指南和下载驱动

点击上面那个技术文档 ---> xx系列开发板使用说明 --->点击阅览就会进入另一个链接，这个链接下的板子可能比较老

也有可能不是一个跟你板子配套的使用指南，对于我的EVB_Air724UG_A13开发板，需要进入另外链接；

这个链接主要包含介绍了开发板的每个部分硬件的功能描述，开发板使用方法，驱动下载，安装编程环境，下载固件的方式，原理图和设计参考。

在这里我们需要仔细阅读开发板使用方法，引脚图，然后下载驱动，安装驱动，看设备管理器出现是否和文档描述一致，确保驱动安装正确。

这一步很重要，若搞不明白，到后面连固件和程序怎么下载都搞不定。同时也有一些资源包，可以看看。

至于安装编译环境和下载固件方法，这里只有下载链接，说的也很笼统，后面会有更详细的链接讲解，这里就不用管了。

3.3 安装编辑器

lua编程软件建议vscode，附带安装教程，包括vscode安装和lua插件安装；

注意：vscode为Lua脚本编辑工具，仅仅具有脚本代码编辑功能，没有编译功能；
Lua为解释性语言，在LuatOS-Air开发方式下，开发调试过程如下：

使用vscode编写Lua脚本
使用Luatools烧录Lua脚本
使用Luatools输出脚本运行日志

3.4 安装下载开发工具

官方提供了两种方式：

LuatIDE方式：这种方式是官方推荐方式，LuatIDE是vscode的一个插件，安装方式链接；
Luat下载调试工具v2方式：官方不推荐方式，Luatools工具下载链接；

到此，所有的资料就下载完了。

4 Air724UG其他资料学习

4.1 Lua语法学习

当你按照下载教程完成固件和demo下载并正常运行后，你肯定后面就需要编写自己的程序了， LuatOS-Air是基于lua 5.1编程语言开发的通信架构，因此不管你会不会lua语言开发，都需要学习。
好在lua语言简单易用，而Luat遵从了lua语言的语法规则；
Lua语法学习有多种途径：

LUA的菜鸟教程

合宙社区Lua语法介绍

合宙社区Luat入门教程

4.2 LuatOS-Air框架学习

LuatOS-Air = Lua + AT，LuatOS-Air推出的物联网开源架构，依托于通信模块做简易快捷的开发，将传统的AT命令用Lua语言封装成API，并提供各种功能应用的demo，大大减少用户的开发成本。开发者可以通过调用API轻松，便捷的实现TTS、GPS、SOCKET、MQTT、OTA等功能。例如下面通过几行代码既可以实现GPS，MQTT功能。

而Air724UG就是基于LuatOS-Air框架开发的，因此开发框架的掌握也是必须的。LuatOS-Air框架学习链接；

4.3 LuatOS-Air模块应用手册

介绍了几乎所有合宙4G模块的资料，包括入门资料包，环境搭建，其实上面的资料相关内容也是从LuatOS-Air模块应用手册截取出来的，LuatOS-Air模块应用手册链接；