欢迎来到Luat开源社区

目前基于合宙公司出品的模块软件包含如下三种:

标准AT版本是传统的AT命令开发模式,用户需要MCU编程实现对模块的控制。

Luat = Lua + AT, Luat 是合宙(AirM2M)推出的物联网开源架构,依托于通信模块做简易快捷的开发,将传统的AT命令用Lua封装成API,并提供各种功能应用的demo,大大减少用户的开发成本。

C-SDK模式是采用C语言的开发模式。

目前支持的主打模块有两款:Air202,Air800。其中,Air202是一款GPRS模块; Air800是一款支持GPRS+北斗+GPS的三合一模块。

目前支持的模块有如下几款:

序列 名称 功能 方案 尺寸
Air202 系列 四频GPRS模块 RDA8955方案 14.8 * 17.7 * 2.3mm
Air800 模块 四频GPRS+北斗+GPS模块 RDA8955+GK9501方案 14.8 * 23.8 * 2.4mm

传统AT命令

对于习惯于MCU+AT命令开发模式的二次开发用户来说,我们准备了AT命令版本的模块和开发板,以方便用户开发。例如Air800T,Air202T。

AirT模块或开发板相对于同名的Air模块或开发板来说,仅仅只是固件的不同,硬件上完全相同。模块或开发板出厂时的版本,不带T的是Luat版本,带T的是AT命令版本。相互之间可以互刷。

例如,Air202T出厂固件版本是AT命令版本,它可以刷Air202的固件;Air202出厂固件是Luat版本,也可以刷Air202T的固件。同时,无论是Air202还是Air202T,都可以刷C_SDK包。


Luat软件架构简介

Luat 的软件架构分为底层软件和上层Lua脚本两个部分:

1.基础软件,底层lod,不同功能不同lod,合宙官方提供,详见core件中。用C语言开发完成,内嵌了Lua虚拟机,支持上层软件的运行。基础软件编译后的文件称为lod。

2.上层软件(script),采用 Lua 脚本语言开发,是模块的应用例程源码。脚本分为两部分:Lib和demo。其中:

Lib中是库文件,对AT命令封装成API,Lib 实现公用的服务,比如sms,call,audio,mqtt,gps等等;

demo代码通过调用lib 的接口来实现业务逻辑。用户可以在demo基础上修改糅合,实现自己的业务功能。

基础软件和上层软件,两部分软件缺一不可,一起运行于模块之中,完成各种功能和应用。

Attention

Luat 开发板/模块在出厂的时候,已经下载了默认软件,默认软件包括: 最新的基础软件lod+上层软件中的/demo/default 。


Luat脚本二次开发入门

Luat脚本开发方式适用于所有Air开源模块

如果用户手上已经有Luat Air系列开发板或小蛮GPS定位器(基于Air200开发),此时就具备实体开发调试的基本条件了。

二次开发用户需要对开发板有基本的了解:

Important

Luat 开发板的UART口都是3.3V TTL 电平。请不要用5V TTL电平。S6,S6有电平转换,支持2.8V 3.3V 5V。


Luat 脚本开发一般的步骤如下图:

trace

具体来说,就是用户下载lua脚本到开发板的模块里,通过trace打印来验证代码执行情况并检查错误,以便修改代码,并重新下载和打印trace,在这个循环的过程中完成产品开发。

第一步:clone 合宙开源库luat脚本到本地电脑

可以从Github Luat克隆,也可以从wiki:Luat软件版本下载。

开源资料包架构如下:

\core是模块基础软件代码,支持Lua的运行,由合宙官方提供。

\script是运行在上层的Lua脚本文件,是模块的应用例程源码。

另外,用户开发过程需要用到的一些工具。其中:

下载调试工具是 Luat 专用集成开发工具,集调试、下载和trace,生成量产功能于一体。

LuaForWindows是一款Lua代码编辑和语法检查工具。

第二步:用户编写Lua代码

用户对Lua项目的二次开发,请参考: Lua开发相关文档

另外lib库文件和demo文件都给出了详细注释。

开发者可以用喜欢的IDE,也可以用LuaForWindows,或其他编辑工具。

第三步:Lua脚本下载到Luat模块中

开发者自己开发的Lua代码需要下载到Luat模块或开发板中。

开发者可以用下载调试工具进行下载调试。

第四步:查看模块trace打印

用户需要查看模块的trace以检查和修改自己的Lua代码。

开发者使用下载调试工具查看模块打印的trace。




C_SDK软件架构简介

C_SDK开发环境,用于合宙模块上进行C语言二次开发,有丰富的api接口。软件架构如图:

C_SDK软件架构

C语言SDK详细描述



Let's get started!

用户买到Air模块或开发板,请先到 Luat模块外围硬件设计 下载模块硬件设计手册或开发板使用说明,并仔细阅读。

a) 如果是不带T的模块或开发板,那么出厂的是Luat版本,可以用时间线app来查看位置。

b) 如果是带T的模块或开发板,那么出厂的是AT命令版本,可以参考:AT指令教程 进行开发。

c) 如果用户不太清楚自己的模块或开发板是什么版本,那么请按照上面a)和b)进行鉴别,或按照以下指引烧录所需版本:

如果是Air202开发板,请到:Air202模块 选择版本下载;

如果是Air800开发板,请到:Air800模块 选择版本下载;

如果是Air200开发板,请到:更多模块 选择版本下载。


Luat技术支持

Luat开源技术交流群:201848376

Luat硬件技术支持:627242078

Luat C语言SDK技术支持:151645843

Luat开源App时间线:604902189

Luat WiFi模块技术支持:679177589

Luat设计外包沟通:320315140