跳转至

Air780ER2/ER3_AirLink/RNDIS 专用 4G 模组使用说明

作者:马梦阳 | 最后修改:2026-07-01

一、Air780ER2/ER3 概述

实现 4G 上网能力

Air780ER2、Air780ER3 用于搭配没有 4G 功能的 MCU 或者 WiFi 主控来实现 4G 上网;

主控也可通过 UART(780ER2) 或者 SPI(780ER3) 方式,采用合宙 AirLink 通信协议进行数据交互,实现 4G 上网;

AirLink 是合宙自研的一套面向硬件设备间数据交互的标准化通信协议,方便通信双方进行数据传输,通过 AirLink 可以实现供网能力、外设控制、设备运维三大功能,AirLink 详细介绍请看产品简介中的“一、AirLink 概述”和 AirLink 通信协议

不需要进行二次开发,上手即用

Air780ER2、Air780ER3 不需要进行二次开发,内部已经烧录好了固件脚本,可以直接进行使用。

只支持 USB RNDIS 虚拟网卡和 AirLink 通信协议

Air780ER2、Air780ER3 作为 USB RNDIS 虚拟网卡使用时,可以在 Windows 和 Linux 设备下使用;

作为 AirLink 从设备使用时,只能与合宙官方主控模组(例如 Air160x、Air8101 等模组)进行搭配使用,不支持外挂在其他非官方主控设备上使用。

二、硬件说明

Air780ER2、Air780ER3 模组相关资料请参考资料中心文档。

三、AT 指令说明

Air780ER2、Air780ER3 支持部分 AT 指令集,通过 USB 口进行通信,波特率为 115200。

设备上电开机之后即可开始 AT 交互,不需要额外进行任何配置。

接下来详细介绍 Air780ER2、Air780ER3 支持的 AT 指令:

3.1 设置命令回显模式: ATE

功能说明:

执行命令设置 TA 在命令模式下,是否可以回显从 TE 接收到的字符。

语法规则:

命令类型
语法
返回
执行命令
ATE<value>
OK

参数定义:

参数
定义
取值
对取值的说明
<value>
是否回显
0
回显模式关闭
1(默认)
回显模式打开

举例:

命令(→)/返回(←)
实例
解释和说明

ATE0
关闭回显

OK
返回 OK

ATE1
开启回显

OK
返回 OK

3.2 查询信号质量: AT+CSQ

功能说明:

查询设备的信号强度与信道误码率。

语法规则:

命令类型
语法
返回
执行命令
AT+CSQ
+CSQ: <rssi>,<ber>

OK

参数定义:

参数
定义
取值
对应的接收信号强度(dbm)
<rssi>
接收信号强度指示(received signal strength indication)
=(接收信号强度 dBm+113)/2

0
小于等于-115dBm
1
-111dBm
2~30
-109~-53dBm
31
大于等于-51dBm
99
未知或不可测
<ber>
信道误码率(bit error rate,只有通话建立后,才能获知该值)
0~7
GSM 05.08 section 8.2.4所示的RXQUAL值
99
未知或不可测

举例:

命令(→)/返回(←)
实例
解释和说明

AT+CSQ
查询信号强度和质量

+CSQ: 15,0

OK
查询结果

3.3 查询 IMEI 号: AT+CGSN

功能说明:

查询设备的 IMEI 号码。

语法规则:

命令类型
语法
返回
执行命令
AT+CGSN
<IMEI>

OK

参数定义:

参数
定义
取值
对取值的说明
<IMEI>
产品序列号,即国际移动设备识别码 IMEI(International Mobile Equipment Identification)
-
15 位数字组成

举例:

命令(→)/返回(←)
实例
解释和说明

AT+CGSN
查询产品IMEI

359759002514931

OK
返回查询结果

3.4 查询 IMSI: AT+CIMI

功能说明:

查询设备的 IMSI 号码。

语法规则:

命令类型
语法
返回
执行命令
AT+CIMI
<IMSI>

OK

参数定义:

参数
定义
取值
对取值的说明
<IMSI>
国际移动台用户识别码(International Mobile Subscriber Identity)
-
15 位数字组成

举例:

