跳转至

软件环境清单

作者：沈园园

一、本篇文章的目的

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

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

二、软件环境清单

2.1 USB 驱动

Air724UG 基于展锐 8910 平台，属于合宙第一代 4G 模组，需要手动安装 USB 驱动才能被电脑识别。

2.1.1 驱动下载

该驱动适合 Win7 及以上版本的非企业版 WINDOWS 系统。

点击如下链接下载驱动：

Air722_Air724_Air795_Air820模组USB驱动

更详细的驱动说明参考：彻底讲清楚 USB驱动问题

2.1.2 安装步骤

  1. 下载驱动压缩包，解压后，根据电脑配置安装对应驱动。

如果你的电脑是 64 位，就按照如下选择：

USB 驱动安装选择

  1. 使用 USB 数据线将 Air724UG 核心板（TYPE-C 接口）或开发板（Micro-USB 接口）连接到电脑。

  2. 打开设备管理器，查看「端口 (COM 和 LPT)」中是否出现 Air724UG 的 USB 串口设备。

  3. 安装成功后，设备管理器中会显示出 Air724UG 的多个 USB 虚拟串口，通常包括：

  4. AT 串口（用于 AT 指令通信，设备实例路径以 0006 结尾）

  5. 普通日志串口（用于查看模组运行日志，设备实例路径以 0002 结尾）

  6. 底层日志串口（用于查看底层日志，设备实例路径以 0004 结尾）

如果设备管理器中端口未正确识别，检查是否正确安装了驱动，或者检查数据线是否只有充电功能没有数据功能。

2.2 Luatools 工具

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

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

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

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

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

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

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

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

注意：Luatools 要 3.1.11 或以上版本。

2.3 项目使用的内核固件

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

  1. 内核固件；

  2. 脚本和资源文件。

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

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

Air724UG 的 LuatOS 固件为 LuatOS-SoC 固件，与旧版 LuatOS-Air 固件（如 LuatOS-Air_V4033_RDA8910 系列）不兼容，内核固件文件名以 .soc 作为后缀，例如：LuatOS-SoC_V1008_Air724UG.soc。

点击：Air724UG LuatOS 固件版本。

当前最新版本内核固件为 LuatOS-SoC_V1008_Air724UG.soc，发布日期 2026.8.11，在固件版本页面中点击下载链接即可获取，历史版本固件 SDK 仅用于对比测试，推荐使用最新版本。

使用 LuatOS-SoC 固件刷机时，需要注意以下几点：

  1. 需要使用 LuaTools 3.1.1 以上版本进行刷机；

  2. 第一次烧录 LuatOS-SoC 到 Air724UG 模组时，若模组当前固件是 AT 固件，可以直接烧录；

  3. 若原本是 LuatOS-Air 固件，需要通过 boot 按钮进入刷机模式，才能执行烧录。

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

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

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

脚本文件 包含两大部分：用户脚本文件和扩展库脚本文件：

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

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

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

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

Air724UG 的 demo 代码仓库地址：https://gitee.com/openLuat/LuatOS/tree/master/module/Air724/demo

2.4.1 只有用户脚本文件

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

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

2.4.2 有用户脚本和资源文件，使用默认扩展库脚本文件

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

2.4.3 只有用户脚本文件，使用自己指定的扩展库脚本文件

和 2.4.2 相比，扩展库脚本文件不再使用默认扩展库，而是使用用户指定的扩展库脚本文件。

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

2.5 LuatOS 开发工具大全

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

LuatOS开发工具大全 - 合宙模组资料中心

搜索