合宙Air780EG开发板系列教程—03 Luatools下载调试工具（基于luatos的开发)

1、 LuaTools 简介

Luatools是合宙提供的单机版调试工具，支持最新固件获取、固件打包、trace打印、单机烧录等功能。此工具适用于合宙的SoC、cat1模块、cat4模块、2G模块。

2、环境

运行于 Windows 系统，只要可以正常运行 Windows7 或以上系统即可使用Luatools，不支持mac与linux。

3、LuaTools 安装

-点击 LuaTools下载 ，下载完成是一个文件名为Luatools_v2.exe的运行程序。
点击下载，或者另存为都可。下载完成后会看到需要怎么确认。
打开浏览器下载界面，点击保留
点击显示详细信息

点击任然保留

• 新建一个 LuaTools文件夹，移动到LuaTools文件夹下。
  

• 双击 Luatools_v2.exe开始安装，安装完成后会看到出现了很多文件夹

• 打开Luatools，点击更新，目的是为了加载需要的资源包。
  

4、编写代码

• 打开VSCode，创建一个lua文件夹，在该文件夹下新建一个名为 main.lua的文件。通过Luatools烧录必须要一个名为 main.lua的文件。
• 编写代码，先写一个简单的代码，LuaTools需要PROJECT和VERSION这两个信息，记得添加，要不然会报错。保存。

-- LuaTools需要PROJECT和VERSION这两个信息
PROJECT = "AIR_780eg"
VERSION = "1.0.0"

_G.sys = require("sys")

print("hello,cheney")

sys.run()

5、添加底层CORE

• 打开Luatools，点击项目管理

• 新建一个新项目，命名为test_01，点击确定

• 可以看到，我们新建了一个新项目，上面的CORE底层文件是空的，我们需要添加CORE文件，点击选择文件，然后找到我们安装Luatools的那个文件夹，选择resource文件夹

• 然后选择和合宙版本对应的CORE文件，我用的是合宙AIR780EG，所以我选择的是618_lua这个，注意不要选择618_at这个，我们选择不用AT指令，不要选错了，要不然烧录没反应。

• 随便选择一个文件，我选择的是第一个，其他的也可以。

6、烧录

• 添加好了底层文件，可以看到上面会有显示我们添加的是哪个CORE文件。

• 点击添加脚本，把刚刚在VSCode上写好的main.lua文件添加进来

• 添加进来后，点击下载底层和脚本，把右边的也选上

• 点击下载后，

• 按住下载模式按键（boot 键）不放，同时再长按开机键开机，这时开发板会进入下载模式，luatool下载进度条会开始跑，这时可以松开 boot 按键。直到工具提示下载完成。

• 如果，未能成功进入下载模式，而是进入正常开模式，这时可以按住 boot 键，再短按复位按键，让开发板重启，重新进入下载模式。

• 如何判断有没有进入下载模式:可以通过 PC 端的设备管理器中虚拟出来的 USB 断开数量来判断：

正常开机模式：
下载模式：

• 下载成功后我们可以看到显示下载成功了，这时候我们就可以看到打印出来了我们想要的hello cheney
  

7、如何循环打印语句

-- LuaTools需要PROJECT和VERSION这两个信息
PROJECT = "AIR_780eg"
VERSION = "1.0.0"

_G.sys = require("sys")

-- 每 1s 打印一次
sys.timerLoopStart(function ()
    print("1111")
end,1000)

sys.run()

8、结束语

下一节介绍一下 sys 库