• 物联网工程师开发服务平台

AT v1.x 透传固件及指令使用示例

本文将详细介绍:如何更新 AT 应用程序固件,如何实现工作模式切换,及如何开启模块 WiFi 功能,以及进行 Sokcet 通信等功能。

这里提供一个格西烽火串口指令工程下载链接,AT_v1.0_CMD.bsp, 用户可快速进行 AT 指令的开发与调试。

目录

AT透传固件更新

更新方法有两种:

  • 一种是进入 Bootloader 模式,输入命令 1 ,通过串口烧录。
  • 一种是进入 网页设置界面,进入 “模块管理界面” ,更新固件。

通过Bootloader模式更新固件

1.硬件准备

首先,您需要拥有一个模块可以正常运行的硬件环境,可以是以下任意一种:

  • MXKit-xxxx 开发板 - 支持绝大多数的EMW系列模块。
  • EMW-380-S2 开发板 - 支持 3088,3162。
  • 或您自己搭建的 EMWxxx 模块的 最小工作电路(至少包括:电源,串口两部分)。

2.软件准备

3.更新步骤

(1) 连接串口

通过 Mini USB(for MXKit) 或 Micro USB(for EMB-380-S2) 串口线,将开发板连接到PC,在PC的控制面板中-设备管理器找到 COM 端口号,打开secureCRT,创建连接,配置如下:

com_config

(2) 进入Bootloader模式

BOOT 脚拉低 0,STATUS 脚拉高1,按RESET键重启模块,串口输出log如下图:

bootloader

(3)下载固件

输入:1,Update application。返回如下图:

command_1

此时,选择菜单栏:Transfer—Send Ymodem,选择要下载的固件,如下图:

choose_bin

下载成功后,输出如下图。此时可将BOOT脚拉高,STATUS脚拉高,进入正常工作模式。透传或AT指令模式。

download_ok

通过网页功能更新固件

1.模块 AP 模式或 STATION 模式下均可以进行网页应用程序固件更新,

  • AP模式时,用PC连接Wi-Fi模块,SSID为MXCHIP_XXXXXX(XXXXXX是模块的MAC地址后六位)。打开浏览器,在地址栏输入“10.10.10.1”,弹出认证对话框,默认用户名和密码:admin,admin,点击确定,如左图。

  • Station模式时,PC与模块均连接至同一个AP,查询模块IP地址后,在PC端浏览器中输入该IP地址,即可进入登录界面。默认用户名和密码:admin,admin,点击确定,如右图。

login_ap login_station

2.成功登录后,打开“模块管理”页面,找到“模块固件升级”,此时可以选择要更新的应用程序固件,进行更新。

module_manage

3.文件选择确认后,开始上传,此时切勿断开电源或其它操作,否则会导致固件更新失败。

bin_webupdate

4.更新完成后,设备将重启,请等待完成即可。

bin_webupdateok

工作模式切换

透传模式切换至WiFi AT指令模式

1.引脚状态:BOOT拉高,STATUS拉高,并重启模块。用户串口参数设置如下图:

usercom_config

注意:Port端口号,可在PC端设备管理器中查看。

2.输入切换命令符

打开串口调试工具格西烽火,输入模式切换指令符:+++,等待返回a后,输入a。

3.验证: 此时,串口工具发送字符串: AT+HELP\r,查看是否返回正确的AT指令列表。若返回,则成功完成模式切换。如下图所示。

into_atmode

AT指令模式切换至透传模式

Wi-Fi AT指令模式或 BT AT指令模式下,发送指令字符串:AT+QUIT\r,返回+OK, 即可退出AT指令模式。如下图所示:

at_quit

透传模式切换至BT AT指令模式

1.该BT AT指令模式仅EMW3239支持,引脚状态:BOOT拉高,STATUS拉低,并重启模块。 用户串口设置如下图:

usercom_config

注意:Port端口号,可在PC端设备管理器中查看。

2.输入切换命令符 打开串口调试工具软件,输入模式切换指令符:+++,等待返回a后,输入a。

3.验证:此时,输入指令字符串: AT+HELP\r,看是否返回正确的AT指令列表。若返回,则成功完成模式切换。如下图所示。

into_atmode

WiFi功能用例

启动AP模式

