嵌入式开发入门：Git克隆与Air780EPM代码烧录指南-代码聚汇网

嵌入式开发入门：Git克隆与Air780EPM代码烧录指南

ChanKinYi

1. 项目概述

作为一名嵌入式开发工程师，我经常需要从开源平台获取各种Demo代码进行学习和测试。对于刚入门的新手来说，克隆代码仓库这个看似简单的操作却常常成为第一道门槛。今天我就以LuatOS的Air780EPM模组为例，手把手教你两种最常用的代码获取方式：直接下载和使用Git工具。

这个教程特别适合以下人群：

刚接触嵌入式开发的在校学生
从其他领域转行到物联网开发的工程师
对Git操作不熟悉但需要快速获取开源代码的爱好者

我们将从最基础的步骤开始，不仅教你如何获取代码，还会完整演示代码修改、烧录到硬件以及功能验证的全过程。即使你之前完全没有接触过Git或嵌入式开发，跟着本文操作也能在30分钟内完成整个流程。

2. 代码获取方式详解

2.1 直接下载仓库文件

对于急需代码又不想折腾Git的新手，这是最快捷的方式：

访问Gitee上的LuatOS仓库：

code复制https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EPM

点击页面右上角的"克隆/下载"按钮，选择"下载ZIP"
将下载的压缩包解压到你项目的目录中

注意：这种方式虽然简单，但后续无法方便地同步仓库更新。如果你计划长期维护这个项目，建议还是学习使用Git工具。

2.2 使用Git工具完整克隆

Git是代码管理的标准工具，掌握它能让你更好地参与开源项目。下面是详细步骤：

2.2.1 安装Git客户端

访问Git官网下载页面：

code复制https://git-scm.com/downloads

选择对应你操作系统的版本下载（Windows用户推荐下载"Standalone Installer"）
运行安装程序，所有选项保持默认即可

安装完成后，你可以在任意文件夹右键看到"Git Bash Here"和"Git GUI Here"选项，这表示安装成功。

2.2.2 配置Git环境

新建一个文件夹作为你的项目目录，右键选择"Git Bash Here"

设置你的用户信息（提交代码时会用到）：

bash复制git config --global user.name "YourName"
git config --global user.email "your_email@example.com"

初始化本地仓库：
```
bash复制git init
```
执行后会生成一个隐藏的.git目录，这是Git管理仓库的核心。

2.2.3 配置SSH密钥（可选但推荐）

为了避免每次操作都需要输入密码，我们可以配置SSH密钥：

生成SSH密钥对：
```
bash复制ssh-keygen -t rsa -C "your_email@example.com"
```
连续按回车使用默认设置，密钥会生成在~/.ssh/目录下
查看并复制公钥内容：
```
bash复制cat ~/.ssh/id_rsa.pub
```
登录Gitee，进入"设置"-"SSH公钥"，添加你的公钥

2.2.4 克隆远程仓库

获取仓库的SSH地址（在Gitee仓库页面的"克隆/下载"处选择SSH）

执行克隆命令：

bash复制git clone git@gitee.com:openLuat/LuatOS.git

等待克隆完成，你会在当前目录看到LuatOS文件夹

提示：如果克隆速度慢，可以尝试改用HTTPS协议，或者配置Git的代理设置。

3. 代码修改与验证

3.1 定位并修改示例代码

克隆完成后，我们找到helloworld示例：

code复制LuatOS-master/module/Air780EPM/demo/helloworld/main.lua

用VSCode或其他编辑器打开这个文件，你会看到如下内容：

lua复制sys.taskInit(function()
    while true do
        sys.wait(3000)
        log.info("hello world")
    end
end)

这是一个简单的循环打印程序。我们将其修改为：

lua复制sys.taskInit(function()
    local count = 0
    while true do
        sys.wait(3000)
        count = count + 1
        log.info("hello world", "count:"..count)
    end
end)

这样修改后，每次打印会附带一个递增的计数器，方便我们观察程序是否正常运行。

