跳转至

LuatOS 模拟器运行说明

作者：江访　|　最后修改：2026-03-31

一、概述

LuatOS 模拟器是一款支持运行 LuatOS 脚本的软件，具备联网控制、数据传输、UI 交互、文件系统操作等功能。与 LuatOS 嵌入式设备相比，无需烧录就能快速看到效果，运行效果一致且运行速度更快。该软件既可集成在 Luatools 工具内一键启动也可以作为独立程序使用。

对于 GPIO、UART、SPI、I2C 等通信接口，相关教程后续将逐步更新。

注意事项：

  • LuatOS 模拟器仅支持有线联网，不支持 4G 和 wifi 联网。若涉及到联网验证，我们可以使用以下方式进行判断，让代码自动匹配对应的程序。
if rtos.bsp() == "PC" then
   -- 加载“pc模拟器网卡”驱动模块
   require "netdrv_pc"
elseif rtos.bsp() ~= "Air8101" or rtos.bsp() ~= "Air1601"  then
   -- 加载“4G网卡”驱动模块
   require "netdrv_4g"
else
   -- 加载“wifi”驱动网卡
   require "netdrv_wifi"
end
  • 若遇到模拟器闪退，可能为所选的文件不存在，重新选择文件再运行模拟器即可

二、下载 Luatools 工具

LuatOS 模拟器是通过 Luatools 工具进行下载和更新，且主要运行方式也是在 Luatools 工具上，所以需要先下载 Luatools 工具

操作说明：

  • 点击下载：Luatools v3 下载调试工具

  • Luatools.exe下载后，单独创建一个文件夹放置 Luatools 安装包，然后再运行 Luatools 安装包

  • 后续 log 文件夹内的历史日志会随着 Luatools 工具的运行不断增加，可以找到此文件夹按需进行清理，详细使用可以查看 Luatools 工具使用说明

三、下载模拟器

打开Luatools，按以下路径获取模拟器（以v3.2.6界面为例）。

操作说明：

  • 点击顶部菜单 【3 合宙各种资源入口】；
  • 点击【3.3 离线资源下载】；
  • 勾选【公共资源】→【LuaOS的PC模拟器】最新版本；
  • 点击【开始下载(非刷机)】。

四、下载内核固件和脚本代码

本章节为以下章节做准备

  • 【五、 通过 Luatools 工具创建项目】

  • 【7.1 使用 Luatools 工具集成的模拟器加载和运行脚本】

  • 【7.2.1 指定文件夹运行脚本】

操作说明：

  1. 按 docs 文档中每个型号目录下的【固件和应用脚本 Demo】文档教程，下载内核固件和脚本代码，

  2. 以 Air8000 的固件和应用脚本 Demo 为例

  3. 通过 LuatOS 固件版本下载地址章节下载固件

  4. 通过二次开发 demo 章节下载脚本

五、 通过 Luatools 工具创建项目

本章节为以下章节做准备

  • 【7.1 使用 Luatools 工具集成的模拟器加载和运行脚本】

  • 章节【7.2.2 指定 Luatools 项目配置文件运行】

操作说明：

  • Luatools工具首页点击【项目管理测试】；

  • 进入项目管理测试后，点击左下角【创建】，

  • 输入并确定项目名；

  • 选择刚才通过上一章节【四、下载内核固件和脚本代码】下载的固件。

六、如何找到模拟器

可通过内置入口和独立程序两种方式，找到LuatOS模拟器。

6.1 Luatools工具内置入口

操作说明：

  • 【点击 Luatools 工具首页：项目管理测试】

  • 找到【左下角：模拟器运行】

如下图示（此时还缺少脚本程序 ）

6.2 LuatOS 模拟器独立程序位置

LuatOS 模拟器会在 Luatools 工具目录 resource/LuatOS_PC 文件夹下

也可以通过以下方式进入

  • 【进入：Luatools 工具首页】
  • 【点击上方：3 合宙各种资源入口】
  • 【点击:3.3 离线资源下载】**
  • 【点开：公共资源】
  • 【点开：LuaOS 的 PC 模拟器】
  • 【选择：最新版本】
  • 【点击右上方：打开本地资源目录】

  • 【打开：最新版本的文件夹】
  • 【双击 cmd】自动进入当前目录
  • 或在 电脑 cmd 中执行 cd 命令跳转至 luatos-pc.exe 所在文件路径，例如：cd D:\XXX\LuatOS-SoC_V2019_PC

七、使用 LuatOS 模拟器运行脚本

接下来使用LuatOS模拟器运行AirUI脚本，可以选择以下三种方式，推荐使用7.1方式。

7.1 使用 Luatools 工具集成的模拟器加载和运行脚本

  • 我们通过章节【四、下载内核固件和脚本代码】将 LuatOS 仓库代码下载了下来

  • 例如：运行 LuatOS\module\Air8000\demo\ui\airui\single 目录下脚本，该文件夹表示为 Air8000 模块下 airui 单组件演示 demo

  • 将整个 single 文件夹拖入至 Luatools 工具对应项目下的脚本和资源列表内

  • 【点击左下角：模拟器运行】，可以看到【UI 交互页面】和【日志输出界面】。没有 UI 界面的代码只会显示日志输出界面，不会显示 UI 交互界面窗口**

7.2 使用 LuatOS 模拟器独立程序加载和运行脚本

7.2.1 指定文件夹运行脚本

  • 我们通过章节【四、下载内核固件和脚本代码】将 LuatOS 仓库代码下载了下来

  • 通过章节【6.2 LuatOS 模拟器独立程序位置】说明打开 cmd 快捷方式

  • 例如：脚本文件在 C:\gitee\LuatOS\module\Air8000\demo\socket\client 目录、核心库文件在 C:\gitee\LuatOS\script\libs 目录

  • 脚本 netdrv_device.lua 中默认使用的是 require "netdrv_4g" 加载“4G 网卡”驱动模块，PC 模拟器中则需要改成 require "netdrv_pc" 加载“pc 模拟器网卡”驱动模块

  • 脚本 tcp_client_main.lua 中通过 require "libnet" 加载了 libnet 扩展库，则除了加载脚本文件夹还需要加载扩展库文件夹

  • 上述情况输入以下命令,按回车执行。luatos-pc.exe 执行所加载文件夹内的第一个 mian.lua 文件

luatos-pc.exe C:\gitee\LuatOS\module\Air8000\demo\socket\client\ C:\gitee\LuatOS\script\libs\
  • 运行效果

7.2.2 指定 Luatools 项目配置文件运行

  • 通过章节【6.2 LuatOS 模拟器独立程序位置】说明打开 cmd 快捷方式

  • 按章节【五、 通过 Luatools 工具创建项目】和按【7.1 使用 Luatools 工具集成的模拟

  • 器加载脚本】后，在 Luatools 工具安装目录下 project 文件夹内会有项目的启动文件

  • 例如：创建的 test 项目路径为 C:\Luatools_v1\project\test.ini

  • 输入命令，按回车执行

luatos-pc.exe  --llt=C:\Luatools_v1\project\test.ini
  • 运行效果