在Wi-Fi AT指令模式下,可实现模块启动AP模式,具体步骤如下:

序号 步骤 发送指令(或操作) 返回(或现象)
1 进入AT指令模式 +++, 返回a后,发送:a a+OK
2 设置Wi-Fi工作模式 AT+WMODE=AP +OK
3 设置AP的ssid和key,WPA加密 AT+WAP=mxchip_3165,1234567890 +OK
4 设置AP的IP地址(不设置为默认值) AT+IPCONFIG=AP, 10.10.10.10,255.255.255.0,10.10.10.1 +OK
5 设置AP的信道 AT+WAPCH=6 +OK
6 保存设置,重启有效 AT+SAVE +OK
AT+REBOOT +OK
7 再次进入AT指令模式,查询设置是否起效,包括:AP名称和密码,IP地址 +++, 返回a后,发送:a a+OK
AT+WAP +OK=mxchip_3165,1234567890
AT+IPCONFIG +OK=10.10.10.10,255.255.255.0,10.10.10.1,,,
8 验证AP是否确实建立 AT+WSTATUS +OK=UAP_UP, STATION_DOWN
PC端查看,能否扫描到命名为:mxchip_3165的 AP,并验证能否连上 能扫描到该AP,并成功连接

AP模式设置串口工具log输出如下图所示:

ap_log

启动STATION模式

在AT指令模式下,实现STATION模式联网的具体步骤如下:

序号 步骤 发送指令(或操作) 返回(或现象)
1 进入AT指令模式 发送 +++, 返回a后,发送:a a+OK
2 设置Wi-Fi工作模式 AT+WMODE=STA +OK
3 设置STATION的ssid和key AT+WSTA=SWYANG,12345678 +OK
4 设置IP地址(二选一) 可自动获取 ,AT+DHCP=ON +OK
可手动修改,AT+DHCP=OFF,AT+IPCONFIG=STA, 192.168.1.106,255.255.255.0,192.168.1.1 +OK,+OK
5 保存设置,重启有效 AT+SAVE +OK
AT+REBOOT +OK
6 查询设置是否起效 发送 +++, 返回a后,发送:a a+OK
AT+WSTA +OK=ssid,77777777
AT+IPCONFIG +OK=10.10.10.10,255.255.255.0, 10.10.10.1, 192.168.1.106,255.255.255.0,192.168.1.1
7 查看STATION能否联网 AT+WSTATUS +OK=UAP_DOWN,STATION_UP
手机端连接至ssid,使用APP Bonjour Browser查看,能否发现模块,如:EMW3165#548D36。 命名规则:模块型号#MAC后8位 成功发现模块

Station模式设置串口log输出如下图所示:

sta_log

Socket通信用例

TCP服务器端

当需要模块做 TCP 服务器,并创建 TCP 链接,进行 TCP 通信时,可参考如下步骤:

1.AP模式下的TCP服务器

在 WiFi AT指令模式下,AP模式下,模块做 TCP 服务器,建立一个TCP连接,并通信。 具体步骤如下(以链接 1 为例,链接 2 方法相同):

序号 步骤 发送指令(或操作) 返回(或现象)
1 进入AT指令模式 +,+,+, 返回a后,发送:a a+OK
2 设置并开启AP模式 请参考启动AP模式,获取AP的ssid和key,获取模块的IP地址 +OK=mxchip_3165,1234567890, +OK=10.10.10.1,255,.255.255.0,10.10.10.1
3 PC连接到AP,并获取PC的IP地址 PC端Wlan连接到AP:mxchip_3165 成功连接到AP
PC端查看IP地址,查看方法:PC打开DOS命令窗口cmd.exe,输入命令ipconfig,查看无线局域网IP地址 IP地址:10.10.10.2
4 设置通道1的TCP参数 AT+CON1=SERVER,20001,, +OK
5 保存设置,重启生效 AT+SAVE +OK
AT+REBOOT +OK
6 查询设置是否生效 发送+++, 返回a后,发送:a a+OK
AT+CON1 +OK=SERVER, 20001,,
7 打开EVENT事件通知 AT+EVENT=ON +OK
8 创建一个TCP连接,并获取该TCP连接的socket号 PC端Wlan连接至AP: mxchip_3165 成功连接
TCP工具端创建一个TCP客户端,目标IP:10.10.10.1,目标端口号:20001, 本机端口:随机选择 TCP连接建立, 并返回:+EVENT=TCP_CLIENT, CONNECT,3
9 AT指令模式下发送数据 AT+SSEND=3,4 返回>后,输入字符串:1234 TCP工具接收区收到:1234
AT+SSSEND=3,5,12345 TCP工具接收区收到:12345
10 切换至透传模式下 AT+QUIT +OK(退出AT指令模式,进入透传)
11 模块接收数据(AT指令模式和透传模式) TCP工具发送区输入数据:1234567890 secureCRT接收区: +EVENT=SOCKET,3,10,1234567890

