本文介绍:EMB1082 AT固件支持的 AT 指令集。
工作模式
模块工作在从机模式时,蓝牙连接成功后自动进入透传模式,蓝牙连接断开时进入AT指令模式。
AT指令格式
AT+ 指令采用基于 ASCII 码的命令行,格式如下:
1.格式说明
- a) <>:表示必须包含的部分
- b) []:表示可选的部分
2.命令格式
AT+<CMD>[op][para-1,para-2,para-3,......]\r\n
- a)
AT+: 命令消息前缀 - b)
CMD: 指令字符串 - c)
[op]: 指令操作符。可以是:
- 1、
"=": 表示参数设置,或查询指定参数 - 2、
"?": 表示查询系统参数 - 3、
"无":表示执行指令 - 4、
"=?":表示查询用户设置的参数
- d)
[para-n]: 表示设置的参数值,或指定查询的参数 - e)
\r: 回车结束符,ASCII码 0x0d - f)
\n: 换行符,ASCII码: 0x0a
3.回应消息格式
[\r\n][+CMD:][para-1,para-2,para-3,......]<\r\n><STATUS><\r\n>
- a)
\r::回车结束符,ASCII码: 0x0d - b)
\n :换行符,ASCII码: 0x0a - c)
[+CMD:] :相应的命令字符串 - d)
[para-n] :查询时返回的参数 - e)
[STATUS]:指令执行成功与否,有两种情况:
- (1)
OK: 表示正确执行; - (2)
ERROR: 表示执行出错。
AT 指令详述
AT
功能:测试指令
AT+RESET
功能:模块复位重启
| 格式: |
AT+RESET |
| 响应: |
OK |
| 参数: |
无 |
AT+VERSION
功能:查询版本号
| 格式: |
AT+VERSION |
| 响应: |
+VERSION =<Param> |
| 参数: |
无 |
| 说明: |
Param:patch版本(8个字符)+app版本(8个字符)Patch和app版本都是32位,版本的响应是以字符串形式 |
AT+LADDR
功能:查询蓝牙设备地址
| 格式: |
AT+LADDR |
| 响应: |
+LADDR=<Param> |
| 参数: |
无 |
| 说明: |
Param:模块蓝牙地址 |
AT+NAME
功能:设置/查询模块名称:
| 设置格式: |
AT+NAME=<Param> |
| 响应: |
Param:模块名称(默认名称:“MXHCIP”) |
| 查询格式: |
AT+NAME |
| 响应: |
+NAME=<Param> |
AT+PIN
功能:设置/查询配对码
| 格式: |
AT+PIN=<Param> |
| 响应: |
+PIN=<Param> OK |
AT+BAUD
功能:查询/设置串口参数
| 设置格式: |
AT+BAUD=<Param> |
| 响应: |
+BAUD=<Param>OK |
| 参数: |
Param:波特率,字符串 取值如下:2400 4800 9600 19200 38400 57600 115200 921600 默认值:9600 |
| 查询格式: |
AT+BAUD |
| 响应: |
+BAUD=<Param> |
AT+ADVCFG
功能:查询/设置蓝牙广播参数
| 设置格式: |
AT+ADVMOD=<Param> |
| 响应: |
+ADVMOD =<Param>OK |
| 查询格式: |
AT+ADVMOD |
| 响应: |
无 |
AT+ ADVINT
功能:开启/关闭—广播
| 设置格式: |
AT+ADVINT=<Param> |
| 响应: |
+ADVINT=<Param>OK |
| 参数: |
Param:XXXX 默认值:320(200ms) |
| 查询格式: |
AT+ADVINT |
| 响应: |
+ ADVINT =<Param> |
AT+POWER
功能:查询/设置 蓝牙最大发射功率
| 设置格式: |
AT+POWER=<Param> |
| 响应: |
+POWER=<Param> OK |
| 参数: |
Param(-20,0,3,4,8): |
|
-20:-20dBm |
|
0: 0dBm |
|
3: 3dBm |
|
4: 4dBm |
|
8: 8dBm |
|
1:自动广播默认值:0 |
| 查询格式: |
AT+POWER |
| 响应: |
+POWER=<Param> |
AT+ADVDAT
功能:设置/查询— 广播数据:(BEACON模式有效)
| 设置格式: |
AT+ADVDAT=<Param> |
| 响应: |
+ADVDAT=<Param>OK |
| 参数: |
Param:小于等于31*2字符串 |
| 查询格式: |
AT+ADVDAT |
| 响应: |
+ADVDAT=<Param> |
AT+SCANRSP
功能:设置/查询—SCAN Response数据:(BEACON模式有效))
| 设置格式: |
AT+SCANRSP=<Param> |
| 响应: |
+SCANRSP=<Param>OK |
| 参数: |
Param:小于等于31*2字符串 |
| 查询格式: |
AT+SCANRSP |
| 响应: |
+SCANRSP=<Param> |
AT+ROLE
功能:设置/查询—主/从模式
| 设置格式: |
AT+ROLE=<Param> |
| 响应: |
+ROLE=<Param>OK |
| 参数: |
Param(0,1): 0:从设备 1:主设备 2:beacon设备 默认值:0 |
| 查询格式: |
AT+ROLE |
| 响应: |
+ROLE=<Param> |
AT+PHY2M
功能:设置/查询—2M模式:
| 设置格式: |
AT+PHY2M=<Param> |
| 响应: |
+PHY2M=<Param>OK |
| 参数: |
Param(0,1):0:1M 1:2M 默认值:0 |
| 查询格式: |
AT+PHY2M |
| 响应: |
+PHY2M=<Param> |
AT+SLEEP
功能:进入DLPS
| 设置格式: |
AT+SLEEP |
| 响应: |
+SLEEP OK |
| 参数: |
注:非连线模式。 任意指令唤醒。 |
AT+PAIR
功能:设置/查询—配对模式
| 查询格式: |
AT+PAIR=<Param> |
| 响应: |
+PAIR=<Param>OK |
| 参数: |
Param(0,1,2,3) |
|
0:NO PASS WORD |
|
1:JUST WORK |
|
2:PASS_WORD |
|
3:PASS_WORD_BOND |
|
默认值:1 |
AT+INQ
功能:搜索蓝牙设备(主模式指令)
| 格式: |
AT+INQ |
| 响应: |
OK +INQS |
|
0:<NAME> <MAC> |
|
1:<NAME> <MAC> |
|
2:<NAME> <MAC> |
| 参数: |
NAME: 搜索到的透传模块的名称 MAC:搜索到的透传模块的MAC地址 |
AT+SINQ
功能:停止搜索蓝牙设备(主模式指令)
| 格式: |
AT+SINQ |
| 响应: |
+INQE |
| 参数: |
无 |
AT+SCANRLT
功能:根据编号查询搜索到到蓝牙地址(主模式指令):
| 查询格式: |
AT+SCANRLT=<Param> |
| 响应: |
+SCANLT=<Param>:<MAC> |
| 参数: |
Param: 搜索到的透传模块的序号 |
|
MAC: 搜索到的透传模块的MAC地址 |
AT+CONN
功能:连接远端设备(主模式指令):
| 查询格式: |
AT+CONN=<Param> |
| 响应: |
OK |
|
+CONNS |
|
+CONNECTED>> <MAC>(已连接远端设备) |
| 参数: |
Param:搜索到的透传模块的设备序号(0 - 9) |
|
MAC:建立连接的蓝牙设备的MAC地址 |
AT+FC
功能:设置/查询—UART流控:
| 查询格式: |
AT+FC=<Param> |
| 响应: |
+FC=<Param>OK |
|
Param(0,1): |
|
0:禁能UART流控 |
|
1:使能UART流控 |
|
默认值:0 |
| 查询格式: |
AT+BTFC |
| 响应: |
+BTFC=<Param> |
AT+DEFAULT
功能:软件重置(恢复默认设置,500ms后重启):
AT+SERVUUID
功能:设置/查询透传服务UUID:
| 设置格式: |
AT+SERVUUID=<Param> |
| 响应: |
+SERVUUID=<Param>OK |
| 参数: |
Param:UUID值(16bit或者128bit);4字节或者32字节16进制字符串,形式如:1B7E8251287741C3B46ECF057C562023 |
| 查询格式: |
AT+SERVUUID |
| 响应: |
+SERVUUID=<Param> |
AT+RXUUID
功能:设置/查询透传主服务中RX Port特性的UUID:
| 设置格式: |
AT+RXUUID=<Param> |
| 响应: |
+RXUUID=<Param>OK |
| 参数: |
Param:UUID值(只支持16bit);4字节16进制字符串,形式如:FFE1 |
| 查询格式: |
AT+RXUUID |
| 响应: |
+RXUUID=<Param> |
AT+TXUUID
功能:设置/查询透传主服务中TX Port特性的UUID:
| 设置格式: |
AT+TXUUID=<Param> |
| 响应: |
+TXUUID=<Param>OK |
| 参数: |
Param:UUID值(只支持16bit);4字节16进制字符串,形式如:FFE1 |
| 查询格式: |
AT+TXUUID |
| 响应: |
+TXUUID=<Param> |