无需开发板，在Windows上用LuatOS模拟器快速体验AirUI界面开发

最近合宙的AirUI在开发者圈子里热度很高，从DIY空气质量分析仪到Air8101畅玩板，各种炫酷的交互示例不断涌现，让人跃跃欲试。

很多刚接触的朋友可能会问：手头没有实体开发板，还能体验和学习AirUI吗？

答案是肯定的。LuatOS官方提供的PC模拟器，就是为解决“有想法但暂时没硬件”这个痛点而生的。它让你能在Windows电脑上直接运行和调试AirUI应用程序，无需烧录，效果立即可见。

这份快速上手指南，将带你从零开始，在电脑上跑起第一个AirUI界面。

一、LuatOS模拟器是什么？

LuatOS模拟器是一款能够在PC上运行LuatOS脚本的软件环境。它模拟了物联网设备的核心功能，包括联网控制、数据传输、UI交互以及文件系统操作等。你可以通过集成在Luatools工具内的入口一键启动，也可以将其作为独立程序使用。

与真机调试相比，模拟器的优势非常明显：无需反复烧录固件，就能快速验证UI效果和逻辑，并且运行速度通常更快。

需要注意一点：LuatOS模拟器目前仅支持有线网络（模拟网卡），不支持4G和Wi-Fi联网。如果你的代码涉及网络功能，可以通过判断运行环境来加载不同的驱动模块，让同一份代码自动适配模拟器与真机。

例如，可以使用以下Lua代码进行条件判断：

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是合宙官方提供的多功能调试工具，集成了最新固件获取、脚本打包、日志跟踪、单机烧录等功能。请注意，该工具目前仅支持Windows 10及以上操作系统。

下载地址：
https://docs.openluat.com/common/Luatools/

使用要点：
建议在电脑的某个根目录下（例如 D:\Luatools）单独创建一个文件夹来存放Luatools工具。直接双击运行下载好的 Luatools_v3.exe 即可。工具运行后会产生日志文件，存放在 log 文件夹内，你可以定期清理。更详细的使用说明可以参考上述下载地址中的官方文档。

三、获取LuatOS模拟器资源

打开Luatools工具，按照以下路径下载PC模拟器资源包。

操作步骤：

1. 点击顶部菜单栏的 【3 合宙各种资源入口】。
2. 在下拉菜单中选择 【3.3 离线资源下载】。
3. 在资源列表中，找到并勾选 【公共资源】→【LuatOS的PC模拟器】 下的最新版本（例如V2019）。
4. 点击右上角的 【开始下载(非刷机)】 按钮。

四、下载内核固件和示例脚本

你需要根据目标设备型号，从合宙资料中心下载对应的内核固件和示例脚本代码，为后续创建项目做准备。

这里以 Air8000A 型号为例：

• 内核固件下载地址：
  https://docs.openluat.com/air8000/luatos/firmware/
• 脚本代码（含AirUI示例）下载地址：
  https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/ui

从第二个链接下载的代码仓库中，就包含了丰富的AirUI演示示例，是我们体验的重点。

五、在Luatools中创建项目

接下来，我们在Luatools工具中创建一个项目，用于管理和运行AirUI脚本。

操作步骤：

1. 在Luatools工具首页，点击 【项目管理测试】 按钮。
2. 进入项目管理界面后，点击左下角的 【创建】 按钮。
3. 输入项目名称（例如“test”）并点击确定。
4. 在弹出的文件选择框中，定位并选择你在第四步中下载的内核固件文件（通常是一个 .soc 文件）。

六、如何找到模拟器

有两种方式可以启动LuatOS模拟器。

6.1 Luatools工具内置入口（推荐）
在 【项目管理测试】 界面，左下角就有一个 【模拟器运行】 按钮，这是最便捷的集成启动入口。

6.2 独立程序位置
模拟器也可以作为独立程序运行。它位于Luatools安装目录下的 resource/LuatOS_PC 文件夹中。

你也可以通过以下方式快速打开该目录：
在Luatools首页，点击 【3 合宙各种资源入口】→【3.3 离线资源下载】，选中已下载的PC模拟器版本，然后点击 【打开本地资源目录】。

进入对应版本的文件夹（例如 LuatOS-SoC_V2019_PC），你会看到 luatos-pc.exe 等可执行文件。双击 cmd 快捷方式可以快速打开命令行并定位到此路径。

七、使用模拟器运行AirUI示例脚本

现在，让我们用模拟器实际运行一个AirUI示例。推荐使用第一种集成方式。

7.1 使用Luatools集成的模拟器（推荐）
我们已经下载了LuatOS的代码仓库。假设我们要运行Air8000模块的单组件演示Demo，其路径为：
LuatOS\module\Air8000\demo\ui\airui\single

1. 在Luatools的项目管理界面，直接将整个 single 文件夹拖拽到右侧的 【脚本和资源列表】 区域。
   
2. 点击左下角的 【模拟器运行】 按钮。

稍等片刻，你将同时看到弹出的AirUI演示窗口和后台日志输出窗口，这表示你的AirUI界面已经在PC上成功运行起来了！

7.2 使用独立程序运行脚本
如果你选择使用独立程序，在按照 7.1 步骤将脚本加载到项目后，Luatools会在其安装目录的 project 文件夹下生成该项目的配置文件。

例如，创建的 test 项目会生成：C:\Luatools_v1\project\test.ini

然后，你可以通过命令行（在模拟器所在目录）执行：

luatos-pc.exe --llt=C:\Luatools_v1\project\test.ini

运行效果与集成方式一致。

结语

看到自己电脑上跑起一个完整的物联网设备UI界面，是不是很有成就感？通过LuatOS模拟器，你可以在没有硬件的情况下，高效地进行AirUI界面布局、交互逻辑的开发和调试，极大降低了学习和前期开发的门槛。

希望这篇指南能帮助你快速上手。关于模拟器中GPIO、UART等硬件接口的模拟调试方法，我们将在后续的文章中分享。如果你在云栈社区或其它技术论坛遇到了有趣的问题，也欢迎一起交流探讨。