PC端利用TCP/UDP测试软件创建TCP客户端,如下图:

ap_tcpclient_creat

TCP连接通信情况见下图。

左侧为TCP/UDP测试软件工作区,右侧为串口调试软件的数据接收工作区。

ap_pc_tcpclient ap_tcpserver_log

2.STATION模式下的TCP服务器

在 WiFi AT指令模式下,STATION模式下,模块做 TCP 服务器,建立一个TCP连接,并通信。具体步骤如下(以链接 1 为例,链接 2 方法相同):

序号 步骤 发送指令(或操作) 返回(或现象)
1 进入AT指令模式 发送+++, 返回a后,发送:a a+OK
2 设置并开启STATION模式 请参考:启动Station模式]。STATION模式下建网获取模块的STATION的ssid和IP地址 如:+OK=ssid,77777777,如:+OK=192.168.1.106,255,255.255.0,192.168.1.1
3 设置通道1的TCP参数 AT+CON1=SERVER,20001,, +OK
4 保存设置,重启生效 AT+SAVE +OK
AT+REBOOT +OK
5 重新进入AT指令模式,查询设置是否生效 发送+++, 返回a后,发送:a a+OK
AT+CON1 +OK=SERVER,20001,,
6 打开EVENT事件通知 AT+EVENT=ON +OK
7 创建一个TCP连接,并获取该TCP连接的socket号 PC端Wlan连接至ssid 成功连接
TCP/UDP测试软件创建一个TCP客户端,目标IP:192.168.1.106,目标端口号:20001, 本机端口:随机选择 TCP连接建立,并返回:++EVENT=TCP_CLIENT, CONNECT,2
8 AT指令模式下发送数据 AT+SSEND=3,4 返回>后,输入字符串:1234 >1234
AT+SSSEND=3,5,12345 >12345
9 切换至透传模式 AT+QUIT +OK (退出AT指令模式,进入透传模式)
10 模块接收数据(AT指令模式和透传模式) TCP工具发送区输入数据:1234567890 secureCRT接收区接收数据:+EVENT=SOCKET,3,10,1234567890

PC端利用TCP/UDP测试软件创建TCP客户端,如下图:

sta_tcpclient_creat

TCP通信过程示意如下图:

左侧为TCP/UDP测试软件工作区,右侧为串口调试软件的数据接收工作区。

sta_tcpserver_log

TCP客户端

当需要模块做 TCP 客户端,并创建 TCP 链接,进行 TCP 通信时,可参考如下步骤:

1.AP模式下的TCP客户端

在 WiFi AT指令模式下,AP模式下,模块做 TCP 客户端,建立一个TCP连接,并通信。具体步骤如下(以链接 1 为例,链接 2 方法相同):

序号 步骤 发送指令(或操作) 返回(或现象)
1 进入AT指令模式 +,+,+, 返回a后,发送:a a+OK
2 设置并开启AP模式 请参考:启动AP模式 ,获取AP的ssid和key,获取模块的IP地址 +OK=mxchip_3165,1234567890。 +OK=10.10.10.1,255,.255.255.0,10.10.10.1
3 PC连接到AP,并获取PC的IP地址 PC端Wlan连接到AP:mxchip_3165 成功连接到AP
PC端查看IP地址,查看方法:PC打开DOS命令窗口cmd.exe,输入命令ipconfig,查看无线局域网IP地址 IP地址:10.10.10.2
4 设置通道1的TCP参数 AT+CON1=CLIENT, ,4001,10.10.10.2 +OK
5 保存设置,重启生效 AT+SAVE +OK
AT+REBOOT +OK
6 查询设置是否生效 发送+++, 返回a后,发送:a a+OK
AT+CON1 +OK= CLIENT, ,4001,10.10.10.2
7 打开EVENT事件通知 AT+EVENT=ON +OK
8 创建一个TCP连接,并获取该TCP连接的socket号 PC端Wlan连接至AP:mxchip_3165 成功连接
TCP工具端创建一个TCP服务器,目标IP:10.10.10.1,。目标端口号:20001。本机端口:随机选择。 TCP连接建立,并返回:+EVENT=TCP_SERVER, CONNECT,1
9 AT指令模式发送数据 AT+SSSEND=2,,16,I am tcp client. TCP工具接收区:I am tcp client.
10 切换至透传模式 AT+QUIT +OK(退出AT指令模式,进入透传)
11 模块接收数据(AT指令模式和透传模式) TCP工具发送区输入数据:I am tcp server. 串口工具接收区:+EVENT=SOCKET,2,16,I am tcp server.

