跳转至

默认出厂固件

作者：王城钧　|　最后修改：2026-10-19

一、默认出厂固件

本板有默认的出厂固件，包含每个功能对应的脚本；把拨码拨到 ON、插上 USB 线供电即可运行，不需要自己烧录。

  • 固件包下载：Air8101_Factory_001.999.001_LuatOS-SoC_V2020_Air8101B_106.soc；
  • 内核：Air8101 106 号固件（标识 LuatOS-SoC_V2020_Air8101B_106），理论 V2018 之后的 106 号固件都支持；
  • 平台：主控 Air8101B，出厂固件工程名（PROJECT）Air8101_Factory，版本（VERSION）001.999.001；
  • 分区：文件系统 4096KB、脚本区 512KB、可用 RAM 1.5MB。

106 号不是独立的固件包，而是 LuatOS-SoC_V20xx_Air8101 中按编号提供的"分区 + 库裁剪"配置；上面的出厂固件包已经把 106 号内核和出厂脚本打包在一起。烧成 101/102/104/105 号后，文件系统只剩 256KB~2.4MB，音频播放、TTS、录音也不可用。

1、最新版本固件

固件更新说明

  1. 第一版出厂固件：工程 Air8101_Factory，版本 001.999.001，配套内核 V2020 的 106 号固件；
  2. 出厂界面包含网络优先级、WiFi、温湿度、空气质量、音频播放、摄像头 6 个功能页，并默认接入合宙 IOT 平台上报温湿度、电压、VOC、GNSS 位置。

2、历史版本固件

固件更新说明

  1. 第一版出厂固件：工程 Air8101_Factory，版本 001.999.001，配套内核 V2020 的 106 号固件；
  2. 出厂界面包含网络优先级、WiFi、温湿度、空气质量、音频播放、摄像头 6 个功能页，并默认接入合宙 IOT 平台上报温湿度、电压、VOC、GNSS 位置。

各版本的完整更新记录、全部数字固件的功能对照表，见 固件和Demo。

二、源码链接

出厂固件的脚本基于 LuatOS Air8101 Demo 修改，各功能模块的参考代码在 LuatOS 仓库 module/Air8101 下：

脚本区只有 512KB，工程里不要放图片、音乐等大文件（音乐建议放 TF 卡或外挂 Flash），否则会报超出脚本区大小。需要把资源随脚本烧录时，注意 luadb 也占用脚本区空间。

更多软件资料见 软件开发资料-总体说明。

三、图文使用说明

1、界面框架

出厂固件使用 AirUI 做磁贴式界面：顶部状态条左侧显示时间、中间显示日期、右侧显示当前联网方式和本机 IP；中部为功能磁贴矩阵，点击磁贴进入对应详情页，详情页左上角「返回」回到首页。

首页共 6 个功能入口：网络优先级、WiFi、温湿度、空气质量、音频播放、摄像头。

首页

首页

2、上手流程

  1. 按下载和调试把 VBAT_Air8101 和总供电拨码拨到 ON；
  2. 插上 Type-C 供电，屏幕自动点亮并进入首页；
  3. 联网二选一：插网线（首页右上角显示以太网 IP，如图中 192.168.1.90），或在 WiFi 页选择热点连接；
  4. 按需接上配件板（温湿度传感器、空气质量传感器、摄像头、TF 卡、扬声器），对应拨码见电路和使用说明；
  5. 用 Luatools 查看日志，确认固件版本和运行状态。

3、分页说明

以下图片均为出厂固件实际界面。

3.1 首页

顶部左侧为大号时钟，中间为日期与星期，右侧为当前联网方式（以太网/WiFi）与本机 IP；下方磁贴为各功能入口，磁贴图标与名称对应功能模块。

3.2 WiFi

进入后自动扫描周边热点（截图为 9 个），列表显示信号强度（dBm）与加密状态：

  • 顶部显示「已保存热点」和「连接状态」，已连接时显示对端 IP；
  • 点击任意热点开始配网，连接成功后状态变绿；
  • 底部按钮：重新扫描 / 清除凭据 / 上一页 / 下一页（列表分页，如「1 / 2」）。

WiFi

3.3 温湿度（RS485）

通过板载 RS485 读取温湿度变送器（从站 1，寄存器 0x001E / 0x001F，串口参数 9600 8N1）：

  • 顶部显示「485 通信状态」和最近更新时间；
  • 中部两张卡片分别显示温度（℃）和湿度（%RH）；
  • 底部「立即读取」按钮手动触发一次采集。

