软件环境清单

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

一、本篇文章的目的

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

这些文档会用到一些公共的软件环境清单，本篇文章重点介绍这些软件环境清单。

要想烧录 LuatOS 内核固件和脚本文件到 Air1601/Air1602 MCU 引擎中，需要用到合宙强大的调试工具：Luatools。

详细使用说明参考：Luatools 工具使用说明。

Luatools 工具拥有以下几大核心功能：

Luatools 下载之后，新建一个命名为 "Luatools" 的文件夹，将下载的 Luatools_v3.exe 拷贝或移动到新建的 Luatools 文件夹内，点击 Luatools_v3.exe 即可运行。

注意：LuaTools 要 3.1.11 或以上版本

一个完整的 LuatOS 项目软件包含两大部分：

本小节重点介绍如何获取内核固件。

内核固件又叫内核文件、core 固件、底层 core。

内核固件的文件名以 soc 做为后缀，例如：LuatOS-SoC_V1001_Air1601.soc。

点击：Air1601/Air1602 LuatOS 固件和 Demo，如下图所示（注意：下载页面的内容会不定期更新，实际访问时，以最新的页面为准）：

一个完整的 LuatOS 项目软件包含两大部分：内核固件，脚本和资源文件。

本小节重点介绍如何获取脚本和资源文件。

脚本文件包含两大部分：用户脚本文件和 lib 脚本文件：

用户脚本文件是必须存在的；
lib 脚本文件不是必须存在的；如果项目脚本文件中需要 lib 脚本文件，可以手动选择自己指定的 lib 脚本文件，也可以勾选 Luatools 的添加默认 lib 选项自动使用默认 lib 脚本文件。

资源文件是指除脚本文件外的其他任何文件，例如图片、音频、txt 文件等。

合宙对外发布了很多 LuatOS demo 项目，每个 demo 项目文件中的文件都是用户脚本文件或者资源文件。

下面举三个例子，来分别说明以下三种情况如何选择脚本和资源文件：

以合宙对外发布的 LuatOS helloworld demo 项目为例，来说明只有用户脚本的情况。

点击：Air1601/Air1601 LuatOS 固件和 Demo，如下图所示（注意：下载页面的内容会不定期更新，实际访问时，以最新的页面为准）：

点击上图中的 demo 链接，打开代码仓库，如以下三张图片所示，最终就可以找到 helloworld 功能的 main.lua 用户脚本文件：

以合宙对外发布的 LuatOS demo 项目为例，来说明有用户脚本和资源文件，使用默认 lib 脚本文件的情况。

用户脚本获取方法同 2.3.1 章节介绍，那么默认 lib 脚本文件如何获取呢？

不需要手动再去找 lib 脚本文件，使用 Luatools 烧录脚本和资源文件时，只需要勾选添加默认 lib 即可，如下图所示：

和 2.3.2 相比，lib 脚本文件不再使用默认 lib，而是使用用户指定的 lib 脚本文件。

在这种情况下，只需要选择好自己指定的 lib 文件文件即可，和用户脚本文件的使用方式完全一样。

包含Luattools下载调试工具，LuatOS PC模拟器，合宙TCP/UDP web测试工具，MQTT，HTTP，FTP，GPS，串口调试工具，等各种工具的下载和详细使用说明。