PC端利用TCP/UDP测试软件创建一个TCP服务器,与模块TCP客户端进行通信,具体情况请参考下图。

其中,上方为TCP/UDP测试软件工作区,下方为串口调试软件的数据收发工作区。

ap_pc_tcpserver ap_tcpclient.png

2.STATION模式下的TCP客户端

在 WiFi AT指令模式下,STATION 模式下,模块做 TCP 客户端,建立一个TCP连接,并通信。具体步骤如下(以链接 1 为例,链接 2 方法相同):

序号 步骤 发送指令(或操作) 返回(或现象)
1 进入AT指令模式 发送+++, 返回a后,发送:a a+OK
2 设置并开启 STATION 模式 请参考:启动Station模式,获取STATION的ssid和密码,获取模块的IP地址 如:+OK=ssid,77777777,如:+OK=10.0.3.25,255,.255.255.0,10.0.3.1
3 PC连接到STATION:ssid,并获取PC的IP地址 PC连接到STATION: ssid 成功连接到ssid
PC端查看IP地址。查看方法:PC打开DOS命令窗口cmd.exe,输入命令ipconfig,查看无线局域网IP地址 IP地址:10.0.3.34
4 设置通道1的TCP参数 AT+CON1=CLIENT, ,4001,10.0.3.34 +OK
5 保存设置,重启生效 AT+SAVE +OK
AT+REBOOT +OK
6 查询设置是否生效 发送+++,返回a后,发送:a a+OK
AT+CON1 +OK=CLIENT,,4001,10.0.3.34
7 打开EVENT事件通知 AT+EVENT=ON +OK
8 创建一个TCP连接 并获取该TCP连接的socket号 PC端连接至AP:mxchip_3165 |成功连接
TCP工具端创建一个TCP服务器,目标IP:10.0.3.25。目标端口号:4001。 本机端口:随机选择。 TCP连接建立,并返回:+EVENT=TCP_SERVER,CONNECT,1
9 AT指令模式发送数据 AT+SSSEND=2,16, I am tcp client. +EVNET=SOCKET,2,16,I am tcp client.
10 切换至透传模式 AT+QUIT +OK(退出AT指令模式,进入透传模式)
11 模块接收数据(AT指令模式和透传模式) TCP工具发送区输入数据:I am tcp server. 串口工具接收区:+EVENT=SOCKET,2,16,I am tcp server.

在PC端利用TCP/UDP测试软件创建一个TCP服务器,与模块的TCP客户端进行通信,具体情况如下图。

其中,上方为PC端TCP/UDP测试软件数据收发工作区,下方为串口调试软件数据收发工作区。

sta_pc_tcpserver sta_tcpclient.png

UDP广播

当需要模块做 UDP 广播(服务端),并发 UDP 广播信息时,可参考以下步骤。

1.AP模式下的UDP广播

、 在WiFi AT指令模式下,AP 模式下建立一个UDP服务端,模块发 UDP 广播信息。具体步骤如下(以链接 1 为例,链接 2 方法相同):

