Air8202系列工业模组使用手册

作者：laolu　|　最后修改：2026-09-07

Air8202系列工业模组使用手册-飞书文档版

Air8202系列工业模组使用手册-飞书文档版,点击查看

一，如何开机？

1，电池供电；

当USB充电线没有插入，只有电池供电时，需注意如何使用拨码开关开机；

微信图片_20260904112143_355_364.jpg

2，USB充电线插入时；

当USB充电线插入时：

1）当拨码开关朝上拨时，Air8202C开机，充电器给锂电池充电；

2）当拨码开关朝下拨时，Air8202C开机，充电器不给锂电池充电；

说明！

无论拨码开关朝上还是朝下，无论锂电池是否在位，只要插入USB充电线，Air8202C都可以开机运行；

二，如何查看位置？

1，Air8202 PCBA；

如果你购买的是Air8202C或Air8202G PCBA，也就是没有电池和外壳的板子，我们假定你对如下基本知识已经掌握：
LuaTools下载调试工具，https://docs.openluat.com/common/Luatools/ ；
合宙IoT系统的账号概念，https://iot.openluat.com/cloud/main ；
IMEI归属到自己账号下，https://docs.openluat.com/air780epm/product/attributioniot/ ；
通过模组丝印，或者LuaTools，获取Air8202的IMEI，并将其归属在自己的IoT账号下；
登录 move.luatos.com 或者合宙IoT 小程序，便可查看自己账号下的设备了；

2，Air8202 整机；

Air8202整机，可以像处理Air8202 PCBA一样处理；
后续，我们会在Air8202上张贴一张二维码；
第一步，微信扫码调出合宙IoT小程序；
第二步，登录个人IoT账号，或者注册新账号；
第三步，合宙IoT小程序再扫码绑定该设备；
绑定设备之后，就可以通过合宙IoT 小程序或者 move.luatos.com 查看自己账号下的设备了；

三，出厂固件；

1，特别说明；

绝大部分的用户，都不需要关心固件的问题，因为Air8202在出厂时已经内置好了固件；
即便出厂时内置的固件不是最新版本，我们也会安排自动更新到彼时最新的固件版本；
下面针对固件的介绍，仅仅是针对开发者这个用户群体的，大部分用户只需要使用，或者只需要关注更符合自己场景需要的、更佳用户体验的Web前端的设计即可；

2，最新固件；

模组：Air780EGG；

固件，在写这篇文档时的版本号为：Air8202_004.000.038_LuatOS-SoC_V2050_Air780EGG_113

说明！

固件会根据不同阶段对应用场景的不同理解进行及时迭代，所以有可能在你使用时此版本已非最新版本，请根据下面源码地址中的源码随时更新；

Air8202_004.000.038_LuatOS-SoC_V2050_Air780EGG_113.soc

3，源码地址；

https://gitee.com/openLuat/LuatOS/tree/master/module/iRTU/irtu-8202G-smart-nocfg

4，固件定义

在合宙 iRTU 固件的基础上修改，无需通过iRTU配置平台，默认上报合宙AirCloud云平台；

4.1 设备的模式

设备只有两种模式：GPS开和GPS关。

如下两个条件，只要任意一个成立，都是GPS开的模式：

（1）刚开机5分钟内；

（2）180秒钟内必有震动；

如上两个条件都不成立，也就是说30秒钟内都静默，并且是在开机5分钟之后，就进入GPS关闭模式了。

4.2 上报频率

（1）GPS开的模式，10秒钟上报一次；

（2）GPS关的模式，5分钟上报一次。

4.3 上报内容

1，每次上报都上报经纬度，gsensor 的xyz 三个原始数值，还有电量，信号等其他的值。

2，在 GNSS开启状态，上报内容如下：

（1）每秒一次的GNSS数据，一共10次，包括经纬度，角度，速度，海拔。

数据格式为：经度，维度，速度，角度，海拔，按照这个次序，每个数据4字节。

TLV 1294, BINARY, 长度 = 样本数 × 10 字节（满包 100 字节，时间正序）

每个样本 10 字节，5 个 int16 大端，顺序：经度差、纬度差、速度、航向、海拔

