简介¶
本文主要介绍博流 AT指令集以及使用方法。指令集包含:基础 AT 指令、Wi-Fi 功能 AT 指令、TCP/IP ⼯具箱 AT 指令、BLE 相关 AT 指令。
类型 |
格式 |
描述 |
查询指令 |
AT+<x>? |
该指令用于返回当前参数的值 |
设置指令 |
AT+<x>=<···> |
该指令用于设置用户自定义的参数 |
执行指令 |
AT+<x> |
该指令用于执行模块内部变参数不可变的功能 |
基础AT指令¶
基础AT指令描述¶
AT+UART¶
指令
查询指令
AT+UART?
设置指令
AT+UART=<baudrate>,<databits>,<stopbits>,<parity>,<flow control>
响应
+UART_CUR:<baudrate>,<databits>,<stopbits>,<parity>,<flow control> | OK
OK |
参数说明
<baudrate>: UART 波特率
<databits>: 数据位
5: 5-bit 数据位
6: 6-bit 数据位
7: 7-bit 数据位
8: 8-bit 数据位
<stopbits>: 停止位
1: 1-bit 停⽌位
2: 1.5-bit 停⽌位
3: 2-bit 停⽌位
<parity>: 校验位
0: None
1: Odd
2: Even
<flow control>: 流控
0: 不使能流控
1: 使能 RTS
2: 使能 CTS
3: 同时使能 RTS 和 CTS
AT+GMR¶
AT+RST¶
执行指令
AT+RST
响应
OK
AT+RESTORE¶
执行指令
AT+RESTORE
响应
OK
AT+S.HELP¶
执行指令
AT+S.HELP
响应
OK
AT+GSLP¶
指令
设置指令:
AT+GSLP=<time>
响应
<time>
OK
参数说明
<time>: 设置 BL602 的睡眠时长,单位:秒。 BL602 会在休眠设定时长后唤醒
Wi-Fi 功能 AT 指令¶
指令 |
描述 |
设置 Wi-Fi 模式 (STA/AP/STA+AP) |
|
扫描附近AP |
|
连接AP |
|
断开AP |
|
设置自动重连 |
|
开启AP |
基础AT指令描述¶
AT+CWMODE¶
指令
查询指令
AT+CWMODE?
功能:查询BL602 Wi-Fi 模式
设置指令
AT+CWMODE=<mode>
功能:设置BL602 Wi-Fi 模式
响应
+CWMODE:<mode>
OK
参数说明
<mode>:
0: 无 Wi-Fi 模式,并且关闭 Wi-Fi RF
1: Station 模式
2: SoftAP 模式
3: SoftAP+Station 模式
AT+CWLAP¶
指令
查询指令
AT+CWLAP
功能:扫描附近的AP热点。
响应
+CWLAP:
<ap list>...
OK
响应说明
<序号>,<SSID>,<BSSID>,<信道>,<信号强度>,<加密方式>
AT+CWAUTOCONN¶
指令
查询指令
AT+CWAUTOCONN?
功能:查询BL602 Wi-Fi 自动重连
设置指令
AT+CWAUTOCONN=<auto_connect>
功能:设置BL602 Wi-Fi 自动重连
响应
+CWAUTOCONN:<mode>
OK
参数说明
<auto_connect>:
0: 当WiFi模式变成Station或SoftAP+Station时,不连接WiFi
1: 当WiFi模式变成Station或SoftAP+Station(默认配置)时,连接WiFi
AT+CWJAP¶
指令
查询指令
AT+CWJAP?
功能:查询 BL602 Station 已连接的 AP 信息。
设置指令
AT+CWJAP=<ssid>,<pwd>
功能:设置 BL602 Station 需连接的 AP。
响应
+CWJAP:<ssid>,<ip>
OK
OK
+EVT:0:wifi connected
参数说明
<ssid>: 字符串串参数,AP 的 SSID
<ip>: 当前获取到的ip地址
<ssid>: 目标 AP 的 SSID
<pwd>: 目标 AP 的 密码
若SSID或密码包含任何特殊字符,例如"或者,则需要转义
AT+CWQAP¶
指令
设置指令:
AT+CWQAP=<link id>
响应
OK
AT+SOFTAP¶
指令
查询指令
AT+SOFTAP?
功能:查看开启的AP热点信息。
设置指令
AT+SOFTAP=<ssid>,[pwd]
功能:开启一个AP热点。
响应
+SOFTAP:<ip>,<bssid>
OK
OK
参数说明
<ip>: 开启的AP热点的IP地址
<bssid>: 当前开启的AP热点的MAC地址
<ssid>: 设置AP 的 SSID
[pwd]: 设置 AP 的 密码,若没有此参数,则该AP为开放式AP
若SSID或密码包含任何特殊字符,例如"或者,则需要转义
TCP/IP 相关 AT 指令¶
指令 |
描述 |
建立 TCP 连接,UDP 传输 |
|
关闭 TCP 连接,UDP 传输 |
|
删除或创建TCP服务器 |
|
发送TCP/IP数据 |
|
收到TCP/IP数据 |
基础AT指令描述¶
AT+CIPSTART¶
设置指令 |
AT+CIPSTART=<link id>,<type>,<remote IP>,<remote port> |
响应 |
OK 或者已经建立TCP连接,响应:ALREADY CONNECTTED ERROR |
参数说明 |
|
示例 |
AT+CIPSTART=0,TCP,192.168.101,8000 AT+CIPSTART=1,UDP,192.168.101,5000 |
AT+CIPCLOSE¶
指令
设置指令:
AT+CIPCLOSE=<link id>
响应
OK
参数说明
<link id>: 需要关闭的ID
AT+CIPSERVER¶
指令
设置指令:
AT+CIPSERVER=<mode>[,<port>]
响应
OK
参数说明
<mode>:
0: 关闭服务器器
1: 建立服务器器
<port>: 端口号,默认为 333
示例
// 建立 TCP 服务器器
AT+CIPSERVER=1,80
AT+CIPSEND¶
指令
设置指令:
AT+CIPSEND=<link id>,<data len>
响应
OK
参数说明
<link id>: 连接ID
<data len>: 需要传输的数据长度(单位:byte)
示例
AT+CIPSEND=0,20
表示即将向id为0的连接发送20字节的数据
+IPD¶
说明
+IPD为收到TCP/UDP对端连接数据时的响应
+IPD:<link id>,<data len>
<data>
参数说明
<link id>:发送数据的ID
<data len>:即将接收的数据长度(单位:byte)
<data>:接收数据
BLE 相关 AT 指令¶
指令 |
描述 |
设置 BLE 数据包⻓度 |
|
设置 BLE 设备名称 |
|
设置 BLE 设备地址 |
基础AT指令描述¶
AT+BLEDATALEN¶
指令
设置指令:
AT+BLEDATALEN=<conn_index>,<pkt_data_len>
功能:设置 BLE 数据包⻓度。
响应
OK
参数说明
<conn_index>: BLE 连接号, 范围 [0~2].
<pkt_data_len>: 数据包长度,取值范围: 0x001b ~ 0x00fb
注意
需要先建立 BLE 连接,才能设置数据包长度
示例
AT+BLEINIT=1 // 初始化为 client
AT+BLECONN=0,"24:0a:c4:09:34:23"
AT+BLEDATALEN=0,30
AT+BLENAME¶
指令
查询指令
AT+BLENAME?
功能:查询 BLE 设备名称。
设置指令
AT+BLENAME=<device_name>
功能:设置 BLE 设备名称,最大长度为32
响应
+BLENAME:<device_name>
OK
OK
参数说明
<device_name>: BLE 设备名称
AT+BLEADDR¶
指令
查询指令
AT+BLEADDR?
功能:查询 BLE 设备的 public address。
设置指令
AT+BLEADDR=<addr_type>[,<random_addr>]
功能:设置 BLE 设备的地址。
响应
+BLEADDR:<BLE_public_addr>
OK
OK
参数说明
<addr_type>:
0: public address
1: random address