序号 步骤 发送指令(或操作) 返回(或现象)
1 进入AT指令模式 发送+++, 返回a后,发送:a a+OK
2 设置并开启AP模式 请参考:启动AP模式,获取AP的ssid和key,获取模块的IP地址 +OK=mxchip_3165,1234567890, +OK=10.10.10.1,255,.255.255.0,10.10.10.1
3 PC连接到AP,并获取PC的IP地址 PC端Wlan连接到AP:mxchip_3165 成功连接到AP
PC端查看IP地址。查看方法:PC打开DOS命令窗口cmd.exe,输入命令ipconfig,查看无线局域网IP地址 IP地址:10.10.10.2
4 设置通道1的TCP参数 AT+CON1=BOARDCAST,20001,4001, +OK
5 保存设置,重启生效 AT+SAVE +OK
AT+REBOOT +OK
6 查询设置是否生效 发送+++, 返回a后,发送:a a+OK
AT+CON1 +OK=BOARDCAST,20001,4001,
7 PC端 创建一个UDP连接 PC端Wlan连接至AP:mxchip_3165 成功连接
UDP工具端创建一个UDP广播连接,目标IP:10.10.10.255(必须同一网段)。目标端口号:20001。本机端口:4001 UDP广播连接建立
8 AT指令模式发送数据 AT+SSSEND=0,19,I am udp boardcast. TCP工具接收区收到:I am udp boardcast.
AT+SSSEND=3,19,I am udp boardcast. TCP工具接收区收到:I am udp boardcast.
9 切换至透传模式 AT+QUIT +OK(退出AT指令模式,进入透传)
11 模块接收数据(AT指令模式和透传模式) UDP工具发送区输入数据:I am udp boardcast receiver. 串口工具接收区:+EVENT=SOCKET,2,28,I am udp boardcast receiver.

在PC端利用TCP/UDP测试软件创建一个UDP广播连接,与模块进行UDP通信,具体情况请参考。

其中,上方为PC端TCP/UDP测试软件数据收发工作区,下方为串口调试软件数据收发工作区。

ap_pc_udpboardcast ap_udpboardcast_log.png

2.STATION模式下的UDP广播

在WiFi AT指令模式下,STATION 模式下建立一个UDP服务端,模块发 UDP 广播信息。具体步骤如下(以链接 1 为例,链接 2 方法相同):

序号 步骤 发送指令(或操作) 返回(或现象)
1 进入AT指令模式 发送+++, 返回a后,发送:a a+OK
2 设置并开启STATION模式 请参考:启动Station模式,获取模块的STATION的ssid和IP地址 如:+OK=ssid,77777777, IP地址为:+OK=192.168.31.174,255.255.255.0,192.168.31.1
3 设置通道1 TCP参数 AT+CON1=BOARDCAST,20001,4001, +OK
4 保存设置,重启生效 AT+SAVE +OK
AT+REBOOT +OK
5 查询设置是否生效 发送+++, 返回a后,发送:a a+OK
AT+CON1 +OK=BOARDCAST,20001,4001,
6 PC端 创建一个UDP连接 PC端Wlan连接至ssid 成功连接
UDP工具端创建UDP连接,目标IP:192.168.31.255(必须同一网段),目标端口号:20001,本机端口:4001 UDP连接建立
7 AT指令模式下发送数据 AT+SSSEND=0,19,I am udp boardcast. TCP工具接收区收到:I am udp boardcast.
AT+SSSEND=3,19, I am udp boardcast. TCP工具接收区收到:I am udp boardcast.
8 切换至透传模式 AT+QUIT +OK(退出AT指令模式,进入透传)
9 模块接收数据(AT指令模式和透传模式) UDP工具发送区输入数据:I am udp boardcast receiver. 串口工具接收+EVENT=SOCKET,2,28,I am udp boardcast receiver.

在PC端利用TCP/UDP测试软件创建一个UDP广播连接,与模块进行UDP通信,具体情况请参考。

其中,上方为PC端TCP/UDP测试软件数据收发工作区,下方为串口调试软件数据收发工作区。

sta_pc_udpboardcast

sta_udpboardcast_log

UDP单播

当需要模块做 UDP 单播(服务端),并发 UDP 单播信息时,可参考以下步骤。

1.AP模式下的UDP单播

在WiFi AT指令模式下,AP 模式下建立一个UDP客户端,模块发 UDP 单播信息。具体步骤如下(以链接 1 为例,链接 2 方法相同):

