默认出厂固件

本文介绍 Air8780 默认出厂固件的资源与使用。

一、默认出厂固件

Air8780 基于合宙 4G 模组 Air780 系列开发，不同型号板载不同的 Air780 模组，需使用对应型号的出厂固件。

1、最新版本固件

版本：001.001.002（P / G / H / N / S / U 内核 LuatOS-SoC_V2054，V 内核 LuatOS-SoC_V2052）

型号	固件（.soc）	下载
Air8780P	Air8780P_001.001.002_LuatOS-SoC_V2054_Air780EPM_110.soc	下载
Air8780G	Air8780G_001.001.002_LuatOS-SoC_V2054_Air780EGP_110.soc	下载
Air8780H	Air8780H_001.001.002_LuatOS-SoC_V2054_Air780EHM_1.soc	下载
Air8780N	Air8780N_001.001.002_LuatOS-SoC_V2054_Air780EHN_1.soc	下载
Air8780S	Air8780S_001.001.002_LuatOS-SoC_V2054_Air780EGG_1.soc	下载
Air8780U	Air8780U_001.001.002_LuatOS-SoC_V2054_Air780EHU_1.soc	下载
Air8780V	Air8780V_001.001.002_LuatOS-SoC_V2052_Air780EHV_13.soc	下载

固件更新说明：

P / G / H / N / S / U 内核升级至 LuatOS-SoC_V2054，固件版本升级至 001.001.002

2、历史版本固件

历史出厂固件按版本号归档，可在以下目录中按需选取（仅限对比测试使用，推荐使用最新版本）：

二、源码链接

Air8780 出厂固件源码（Gitee）：

https://gitee.com/openLuat/LuatOS/tree/master/module/Air8780/project/factory

三、视频教程

Air8780 出厂固件视频教程

四、图文使用说明

Air8780 系列板载的 Air780 模组不同，使用场景也不同，下面按场景分别说明：通用场景（Air8780P / Air8780H / Air8780N / Air8780U）、定位场景（Air8780G / Air8780S）、音频场景（Air8780V）。

1、通用场景（Air8780P / Air8780H / Air8780N / Air8780U）

Air8780P、Air8780H、Air8780N、Air8780U 分别板载 Air780EPM、Air780EHM、Air780EHN、Air780EHU 模组，使用方式一致，下面统一说明。

① 产品连接说明

Air8780 为工业模组，板边采用半孔（邮票孔）封装，可直接贴片焊接到用户主板；板载 Type-C USB 接口、SIM 卡座与 BOOT 按键，通过一根 USB 线即可完成固件下载与调试。需要注意的是，P4 / G4 等版本板上没有 DCDC 电源，必须通过 VBAT 供电才可稳定调试。

Air8780 工业模组

下图左侧为 Air8780P（板载 Air780EPM 模组）、右侧为 Air8780H（板载 Air780EHM 模组）：

Air8780P 与 Air8780H

板上预留了 PH2.0 母座，外设可直接对插，例如外接喇叭：

Air8780 通过 PH2.0 母座外接喇叭

详细的接线与下载模式说明见下载和调试。

出厂固件通过 I2C 接口外接传感器，可搭配合宙标准配件 AirSHT30_1000 温湿度传感器与 AirVOC_1000 气体传感器，管脚连接如下（四个型号相同）：

信号	设备管脚	AirSHT30_1000	AirVOC_1000
SDA	PIN34（I2C1_SDA / GPIO19）	SDA	SDA
SCL	PIN35（I2C1_SCL / GPIO18）	SCL	SCL
3.3V	PIN10（3.3V，最大 300mA）	3V3	3V3
GND	PIN11	GND	GND

注意：I2C1 的 SDA/SCL 需做好上拉，电平需与外设匹配。

② 设备归属

查看上报数据前，需先把设备归属到自己的合宙 IoT 账号下。根据购买渠道不同，操作略有差异（电商 / 线下 / 第三方等），具体步骤见：设备如何归属到自己账号名下

③ 查看上报数据

设备正常联网后，采集到的传感器数据会自动上报到合宙设备管理平台。在浏览器中打开平台地址并使用已归属设备的合宙 IoT 账号登录，即可在线查看实时数据、历史数据：

https://iot.luatos.com/ai_app/luatos/General_data_query/index.html

第一步：在设备管理中检索设备

登录后先在页面左上角的项目下拉框中选择设备归属的项目（例如 test1），点击左侧「设备管理」，在搜索框中输入设备外壳标签上的 IMEI 号（例如 864317083931496）进行检索，即可找到对应的设备卡片。卡片上会实时显示设备的在线状态、最近上报时间以及温度、湿度、信号强度等数据。

设备管理-检索设备

第二步：在详情中查看实时数据

点击设备卡片上的「详情」按钮，右侧弹出设备详情面板，默认显示「概览」页，可查看设备名称、归属项目、在线状态、最近上报时间，以及温度、湿度、CPU、VOC、信号强度等实时数据，带定位的设备还会显示当前位置。

设备详情-实时数据

第三步：查看历史数据

在详情面板中切换到「历史数据」标签，选择时间范围后点击「查询」，即以表格形式列出该时间段内的全部上报记录，包含时间、温度、湿度、CPU、VOC、信号、经度、纬度等字段，便于回溯设备的运行与环境变化情况。

历史数据查询

第四步：在微信小程序中查看数据

除网页端外，也可通过微信小程序随时随地查看设备数据。在微信中搜索小程序「合宙IOT」，登录并选择设备所在项目（例如 test1）后，按以下步骤操作：