温湿度

3.4 空气质量（I2C）

通过 I2C 读取 AGS02MA 空气质量传感器：

  • 从机地址 0x1A，页面显示 TVOC（ppb）、空气质量等级与折算 ppm；
  • 采集正常时每 5 秒自动刷新一次，也可点「立即读取」手动采集；
  • 「重新探测」用于重新扫描 I2C 上的传感器；「改用温湿度」可切换到温湿度传感器（两种传感器方案二选一）。

接线与参数（界面底部说明）：

  • 接线：VDD / GND / SCL / SDA，接板上 I2C 排针，SCL = GPIO38、SDA = GPIO39（与触摸同一条总线）；
  • AGS02MA 要求 I2C ≤ 30kHz，空气质量模式整条总线已自动降速；
  • 传感器上电需要预热 1~2 分钟，刚上电读数不准属正常现象。

空气质量

3.5 音频播放

  • 顶部显示播放状态，就绪后点击列表中的任意一首开始播放；
  • 底部「- / +」调节音量（截图为 40），右侧「停止」按钮结束播放；
  • 曲目来源是 TF 卡的 /sd 目录：未插卡时提示「TF 卡没挂上（/sd 不存在）；检查卡座、卡格式（FAT32）」；
  • 脚本区只有 512KB，音乐不要随脚本烧进 luadb；插卡后重新打开本页即可看到曲目列表。

音频播放

3.6 摄像头

  • 页面中部为取景/预览区，点击下方「拍照」抓取一帧；
  • 「存到 SD 卡」把当前照片保存到 TF 卡；「清除」清空预览。

摄像头

4、上云与运维

出厂固件默认接入合宙 IOT 平台，设备上报温度、湿度、电压、VOC、GNSS 位置等数据。

设备详情（网页端）

网址：web网页

  • 项目：8101开发板，设备 ID 与在线状态在顶部显示；
  • 右侧「概览」：最近上报时间、固件版本 001.999.001、开机时长与内存占用、实时数据（温度、湿度、CPU、VOC、信号、电压）；
  • 「历史数据」查看上报曲线，「控制」可下发指令，「位置」显示 GNSS 经纬度与地图位置。

合宙 IOT 设备详情

手机端（合宙 IOT）

手机上同样可以查看概览、历史数据与控制：归属项目、固件版本、模组型号、MAC 地址、温度、湿度、电压、4G 信号、GNSS 经纬度，以及腾讯地图上的设备位置。

合宙 IOT 手机端

说明：页面中的「固件版本」「模组型号」来自设备上报（Tag 1027 / 774），设备尚未上报时显示「暂未上报」，可在「控制 · 设备信息查询」中下发指令触发上报。

四、恢复出厂状态

开发板被改写过固件或脚本后，按以下步骤恢复到出厂状态：

  1. 用 Luatools 烧录出厂固件包 Air8101_Factory_001.999.001_LuatOS-SoC_V2020_Air8101B_106.soc（内核与出厂脚本一体包）；
  2. 烧录完成后断电重启，确认首页 6 个磁贴正常、能联网并上报到合宙 IOT 平台。

只烧 106 号固件不会清掉脚本，业务脚本仍在；要完全恢复出厂界面，需要同时重烧出厂脚本工程。

五、常见问题

现象 排查方向
上电不亮、无法启动 VBAT_Air8101 与总供电拨码是否拨到 ON
首页正常但没有 IP 网线未插好/路由器无 DHCP；或到 WiFi 页重新配网（仅支持 2.4GHz）
温湿度显示「485 离线」 打开 VBAT_485 拨码、GPIO52 拉高，传感器串口参数需为 9600 8N1、从站地址 1
空气质量读数为 0 或异常 上电预热 1~2 分钟；确认 SCL=GPIO38、SDA=GPIO39 接线；I2C 速率 ≤30kHz
音频页提示 TF 卡没挂上 检查卡座、卡格式是否为 FAT32；菜单里看不到曲目时重新进入本页
音频列表为空 音乐未放到 TF 卡 /sd 目录；不要塞进脚本 luadb（脚本区仅 512KB）
摄像头拍照黑屏 打开 VBAT_UVC 拨码、GPIO29 拉高，使用前先断电复位一次
平台显示离线 设备未联网或未上报；确认设备 ID 与项目归属，必要时在「控制」页下发查询指令
搜索