├── 经度差 = (样本经度 − 本包512值) × 100000 → 还原：经度 = 512值 + dlng/100000

├── 纬度差 = (样本纬度 − 本包513值) × 100000 → 还原：纬度 = 513值 + dlat/100000

├── 速度 = km/h × 10（RMC 节值 × 1.852 换算）

├── 航向 = 度 × 10（北向起顺时针，静止时不可信）

└── 海拔 = 米

经纬度为什么是差值：绝对经度 ±180° 塞进 int16 只有约 600m/LSB 的分辨率，完全不可用；改成相对本包 512/513 坐标的差值 ×100000 后，分辨率 1LSB≈1.1m、范围 ±0.33°（±36km），10 秒内的车辆位移绰绰有余，服务端拿报文经纬度一加即还原每秒绝对坐标。

（2）每秒20次的gsensor原始数据，xyz每次各12bit，10秒钟200个抽样，一共900字节。

数据格式为: 每秒按照时间次序，每秒中采样20次，每次按照xyz三个次序，x轴12bit，y轴12bit，z轴12bit，取值范围是-2048到2047之间，通过pack函数压到字节数组。

3，在GNSS关闭状态，上报内容如下：

（1）5分钟一次的数据，包括最近的经纬度，电量，信号强度等。

（2）5分钟一次的gsensor数据。

4.4 室内和室外的处理

设备不关心是在室内还是室外。

4.5 基站定位怎么用

只要GPS成功定位一次后，就作废基站定位，永远采用最后一次的gps定位数据。

在GPS定位成功之前，上报的位置，采用基站定位的经纬度。

4.6 LED 的定义

1，两个颜色的灯的分工：绿灯负责指示网络状态，黄色负责指示充电状态；

2，黄灯状态：

充电中，常亮；

充满电，闪烁，600ms亮，400ms灭；

充电器不在位：不亮。

3，绿灯状态：

（1）开机后，绿灯闪烁，200ms开，200ms关，持续20秒钟；

（2）收到服务器第一个下行任何消息，停止闪烁，改为常亮，并持续1分钟后关闭；

（3）从GNSS关到GNSS开的状态切换，灯常亮10秒钟；

4.7 关于震动灵敏度的设定

当前的震动灵敏度设定，使得小轿车行驶在平稳的路面，也会时不时触发震动，使得GNSS不会关闭；

同时，设定的又不是极度灵敏，在车静止的时候，180秒钟后会关闭GNSS。

4.8 充电电流

8202 采用 2000mAh 的18500 电池，充电电流配置为默认的 500mA；

4.9 每秒25hz 的gsensor 原始数据

在GNSS开启的情况下，上报25hz，也就是5秒钟125个抽样点的gsensor 原始数据，方便后台和前端做算法的计算。

4.10 运维日志

1，打开库内日志：create.lua 的 setup_params 里加一行 aircloud_mtn_log_enabled = true

（注意 820 行那条“收到运维日志上传请求”也会随之写入，上传测试时日志文件自身会多一条记录，属正常现象）

2，业务侧埋点，在如下事件写入mtn log：

(1)看门狗复位触发；

(2)GNSS 开关切换；

(3)1293 上报异常；

(4)socket 异常；

(5)向服务器上报成功或者失败，但是不记录长报文，免得日志过长；

(6)收到服务器下发的报文如实记录。

四，重要说明！

1，关于型号规划；

	模组	贴片SIM卡	光敏电阻	SIM卡座
Air8202C	Air780EGG	✅	❌	❌
Air8202G	Air780EGG	✅	✅	❌

2，关于板载模组；

Air8202C和Air8202G，板载模组已从Air780EGP更新为Air780EGG；

Air780EGP，Flash 4MB+RAM 4MB，内置G-Sensor；

Air780EGG，Flash 8MB+RAM 8MB，内置G-Sensor；

相关模组资料：https://docs.openluat.com/air780egh/product/ ；

当前部分资料中仍然为Air780EGP的图片介绍，我们会尽快改正，但从2026年8月27日起，所有发货的Air8202都已实际更改为Air780EGG，请特别注意；

3，关于贴片SIM卡；

无论Air8202C还是Air8202G，后续都将只支持贴片SIM卡，默认100M/月，不再支持SIM卡座；