序号 步骤 发送指令(或操作) 返回(或现象)
1 进入AT指令模式 发送+++, 返回a后,发送:a a+OK
2 设置并开启AP模式 请参考:启动AP模式,获取AP的ssid和key,获取模块的IP地址 +OK=mxchip_3165,1234567890, +OK=10.10.10.1,255,.255.255.0,10.10.10.1
3 PC连接到AP,并获取PC的IP地址 PC端Wlan连接到AP:mxchip_3165 成功连接到AP
PC端查看IP地址。查看方法:PC打开DOS命令窗口cmd.exe,输入命令ipconfig,查看无线局域网IP地址 IP地址:10.10.10.2
4 设置通道1的TCP参数 AT+CON1=UNICAST,20001,4001,10.10.10.2 +OK
5 保存设置,重启生效 AT+SAVE +OK
AT+REBOOT +OK
6 查询设置是否生效 发送+++, 返回a后,发送:a a+OK
AT+CON1 +OK=UNICAST,20001,4001,10.10.10.2
7 PC端创建一个UDP连接 PC端Wlan连接至AP:mxchip_3165 成功连接
UDP工具端创建一个UDP单播连接,目标IP:10.10.10.1,目标端口号:20001,本机端口:4001 UDP单播连接建立
8 AT指令模式发送数据 AT+SSSEND=0,17,I am tcp unicast. TCP工具接收区收到:I am tcp unicast.
AT+SSSEND=2,17,I am tcp unicast. TCP工具接收区收到:I am tcp unicast.
9 切换至透传模式 AT+QUIT +OK(退出AT指令模式,进入透传)
10 模块接收数据(AT指令模式和透传模式) UDP工具发送区输入数据:I am tcp unicast receiver. 串口工具接收区: +EVENT=SOCKET,2,26,I am udp boardcast receiver.

在PC端利用TCP/UDP测试软件创建一个UDP广播连接,与模块进行UDP通信,具体情况请参考。

其中,上方为PC端TCP/UDP测试软件数据收发工作区,下方为串口调试软件数据收发工作区。

ap_pc_udpunicast

ap_udpunicast_log

2.STATION模式下的UDP单播

在WiFi AT指令模式下,STATION 模式下建立一个UDP客户端,模块发 UDP 单播信息。具体步骤如下(以链接 1 为例,链接 2 方法相同):

序号 步骤 发送指令(或操作) 返回(或现象)
1 进入AT指令模式 发送+++, 返回a后,发送:a a+OK
2 设置并开启 STATION模式 请参考:启动Station模式,获取模块的STATION的ssid和IP地址 如:+OK=ssid,77777777, 如:+OK=10.0.3.25,255,.255.255.0, 10.0.3.1
3 PC连接到STATION:ssid,并获取PC的IP地址 PC连接到STATION: ssid 成功连接到ssid
PC端查看IP地址。查看方法:PC打开DOS命令窗口cmd.exe,输入命令ipconfig,查看无线局域网IP地址 IP地址:10.0.3.34
4 设置通道1的TCP参数 AT+CON1=UNICAST,20001,4001,10.0.3.34 +OK
5 保存设置,重启生效 AT+SAVE +OK
AT+REBOOT +OK
6 查询设置是否生效 发送+++, 返回a后,发送:a a+OK
AT+CON1 +OK=UNICAST,20001,4001, 10.0.3.34
7 PC端 创建一个UDP连接 PC端Wlan连接至ssid 成功连接
UDP工具端创建UDP单播连接,目标IP:10.0.3.25,目标端口号:20001,本机端口:4001 UDP单播连接建立
8 AT指令模式发送数据 AT+SSSEND=0,17,I am udp unicast. TCP工具接收区收到:I am udp unicast.
AT+SSSEND=2,17,I am udp unicast. TCP工具接收区收到:I am udp unicast.
9 切换至透传模式 AT+QUIT +OK(退出AT指令模式,进入透传模式)
10 模块接收数据(AT指令模式和透传模式) TCP工具发送区输入数据:I am tcp unicast receiver. 串口工具接收区+EVENT=SOCKET,2,26,I am tcp unicast receiver.

在PC端利用TCP/UDP测试软件创建一个UDP广播连接,与模块进行UDP通信,具体情况请参考。

其中,上方为PC端TCP/UDP测试软件数据收发工作区,下方为串口调试软件数据收发工作区。

sta_pc_udpunicast

sta_udpunicast_log

文本导读目录