Luat系列教程:1、下载调试工具LuaTools的使用指南

LUAT系列全部教程可以点击下面链接查看(建议保存书签):

https://www.chenxublog.com/tag/luat系列教程

本来是想直接开始写脚本的hello world的教程,但是发现和多人从最基本的烧程序都不知道从何入手,官网给的资料也并不多(我在刚用的时候也卡在这里很久),所以就单独出一期LuaTools的使用教程。

下载LuaTools工具

下载工具一般要经过以下步骤:

  • 打开合宙官网:http://www.openluat.com/
  • 选择上面的“产品中心”,随便选一个产品,如:Air202 GPRS 通信模块
  • 点击模块介绍那边的“资料下载”选项卡
  • 点击“[LuaTools] Luat下载调试工具x.x.x”下载

当然,如果嫌麻烦,直接打开下面链接下载吧。。

http://www.openluat.com/Product/file/rda8955/luatools-redirect.html

下载后可能会进行自动升级,这个工具基本上是持续使用,都不会出现版本过旧的问题


↑软件界面

这时候,我们只需要用usb转串口线,与给模块/开发板的HOST串口相连,GND相连,并给模块上点即可

注意:模块的HOST口使用的是921600波特率,如果你使用的是劣质串口芯片(如质量差的pl2303以及山寨的ch340之类的),会出现无法通讯的现象。并且需要保证模块供电充足,不然会出现无限重启的状况。

下载lod固件文件/更改AT和luat底层版本

lod文件相当于一个模块的底层部分,lod文件可以分为AT版与luat版

  • AT版只能使用AT命令对模块进行控制,AT串口为uart1口
  • luat版为运行lua脚本所使用的底层,可对模块内部进行片内编程,完成一部分或全部的本应由外接单片机完成的工作

刷入AT版本的lod

刷入AT版本的固件十分简单,在上面连接模块完成之后,确保串口选项卡的串口为你设备的串口值,点击菜单中的AT切换为标准的AT版本,如下图:

点击下载为模块烧入AT固件:


这样,AT版本固件的lod就烧录完成了。

刷入luat版本的lod

luat的固件因为需求不同,所以为了节省空间,提供了多种库的组合
luat的固件可以在下载工具目录的/LuaTools x.x.x/8955Lod/找到,每个版本的区别可以参考readme.txt文件中的描述,部分内容也贴在下面:

Luat_VXXXX_8955.lod:不支持SSL、TTS、SPI接口的LCD功能
Luat_VXXXX_8955_SSL.lod:支持SSL功能
Luat_VXXXX_8955_SSL_TTS.lod:支持SSL、TTS功能,不支持MP3、MIDI、录音功能
Luat_VXXXX_8955_SSL_UI.lod:支持SSL、SPI接口的LCD功能
Luat_VXXXX_8955_TTS_UI.lod:支持TTS、SPI接口的LCD功能
Luat_VXXXX_8955_TTS1.lod:支持TTS功能
Luat_VXXXX_8955_TTS2.lod:支持TTS功能、不支持MP3、MIDI、录音、json
Luat_VXXXX_8955_UI.lod:支持SPI接口的LCD功能
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功能

我以烧录最基本的Luat_VXXXX_8955.lod为例,首先在调试工具中确保串口选项卡的串口为你设备的串口值,点击下载LOD(core)按钮,选中之前在工具目录的lod文件:

选中确认无误后,点击下载进行写入lod的操作



欸等等怎么失败了
这样,我们就当作这个lod下载成功了

下载lua脚本文件

由于luat模块的特色就是lua二次开发,所以下载烧录脚本的方法也是必须掌握的,下面以烧录S9开发板的示例程序为例(S9就是那个板载usb的开发板)

获取luat的脚本库

提前说明:如果你会使用git工具,我也不建议你用git将下文的git仓库clone下来,因为那个仓库历史文件太tm大了,下载速度还贼慢。当然,你如果真的想clone下来,那就clone下来吧。

首先打开github的仓库页:

https://github.com/openLuat/Luat_2G_RDA_8955/

点击右边那个绿色的东西,下载zip打包文件:

如果你发现下载贼慢,或者是那个链接根本打不开,那么可以尝试我clone到开源中国的链接:

https://gitee.com/chenxuuu/Luat_2G_RDA_8955

下载完之后,解压,放到你觉得可以放的地方

烧录S9需要的底层lod文件

S9需要的底层lod是Luat_VXXXX_8955_UI.lod,这里的UI库包含了字库和各种SPI、I2C屏幕的驱动
烧录步骤不再重复,请确保烧录最后成功了

烧录lua脚本

lua脚本分为两部分:一个部分是官方写的lib库文件(library),另一部分是用户自己的脚本文件。一般lib的文件不用去修改,除非有特殊需求。

lua库分为两个版本:
一个是老的script
另一个是由稀饭放姜进行编写的script_LuaTask

现阶段建议新项目都用script_LuaTask进行编写;老用户使用了script编写的,如码夫支付模块,可以继续用老版本,没有任何影响。

这里烧录的S9开发板就是使用的script_LuaTask进行编写的,具体步骤如下:

点击下载lua脚本按钮,将文件列表全部清空:

点击添加脚本,将刚刚从git仓库下载的Luat_2G_RDA_8955/script_LuaTask/product/LuatBoard_Air202/demo下的所有文件全部选中,点击打开确认选中

这里如果没有选择lib文件,工具会自动进行提示
在实际使用中,你也可以手动将Luat_2G_RDA_8955/script_LuaTask/lib文件夹下的所有文件按上面的步骤进行选中。这里的演示没有选中

点击下载,会弹出对话框让你补全lib库文件,这里我们选择“优先推荐”的LuaTask库,点击确定

这时可能会弹出底层不支持的对话框,我们选择依旧只下载脚本,点击确定(Air202 32Mb版没办法用UI+TTS的lod,装不下)

最后,等待下载成功即可

关闭对话框,即可看到设备运行的trace信息,这个信息可能会在下一章进行解释:

烧录wifi固件

Air系列最近又出了一款wifi模块,luatools工具也很快就添加了wifi模块烧写的功能,工具更新十分迅速

我们要使用wifi烧写工具的话,需要点击上方菜单栏处的切换模式切换至W600 WiFi

这时只需要在你需要烧录的COM口打上勾,选上要烧录的固件,点击烧录就可以了:

如果还要使用2G模块烧录,可以点击菜单栏的切换模式切换至2G/NB-IoT切换回来

小工具

小工具这个功能也是新版本刚加上的功能,目前只有一个模块生产记录查询,如下:

6 Comments

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注