命令(→)/返回(←)
实例
解释和说明

AT+CIMI
查询IMSI号

460001841426414

OK
返回查询结果

3.5 查询 SIM 卡 ICCID 号码: AT+CCID(/ICCID)

功能说明:

查询 SIM 卡的 ICCID。

语法规则:

命令类型
语法
返回
执行命令
AT+CCID
<ICCID>

OK
AT+ICCID
+ICCID:<ICCID>

OK

参数定义:

参数
定义
取值
对取值的说明
<ICCID>
产品 ICCID 号(Integrated circuit card identity , 集成电路卡识别码)
-
20 位数字组成

举例:

命令(→)/返回(←)
实例
解释和说明

AT+CCID
查询 SIM 卡 ICCID 号

89860117831003134201

OK
返回查询结果


AT+CCID
查询 SIM 卡 ICCID 号

+ICCID:89860117831003134201

OK
返回查询结果

3.6 RNDIS/ECM 功能开关: AT+RNDISCALL

注:Air780ER2、Air780ER3 仅支持 USB RNDIS 功能;

功能说明:

开启/关闭设备 USB RNDIS/ECM 功能,默认为开启状态

语法规则:

命令类型
语法
返回
设置命令
AT+RNDISCALL=<mode>
OK

参数定义:

参数
定义
取值
对取值的说明
<mode>
工作模式

0
关闭 RNDIS/ECM 网卡,立即执行,重启后也生效
1
打开 RNDIS/ECM 网卡,立即执行,重启后也生效

举例:

命令(→)/返回(←)
实例
解释和说明

AT+RNDISCALL=0
关闭 RNDIS/ECM 网卡

OK
返回执行结果

AT+RNDISCALL=1
打开 RNDIS/ECM 网卡

OK
返回执行结果

3.7 重启模块: AT+RESET

功能说明:

重启模块。

语法规则:

命令类型
语法
返回
执行命令
AT+RESET
OK

参数定义:

无。

举例:

命令(→)/返回(←)
实例
解释和说明

AT+RESET
重启模块

OK
返回执行结果

3.8 FOTA 空中升级: AT+UPGRADE

功能说明:

FOTA(Firmware Over The Air)是空中升级固件的功能。完整功能顺序如下:

1、发送 AT+UPGRADE 触发 FOTA 升级功能;

2、内部自动向服务器发送请求,用于版本查询;

3、发现有新版本之后再次发送请求进行下载;

4、下载完成后进行刷写、重启操作;

5、重启后自动向服务器发送请求,用于上报升级状态;

语法规则

命令类型 语法 返回 说明
设置命令 AT+UPGRADE=<tag>,<value>[,<savetoNV>] OK 设置<tag>值
AT+UPGRADE=<tag> +UPGRADE: <tag>,<value> 查询<tag>值
查询命令 AT+UPGRADE? +UPGRADE: <state>

OK
<state>= 0 或 1 时的返回
+UPGRADE: <state>,<percent>

OK
<state>= 2 时的返回
+UPGRADE: <state>[,<fota error cause>]

OK
<state>= 3 时的返回
执行命令 AT+UPGRADE OK 手动触发升级

参数定义:

参数 定义 取值 对取值的说明
<tag> "AUTO" 使用"AUTO"设置是否自动升级
"PERIOD" 使用"PERIOD"设置自动升级的查询周期,单位:秒。当设置的周期到时,模块触发 FOTA 升级操作。
<savetoNV> 是否把参数保存到 NV 0 保存参数,缺省值
1 不保存
<value> <tag>的取值,不同的<tag>有不同的取值 0 <tag>="AUTO"时的取值,整数型。
0:关闭自动 FOTA(模块不再和服务器通讯)
1:打开自动 FOTA(模块定期向服务器查询)
注:缺省为 1,即自动升级为打开!
1
60~2^32(4294967296) <tag>="PERIOD"时的取值,整数型,单位为秒。缺省值为 86400,即 24 小时。
<state> 0 空闲中
1 检测中
2 下载中
3 已结束(成功/失败)
<percent> 升级百分比 1~100 当模块处于<state>=2 的状态时,下载固件的百分比
<fota error cause> FOTA 错误原因 0 升级成功
1 网络连接失败
2 检测失败
3 无新版本
4 下载失败
5 升级失败
6 升级包已就绪
7 正在重启

