Embedded

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

2018 年 7 月 28 日 6 Comments

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切换回来

小工具

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

相关文章：

Luat系列教程：7、串口收发 Luat系列教程：6、mqtt代码详解 Luat系列教程：5、socket代码详解 Luat系列教程：4、学会使用并看懂luatools的trace信息 Luat系列教程：3、LUAT程序的基本时序

6 Comments

发表回复

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