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

刘晨旭 合宙Luat 昨天


合宙Luat将为广大开发爱好者提供系列官方教程,从最基本的烧录程序到各类应用,详尽细致轻松上手,从小白到大神,开启你的进阶之路吧!



1

下载LuaTools工具

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

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


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


LuaTools下载:

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


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

软件界面



2

2G模块烧写教程(Air2xx / Air8xx系列)


4G模块烧录方法请看往下翻,看下一部分。


这时候,我们只需要用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:

    不支持SSLTTS、SPI接口LCD功能

  • Luat_VXXXX_8955_SSL.lod:

    支持SSL功能

  • Luat_VXXXX_8955_SSL_TTS.lod:

    支持SSLTTS功能,不支持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),支持SSLTTS、SPI接口LCD功能




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



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






上面下载失败了,要重新下载一遍


下载Lua脚本文件

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

lib库已在Luatools中自带,无需再自己下载


烧录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文件,工具会自动进行提示。



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



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


最后,等待下载成功即可

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




3

4G模块烧写教程(Air7xx系列)


这里我们使用Air720开发板(S720 Border)作为演示,首先需要将开发板按如下方式连接电脑:


连接后,我们会在设备管理器看到有几个未安装的驱动,我们需要安装上这些驱动。

安装驱动



对于Win8/Win8.1/Win10电脑,在安装驱动前需要进行如下操作(Win7可以跳过该部分直接安装驱动):


Win8:

在桌面右侧点击弹出菜单中的“设置”,点击“更改电脑配置”,在左侧点击“通用”,接着点击右侧“高级启动”中的“立刻重启”按钮。


Win10:

按下win+i快捷键,点击“更新和安全”—“恢复”—“高级启动”下的“立即重启”按钮;

接着就进入了高级启动界面,选择“疑难解答”—“高级选项”—“启动设置”—“重启”;
在启动设置页按F7选择禁用驱动强制数字签名,就可以在该模式下开机了。



我们可以在http://www.openluat.com/Product/4g/Air720D.html页面的资料下载,下载[驱动程序] AirM2M_USB_Download&Com_Driver_for_4G_V1.0

安装压缩包中的驱动。注意,32位与64位驱动不同,请根据自己电脑选好安装包exe;


安装过程中
肯定会弹出下面的窗口,点击始终安装即可。




安装成功后,将板子重新连接即可。





下载AT版本的固件


注意:AT固件也可以直接通过AT指令来进行远程升级,无需使用LuaTools工具,详情请参阅:

http://ask.openluat.com/article/186



打开Luatools,将在菜单栏切换为4G模式:



直接点击AT--升级到标准AT版本即可,点击下载



这时工具会进入下载模块,我们可以点击开发板上的“重启”按键,或者开关旁边的拨码开关,下载工具会自动开始下载:







烧录后,我们可以用串口工具,通过虚拟的AT串口来进行AT操作:




同时,也可以从开发板的另一个usb引脚,将拨码改至UART2,进行AT控制:







下载Luat底层固件

打开Luatools,将在菜单栏切换为4G模式:

首先要先烧录blf底层文件,点击右上角的下载CORE
选择需要烧入的底层文件(可在
LuaTools x.x.x\asr1802\CORE\Luat_V0005_ASR1802\文件夹找到),点击下载


这时工具会进入下载模块,我们可以点击开发板上的“重启”按键,或者开关旁边的拨码开关,下载工具会自动开始下载:





底层烧录完成。


烧录脚本文件

我们用demo文件夹中的adc举例,烧录一个完整的脚本工程:
(如果需要新建项目,千万不要在Luatool下建立项目文件夹,不然会在更新时被删掉)


点击
下载Lua脚本,先点击打开4G(.blf)文件按钮,选择之前烧录的底层文件,然后点击清空所有



接着点击添加脚本我们把LuaTools x.x.x\asr1802\lib\demo\adc文件夹下的所有文件添加进去,点击下载脚本



这是会由于没有添加lib文件夹内的lua库文件而弹出一个对话框,我们直接点击确定,自动补全即可:
(如果没补全,那就手动把lib文件夹的所有文件都加进去)



接着就和上面烧录固件一样了,点击开发板上的重启按键,或者开关旁边的拨码开关,下载工具会自动开始下载






烧录完成后,关闭烧录对话框,检查一下左上角是否勾上了自动usb口,如果已勾选,等待十几秒后即可看到luatools会输出adc demo的trace:





4

烧录Wi-Fi固件


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


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


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



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



5

小工具


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




今天的Luat教程就到这里了,相信你已经可以轻松上手了~欢迎留言互动,一起迈向大神之路!


另外,合宙Luat物联网大佬比武火热进行中,欢迎来挑战哦~





Luat小企业系列原创文章回顾:

小企业怎么寻找生意的蓝海?

小企业2B新产品怎样定价?

小企业的2B业务怎么获客(一)?

合宙Luat将陆续推出小企业系列原创作品,敬请关注!




 ▼
Luat热文推荐

>小企业怎么寻找生意的蓝海?

>NB-IoT,未来的物联网脊梁,还是扶不起的阿斗?

>2019年最值得工作和落户的几个城市,有你的家乡吗?

>为什么说『 物联网通信模块业务』没有前途?

>4G模块价格进入2位数时代,合宙Air720模块正式量产发货


>NB向左,GPRS向右,谁会率先突破百亿连接数?

>GPRS模块为什么会低至十几元?我所经历的物联网模块国产化过程

    已同步到看一看