如何克隆Demo代码仓库

本章将带我们快速体验LuatOS的入门

一、背景简介

项目的产品定义是：模组每隔3秒，就往串口输出一次 “ hello world” 字符串。

要想达到这个目的，必要先介绍一下 LuatOS 在合宙4G模组的运行原理：

 4G模组，除了运行4G协议栈之外，还植入了5.3版本的Lua虚拟机，以及内置的一个脚本代码区。

4G模组上电之后， 虚拟机会去代码区读取脚本代码的main入口， 并执行这个 main入口函数。

在完成这个初始项目之前，我们还需要准备好一套合适的硬件——运行LuatOS脚本的4G模组。

今天，我们用 LuatOS-Air780EPM 这个仓库中的demo作为例子来进行学习。

二、下载模组的示例代码

下载示例代码到一个合适的项目目录。从gitee下载代码的教程如下：

1、最简单快速的方式：

直接进入仓库，点击下载仓库文件

2、使用git工具下载

git工具下载地址：Git - Downloading Package

以下是以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:Gitee - 基于 Git 的代码托管和研发协作平台

在gitee找到账号设置，然后找到SSH公钥，再添加公钥。

6）、克隆仓库到本地，输入以下命令

此时在资源管理器中可以看到git下来的仓库文件

三、修改代码

用编辑器打开你下载下来的LuatOS-master\module\Air780EPM\demo\helloworld\main.lua 文件。demo链接地址

我们今天都用 vscode 做演示。

​ 如果你是用其他的编辑器， 也差不多类似。

其中sys.timerLoopStart(func, timeout)的作用是每隔timeout的时间循环执行回调函数func中的内容。

你把这段代码稍作修改后，改为这样：

然后保存，代码修改工作就大功告成了！

我们实现了每隔3000ms执行一次printf("hello world")

是不是超级简单？

四、烧录代码到硬件

烧录代码， 需要进行如下几步：

1 、下载和安装合宙调试工具 LuatTools

​ 要想烧录代码， 先要下载合宙的强大的调试工具： Luatools。

​ 如果你已经安装使用过 Luatools， 可以直接跳到下个小节： 烧录代码。

​ Luatools 的最新版本的工具介绍和下载地址为：

LuaTools下载调试教程 - common@air780epm - 合宙模组资料中心

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