Air8101 软件环境清单

一、本篇文章的目的

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

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

二、软件环境清单

2.1 Luatools 工具

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

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

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

一键获取最新固件：自动连接合宙服务器，轻松下载最新的合宙模组固件。
固件与脚本烧录：便捷地将固件及脚本文件烧录至目标模组中。
串口日志管理：实时查看模组通过串口输出的日志信息，并支持保存功能。
串口调试助手：提供简洁的串口调试界面，满足基本的串口通信测试需求。

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

2.2 项目使用的内核固件

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

内核固件；
脚本和资源文件。

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

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

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

下面以 LuatOS-SoC_V10001_Air8101.soc 为例，来说明如何获取内核固件（注意：如果你的项目中使用的不是 LuatOS-SoC_V10001_Air8101.soc，同样可以参考以下步骤，最终只需要选择你需要的内核固件即可）。

点击：SDK& Demo - luatos@air8101 - 合宙文档中心，如下图所示（注意：下载页面的内容会不定期更新，实际访问时，以最新的页面为准）：

2.3 项目使用的脚本和资源文件

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

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

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

1. 用户脚本文件是必须存在的；

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

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

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

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

1. 只有用户脚本文件，没有 lib 脚本文件；

2. 有用户脚本和资源文件，使用默认 lib 脚本文件；

3. 只有用户脚本文件，使用自己指定的 lib 脚本文件；

2.3.1 只有用户脚本文件

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

点击：https://docs.openluat.com/air8101/luatos/firmware/，如下图所示（注意：下载页面的内容会不定期更新，实际访问时，以最新的页面为准）：

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

2.3.2 有用户脚本和资源文件，使用默认 lib 脚本文件

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

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

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

2.3.3 只有用户脚本文件，使用自己指定的 lib 脚本文件

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

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

2.4 SSCOM 串口通信工具

SSCOM 是一种简单实用的串口通信工具，可以在计算机与设备之间建立串口通信连接，实现数据的发送与接收。

详情参考：SSCOM 下载和使用说明

2.5 LLCOM 串口通信工具

LLCOM 是另外一种简单实用的串口通信工具，可以在计算机与设备之间建立串口通信连接，实现数据的发送与接收。

详情参考：LLCOM | 能跑 Lua 代码的串口调试工具！，详细使用说明可以直接参考下载网站。

2.6 合宙 TCP/UDP web 测试工具

为了方便测试，合宙提供了免费的不可商用的 TCP/UDP web 测试工具：合宙 TCP/UDP web 测试工具。

详情参考：合宙 TCP/UDP web 测试工具使用说明。

2.7 MQTT 客户端软件 MQTT.fx

MQTT.fx 是一款第三方 MQTT 客户端工具，可以方便的测试 MQTT 的各项功能。

详情参考：MQTT.fx 工具使用说明。