• Stars
    star
    202
  • Rank 193,691 (Top 4 %)
  • Language
    Lua
  • Created over 7 years ago
  • Updated over 4 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Luat 2G开源项目,适用于Air202、Air800、Air201等,已经停止维护

Luat

LUAT LOGO

概述

Luat 是合宙(AirM2M)推出的物联网开源架构,依托于通信模块做简易快捷的开发.

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

开发者可以通过调用API轻松,便捷的实现TTS、GPS、SOCKET、MQTT、OTA等功能。例如下面通过几条代码既可以实现GPS,MQTT功能。

GPS

--引用gps.lua、sys.lua
require"gps"
require"sys"

--定义函数prtgps,在trace中输出gps定位信息
--是否3D定位,经纬度,速度,方向角,海拔
local function prtgps()
    print("gps", gps.is3dfix(), gps.getgpslocation(), gps.getgpsspd(), gps.getgpscog(), gps.getaltitude())
end

--设置定时器,每10秒调用一次prtgps函数
sys.timer_loop_start(prtgps, 10000)
--开机后,初始化gps;gps授时同步时钟
gps.init()
gps.settimezone(gps.GPS_BEIJING_TIME)

mqtt

--引用mqtt.lua
require"mqtt"

--mqtt connect成功的回调函数
local function connectedcb()
    --订阅主题
    mqttclient:subscribe({topic="/event0",qos=1})
    --发布消息
    mqttclient:publish("/event0", "qos1data", 1)
end

--创建mqtt client
mqttclient = mqtt.create("TCP", "lbsmqtt.airm2m.com", 8083)
--连接到 mqtt 服务器
mqttclient:connect("clientID", 240, "username", "password", connectedcb)

Luat介绍

Lua脚本是内嵌在模块基础软件core中运行的(core编译生成的文件是.lod文件),Lod中有支持Lua运行的环境,Lua脚本就在这个环境中运行。脚本实现功能是通过API(对AT命令进行了封装)实现的。

在模块内部,Lua发出AT命令,并通过虚拟的uart.ATC 口和Lod之间进行AT命令的交互。即Lua发出AT命令,Lod接收后进行解析并返回AT命令运行结果,不需要上位机(一般是单片机)通过物理串口给模块发AT命令,这样就节省了单片机的花费。

infomation

script和script_LuaTask

script和script_LuaTask是两版上层脚本开发架构:

  • 1、script是第一版,整个应用开发仅支持单线程

  • 2、script_LuaTask是第二版,基于Lua的协程实现了多线程的支持,相比于第一版script来说,用户编程变得简洁,在此郑重感谢Luat开源技术支持群(QQ群号:201848376)里的“稀饭放姜”大神对此版本架构提出的建议以及对此版本开发做出的贡献,同时感谢LuaTask群(QQ群号:670342655)里面的所有成员对此版本的辛勤付出。

建议新项目使用script_LuaTask版本开发。

各个接口说明可在http://wiki.openluat.com/doc/luatApi/查看


项目结构

├── core

    └──Luat_VXXXX_8955.lod:不支持SSL、TTS、SPI接口的LCD功能
    Lua脚本和资源(通过烧写工具烧写的文件,例如lua脚本文件,mp3音频文件)可用768KB
    文件系统(例如脚本运行过程中创建的参数文件,录音文件,远程升级文件等)可用860KB

    └──Luat_VXXXX_8955_SSL.lod:支持SSL功能
    LuaDB脚本和资源(通过烧写工具烧写的文件,例如lua脚本文件,mp3音频文件)可用768KB
    文件系统(例如脚本运行过程中创建的参数文件,录音文件,远程升级文件等)可用796KB

    └──Luat_VXXXX_8955_SSL_TTS.lod:支持SSL、TTS功能,不支持MP3、MIDI、录音功能
    LuaDB脚本和资源(通过烧写工具烧写的文件,例如lua脚本文件,mp3音频文件)可用324KB
    文件系统(例如脚本运行过程中创建的参数文件,录音文件,远程升级文件等)可用344KB

    └──Luat_VXXXX_8955_SSL_UI.lod:支持SSL、SPI接口的LCD功能
    LuaDB 脚本和资源(通过烧写工具烧写的文件,例如lua脚本文件,mp3音频文件,图片文件)可用704KB
    文件系统(例如脚本运行过程中创建的参数文件,录音文件,远程升级文件等)可用540KB

    └──Luat_VXXXX_8955_TTS_UI.lod:支持TTS、SPI接口的LCD功能
    LuaDB 脚本和资源(通过烧写工具烧写的文件,例如lua脚本文件,mp3音频文件,图片文件)可用152KB
    文件系统(例如脚本运行过程中创建的参数文件,录音文件,远程升级文件等)可用132KB

    └──Luat_VXXXX_8955_TTS1.lod:支持TTS功能
    LuaDB脚本和资源(通过烧写工具烧写的文件,例如lua脚本文件,mp3音频文件)可用216KB
    文件系统(例如脚本运行过程中创建的参数文件,录音文件,远程升级文件等)可用260KB

    └──Luat_VXXXX_8955_UI.lod:支持SPI接口的LCD功能
    LuaDB 脚本和资源(通过烧写工具烧写的文件,例如lua脚本文件,mp3音频文件,图片文件)可用512KB
    文件系统(例如脚本运行过程中创建的参数文件,录音文件,远程升级文件等)可用796KB

    └──Luat_VXXXX_8955_SSL_FLOAT.lod:支持SSL功能、浮点数

    └──Luat_VXXXX_8955_SSL_UI_FLOAT.lod:支持SSL功能、PI接口的LCD功能、浮点数

    └──Luat_VXXXX_8955F.lod:64M flash版本(Air202F),支持SSL、TTS、SPI接口的LCD功能


├── script_LuaTask 基于Lua的协程实现了多线程的支持

    └── demo 例程
    └── lib 库文件
    └── product/LuatBoard_Air202  LuatBoard开发板

底层软件(也叫基础软件,位于/core)用C语言开发完成,支撑Lua的运行。

lib目录中的“库脚本”(所有项目都应该使用),

用户自己编写的“应用脚本”(例如demo目录下的脚本)

LuaTools

使用Luat调试开发工具对模块进行lod和script的下载。该工具功能如下:

  • 加密lod功能;

  • 下载官方lod底层;

  • 下载Lua脚本进行二次开发;

  • 用App验证开发板是否为良品;

  • 对模块打印trace进行输出分析;

  • 生成量产文件进行远程升级/批量生产。

工具并不支持代码编辑功能,如果要编辑代码,则需下载其他编辑器,比如sublime text 3,vscode,notepad++等。

你可以点击此处查看使用教程