举例:

命令(→)/返回(←) 实例 解释与说明
AT+UPGRADE="AUTO" 查询自动检测开关
+UPGRADE: "AUTO",1

OK
返回查询结果
AT+UPGRADE="AUTO", 1 开启自动检测开关
OK 返回 OK
AT+UPGRADE="PERIOD" 查询自动检测间隔
+UPGRADE: "PERIOD",86400

OK
返回查询结果(单位 秒)
AT+UPGRADE="PERIOD", 86400 设置自动检测间隔
OK 返回 OK
AT+UPGRADE 手动触发 FOTA 升级检测
OK

+UPGRADEIND: 3
无新版本
AT+UPGRADE 手动触发 FOTA 升级检测
OK

+UPGRADEIND: 2,10
+UPGRADEIND: 2,20
+UPGRADEIND: 2,30
+UPGRADEIND: 2,40
+UPGRADEIND: 2,50
+UPGRADEIND: 2,60
+UPGRADEIND: 2,70
+UPGRADEIND: 2,80
+UPGRADEIND: 2,90
+UPGRADEIND: 3,6
+UPGRADEIND: 3,7
有新版本,执行下载、升级操作
AT+UPGRADE? 查询状态
+UPGRADE: 3,1

OK
3,1 表示网络连接失败

3.9 写 SN 号命令:AT+WISN

功能说明:

用于写用于 SN(serial number)到模块里。

语法规则:

命令类型 语法 返回
设置命令 AT+WISN=<user_sn> OK

+CME ERROR: <err>
查询命令 AT+WISN? <user_sn>

OK

参数定义:

参数 定义 取值 对取值的说明
<user_sn> special SN - 由用户定义,最长 64 位

举例:

命令(→)/返回(←) 实例 解释与说明
AT+WISN="1234567890" 写客户 SN 号
OK
AT+WISN? 查询客户 SN 号
1234567890

OK

3.10 查询模块型号:AT+CGMM

功能说明:

查询模块的型号名称。

语法规则:

命令类型 语法 返回
执行命令 AT+CGMM <model>

OK

参数定义:

参数 定义 取值 对取值的说明
<model> 模块的型号 - 由厂商而定

举例:

命令(→)/返回(←) 实例 解释与说明
AT+CGMM 查询模块型号
+CGMM: "Air780ER2"

OK
返回查询结果

3.11 打开/关闭网络灯:AT+CNETLIGHT

功能说明:

设置命令用于打开/关闭网络状态指示灯(NET_STATUS)。

查询命令用于查询网络状态指示灯是否已经打开。

如下表描述了管脚定义。

网络指示管脚定义:

状态 管脚工作状态 网络状态
NET_STATUS 短亮(0.2 秒),长灭(1.8 秒) 搜网状态
长亮(1.8 秒),短灭(0.2 秒) 联网待机
快亮(0.1 秒),快灭(0.1 秒) 数据传输状态

语法规则:

命令类型 语法 返回
设置命令 AT+CNETLIGHT=<n> OK
查询命令 AT+CNETLIGHT? +CNETLIGHT: <n>

OK

参数定义:

参数 定义 取值 对取值的说明
<n> 网络状态指示灯的开关状态 0 关闭
1 打开,缺省值

举例:

命令(→)/返回(←) 实例 解释与说明
AT+CNETLIGHT=1 打开网络状态指示灯
OK
AT+CNETLIGHT=0 关闭网络状态指示灯
OK
AT+CNETLIGHT? 查询网络状态指示灯开关状态
+CNETLIGHT: 0

OK
返回查询结果

3.12 查询支持的 AT 指令:AT+HELP

功能说明:

查询设备支持的 AT 指令。

语法规则:

命令类型
语法
返回
执行命令
AT+HELP
+HELP:
AT+CSQ - Signal quality
AT+CGSN - Device IMEI
AT+CIMI - SIM IMSI
AT+ICCID - SIM ICCID
AT+CCID - SIM ICCID
AT+RNDISCALL=1 - Enable RNDIS
AT+RNDISCALL=0 - Disable RNDIS
AT+RESET - Reboot device
ATE0 - Disable echo
ATE1 - Enable echo
AT+HELP - Show this help
AT+UPGRADE - FOTA upgrade
AT+WISN - Read/Write custom SN
AT+CNETLIGHT - Network status LED