在设备页搜索框中输入 IMEI 号（例如 864317083931496），即可找到在线的设备卡片，卡片上显示温度、4G 信号、最近定位位置与上报时间。

小程序-搜索设备

点击「查看详情 / 控制」进入设备详情，在「概览」页可查看归属项目、模组型号（Air8780），以及温度、湿度、CPU、4G 信号、GNSS 经纬度等上报数据。

小程序-查看设备概览

在概览页下方的「设备位置」区域，可在腾讯地图（GCJ-02）上查看设备位置，并给出 GCJ-02 与 WGS84 两套经纬度坐标。

小程序-查看设备位置

切换到「历史数据」页，可查看温度等数据的变化曲线，并按时间逐条查看历史上报记录（含上报协议）。

小程序-历史数据

2、定位场景（Air8780G / Air8780S）

Air8780G、Air8780S 板载的 Air780EGP / Air780EGG 支持 GNSS 定位，出厂固件默认把定位数据上报到合宙设备管理平台，定位数据的查看方式与合宙定位器方案 Air8202 一致。

第一步：设备归属

查看数据前，需先把设备归属到自己的合宙 IoT 账号下。根据购买渠道不同，操作略有差异（电商 / 线下 / 第三方等），具体步骤见：设备如何归属到自己账号名下

第二步：在设备管理中查看实时位置

设备正常联网后，定位数据会自动上报。在浏览器打开合宙设备管理平台，使用已归属设备的合宙 IoT 账号登录：

https://iot.luatos.com/ai_app/luatos/General_data_query/index.html

在「设备管理」中按 IMEI 检索设备（例如 864317081866256），卡片上会显示在线状态、温度、湿度与信号强度；点击「详情」，在概览页的「位置」区域可看到当前定位地址与 GCJ-02 经纬度。

设备详情-查看实时位置

第三步：在位置地图中查看定位

点击左侧「位置地图」，在左上角搜索框中输入 IMEI 检索设备，地图上会显示设备的定位标注；按「全部 / 在线 / 警告 / 离线 / 失联 / 有定位」等状态还可快速筛选。

位置地图-查看定位

第四步：查看历史定位数据

在设备详情面板中切换到「历史数据」标签，选择时间范围后点击「查询」，即以表格形式列出该时间段内的全部上报记录，每条记录都带有经度、纬度坐标，便于回溯设备的历史位置。

历史定位数据

定位固件的工作模式、上报频率、上报内容、基站定位策略等完整说明，可参考 Air8202 固件文档：Air8202 默认出厂固件。

3、音频场景（Air8780V / Air780EHV）

Air8780V 板载 Air780EHV 模组，模组内置 Audio Codec，并板载音频 PA、驻极体 Mic 与 PH2.0 母座，可直接外接喇叭和麦克风做音频播放、TTS 与录音。

硬件连接

板载音频 PA，支持 8Ω / 2W 喇叭，喇叭两根线接 SPK 母座（模组侧 PIN5 / SPK+、PIN6 / SPK-）：

板载音频 PA 与喇叭

板载驻极体 Mic（HMB-O60G30-CW1），接 MIC 母座（模组侧 PIN3 / MIC+、PIN4 / MIC-），Mic 与 Speaker 母座间距均为 PH2.0：

Mic/Speaker PH2.0 母座

音频部分在 PCB 上的位置：

音频部分 PCB 位置

GPIO22（gpio.AUDIOPA_EN）已连接板载 PA 使能，GPIO20 控制内部 Codec 电源；由软件控制 PA 开关可抑制上电 POP 音。

软件调用（exaudio 库）

local exaudio = require "exaudio"

exaudio.setup({
    model     = "es8311",
    i2c_id    = 0,
    dac_delay = 6,                       -- 固件 >= V2026 填 6（100ms 单位），旧固件填 600
    pa_ctrl   = gpio.AUDIOPA_EN,         -- GPIO22，板载 PA 使能
    dac_ctrl  = 20,                      -- GPIO20，内部 Codec 电源
})

-- 播放本地音频文件
exaudio.play_start({type = 0, content = "/luadb/sample.mp3"})

-- 中文 TTS 合成播放
-- exaudio.play_start({type = 1, content = "欢迎使用 LuatOS 音频系统"})

-- AMR 录音 5 秒
-- exaudio.mic_vol(60)
-- exaudio.record_start({format = exaudio.AMR_NB, time = 5, path = "/record.amr"})

完整的文件播放、TTS、AMR/PCM 录音等示例与常见问题，见 Air780EHV 音频教程：Air780EHV 音频使用说明，API 见 exaudio 库手册。

平台远程播放 TTS（无需写代码）

除了在代码里调用 exaudio，也可以直接在设备管理平台上远程下发文字，让设备实时合成并播报。

第一步：在设备管理中检索设备

点击左侧「设备管理」，先在页面左上角选择设备归属的项目，在搜索框中输入设备外壳标签上的 IMEI 号（例如 864317080364287）进行检索，找到在线的设备后点击「详情」。

设备管理-检索设备

第二步：在「控制」页下发 TTS

在设备详情面板中切换到「控制」标签，找到「语音播报（TTS）」区域，在输入框中填写要播报的内容（例如「上海合宙欢迎你」），点击「发送播报」。提示「已提交，等待设备响应」后，设备即会通过外接喇叭实时朗读该文字。

控制-发送 TTS 播报

烧录调试：下载和调试
产品总体说明：Air8780 系列工业模组使用手册