晨旭的博客
你想干什么!
晨旭的博客~
Luat系列教程:1、下载调试工具LuaTools的使用指南
Luat系列教程:1、下载调试工具LuaTools的使用指南

本来是想直接开始写脚本的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

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

https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728204412.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10
↑软件界面

这时候,我们只需要用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版本,如下图:
https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728205500.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10
点击下载为模块烧入AT固件:
https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728205744.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10
https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728205824.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10
https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728205850.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10

这样,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文件:
https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728210451.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10
选中确认无误后,点击下载进行写入lod的操作
https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728210631.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10
https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728210654.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10
https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728210723.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10
欸等等怎么失败了
这样,我们就当作这个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打包文件:
https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728211929.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10

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

https://gitee.com/chenxuuu/Luat_2G_RDA_8955

https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728212200.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10

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

烧录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脚本按钮,将文件列表全部清空:
https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728213313.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10
点击添加脚本,将刚刚从git仓库下载的Luat_2G_RDA_8955/script_LuaTask/product/LuatBoard_Air202/demo下的所有文件全部选中,点击打开确认选中

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

点击下载,会弹出对话框让你补全lib库文件,这里我们选择“优先推荐”的LuaTask库,点击确定
https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728213700.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10
这时可能会弹出底层不支持的对话框,我们选择依旧只下载脚本,点击确定(Air202 32Mb版没办法用UI+TTS的lod,装不下)
https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728214158.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10
最后,等待下载成功即可
https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728214321.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10

关闭对话框,即可看到设备运行的trace信息,这个信息可能会在下一章进行解释:
https://source.papapoi.com/wp-content/uploads/2018/07/QQ截图20180728214421.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10

烧录wifi固件

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

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

https://source.papapoi.com/wp-content/uploads/2018/08/5219bb918f6129a07fde1351de374fe5.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10

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

https://source.papapoi.com/wp-content/uploads/2018/08/e4656c74362e28b38fe08cba5b21be43.png?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10

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

小工具

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

https://source.papapoi.com/wp-content/uploads/2018/07/InkedQQ截图20180810223854_LI.jpg?imageView2/2/w/800|watermark/1/image/aHR0cDovL3NvdXJjZS5wYXBhcG9pLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNi8wOC9sb2dvcGljLnBuZw==/dissolve/100/gravity/SouthEast/dx/10/dy/10

赞赏
如非特使说明,本站所有文章均采用知识共享 署名-非商业性使用-相同方式共享4.0国际许可协议(CC BY-NC-SA 4.0)进行许可。

相关文章

发表评论

textsms
account_circle
email

晨旭的博客~

Luat系列教程:1、下载调试工具LuaTools的使用指南
本来是想直接开始写脚本的hello world的教程,但是发现和多人从最基本的烧程序都不知道从何入手,官网给的资料也并不多(我在刚用的时候也卡在这里很久),所以就单独出一期LuaTools的使…
扫描二维码继续阅读
2018-07-28