4，关于SIM卡座；

无论Air8202C还是Air8202G，后续都将只支持贴片SIM卡，默认100M/月，不再支持SIM卡座；

5，关于最终型号统一；

在Air8202G上市之后，Air8202C将不再供应，统一由Air8202G替代Air8202C；
Air8202G相对Air8202C增加了光敏电阻检测，可以用于防拆或掀盖监测等场景，但不影响任何Air8202C实现的功能；

6，关于年费；

年费18元，包含如下服务；

100M*12个月的年流量；
1G容量云端存储；
200万条报文；
LBS(基站/WiFi)定位；
Web后台连接免费用；

7，关于Web前端订制；

订制前提：功能需求描述清晰，或有竞品可供参考；
订制费用：500元；

五，产品介绍；

Air8202C

Air8202C，相对Air8202G，不支持光敏电阻防拆检测；

Air8202G

Air8202G，相对Air8202C，增加支持光敏电阻防拆检测；

Air8202是一款基于Air780EGG设计的定位器方案，设计目标是：功能符合直觉，性能超越预期；

说人话就是：用着简单，用着更爽；
Air8202的产品定义，核心特点如下；

1) 支持4G和GNSS定位，空旷环境下定位精度在2-3米；

2) 支持板载GNSS陶瓷天线，板载4G贴片天线；

3) 支持4.2V和4.35V电池类型灵活充电控制；

4) 支持软件控制断电模式，出厂电池安装好无压力；

5) 支持光敏电阻焊接，防拆模式随时上报状态；(仅Air8202G支持)

6) 较小尺寸22mm*50mm，带三个定位孔，方便固定；

7) 只适合电池供电和塑料外壳，不适合铁质外壳，不支持大于4.35V 的外部电源供电；
搭配合宙iRTU固件，iRTU配置后台，合宙云AirCloud，合宙定位小程序，真正实现软件免开发；

关于iRTU相关介绍，请点击了解；

https://docs.openluat.com/value/irtu/state/
Air8202原理图完全公开，PCB不公开；

原理图公开是为了调试方便，PCB不公开是为了让大家更关注产品本身，而不是关注在技术实现的细枝末节上；

Air8202_V1_20260825_2250.pdf

合宙Air8xxx系列工业模组，面向不同的应用场景，各有专长；

产品系列	说明
Air8780系列	以Air780系列模组为基础，将SIM卡、电源、USB下载、天线、音频等电路集成板载，并留出最常用的信号管脚，可插针型号，可邮票孔焊接形式，可二次过炉批量生产
---	---
Air8781系列	体积最小、方便烧录、集成SIM卡座、外接IPEX天线、成本最优的串口小板
Air8782系列	在Air8781的基础上，扩展支持485/232/UART等通信接口
Air8700系列	使用Air700系列模组，搭配SIM卡座和IPEX天线座子，通过邮票孔引出所有模组管脚
Air8702系列	使用Air700系列模组，扩展支持485/232/UART通信接口，同时支持硬件看门狗/IPEX天线接口及上电开机等
Air8783系列	使用Air780ER2模组，支持USB RNDIS上网，适用于Linux/Windows系统主控，同时支持短信转发到企微飞书
Air8700系列	使用Air700系列模组，搭配SIM卡座和IPEX天线座子，通过邮票孔引出所有模组管脚
Air8201系列	适用于宠物定位器的PCBA，集成了通信、定位、G-Sensor、气压传感器、充电管理等电路，可直接用于量产
Air8202系列	集中在锂电池供电的场景，支持板载4G天线和GNSS天线，支持锂电池充电管理和贴片卡/SIM卡兼容
Air8203系列	集中在工业应用场景，兼容不同国家和地区，适用于金属外壳，可支持4G/GNSS/BLE/音频等差异化组合功能
Air8300	支持双网口、4G、WiFi、双485等接口大PCBA，可直接用于量产
Air8301	支持双网口、双485、双232、双DI、双DO的大屏HMI工控板，可直接用于量产
其它型号	合宙官方陆续推出中，如果你有好的想法和需求，欢迎提出来沟通

六，硬件说明；

0，型号说明；