3.2 代码保存与版本管理

修改完成后：

保存文件（Ctrl+S）

如果你想用Git管理修改：

bash复制git add .
git commit -m "add counter to hello world demo"

注意：如果是直接下载的ZIP包，无法使用Git进行版本管理。这也是推荐使用Git克隆的原因之一。

4. 烧录准备与工具安装

4.1 下载烧录工具LuatTools

访问LuatTools下载页面：

code复制https://docs.openluat.com/air780epm/common/Luatools/

下载最新版本的LuatTools（目前推荐v3.x系列）
解压到任意目录（无需安装，绿色版）

4.2 准备硬件环境

准备一根可靠的数据线（确保支持数据传输，不只是充电）
确认你的Air780EPM开发板状态良好
识别开发板上的关键引脚：
- BOOT：用于进入下载模式
- PWR：电源开关
- RST：复位按钮

5. 烧录流程详解

5.1 进入下载模式

Air780EPM有两种进入下载模式的方法：

冷启动方式：
- 按住BOOT键不放
- 长按PWR键开机
- 保持BOOT键按住3秒后松开
热启动方式：
- 在设备已开机状态下
- 按住BOOT键不放
- 短按RST键复位
- 保持BOOT键按住3秒后松开

成功进入下载模式后，设备管理器会显示一个新的串口设备（通常名称包含"Download"字样）。

5.2 配置烧录参数

运行LuatTools_v3.exe
点击右上角的"项目管理测试"按钮
新建项目：
- 选择设备类型为Air780EPM
- 指定刚才修改的main.lua路径
- 添加对应的固件文件（可从同一网站下载）
确认端口选择正确（应该是在下载模式下出现的那个端口）

5.3 执行烧录

点击"下载"按钮
观察进度条和日志输出
烧录完成后设备会自动重启

常见问题：如果烧录失败，首先检查是否成功进入了下载模式，其次确认数据线和端口选择是否正确。

6. 功能验证与调试

6.1 查看运行日志

烧录完成后，LuatTools会自动连接设备并显示日志输出。你应该能看到类似这样的信息：

code复制[2023-08-20 15:30:45] hello world count:1
[2023-08-20 15:30:48] hello world count:2
[2023-08-20 15:30:51] hello world count:3

这表明我们的修改已经成功运行在硬件上了。

6.2 高级调试技巧

日志级别设置：
在LuatTools中可以设置过滤不同级别的日志信息，方便定位问题。
变量监控：
可以在代码中添加更多的log.info()输出来监控关键变量。
异常捕获：
使用pcall()函数包裹可能出错的代码段，可以防止单个任务崩溃影响整个系统。

7. 常见问题排查

7.1 Git相关问题

问题1：克隆时提示权限被拒绝

检查SSH密钥是否配置正确
确认Gitee账户已添加公钥
尝试改用HTTPS协议克隆

问题2：提交代码时提示用户信息未设置

执行git config命令设置用户名和邮箱
使用git config --list检查当前配置

7.2 烧录相关问题

问题1：无法进入下载模式

检查BOOT键是否正常工作
确认按键时序正确（按住BOOT后再操作PWR/RST）
尝试更换数据线或USB端口

问题2：烧录进度卡住

检查端口是否被其他程序占用
重新插拔设备并重试
降低烧录波特率尝试

问题3：设备运行不正常

确认烧录的固件版本与硬件匹配
检查电源供电是否充足
查看完整系统日志定位问题

8. 进阶学习建议

完成这个基础Demo后，你可以尝试以下扩展：

修改打印间隔：调整sys.wait()的参数观察变化
添加更多功能：比如增加传感器数据采集
学习Git分支管理：创建自己的开发分支进行实验
研究LuatOS框架：了解如何创建更复杂的任务

我在实际开发中发现，保持代码版本管理的良好习惯非常重要。即使是个人项目，也建议：

为每个新功能创建独立分支
编写有意义的提交信息
定期同步上游仓库的更新