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

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

# Luatools V2新版本已发布，请移步新版工具教程：
# [Luatools v2烧录教程（适用于2G、4G Cat.1、4G Cat.4模块）](https://wiki.openluat.com/doc/tools/)

目录，可以根据需要直接点击跳转：
[下载LuaTools工具](#下载LuaTools工具 "下载LuaTools工具")

[2G模块烧写教程（Air2xx系列、Air8xx系列）：](#2G模块烧写教程（Air2xx系列、Air8xx系列）：)
[刷入AT版本的lod](#刷入AT版本的lod)
[刷入luat版本的lod](#刷入luat版本的lod)
[下载lua脚本文件](#下载lua脚本文件)

[4G Cat4模块烧写教程（Air720x系列）](#4G Cat4模块烧写教程（Air720x系列）：)
[安装驱动](#安装驱动)
[下载AT版本的固件](#下载AT版本的固件)
[下载LUAT底层固件](#下载LUAT底层固件)
[烧录脚本文件](#烧录脚本文件)

[烧录wifi固件](#烧录wifi固件：)

[小工具](#小工具：)

---

# 下载LuaTools工具
下载工具一般要经过以下步骤：

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

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

![](/static/editormd/php/../uploads/5_26328.png)

↑软件界面

---

# 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版本，如下图：
![](/static/editormd/php/../uploads/5_71164.png)

点击下载为模块烧入AT固件：
![](/static/editormd/php/../uploads/5_97042.png)
![](/static/editormd/php/../uploads/5_44016.png)
![](/static/editormd/php/../uploads/5_61002.png)
这样，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文件：
![](/static/editormd/php/../uploads/5_32027.png)

选中确认无误后，点击下载进行写入lod的操作
![](/static/editormd/php/../uploads/5_89822.png)
![](/static/editormd/php/../uploads/5_91197.png)
![](/static/editormd/php/../uploads/5_32004.png)

### 下载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脚本按钮，将文件列表全部清空：
![](/static/editormd/php/../uploads/5_26666.png)

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

> 这里如果没有选择lib文件，工具会自动进行提示

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

![](/static/editormd/php/../uploads/5_99163.png)

![](/static/editormd/php/../uploads/5_97087.png)

最后，等待下载成功即可

![](/static/editormd/php/../uploads/5_97582.png)

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

![](/static/editormd/php/../uploads/5_74906.png)

# 4G Cat4模块烧写教程（Air720x系列）：

这里我们使用Air720开发板（S720 Border）作为演示，首先需要将开发板按如下方式连接电脑：

![](/static/editormd/php/../uploads/5_96961.png)
连接后，我们会在设备管理器看到有几个未安装的驱动，我们需要安装上这些驱动

## 安装驱动

![](http://oldask.openluat.com/file/attachments-2018-09-OcuKrp1S5b9b596995edb_QQ%E6%88%AA%E5%9B%BE20180914144646.png)

>对于win8/win8.1/win10电脑，在安装驱动前需要进行如下操作（win7可以跳过该部分直接安装驱动）：
win8：在桌面右侧点击弹出菜单中的“设置”，点击“更改电脑配置”，在左侧点击“通用”，接着点击右侧“高级启动”中的“立刻重启”按钮
win10：按下win+i快捷键，点击“更新和安全”--“恢复”--“高级启动”下的“立即重启”按钮

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

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

安装压缩包中的驱动。注意，32位与64位驱动不同，请根据自己电脑选好安装包exe
安装过程中`肯定会弹出`下面的窗口，点击始终安装即可
![](http://oldask.openluat.com/file/attachments-2018-09-whEUtOjF5b9b59a5bf0e1_QQ%E6%88%AA%E5%9B%BE20180914144749.png)
安装成功后，将板子重新连接即可。

## 下载AT版本的固件

> 注意：AT固件也可以直接通过AT指令来进行远程升级，无需使用LuaTools工具，详情请参阅[http://oldask.openluat.com/article/186](http://oldask.openluat.com/article/186)

> 如果是模块飞线烧录，请先确保可以保证模块的稳定供电，并且烧录时模块不会被重启，按下图进行飞线usb：
> ![](/static/editormd/php/../uploads/5_51295.jpg)

打开luatools，将在菜单栏切换为4G模式：
![](http://oldask.openluat.com/file/attachments-2018-09-LfNmMIl85b9b5f5070499_QQ%E6%88%AA%E5%9B%BE20180914151206.png)

直接点击`AT--升级到标准AT版本`即可，点击`下载`：
![](/static/editormd/php/../uploads/5_27069.png)

这时工具会进入下载模块，我们可以`点击开发板上的“重启”按键，或者开关旁边的拨码开关`，下载工具会自动开始下载（如果是720S系列，需要按住boot按键后再开机，并保持按下状态直到工具提示可以松开为止；如果是自己的板子，则需要将boot与1.8v引脚短接）：
![](/static/editormd/php/../uploads/5_94329.png)
![](/static/editormd/php/../uploads/5_93160.png)
![](/static/editormd/php/../uploads/5_65748.png)
![](/static/editormd/php/../uploads/5_98916.png)
烧录后，我们可以用串口工具（SSCOM），通过虚拟的AT串口来进行AT操作：
![](http://oldask.openluat.com/file/attachments-2018-09-vTcfSS2X5b9f0efd8d249_QQ%E6%88%AA%E5%9B%BE20180917101809.png)
![](http://oldask.openluat.com/file/attachments-2018-09-6yPGPoxl5b9f0f0acf48d_QQ%E6%88%AA%E5%9B%BE20180917101828.png)

同时，也可以从开发板的另一个usb引脚，将拨码改至UART2，进行AT控制：
![](/static/editormd/php/../uploads/5_78146.png)

## 下载LUAT底层固件

打开luatools，将在菜单栏切换为4G模式：
![](http://oldask.openluat.com/file/attachments-2018-09-LfNmMIl85b9b5f5070499_QQ%E6%88%AA%E5%9B%BE20180914151206.png)

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

![](/static/editormd/php/../uploads/5_23593.png)

## 烧录脚本文件

我们用demo文件夹中的adc举例，烧录一个完整的脚本工程
（如果需要新建项目，千万不要在luatool下建立项目文件夹，不然会在更新时被删掉）
点击`下载lua脚本`，先点击`打开4G（.blf）文件`按钮，选择之前烧录的底层文件
然后点击`清空所有`：

![](/static/editormd/php/../uploads/5_20611.png)

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

![](/static/editormd/php/../uploads/5_35942.png)

这是会由于没有添加lib文件夹内的lua库文件而弹出一个对话框，我们直接点击确定，自动补全即可，勾选需要打印Trace的端口，默认是USB：
（如果没补全，那就手动把lib文件夹的所有文件都加进去）

![](/static/editormd/php/../uploads/5_69887.png)

接着就和上面烧录固件一样了，点击开发板上的`重启`按键，或者开关旁边的拨码开关，下载工具会自动开始下载（如果是720S系列，需要按住boot按键后再开机，并保持按下状态直到工具提示可以松开为止）

![](/static/editormd/php/../uploads/5_43879.png)
![](/static/editormd/php/../uploads/5_18752.png)
![](/static/editormd/php/../uploads/5_40725.png)

烧录完成后，关闭烧录对话框，即可看到luatools会输出adc demo的trace：

![](/static/editormd/php/../uploads/5_75924.png)

# 烧录wifi固件：

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

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

![](/static/editormd/php/../uploads/5_96609.png)

这时只需要连接设备，点击刷新按钮，选上要烧录的固件，点击烧录就可以了：
![](/static/editormd/php/../uploads/5_98541.png)

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

# 小工具：

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

![](/static/editormd/php/../uploads/5_18127.png)

发表于 2018-08-23 20:54
阅读 ( 40100 )
分类：默认分类

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

你可能感兴趣的文章

相关问题

2 条评论

作家榜 »