Air8202系列工业模组，当前共有两个型号，一个是Air8202C，一个是Air8202G；

除此之外，还有一款适用于锂锰电池的Air8202T在规划中，不过也有可能以其它型号出现，主要看实际设计出来的板子是不是能和8202大小一致；

Air8202C一页纸

Air8202G一页纸

1，原理图；

Air8202G_V0_20260713.pdf

2，Air780EGG模组；

4G Cat.1模组Air780EGG是Air8202工业模组的绝对大脑，不但负责4G和GNSS定位，还内置了G-Sensor做震动判断，可以有效滤除GNSS静态飘逸，也可以根据有无震动做功耗控制；

Air780EGG相关资料：

https://docs.openluat.com/air780egh/product/；

Air780EGG硬件资料：

https://docs.openluat.com/air780egh/luatos/hardware/；

原理图部分；

PCB部分；

3，SIM卡；

Air8202兼容设计了两张SIM卡，双卡单待；

SIM1为自弹式SIM卡槽，Micro SIM小卡，焊盘预留，默认不贴；

SIM2为2mm*2mm贴片SIM卡，默认SIM卡；

原理图部分；

PCB部分；

SIM卡座和GNSS天线、4G贴片天线，位于PCB的TOP面；SIM卡座介于GNSS天线和4G贴片天线之间；

4，GNSS天线；

Air8202板载的是18mm*18mm无源陶瓷天线；

原理图部分；

PCB部分；

SIM卡座和GNSS天线、4G贴片天线，位于PCB的TOP面；SIM卡座介于GNSS天线和4G贴片天线之间；

5，4G贴片天线；

Air8202板载4G贴片天线，相对一般的板载天线，无论VSWR、效率还是增益，各项指标的均衡都做得非常不错；

4G贴片天线资料：

https://docs.openluat.com/accessory/AirANT/shouce/；

4G贴片天线设计指导：

https://docs.openluat.com/air780epm/luatos/hardware/ant/#airant1564；

4G贴片天线购买：Luat.taobao.com;

原理图部分；

PCB部分；

SIM卡座和GNSS天线、4G贴片天线，位于PCB的TOP面；SIM卡座介于GNSS天线和4G贴片天线之间；

6，看门狗Air153C(GPIO24喂狗)；

Air8202C板载了独立硬件看门狗Air153C，通过GPIO24进行喂狗操作；

Air8202G板载了独立硬件看门狗Air153D，通过GPIO24进行喂狗操作；

Air153C/Air153D资料；

不进行喂狗操作，是大家在初始接触时最常遇到的困惑：为什么我的Air8202隔几分钟就会自动重启？

原理图部分；

PCB部分；

7，两颗LED灯；

两颗LED灯，均由AGPIO控制，在低功耗模式下可保持电平，也就是可保证两颗LED常亮或常闭；

原理图部分；

PCB部分；

8，光敏防拆(仅Air8202G支持)；

Air8202G预留了一颗光敏电阻的焊盘，光暗时GPIO20为高电平，光亮时GPIO20由高变低，Air780EGG接收到GPIO20(WAKEUP3)中断信号，即可判断Air8202G已被拆卸；

说明！Air8202C为默认不焊接光敏电阻版本，Air8202G为默认焊接光敏电阻版本；

原理图部分；

光敏电阻型号为GL5528，暗光下阻值1MΩ，亮光下阻值8-20K；

PCB部分；

9，锂电池充电管理；

锂电池充电管理，是Air8202设计比较有特色和出彩的部分；

在由USB进行供电充电前，先由OVP芯片YHM2019进行保护；

YHM2019 REV2.0.pdf
YH2712A负责充电管理，特色之一是可以软件设置电池电压类型，无论是4.2V还是4.35V的电池都可以软件自由设置；

YHM2712A.pdf
YH2712A特色之二是支持"船运模式"，也就是软件控制YH2712A断开电池供电路径，应用场景是当大家的产品为上电开机同时又在出厂时必须安装好电池时，可以使用此模式进行断电控制；

