软件环境清单

一、本篇文章的目的

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

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

二、软件环境清单

2.1 Luatools工具

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

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

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

1. 一键获取最新固件：自动连接合宙服务器，轻松下载最新的合宙模组固件。

2. 固件与脚本烧录：便捷地将固件及脚本文件烧录至目标模组中。

3. 串口日志管理：实时查看模组通过串口输出的日志信息，并支持保存功能。

4. 串口调试助手：提供简洁的串口调试界面，满足基本的串口通信测试需求。

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

2.2 项目使用的内核固件

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

1. 内核固件；

2. 脚本和资源文件。

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

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

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

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

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

下载core_V1112并且解压后，就能找到LuatOS-SoC_V1112_EC618_FULL.soc，如下图所示：

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

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

1. 内核固件；

2. 脚本和资源文件。

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

脚本文件包含两大部分：用户脚本文件和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项目为例，来说明只有用户脚本的情况。

点击：Air780E LuatOS demo下载地址，如下图所示（注意：下载页面的内容会不定期更新，实际访问时，以最新的页面为准）：

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

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

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

点击：Air780E LuatOS demo下载地址，如下图所示（注意：下载页面的内容会不定期更新，实际访问时，以最新的页面为准）：

点击上图中的demo链接，打开代码仓库，如以下三张图片所示，最终就可以找到main.lua和luatos_uploadFile.txt两个文件：main.lua为用户脚本文件，luatos_uploadFile.txt为资源文件：

默认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工具使用说明。

2.8 公有云控制台