今天我们特别将本章介绍给大家，带我们快速体验LuatOS的入门
一、背景介绍
这里，先要告诉你一些前提条件，希望你能够认真看一看这一节。
这个项目的产品定义是：模组每隔3秒，就往串口输出一次 “ hello world” 字符串。
要想达到这个目的，这里有必要先介绍一下 LuatOS 在4G模组的运行原理：
4G模组，除了运行4G协议栈之外，还植入了5.3版本的Lua虚拟机，以及内置的一个脚本代码区。
4G模组上电之后， 虚拟机会去代码区读取脚本代码的main入口， 并执行这个 main入口函数。
你只需要用 Lua 脚本改写 main 入口函数，并把这个脚本烧录到模组的正确位置，就可以正确运行脚本的代码。
幸运的是， 你只需要用Luatools工具烧录脚本， 就一定能保证脚本烧录到正确的位置。
在完成这个初始项目之前，你还需要准备好一套合适的硬件。
合适的硬件是什么呢？
是能运行LuatOS脚本的4G模组。怎么知道哪些4G模组能运行LuatOS呢？要想知道答案，可以看我们的选型手册中的模块对应的总代码仓库地址。通过代码仓库的网址，我们会看到公开的一系列代码仓库。
我们不仅仅公开了每个模组的示例代码，还把缺陷跟踪也公开了，真是绝对自信！
今天，我们用 LuatOS-Air780EPM 这个仓库中的demo作为例子来进行学习。
同时，还有强大的社区资料支持,这个网站的LuatOS-SOC接口文档中，可以看到使用的API函数的介绍说明。
在开始之前，我们已经事先准备好了 Air780EPM 开发板。
二、下载模组的示例代码
1、最简单快速的方式：
直接进入仓库，点击下载仓库文件
2、使用git工具下载
以下是以Git Air780E项目进行举例说明，Git Air780EPM流程一样，只需要替换成Air780EPM Git路径即可。
1、进入下载地址后，下载对应的工具
2、双击安装工具
3、双击后，直接下一步安装即可 中途都是一些配置选项，一般使用默认选项即可。
git下载好之后。。。
1、新建一个文件夹，右键打开操作面板
2、设置用户签名：
用户名和邮箱是用来标识是谁提交的代码，输入以下命令
git config --global user.name "用户名"(用户名看情况随意写) git config --global user.email "邮箱"(不需要真实存在，看情况随便写)3、初始化本地库，输入以下命令
git init输入这个命令后，可以在当前目录下看到一个.git文件。只有.git文件是用git init命令生成的。其他的没关系。有了.git文件后，当前文件夹就是一个git仓库了，可以与远程的仓库进行连接。
4、从远程仓库下载一个公钥，为了让远程仓库验证自己的身份。输入以下命令
ssh-keygen -t rsa #产生公钥 cat ~/.ssh/id_rsa.pub #查看公钥生成的公钥可以在C:/User/用户/.ssh下看到
5、将公钥添加到gitee仓库
在gitee找到账号设置，然后找到SSH公钥，再添加公钥。
6、克隆仓库到本地，输入以下命令
此时在资源管理器中可以看到git下来的仓库文件
三、修改代码
今天我们后面的例子都用 vscode 做演示。
如果你是用其他的编辑器， 也差不多类似。
其中sys.timerLoopStart(func, timeout)的作用是每隔timeout的时间循环执行回调函数func中的内容。
我们把这段代码稍作修改后，改为这样：
然后保存，代码修改工作就大功告成了！
我们实现了每隔3000ms执行一次printf("hello world")
是不是超级简单？
四、烧录代码到硬件
烧录代码， 需要进行如下几步：
1、 下载和安装合宙调试工具 LuatTools
要想烧录代码， 先要下载合宙的强大的调试工具： Luatools。
如果你已经安装使用过 Luatools， 可以直接跳到下个小节： 烧录代码。
Luatools 工具主要有如下几个功能：
（1）自动从合宙服务器获取最新的合宙模组固件；
（2）烧录固件和脚本；
（3）查看和保存模组的串口输出日志；
（4）简单的串口调试；
Luatools 下载之后， 无需安装， 解压到你的硬盘，点击 Luatools_v3.exe 运行，出现如下界面，就代表 Luatools 安装成功了：
2、 烧录代码
首先要说明一点： 脚本代码， 要和固件的bin文件一起烧录。
（1）找到烧录的固件文件
Air780EPM 的固件可以去DOCS网站下载。底层core下载地址：Air780EPM LuatOS固件版本
（2）正确连接电脑和4G模组电路板
使用带有数据通信功能的数据线，不要使用仅有充电功能的数据线；
（3）识别4G模组的BOOT引脚
在下载之前，要用模组的BOOT引脚触发下载， 也就是说，要把4G模组的BOOT引脚拉到 1.8v，或者直接把BOOT引脚和VDD_EXT引脚相连。我们要在按下BOOT按键时让模块开机，就可以进入下载模式了。
具体到 Air780EMP开发板，
1、当我们模块没开机时，按着BOOT键然后长按PWR开机。
2、当我们模块开机时，按着BOOT键然后点按重启键即可。
（4）识别电脑的正确端口
判断是否进入BOOT模式：模块上电，此时在电脑的设备管理器中，查看串口设备， 会出现一个端口表示进入了boot下载模式，如下图所示：
一旦进入了boot下载模式，表示硬件连接上已经处于就绪状态，此时就可以使用Luatools工具进行烧录了！
（5）新建项目
首先，确保你的 Luatools 的版本，是大于 3.0.15 版本的。
在 Luatools 的左上角上有版本显示的，如图所示：
Luatools 版本没问题的话， 就点击Luatools 右上角的“项目管理测试”按钮，如下图所示：
这时会弹出项目管理和烧录管理的对话框，如下图：
1、新建一个项目
（6） 开始烧录
选择Air780EPM板子对应的底层core和刚改的main.lua脚本文件。下载到板子中。
点击下载后，我们需要进入boot模式才能正常下载，在(3)(4)小节已经介绍了如何进入boot模式。
3 、烧录问题排查
如果你在烧录过程中遇到了问题， 请点击如下链接，进行烧录的问题排查。
五、验证功能
烧录完成后，会自动开机，此时电脑的设备管理器中会虚拟出三个端口表示正常开机
Luatools会自动抓取应用日志和系统日志，并且在主界面解析显示应用日志，如下图所示
从打印的日志可以看到，这个4G开发板，在不断的打印 hello world。
六、总结
这节我们学会了
1、如何下载LuatOS的core，
2、如何使用烧录工具Luatools，
3、如何编辑lua脚本实现打印hello world