当插入USB进行充电时，YH2712A自动退出"船运模式"；
YH2712A与Air780EGG之间的通信只需要一个GPIO25，我们有专门的扩展库供大家直接调用：
YH2712A还有一个隐藏技能：
1. 当系统中没有电池时，直接插上USB，系统也可以开机并运行，原因是YH2712A内置路径管理功能，可以将USB_VBUS的5V降压到合理的范围给系统供电，具体降压到几伏以及应该怎么控制，详见扩展库：
2. 需要特别说明的是：这种情况下YH2712A能输出的最大电流是800mA，不过在绝大多数情况下运行都没问题；

原理图部分；

PCB部分；

10，锂电池插座及拨码开关；

Air8202板载了锂电池插座，1.25mm间距，同时也支持在不贴插座的时候直接将锂电池引线焊接到插座焊盘上；

同时，虽然锂电池充电管理芯片YH2712A支持船运模式，我们还是设计了一个物理拨码开关用于电池供电的打开和关闭，供大家选择；

原理图部分；

PCB部分；

说明！

拨码开关拨到板边为关闭，拨到模组和天线方向为导通；

11，Type-C USB座子；

Air8202板载的Type-C USB座子，既可以用于下载(烧录软件)，也可以用于调试(搭配LuaTools)，也可以用于为锂电池充电；

原理图部分；

PCB部分；

12，充电电源焊点；

Air8202除支持USB充电外，也支持焊接点直接焊接；

不过需要提醒的是，充电电压不能超过5.5V，且不能与USB同时接入；

原理图部分；

PCB部分；

七，关于流量卡适配；

经过数次调试和实际验证，中国移动网络在Air8202C/Air8202G上的天线性能会表现得更好；

因此，我们强烈建议大家务必使用中国移动的流量卡，以保证最佳的信号质量和通信稳定性；

同时，合宙也提供中国移动流量卡服务，有需要可以微信扫码添加杨凤珍购买；

30M/月，插拔卡或者贴片卡，2.9/1年，4.9/3年，续费为2.9/1年；

100M/月，插拔卡或者贴片卡，3.9/1年，6.9/3年，续费为3.9/1年；

微信图片_20260622151118_2035_755.jpg

八，USB下载调试；

Air8202基于 Air780EGG 设计，与合宙其它4G模组一样，都是使用USB进行下载烧录和打印调试；

Air780G，默认正常开机进入打印调试模式，如需进入USB下载模式，则需要USB_BOOT和VDD_EXT的短接操作，也可以理解为需要在开机前将USB_BOOT拉高，才能进入下载模式；

关于这一点，大家可以看如下相关链接的资料，这里不再复述；

https://docs.openluat.com/air780epm/luatos/hardware/boot/

https://docs.openluat.com/air780epm/luatos/hardware/usb/

https://docs.openluat.com/air780epm/luatos/hardware/download/

Air8202的Type-C接口做了特殊处理，PIN3接BOOT，PIN9接VDD_EXT，这样就可以搭配合宙的专用下载调试小板AirBurnUSB方便的选择下载模式和调试模式；

九，结构尺寸；

PCB板厚：1.2mm；

其它尺寸，以实物为准；

十，如何设计整机？

合宙内部整机外壳设计方案，请大家参考：Air8202G整机设计说明

1）核心原则；

Air8202包含了除电池之外的所有功能模块，包括GNSS和4G天线、SIM卡座、USB充电座、电池开关等，所以，Air8202的外壳设计将相对简单非常多；

https://docs.openluat.com/air8202/product/

一般来说，电池可以分为硬包电池和软包电池；

软包电池一般指的是聚合物锂电池，如下：

硬包电池，种类很多，比较典型的是，一种是可以充电的圆柱形锂离子电池，一种是不可充电的一次性锂锰电池；

圆柱形锂离子电池，最常用的是18650，其直径为18mm，高度为65mm；

其次是18500，其直径为18mm，高度为50mm；

一次性锂锰电池，一般的规格为CR1214250和CR17505，正常工作电压是2\.0V\-3\.0V，需要升压电路，当前的Air8202还不支持；

**锂锰电池（LiMnO₂）电压范围**

锂锰电池（CR 系列）的电压特性如下：

|    参数|    电压值|
|---|---|
|    标称电压|    3.0V|
|    开路电压（满电）|    约 3.1V ~ 3.3V|
|    工作电压范围|    约 2.0V ~ 3.0V|
|    放电平台电压|    约 2.7V ~ 2.9V|
|    截止放电电压|    约 2.0V|

