跳到主要内容

快速开始

概述​

YFAir8000 基于合宙 Air8000W 模组，使用 LuatOS 固件进行二次开发。环境搭建只需准备代码编辑器和合宙官方烧录工具即可，无需安装复杂的 SDK 和编译工具链。

声明

本 SDK 部分 Demo 源自合宙官方示例。

官方推荐

合宙官方推荐使用 AI 编辑器 Trae，可配置合宙 智能体服务，大幅提升开发效率。当然 VSCode 等任何能写 Lua 代码的编辑器也都可以使用。

准备工作​

1. 安装代码编辑器​

根据个人偏好选择任意代码编辑器即可，以下为常用选项：

  • Trae：合宙官方推荐，可直接集成合宙智能体
  • VSCode：通过 AI 插件（如 Copilot）同样可实现 AI 辅助编程
  • 其他任意能编辑文本的工具都可以

2. 安装合宙烧录工具​

合宙提供专用固件下载工具 Luatools，用于固件烧录、脚本下载和串口日志查看：

  1. 从 合宙文档中心 下载最新版 Luatools.exe
  2. 解压后直接运行，无需安装
  3. 通过 USB Type-C 连接开发板
系统要求

Luatools 仅支持 Windows 10 及以上系统，不支持 macOS 和 Linux。

固件烧录​

YFAir8000 使用 Air8000W 模组，需要烧录两个固件。

固件说明烧录方式
WiFi 固件Air8000W WiFi 和蓝牙 功能固件USB 升级 或 FOTA 远程升级
4G 固件LuatOS 4G基础运行时Luatools 一键下载烧录

1. 烧录 WiFi 固件​

WiFi 固件有两种升级方式，详见官方文档：Air8000 WiFi 固件升级指南

方式适用场景操作
USB 升级首次烧录 / 本地调试电脑通过 USB 线连接设备直接升级
FOTA 升级设备已部署在现场通过远程 OTA 方式升级

2. 烧录 4G 固件​

合宙提供了多个版本的 4G 固件，按位数（32位和64位）和功能划分：

文档链接
固件详情列表https://docs.openluat.com/air8000/luatos/firmware/
32位与64位固件差异https://docs.openluat.com/common/core_32_64/
烧录步骤https://docs.openluat.com/air8000/luatos/common/download/

官方示例 Demo​

合宙提供了极其丰富的 Air8000 示例代码，涵盖 GPIO、UART、I2C、WiFi、MQTT、Modbus、PWM、HTTP、WebSocket、SP、WDT、TF_Card、RTC、ADC 等等绝大多数常用功能：

👉 Air8000 Demo 仓库

本SDK部分demo参照并使用了合宙官方demo