# EMB1082 系列BLE AT 指令

本文介绍：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

响应：

OK

参数：

无

#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>

注：当在设置模块名称时，如果模组正处于ROLE_PERIPHERAL状态并在广播，模块会优先暂停广播并不会更新模块名称，需要再次设置模块名称才可生效。

#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

查询格式：

AT+BAUD

响应：

+BAUD=<Param>

#AT+ADVMOD

功能：查询/设置蓝牙广播参数

设置格式：

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+DEFAULT

响应：

OK

#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>

更新时间: 2024/2/26 15:13:19

← Q & A →