Air8201G 开发套件 · 出厂固件开箱即用体验流程指引
适用对象：拿到 Air8201G 宠物定位器 PCBA + 扩展调试板开发套件、想直接开箱体验成品效果的客户
固件版本：出厂预烧 Air8201G-Turnkey（V001.999.006，Air780EGH 主控）
本文只讲"怎么用"，不涉及任何开发；开发指引见《Air8201G 开发套件 · LuatOS 二次开发流程指引》
一、这套出厂固件是什么
出厂固件把 Air8201G 的全部能力组合成了一个开箱即用的低功耗定位器，设备上电后自动运行，无需任何配置：
| 能力 | 出厂默认行为 |
|---|---|
| 4G 联网 | 插卡自动注册、自动获取 IP，全程保活 |
| 云端接入 | 自动连接 AirCloud（TCP 长连接 + 5 分钟心跳），开机即上报 |
| 定位 | 基站 LBS 定位（免费）每次上报前刷新；卫星 GNSS 定位每 30 分钟后台触发一次 |
| 震动检测 | DA267 加速度计检测震动，震动即触发一次立即上报（10 分钟冷却防抖） |
| 电池管理 | 电压检测、充电识别、低电（<3.4V）自动关机保护，全程低功耗常驻 |
| 按键 | 短按=手动上报一次；长按 7 秒=关机；再次短按开机 |
| 远程升级 | FOTA（开机 + 每 12 小时自动检测，自动下载重启） |
| 运维 | 异常日志自动上报云平台，便于远程定位问题 |
出厂默认未启用：蓝牙广播、计步、屏幕/喇叭等交互外设（如需请联系合宙定制固件）。
二、开箱清单与准备工作
2.1 套件组成（以实物包装为准）
| 项 | 说明 |
|---|---|
| 定位器 PCBA | 集成 Air8201G（Air780EGH 方案）的整机板 |
| 扩展调试板 | 开发调试底座，提供供电/串口/USB 等 |
| 连接排线 | PCBA 与调试板之间装配用（FPC/BTB） |
| 天线 | 4G 天线、GNSS 天线（按套件型号配置） |
2.2 用户自备
- 可上网 4G SIM 卡（小卡，需已激活且开通流量）
- 锂电池（3.7V–4.2V 量程）或直接使用调试板 USB 供电
- 一台可登录 AirCloud 云平台的设备（账号由合宙提供）
2.3 装配步骤
- 将定位器 PCBA 与扩展调试板按定位装配到位，插好 FPC/BTB 排线；
- 装入 SIM 卡（注意方向与卡座标识）；
- 接好 4G 天线（必须）；体验卫星定位时再接好 GNSS 天线并尽量靠近窗边/室外；
- 接电池，或用调试板 USB 口供电。
各型号（BLMQ / BQ / LM / 基础版）天线配置不同，详见 Air8201G 硬件资料。本版固件未启用蓝牙，无需接蓝牙天线。
三、首次上电（约 1 分钟）
- 上电开机：接入电池/USB 后设备一般自动上电；若处于关机态，短按一次 PWRKEY 开机。
- 观察指示灯：开机进入低功耗常驻时，红灯闪烁 3 次表示开机流程完成（这是整机唯一的可视状态提示）。
- 自动联网：SIM 卡正常时约 10–60 秒内完成 4G 注册与 AirCloud 连接（无需任何操作）。
- 云端见数据：登录 AirCloud 后台，看到该设备（按 IMEI 标识）上线并出现首条数据，即开箱成功。
无串口工具也能完整体验；如需看日志，用调试板/USB 连接电脑配合合宙 Luatools 查看（此环节属于调试，可选）。
四、指示灯与按键速查
| 操作 | 预期现象 |
|---|---|
| 上电/开机 | 红灯闪 3 次 → 进入低功耗常驻运行 |
| 短按 PWRKEY（<7 秒） | 红灯闪 3 次 → 触发一次立即上报（原因=MANUAL） |
| 长按 PWRKEY（≥7 秒） | 红灯闪 3 次 → 关机（保护性软关机） |
| 关机后再开机 | 短按 PWRKEY 即可 |
| 电池 ≤3.4V 且未充电 | 自动关机保护（红灯闪 3 次后关机） |
| 强制卫星定位键（WAKEUP0，调试板预留） | 立即强制 GNSS 定位并上报一次（原因=GPS_TRIGGER） |
指示灯仅红灯一种、无声音提示，设备状态以云端数据为准。按键/测试点位置以实物丝印为准。
五、云平台数据怎么看
5.1 数据节奏一览
| 上报类型 | 触发 | 间隔/规则 |
|---|---|---|
| 开机首报 | 上电连上云端后 | 自动 1 次（原因=PWRKEY） |
| 定时上报 | 自动 | 每 5 分钟一次（运动中/静止均一致） |
| 震动上报 | 震动触发 | 立即上报，10 分钟冷却内重复震动不再报 |
| 手动上报 | 短按 PWRKEY / 云端 GET_STATUS | 立即一次，不受冷却影响 |
| 强制定位上报 | 按强制定位键（WAKEUP0） | 强制 GNSS + 立即一次 |
| 心跳 | 自动 | 每 5 分钟一次（保持在线） |
| 卫星定位 | 自动/手动 | 每 30 分钟最多后台触发一次（单次最长 60 秒） |
5.2 上报字段含义（云端对应字段）
| 分类 | 字段 | 说明/示例 |
|---|---|---|
| 设备标识 | 设备号 DEVICE_ID | IMEI |
| SIM 卡号 | ICCID | |
| 元器件型号 | Air8201G | |
| 固件版本 | 底层 LuatOS 固件版本号 | |
| 开机信息 | 开机原因 | 0,0,0=正常上电；1,0,0=看门狗复位等（三位原因码） |
| 开机计数/重启次数 | 本次运行重启计数 + 累计重启统计 | |
| 网络 | 4G 信号强度 | 数值越大越好（CSQ） |
| 小区信息 | MCC/MNC/TAC/小区号/RSRP/RSRQ/SNR 等 | |
| 联网方式 | 4G 等 | |
| IP 类型 | IPv4 / IPv6 | |
| 电池 | 电量百分比 | 3.3V≈0%，4.15V≈100% |
| 电池电压 | mV | |
| 充电状态 | USB/VBUS 接入判定（充电中） | |
| 环境 | 温度 | ℃（芯片/环境温度） |
| 定位 | 经纬度 | 十进制小数（如 31.123456,121.654321） |
| 定位方式 | GNSS（卫星）或 LBS（基站） |
|
| GNSS 详情 | 速度、航向、海拔、卫星数（仅 GNSS 定位成功时有） | |
| GNSS 摘要字段 | 定位成功=lat,lng；定位失败=0.000000,0.000000；本次未触发=SKIP |
|
| 业务 | 上报原因 | PWRKEY/TIMER/MOTION/MANUAL/GPS_TRIGGER |
| 业务流水号 | 每次业务上报递增 | |
| 在线时长 | 本次开机累计在线分钟数 | |
| 运维统计 | 心跳总数/断连/断网/重启/上电时间 | 用于健康度监控 |
字段为设备实际上报内容；具体展示位置与中文字段名以合宙 AirCloud 后台为准。
六、功能体验演示（给客户演示/自测）
6.1 常规定位演示（室内）
设备放桌面静止观察：每 5 分钟 在后台看到一条数据；室内默认是基站 LBS 定位，精度为小区级（几十米~几百米），正常现象。
6.2 震动触发演示
拿起设备晃动或轻拍：震动传感器（DA267）检测到后，若距上次震动上报超过 10 分钟，会立即上报一条（原因=MOTION）；随后 10 分钟内再晃不会重复上报（冷却防抖，属正常省电设计）。
6.3 卫星定位演示（室外）
到室外开阔地等待 GNSS：设备每 30 分钟会自动尝试一次卫星定位（单次最长 60 秒，冷启动首星可能需要 30–60 秒）；定位成功后数据里出现经纬度 + 定位方式=GNSS + 速度/航向/卫星数。想立即看效果，可按调试板预留的强制定位键（WAKEUP0），立即触发 GNSS 并上报。
6.4 按键与手动上报演示
- 短按 PWRKEY：红灯闪 3 次 → 云端立即多一条数据（原因=
MANUAL），不受震动冷却限制； - 长按 7 秒：红灯闪 3 次后关机，整机断电休眠；再短按开机。
6.5 充电与低电演示
插入 USB 充电：设备识别 VBUS 进入充电；云平台可见电量百分比上升；若电压低于 3.4V 且未在充电，设备会自动关机保护电池。
6.6 远程控制演示（云端操作）
| 云端指令 | 设备行为 |
|---|---|
| 查询/GET_STATUS | 立即上报一次当前状态 |
| RESET_FACTORY | 设备重启 |
| 其他（配置下发、模式切换等） | 本版出厂固件为单模式常驻设计，相关指令会被忽略（属正常） |
6.7 远程升级演示（合宙代管）
合宙在 IoT 平台按 IMEI 发布新固件后：设备开机或每 12 小时自动检测 → 自动下载 → 自动重启进入新版本。此流程出厂默认由合宙代管，客户无需操作。
七、常见问题（开箱向）
Q1 上电没反应 / 红灯不闪？ 检查电池是否有电/接线、USB 是否供电；关机态需短按 PWRKEY 开机；确认 4G 天线已接。
Q2 云端看不到设备？ 核对设备 IMEI 是否在合宙开通的出厂项目内、账号权限是否正确；SIM 卡需已激活并开通流量；等待 1–2 个心跳周期再看。
Q3 一直只有基站定位，没有卫星经纬度？ 室内属正常——GNSS 需室外开阔环境且每 30 分钟才自动尝试一次；可用调试板"强制定位键"（WAKEUP0）立即触发一次。
Q4 数据里经纬度为 0.000000,0.000000？
代表本次 GNSS 定位尝试失败（无遮挡的室外空旷处会明显改善）；SKIP 代表本次上报未到 GNSS 触发点，均属正常取值约定。
Q5 晃动设备没有立刻上报？ 大概率处于 10 分钟震动冷却期（防频繁震动耗电）；也可能是震动幅度未达阈值，可加大幅度再试。冷却期的意义就是"真晃也不怕耗电"。
Q6 蓝牙搜不到设备？ 正常。本出厂固件默认未启用蓝牙广播；如需 BLE 近距离交互能力请联系合宙定制。
Q7 按键短按/长按没反应？ 确认按键为 PWRKEY 本体；短按与长按以 7 秒为界，长按松手过早会按短按处理。
Q8 想立即让设备上报一次怎么最快？ 短按一次 PWRKEY（红灯闪 3 次即触发，无需等 5 分钟定时）。
八、注意事项
- 本固件为单工作模式（低功耗常驻）定位器基线：无寻宠/智能等多模式切换、无计步、无 BLE，交互形态以定位+震动+上报为核心；
- AirCloud 后台账号、项目与设备绑定由合宙提供与维护；商用参数（上报周期、定位策略、项目密钥等）可向合宙申请定制固件调整；
- 部分按键/测试点（PWRKEY、强制定位键 WAKEUP0、USB 调试开关等）以开发套件实物丝印与配套说明为准；
- 需要在此固件基础上做功能改动（接自己的服务器、改上报策略、开启 BLE 等），请转读《LuatOS 二次开发流程指引》。
九、配套资料
- Air8201G 硬件资料（型号差异、天线与调试板要求）
- Air8201 系列产品介绍（定位场景与云端/量产服务）
- Air780EGH LuatOS 固件与 Demo（底层固件资料）