如何使用 Luatools 烧录软件

作者：陈媛媛　|　最后修改：2026-04-23

一、本篇文章的目的

针对 Air1601/Air1602 LuatOS 二次开发方式，合宙技术人员在 docs 文档中心编写了几十篇快速入门和软件指南文档。

每篇文档都会基于一个具体的 demo 项目，使用 Luatools 将项目使用的内核固件、脚本和资源文件，烧录到 Air1601 开发板中；

本篇文章重点介绍如何使用 Luatools 工具烧录一个具体的项目到 Air1601 开发板中。

在烧录项目文件到 Air1601 开发板之前，你需要准备好以下几种项目文件：

其中：

内核固件和用户脚本文件是必须存在的；

用户资源文件不是必须存在的；

lib 脚本文件是必须存在的，但是不一定要用户提供，可以使用 Luatools 自动选择的默认 lib 脚本文件。

这几种项目文件的详细解释，参考：Air1601 LuatOS 固件和 Demo 。

本章节以一个具体的 hello_world demo 项目为例，来说明如何烧录项目文件到 Air1601 开发板中。

在这个 demo 项目中，需要准备好的项目文件如下：

外部文章引用本篇文章时，在外部文章的软件环境清单章节中必须说明如何找到以上三种文件。

在 Air1601 开发板上丝印标注 USB1，为芯片烧录下载接口。

将 USB 数据线插入 Air1601 开发板的 USB Type-C 接口，即可为开发板供电，同时该接口也用于程序烧录。

若遇到因电脑 USB 端口供电不足导致的烧录失败，也可改用外部稳压电源通过开发板上的 VIN 引脚进行供电。

注意:

不能是仅有充电功能的数据线

默认情况下, 板⼦⽆法刷机, 也⽆法上电运⾏的, 需要改⼀下以下⼏个拨动开关

修改后的效果

正确插入 USB 转串口扩展板并且 USB 成功连接电脑后，电脑的设备管理器可以看到"USB-SERIAL CH343"的端口。

注意：Air1601下载程序时，除打开 V_Air1601 外，若同时打开VBAT其它开关，需确保其他串口无外部信号输入，否则可能导致下载失败。

若无法确认其他串口是否存在外部信号，建议只保留 V_Air1601 开关开启，关闭其余所有 VBAT 开关。程序下载完成后，再按需打开其他功能对应的 VBAT 开关、接入外部信号正常使用即可。

通过串口烧录方式，烧录项目文件到Air1601开发板

使用 type-C 数据线一端连接开发板 USB 接口，另一端连接电脑 USB 接口，通过电脑的USB 接口直接给开发板供电。当开发板有外部供电时，电源指示灯会亮起，表示开发板已上电。
USB成功连接电脑后，电脑的设备管理器可以看到" USB-Enhanced-SERIAL CH343 "的端口，选中"USB-SERIAL CH343"端口，并且勾选上"通用串口打印"，串口波特率选择"6000000"（V1012及以上版本改为6M），然后点击"打开串口"，接下来点击"项目管理测试"。