# AT 指令系统
AT 指令系统是由 MXCHIP 开发的,运行于 MXCHIP 无线模组上的串行指令系统。
通过该指令系统,用户可以快速地为现有的嵌入式设备增加无线通信功能,大大缩短开发周期,实现快速上市。
#支持型号
AT 固件可运行于:
- EMC3080
- EMC3090
- EMC3280
- EMC3390
- EMW3070
- EMW3072
- EMW3060
- EMW110A
- EMW3080
- EMW5080
- EMW3080V2
- EMW5080V2
- EMW3166
- EMW3165
- EMW3031
#版本说明
AT 固件版本号形如:AT_v2.x.x。 其中:
AT 代表:AT 固件和 AT 指令.
vx.x.x 代表:固件版本号.
这里固件版本号,可通过发送指令: AT+FWVER?\r 进行查询。
#使用条件
Wi-Fi 模组:模组出厂已预烧录 AT 透传固件;
硬件连接:传统产品主控 MCU 的 UART 和 Wi-Fi 模组的用户 UART 进行连接;
软件实现:主控 MCU 通过 AT 指令解析控制 Wi-Fi 模组。
数据流向:
从 设备的主控 MCU 透过 Wi-Fi 模组,上传到云端;
从 云端透过 Wi-Fi 模组,下发到主控 MCU,控制设备。
#工作模式种类
AT 固件提供 4 种工作模式,包括: AT指令控制模式、透明传输模式,、BOOT 模式和测试模式。
#AT指令模式
烧录新版 AT 固件的模块, 其出厂后,初次上电时,默认进入 AT 指令模式,且不启动任何 AP, STAIION, TCP 或 UDP 功能。 若需打开以上功能,均需用户通过 AT 指令逐一设置,一经设置,立即保存起效,且掉电保持。
该模式下,用户可以通过 AT 指令来控制和配置模块。详细指令说明请参考AT指令说明。
#透明传输模式
该模式下,模组用户串口数据自动发送至 Wi-Fi 射频端;同时,Wi-Fi 射频端接受数据自动发送至模组用户串口端。
#BOOT模式
在 BOOT 模式下,开发者可以通过串口的Ymodem文件传输协议来升级模组固件。
#MFG 产测模式
在 MFG 模式下,可查看产测 log 信息。
#各模式引脚状态
AT 固件,通过上电时检测 BOOT 和 STATUS 管脚状态,从而引导模块进入不同工作模式,具体如表(除 EMW3080 以外):
BOOT | STATUS | 工作模式 |
0 | 0 | Reset 后,进入 MFG 产测模式 |
0 | 1 | Reset 后,进入 BOOT 模式 |
1或悬空 | 1或悬空 | Reset 后,进入透明传输模式 或 AT 命令控制模式 |
由于 EMW3080B 没有指定 STATUS 引脚,因此其 AT 透传固件的工作模式判断只需看,模块复位时: BOOT 脚状态或用户串口输入内容,具体如下表:
BOOT | 用户串口输入 | 工作模式 |
x | # | Reset 后,进入 MFG 产测模式 |
0 | 无 | Reset 后,进入 BOOT 模式 |
1或悬空 | 无 | Reset 后,进入 AT 命令控制模式 |
#模式切换
#AT-->Wi-Fi 透传
AT 指令模式 (Wi-i/BT均支持) --> Wi-Fi 透明传输模式
发送指令: AT+CIPSENDRAW\r
返回: OK
#AT-->BT 透传
AT 指令模式(BT/RFCOMM)--> BT 透明传输模式
发送指令:AT+BTSENDRAW\r
返回:OK
注意:目前仅 EMW3239 支持经典蓝牙透传模式(使用BT RFCOMM协议),不支持BLE透传。
#透传-->AT
透明传输模式 --> AT指令模式 当需要从 Wi-Fi 透明传输模式或 BT 透明传输模式,进入 AT 指令模式时,需要:
发送指令:+++
返回:OK
注意: Wi-Fi 透传模式 和 BT 透传模式 之间无法互相切换,必须首先从透明传输模式切换至 AT 指令模式,然后通过不同的 AT 指令,进入相应的透传模式。
#出厂设置
#默认参数
AT 固件支持 MXCHIP 出厂设置,参数如下:
AT 指令串口:波特率 115200、数据位 8、停止位 1、校验位 none,流控 none;
Wi-Fi 设置:默认不启动 Soft AP 或 Station 模式,用户需分别自己定义 Soft_AP 的名称及密码 及 Station 模式连接的AP的名称和密码;
IP 地址:默认 Soft_AP 模式为:10.10.10.1 , 子网掩码:255.255.255.0 , 网关:10.10.10.1 ;
DHCP 服务器:使能;
bonjour 服务器:不使能;
TCP 服务器:不使能;
HTTP 服务器 : 无;
指令回显:默认开启回显功能。
事件通知:默认开启通知功能。
#恢复出厂
(1) 通过指令
在 AT 指令模式下输入:
指令:
AT+FACTORY\r
返回:
OK
即可清除所有用户设置,恢复 MXCHIP 模块出厂设置。
(2) 通过按键
在 AT 指令模式 或 透明传输工作模式下, 通过将模块的 Easylink 管脚,持续拉低 >= 5秒,即可清除所有用户设置,恢复 MXCHIP 模块出厂设置。
#管脚分配
模块 出厂时,通过 AT 固件已设置好的功能管脚包括 5 种:
UART串口: 用于各种工作模式 log 信息输出及 AT 指令收发,包括:Debug调试串口(查看运行log信息)和User用户串口(收发 AT 指令);
Wi-Fi模式LED指示灯: 用于显示当前系统Wi-Fi通信状态,包括:系统指示灯和射频指示灯 2 种。
#UART串口
AT 固件中,模块在不同模式下,不同串口信息输出所用的 UART 串口不同。
通常,用户串口用来收发 AT 指令,调试串口用来查看运行 log 信息。
具体型号模块的串口管脚分配情况如表:
型号 | Bootloader和MFG产测 | AT指令及透传 | 正常工作log和CLI调试命令 |
3165 | Pin29, Pin30, 921600bps | Pin29, Pin30, 115200bps | Pin8,Pin12,115200bps |
3166 | Pin29, Pin30, 921600bps | Pin29, Pin30, 115200bps | Pin8,Pin12,115200bps |
3239 | Pin29, Pin30, 921600bps | Pin29, Pin30, 115200bps | Pin8,Pin12,115200bps |
3162 | Pin22, Pin23, 921600bps | Pin22, Pin23, 115200bps | Pin14,Pin4,115200bps |
3031 | Pin9, Pin10, 921600bps | Pin9, Pin10, 115200bps | Pin21,Pin22,115200bps |
3080B | Pin9, Pin10, 921600bps | Pin9, Pin10, 115200bps | Pin21,Pin22,115200bps |
3060 | Pin9, Pin10, 921600bps | Pin9, Pin10, 115200bps | Pin21,Pin22,115200bps |
注意:用户串口指模块Datasheet上特别标明的USER_UART串口。调试串口指模块Datasheet上特别标明的Debug_UART串口。通常,用户串口在 MXKit 开发板上是 Aduino 接口的 UART 串口。
#Wi-Fi模式LED指示灯
#系统指示灯(SYS_LED)
系统指示灯管脚号及功能说明如表(标明管脚号的需用户自行设计引出):
序号 | 模组型号 | 管脚 |
1 | 3165 | Pin33 |
2 | 3166 | Pin33 |
3 | 3162 | 在模块上(绿色) |
4 | 3080B | Pin19 |
5 | 3031 | 在模块上 |
6 | 3239 | Pin33 |
7 | 3060 | 无 |
系统 LED 指示灯用于显示当前系统运行状态。
- Easylink模式: 配网开始后,模块未获取到ssid和密码时,高低电平交替输出,灯快闪; 模块获取到ssid和密码时,高低电平交替输出,灯慢闪;配网成功后,低电平,灯常亮。
- AP模式:初始化成功后,低电平,灯常亮。
- STATION模式:初始化成功后,低电平,灯常亮。
- AP+STATION双模式:初始化成功后,低电平,灯常亮。
系统指示灯电路设计请参考:
#射频指示灯(RF_LED)
射频指示灯管脚号及功能说明如表(标明管脚号的需用户自行设计引出):
序号 | 模组型号 | 管脚 |
1 | 3165 | Pin31 |
2 | 3166 | Pin31 |
3 | 3162 | 在模块上(红色) |
4 | 3080B | 无 |
5 | 3031 | Pin30 |
6 | 3239 | Pin31 |
7 | 3060 | 无 |
射频 LDE 指示灯用于指示系统无线 Wi-Fi 连接状态。
Easylink模式: 配网成功时,输出低电平,灯亮;配网未成功时,输出高电平,灯灭。
AP模式: 初始化成功后,AP开启ON,输出低电平,灯亮;AP关闭OFF时,输出高电平,灯灭。
STATION模式: 初始化成功后,STATION连接为ON时,输出低电平,灯亮;STATION连接为OFF时,输出高电平灯灭。
系统指示灯电路设计请参考:
更详细的模块外围电路设计,可参考各模块 AN 应用笔记内容。