**关键说明**

- 放电曲线较平坦：锂锰电池在大部分放电周期内电压稳定在 2.7\~2.9V，接近耗尽时才快速下降，这是其优势之一。

- 温度影响：低温环境下电压平台会略有降低，高温环境下开路电压变化不大但自放电加快。

- 不可充电：锂锰电池是一次性电池，强行充电可能导致膨胀、漏液甚至爆炸。

**常见型号参考**

- CR2032、CR2025、CR1220（纽扣型）

- CR14250、CR2、CR123A（圆柱型）

- 均为标称 3.0V，属于同一体系。

基于Air8202的特点：
尺寸为26mm*50mm；
支持充电，不支持升压；
所以，首先选择18550尺寸的锂离子电池作为搭配设计外壳；
18650尺寸更大，容量更大，也更通用，唯一缺点是长度偏长；
聚合物锂电池基本都是非标，我个人判断并不适合作为展示样品使用；

2）参考样机；

友商A

小尺寸一次性锂锰电池CR14250；
PCBA与Air8202高度相似，包含了所有外设，包括天线和光敏电阻；
由于是一次性电池，所以不支持充电；
PCBA尺寸比Air8202更大，大约27.5*53；
外壳为可拆卸结构，因为支持终端客户打开外壳，拨动供电开关，对做库存和运输比较友好，不浪费电；

友商B

小尺寸一次性锂锰电池CR17505，与圆柱形锂离子电池18500尺寸相当；
尺寸1842，比Air8202的2250要小一些；
由于没有板载天线，所以天线的处理要比较复杂，需要一个专门的独立结构承接FPC天线；
支持终端客户滑动开盖，以便插卡和拨动电源开关开机，在储存和运输途中可以有效省电；
由于是一次性电池，所以也不支持充电；

3）结构设计；

参考两位友商的产品，结合Air8202的尺寸和元器件布局，我认为Air8202的整机结构应该设计如下：

像友商B的设计一样，圆柱形锂离子电池18500与Air8202平行放置，而不是上下放置，这样可以有效保证天线的性能，减小厚度，以及给光敏电阻留出开孔空间；
圆柱形锂离子电池，使用胶固定，Air8202主板，需要螺丝固定，相应结构外壳需要加上螺丝孔；
需要留出Type-C USB座子的开口位置，可以使用不防水的3D打印的软套，非硅胶套；
需要留出Nano-SIM卡座的开口位置，可以使用不防水的3D打印的软套，非硅胶套；
需要留出光敏电阻的开口位置，可以使用不防水的3D打印的软套，非硅胶套，是否可以做到透光待评估；

4）3D打印外壳；

合宙有完善的3D打印外壳服务，接下来我们会陆续将3D打印的外壳发布到这里。

十一，iRTU固件及源码；

有了整机硬件，软件怎么办？

软件有LuatOS-iRTU，合宙云AirCloud，合宙定位小程序。

固件

https://docs.openluat.com/value/irtu/state/

大家可以先用Air780EGG的iRTU固件进行配置，A8202的专用iRTU固件正在开发中，相对Air780EGG的iRTU固件，增加了基于充电管理芯片YH2712的充电管理功能；

https://docs.openluat.com/value/irtu/firmware/

源码

Air8202基于Air780EGG设计，所以，如果大家需要自己开发，源码可以参考Air780EGG的iRTU源码即可；

https://docs.openluat.com/value/irtu/open/

十二，新型号Air8202T；

如果，你想用一次性不可充电锂锰电池供电怎么办？比如CR14250、CR17505等；

锂锰电池的工作电压区间是不可以直接给Air8202C/G供电的，而且也不需要充电；

所以，我们在Air8202C/G的基础上规划了新型号Air8202T，做如下修改：

支持一次性锂锰电池，比如CR14250，CR17505等；
不支持充电，不支持USB插座，相应的留出需要升级调试的、方便简易夹具的测试点；
充电部分去掉，换成升压DCDC；
其余配置不变；
正在设计中，敬请期待；
不排除将来型号会改名，比如Air8205；