Air8605 默认出厂固件
特别说明
1、Air8605 主控平台为 Air1602，出厂固件是一套板级工程（桌面 UI + 音视频 + 文件管理 + 网络 + SIP 双向语音 + 串口外设），源码见 module/Air8605/factroy；按装配的联网模组不同，分为 W 版（Air6205A，WiFi） 与 M 版（Air780EX2，4G）；
2、通信模组的专用固件由合宙在出厂前配好，收到主板即可使用，正常使用无需烧录；下文列出的模组固件用于项目调试或版本升级；
3、M 版（4G）只有一份可烧的固件，即 Air8603_Air8605_4G_Air780EX2_001.999.000_LuatOS-SoC_V2054_Air780EX2_109.soc。板载 Air780EX2 采用整机适配配置，不能使用 Air780EX2 公版出厂固件，也不要尝试其他 4G 版本，刷错会导致 4G 无法联网；
4、主控、WiFi 模组、4G 模组与 Air1103 音频固件分别管理，需保持版本与协议兼容；固件与源码持续迭代，实际以源码仓库和合宙交付的最新版本为准。
型号说明（先分清 W 版与 M 版）
读固件说明前，先确认手里的板子是 W 版还是 M 版 —— 两版的界面与业务逻辑完全一致，只有联网模组、对应固件与联网配置不同，固件不可混用。
| 型号 | 联网模组 | 主控 | 需要烧的固件 | 天线（BOM 默认） |
|---|---|---|---|---|
| Air8605W | Air6205A（2.4 GHz WiFi 6 + BLE 5.4） | Air1602 | 主控整机固件 + Air6205A 模组固件，两个都可以烧，对象不同、互不替代 | IPEX 座 → IPEX 转 SMA 同轴线 → 外置 WiFi 天线 |
| Air8605M | Air780EX2（4G Cat.1） | Air1602 | 只有一份：Air8603 / Air8605 共用 4G 专用固件 | SMA 接头外置 4G 天线 + SIM 卡 |
- W 版：WiFi 由外挂的 Air6205A 从机模组提供，经 AirLink（UART3 或 SPI）与主控通信；模组不跑 Lua，只做无线透传。
- M 版：4G 由板载 Air780EX2 提供，另有 SIM 卡座与 RJ45 + CH390H 以太网扩展（由 4G 侧管理，无 PoE）。
- 两版的 SIP 音频链路（Air1103 + UART6）为共用设计，与联网方式无关。
一、最新版本固件
固件版本 001.999.006，内核 LuatOS-SoC V1030，项目版本 V000，屏幕 10 寸 1024×600（文件名标注为准，发布日期以合宙发布为准）。
1、Air8605W（WiFi）固件
W 版有两个固件对象，两个都可以烧，烧录位置不同，不能互相替代：
| 固件对象 | 固件文件（点击下载） | 烧到哪 | 用途 |
|---|---|---|---|
| 主控整机固件 | Engine_Air8605W_10inch_1024x600_000_WiFi_V000_001.999.006_LuatOS-SoC_V1030_Air1602_102.soc |
主控 Air1602（板载 USB 转 UART 口） | 脚本已打包进 .soc，界面与全部内置应用都在里面；恢复出厂、整机复制用这一份 |
| WiFi 模组专用固件 | netdrv_1.0.5_LuatOS-SoC_V1030_Air6205.soc（官方在线下载） |
Air6205A 模组（AirLink UART3 / SPI） | 出厂已配好，通常无需烧录；仅项目调试或升级模组版本时使用 |
只刷主控整机固件即可正常使用 —— Air6205A 出厂已是匹配版本。两份固件不是二选一的关系，而是分别管主控与 WiFi 模组两个对象。
1.1 Air6205A 模组固件版本信息
| 项 | 值 |
|---|---|
| 固件版本 | netdrv 1.0.5 / LuatOS-SoC V1030 / Air6205 |
| 发布日期 | 2026-09-16 |
| 文件大小 | 6,123,824 字节（约 5.8 MB） |
| 固件类型 | 打包量产固件，已内含 core + script（Air6205 未启用 Lua VM，不能跑 Lua 脚本） |
| 官方版本页 | Air6205 LuatOS 固件版本 |
| 归档位置 | ../product/图片和附件/，与 4G 专用固件同目录 |
固件更新说明（2026-09-16）：
- fix：airlink 从机 TX 池高水位阈值由 8KB 调整为 16KB，提前背压，避免 pbuf_alloc 失败；
- fix：上行队列满 / 内存不足时返回 ERR_MEM，让 lwIP 感知背压、TCP 降速重试，避免挤爆 SRAM；
- fix：修复空帧内存泄漏与扫描结果帧积压；
- fix：发送失败路径按 AIRLINK_MEM_TYPE 释放 cmd，修复错堆 free；
- fix：日志缓冲等待增加超时上限，防止 TX 中断停摆时调用者永久卡死。
⚠️ 官方 Air8605 产品资料 · 6.1 只说明「合宙为 Air6205A 提供与 Air8605W 匹配的专用固件，出厂前已完成配置」，未公布该专用版本的文件名。上表
netdrv_1.0.5_LuatOS-SoC_V1030_Air6205.soc是官方公开的 Air6205 模组量产固件，用于核对版本与调试参考，不要直接把它当作 Air8605W 专用固件刷入；确需升级时向合宙索取与本机 AirLink 通道（UART3 或 SPI）匹配的版本。官方 FAQ 亦明确 Air6205 出厂即最新固件、通常无需再烧录（FAQ 2026-10-08 · 87）。
1.2 板级对应与烧录注意事项
| 项 | 值 / 要求 |
|---|---|
| 通信方式 | AirLink，Air8605W 兼容 over UART3 与 over SPI；物理连接、选贴器件与固件配置必须一致 |
| 天线 | Air6205A 模组 IPEX 座 → IPEX 转 SMA 同轴线 → 外置 WiFi 天线（默认不使用 PCB 板载天线） |
| 下载通路 | 主控 USB 转 UART 数据口；步骤见 下载和调试 |
| Luatools 操作 | 烧模组固件时只点「下载固件」；不要在「项目资源管理」里同时选择 Air6205 固件 + 脚本，否则会烧录失败 |
| UART 限制 | 现有固件仅 U1_TX 支持 AirLink over UART；若需使用 U2_TX / U2_RX，须联系合宙申请定制固件 |
| 升级后验证 | 重新确认 AirLink 建链、获取 IP、WiFi 配网与联网状态（见下文「三、3 W 版 WiFi 联网」） |
2、Air8605M（4G）固件
M 版只有这一份可烧的固件，脚本已打包进固件，直接烧到板载 Air780EX2：
固件：Air8603_Air8605_4G_Air780EX2_001.999.000_LuatOS-SoC_V2054_Air780EX2_109.soc（官方在线下载）
| 项 | 值 |
|---|---|
| 适用整机 | Air8603 / Air8605（文件名同时包含两款，表示同一份固件适用于这两款整机的 4G 方案） |
| 项目版本 / 内核 | 001.999.000 / LuatOS-SoC V2054_Air780EX2_109 |
| 固件类型 | 打包固件，已包含脚本（109 号固件） |
| 归档位置 | ../product/图片和附件/ |
| 下载通路 | 4G 模组独立 USB 口（不是主控那个 USB 转 UART 口） |
固件更新说明（2026-10-16）：
- 初始固件：适用于 Air8603 / Air8605 整机的 4G 适配固件。
⚠️ 三点必须注意： 1. 不要用 Air780EX2 公版出厂固件替代，也不要尝试其他 4G 版本，刷错会导致 4G 无法联网； 2. 下载 4G 固件时必须保证电压稳定，电压波动可能导致烧录失败或固件异常； 3. 需要进入下载模式时，用 USB_BOOT 配合 RESET、PWRKEY（键位以原理图丝印为准）。
3、Air1103 音频固件
Air1103 是合宙自研语音芯片（UART6，内置 MIC / 喇叭 / AEC），固件由合宙在出厂前烧好，固件包不对外开放下载，用户不能自行用 Luatools 烧录；采购时需注明「已烧录最新固件」批次，后续升级通过板上预留的 Air1103 USBDM / USBDP + 复位测试点寄回合宙处理（参考 Air1103 固件烧录 FAQ）。因此本节不提供固件文件名。
板级参数（UART6 / 2M 波特率 / GPIO73 供电 / PCM_16000）、PCM 串口协议与 SIP 参数配置步骤见 下载和调试 · 3.3 Air1103 音频固件与 SIP 参数；SIP 服务器、账号、编解码、AEC 与按键参数集中在 SIP demo 的 config.lua，需与主控 SIP 应用配套。
二、源码链接
- 出厂固件工程：module/Air8605/factroy（开机 logo、桌面启动器、系统设置、网络管理、文件管理、音频、FOTA 等）
- 工程采用配置驱动架构，通过
main.lua中的PROJECT切换机型配置（LCD、TP 引脚、GPIO 上电时序与功能开关在config/下声明）；直接使用整机交付时烧上文的打包固件，需要二次开发时才导入源码工程 - 更多软件资料见 总体说明
三、图文使用说明
说明：本出厂固件为触摸屏图形界面。默认机型硬件为 RGB565 屏（40PIN / 50PIN）+ 电容触摸 + SIP 音频链路（Air1103 + 麦克风 + 扬声器 + 回采）+ SD 卡；联网能力按型号区分：W 版为 Air6205A（WiFi），M 版为 Air780EX2（4G）。具体界面与内置应用以实际交付固件版本为准。
1、硬件连接（两版通用）
先把屏幕、触摸 FPC、麦克风、扬声器、SD 卡（可选）、12V 电源接到 Air8605 上。接线定义见 电路和使用说明（在线文档 §10 接口与供电）。
上图为 M 版（可见 4G 天线馈线）；W 版同位置为 Air6205A 模组与 IPEX 转 SMA 同轴线。两者都要注意：
- W 版：IPEX 转 SMA 同轴线接到 SMA 接头后再拧外置 WiFi 天线，默认不用 PCB 板载天线；
- M 版：插好 SIM 卡，4G 天线拧在主板 SMA 座上（IPEX 为预留兼容设计，非默认连接方式）；
- 12V 适配器功率要覆盖屏背光 + 扬声器 + 外设峰值，4G 版还要留出 4G 发射的瞬时电流。
2、端口识别
用能传数据的 USB 线连接主控 USB 转 UART 数据口，打开设备管理器，驱动装好后应看到两个 USB 转串口端口（A / B 通道）：
- 两个端口分别对应打印与下载通道，Luatools 里选能被识别为板子的那个即可；
- 看不到端口时：先装 USB 转串口驱动，再换一根能传数据的线 / 换电脑 USB 口；
- 若出现「其他设备 → UART+SPI+I2C+JTAG」且带黄色感叹号，说明该路驱动未装，按板上实际芯片型号补装（本机为 CH347F）；
- M 版额外用第二根数据线连接 4G 模组独立 USB，会再多出一个端口，专门用于烧 4G 固件和查 4G 日志。
3、W 版 WiFi 联网
W 版的 Air6205A 专用固件已由合宙出厂前配好，主控固件烧好后按现场网络配网即可。进入「设置 → 网络设置」，网络类型显示 wifi_airlink_spi（或 wifi_airlink_uart），「是否 airlink」为「是」，当前状态为「已连接」：
点「WiFi 连接管理」→ 选热点 → 输入密码：
连接成功后可在「已保存 wifi / 附近的 wifi」里看到状态为「已连接」，信号强度以百分比显示：
连不上时先确认三件事：外置 WiFi 天线是否拧紧；现场是否为 2.4 GHz 网络（Air6205A 不支持 5 GHz）；AirLink 通道（UART3 或 SPI）与硬件选贴是否一致。
4、M 版 4G 固件烧录
M 版不提供脚本，只有一份 .soc。用 Luatools 打开 4G 模组独立 USB 对应的端口（识别为「4G模块USB串行设备」），先确认模块信息正常：
点「使用量产文件刷机」→ 选择 Air8603_Air8605_4G_Air780EX2_001.999.000_LuatOS-SoC_V2054_Air780EX2_109.soc → 下载，等待进度到 100%、提示「下载成功」：
烧录完成后确认 SIM 卡与 4G 天线接好，按 PWRKEY 开机。需要进入下载模式时，按住对应按键配合复位：
联网成功后，在「设置 → 网络设置 → 4G」页可看到网络类型 4g_airlink_uart、当前状态「已连接」：
5、开机与欢迎页（两版一致）
设备上电后，固件按以下顺序启动：平台检测与引脚上电 → 点亮屏幕并展示合宙 Logo → 延迟开启背光 → 触摸初始化 → 分批加载业务与 UI 模块 → 欢迎页播放开机动画 → 自动进入桌面。进入桌面后联网模块异步加载，网络未就绪时界面仍可正常使用。
6、桌面概览
开机动画结束后进入桌面，布局自上而下、自左而右分为四块：
- 顶部状态栏：问候语、系统时间、联网状态（WiFi / 4G 信号）、天气卡片；右侧为「资料中心」二维码；
- 左侧导航栏：「桌面」+ 设置、应用市场、文件管理、应用工厂、AI 助手、合宙网盘、功能测试等一级入口，点击即切换；
- 桌面视频播放区：可直接在桌面选片播放本地视频，底部按钮为「暂停 / 单次（循环）/ 选择 / 全屏」；
- 底部：「桌面」返回键。
7、设置界面
点「设置」进入设置主页，左侧为设置分类（IOT 账号、网络设置、亮度和声音、设置当前时间、主题风格、存储和内存、系统更新、数据上报、关于设置等），右侧「设备信息」可直接核对本机固件与硬件是否匹配：
排障时先看这一页：设备型号与固件版本是否与手里板子的型号一致，是判断「有没有刷错固件」最快的方法。
8、文件管理
点「文件管理」进入文件管理器，支持与 PC 互传文件（经 Luatools 日志口双向传输），以及浏览内置文件系统与 SD 卡目录：
9、音视频与本地素材
在桌面视频播放区点「选择」，可从「内置存储 / SD 卡 / 外置存储」中挑选视频文件（如 fruit.mp4），播放中可暂停、切换单次或循环、进入全屏：
轻量视频以软件解码、480×320、约 10 帧/秒作为方案参考；分辨率与码率过高会出现卡顿或音画不同步。
四、历史版本固件
| 版本 | 固件文件 | 更新说明 |
|---|---|---|
| 001.999.006（主控整机） | 同「一、最新版本固件」 | 初始固件：大屏 UI、文件管理、音频、联网与串口外设控制的基础板级工程 |
| 001.999.000（4G 专用） | 同「一、2」 | 初始 4G 适配固件，Air8603 / Air8605 共用 |
| Air6205 V1028（2026-08-12） | netdrv_1.0.5_LuatOS-SoC_V1028_Air6205.soc |
AirLink 链路超时按对端固件版本动态调整、修复 UART 反复 setup/close 的内存泄漏、HSPI/UART 双通道传输完善、从机补 2s 心跳保活 |
| Air6205 V1022（2026-04-23） | netdrv_1.0.5_LuatOS-SoC_V1022_Air6205.soc |
Air6205 第一版正式固件：通过 AirLink 作为外挂 WiFi 从机，支持 SPI / UART 两种通信模式（仅从机） |
五、烧录常见问题
| 现象 | 排查方向 |
|---|---|
| 设备管理器识别不到端口 | 装板载 USB 转串口驱动（本机 CH347F）；换能传数据的 USB 线；确认 12V 与板级供电开关 |
| 点下载没反应 / 提示找不到设备 | 确认串口选对并已「打开串口」；按 PWRKEY 或 BOOT + RESET 重新进入下载模式 |
| 烧录中途失败 | 12V 适配器功率不足，或外设大负载干扰；烧 4G 固件时电压波动最容易失败，改用稳定电源 |
| 4G 无法联网（M 版） | 确认烧的是 Air8603_Air8605_4G_Air780EX2_..._V2054_... 这一份；确认 SIM 卡、SMA 天线与 PWRKEY 开机 |
| WiFi 无法联网（W 版） | 确认 IPEX 转 SMA 同轴线与外置天线接好；确认为 2.4 GHz 网络；核对 AirLink 通道与硬件选贴一致 |
| 设置页型号与本机不符 | 刷错版本固件（W / M 弄混），按「一、最新版本固件」重刷对应 .soc |
六、相关文档
- 烧录调试、抓日志与产线量产：下载和调试
- 产品总体说明：Air8605 产品资料
- 引脚复用、端子与供电：总体说明、电路和使用说明（在线文档 §10 接口与供电）