OK

参数定义:

无。

举例:

命令(→)/返回(←)
实例
解释和说明

AT+HELP
查询设备支持的 AT 指令

+HELP:
AT+CSQ - Signal quality
AT+CGSN - Device IMEI
AT+CIMI - SIM IMSI
AT+ICCID - SIM ICCID
AT+CCID - SIM ICCID
AT+RNDISCALL=1 - Enable RNDIS
AT+RNDISCALL=0 - Disable RNDIS
AT+RESET - Reboot device
ATE0 - Disable echo
ATE1 - Enable echo
AT+HELP - Show this help
AT+UPGRADE - FOTA upgrade
AT+WISN - Read/Write custom SN
AT+CNETLIGHT - Network status LED

OK
返回查询结果

四、USB RNDIS 使用说明

4.1 概述

Air780ER2、Air780ER3 模组均支持 USB RNDIS 虚拟网卡功能,通过 AT 指令开启/关闭,用于外挂在没有 4G 功能的主控 MCU/WiFi 模组使用,为主控 MCU/WiFi 模组提供 4G 上网能力。

4.2 准备硬件环境

1、Air780ER2、Air780ER3 模组;

Air780ER2/ER3 只有模组,需要用户自己搭配主控模组设计开发板,可参考合宙提供的设计电路进行设计。 参考设计文件:https://docs.openluat.com/air780er2/product/shouce/#air780er2

2、一张物联网卡;

3、TYPE-C USB 数据线;

4.3 准备软件环境

Air780ER2、Air780ER3 内部已经烧录好了固件脚本,用户只需要搭配主控,通过 USB 给 Air780ER2/ER3 发送 AT 指令开启 RNDIS 功能即可实现 4G 上网。

4.4 功能演示

本次使用 PC 作为主控,通过串口工具给 Air780ER2/ER3 发送开启 RNDIS 功能的指令,实现 4G 上网。

1、将 PC 与 Air780ER2/ER3 通过 TYPE-C USB 数据线进行连接;

2、将 Air780ER2/ER3 上电开机后,查看 PC 的设备管理器是否有显示出三个端口,如下图所示:

4.5 打开串口工具,发送开启指令

打开串口工具,按照下图中的说明进行操作。

鼠标右键电脑右下角的对应图标,然后点击“网络和 Internet 设置”。

“以太网 2”便是 USB RNDIS 虚拟网卡。

发送 AT+RNDISCALL=0 即可关闭 RNDIS 功能。

本章节不会直接详细介绍各种场景的使用说明,只提供对应场景的相关资料链接,用户通过点击链接可直接进行查看。

5.1 合宙 Air160x 系列主控 MCU 搭配 Air780ER2 4G 模组

Air160x 系列模组资料说明:https://docs.openluat.com/air1601/

应用示例文档:待补充

5.2 合宙 Air160x 系列主控 MCU 搭配 Air780ER3 4G 模组

Air160x 系列模组资料说明:https://docs.openluat.com/air1601/

应用示例文档:待补充

5.3 合宙 Air1780x 系列主控 MCU 搭配 Air780ER2 4G 模组

Air1780x 系列模组资料说明:https://docs.openluat.com/air1780/product/

应用示例文档:待补充

5.4 合宙 Air1780x 系列主控 MCU 搭配 Air780ER3 4G 模组

Air1780x 系列模组资料说明:https://docs.openluat.com/air1780/product/

应用示例文档:待补充

5.5 合宙 Air8101 系列 WiFi 模组搭配 Air780ER2 4G 模组

Air8101 系列模组资料说明:https://docs.openluat.com/air8101/

应用示例文档:待补充

5.6 合宙 Air8101 系列 WiFi 模组搭配 Air780ER3 4G 模组

Air8101 系列模组资料说明:https://docs.openluat.com/air8101/

应用示例文档:待补充

问一下 AI