EW-MOD06指令规格书

[TOC] <h1>一、AT指令说明</h1> <h2>1.1 AT 指令配置</h2> AT+指令是指，在命令模式下用户通过 UART 与模块进行命令传递的指令集，后面将详细讲解 AT+指令的使用格式。上电启动成功后，可以通过 UART 对模块进行设置。模块的缺省口参数为：波特率115200、无校验、8位数据位、1位停止位。 <h2>1.2 AT 指令概述</h2> AT+指令可以直接通过 CRT 等串口调试程序进行输入，AT+指令采用基于 ASCII 码的命令行，指令的格式如下： <h2>1.3.格式说明</h2> <code>&lt; &gt;</code>: 表示必须包含的部分。 <code>[ ]</code>: 表示可选的部分。 <h2>1.4.命令消息</h2> <code>AT+&lt;CMD&gt;[op][para-1,para-2,para-3,para-4…]&lt;CR&gt;&lt;LF&gt;</code> <code>AT+</code>：命令消息前缀。 <code>[op]</code>：指令操作符，指定是参数设置或查询。 <code>“ = ”</code> ：表示参数设置。 <code>“ ? ”</code> ：表示查询。 <code>[para-n]</code>：参数设置时的输入，如查询则不需要。 <code>&lt;CR&gt;</code>：结束符，回车，ASCII码0X0D。 <code>&lt;LF&gt;</code>：结束符，换行，ASCII码0X0A。 <code>[SPACE]</code>：空格符，空格，ASCII码0X20。 <h2>1.5.响应消息</h2> <code>&lt;CR&gt;&lt;LF&gt;+&lt;RSP&gt;[op] [para-1,para-2,para-3,para-4…]&lt;CR&gt;&lt;LF&gt; +：响应消息前缀；</code> <code>RSP</code>：响应字符串，包括： <code>“ OK ”</code> ：表示成功。 <code>“ ERR ”</code> ：表示失败。 <code>[para-n]</code> ：查询时返回参数或出错时错误码。 <code>&lt;CR&gt;</code> ：ASCII码0x0d。 <code>&lt;LF&gt;</code> ：ASCII码0x0a。 <code>[SPACE]</code> ：空格符，空格， ASCII码0X20。 <h1>二、指令说明</h1> <h2>2.1 通用指令</h2> <code>NAME</code> ：查询/设置模块的名称。 <code>MODE</code> ：查询/设置模块的模式。 <code>MAC</code> ：查询/设置模块的MAC地址。 <code>CIVER</code> ：查询软件版本号。 <code>UART</code> ：设置/查询模块串口参数。 <code>Z</code> ：控制模块重启。 <code>+++</code> ：进入透传模式。 <code>AUTO+++</code> ：查询/设置模块在连接上后自动进入透传模式。 <code>FLASH</code> ：存储缺省配置参数到 flash，具体参数见后面解释。 <code>SLEEP</code> ：设置芯片开始/停止 sleep。 <h2>2.2 连接指令</h2> <code>LINK</code> ：查询模块连接状态。 <code>ENC</code> ：配置和查询做为主机进行链接时是否要发起绑定。 <code>SCAN</code> ：搜索周围的从机。 <code>DISCONN</code> ：设置断开某个链接。 <code>CONN</code> ：主动连接 SCAN 扫描到的对端设备。 <code>CONNADD</code> ：设置主动连接的默认对端MAC地址。 <code>SEND</code> ：通过某个链接发送数据到对端。 <h2>2.3 特色功能</h2> <code>UUID</code> ：设置/查询模块的 UUID。 <code>POWER</code> ：查询/设置射频的发射功率。 <code>ADVINT</code> ：查询/设置广播间隔。 <code>CLR_BOND</code> ：清除所有绑定的加密信息。 <code>CLR_INFO</code> ：清除所有 AT+FLASH 命令存储的默认信息。 <h1>三、指令说明</h1> <h2>3.1 AT+NAME</h2> <ul> <li> 功能：查询/设置模块的名称</li> </ul> * 格式： * 查询当前参数值： <code>AT+ NAME?{CR}{LF}</code> * 回应： <code>{CR}{LF}+NAME:name{CR}{LF}OK{CR}{LF}</code> * 设置： <code>AT+NAME=name{CR}{LF}</code> * 回应： <code>{CR}{LF}+NAME:name{CR}{LF}OK{CR}{LF}</code> * 参数： <code>name</code> ：模块的名称(限制长度 1-17 字节) * 设置举例： 例如要设置模块名称为 EW-BLE100 ，则需设置如下 <code>AT+NAME=EW-BLE100{CR}{LF}</code> 上式中的{CR}{LF}及回车换行。 <h2>3.2 AT+MODE</h2> 功能：查询/设置模块广播通道内的工作模式 格式： <ul> <li> 查询当前参数值：</li> </ul> <code>AT+ MODE?{CR}{LF}</code> 回应： <code>{CR}{LF}+MODE:mode{CR}{LF}OK{CR}{LF}</code> * 设置： <code>AT+MODE=mode{CR}{LF}</code> 回应： <code>{CR}{LF}+MODE:mode{CR}{LF}OK{CR}{LF}</code> * 参数： <code>mode</code>：模块的工作模式 <code>I</code>：空闲模式，查询显示 I，设置参数为 I (大写) <code>M</code>：建立链接模式，查询显示 C，设置参数为 M (大写) <code>B</code>：广播模式，查询显示 B，设置参数为 B (大写) <code>U</code>: 升级模式，查询显示 U，设置参数为 U （大写） <code>X</code>：异常模式，查询显示 X，不能设置 <h2>3.3 AT+SLEEP</h2> 功能：开始/停止模块的睡眠功能，使用 AT+FLASH 会记录当前的 Sleep 使能设置，下次上电时会自动启用上次 sleep 的设置。 格式： * 查询： <code>AT+SLEEP?{CR}{LF}</code> 回应： <code>{CR}{LF}+SLEEP:set{CR}{LF}OK{CR}{LF}</code> * 设置： <code>AT+SLEEP=set{CR}{LF}</code> 回应： <code>{CR}{LF}+SLEEP:set{CR}{LF}OK{CR}{LF}</code> * 参数： <code>set</code>：模块 sleep 开始或停止 <code>S</code>：设置模块进入 sleep <code>E</code>：设置模块停止 sleep <h2>3.4 AT+MAC</h2> 功能：查询模块 MAC 地址。 格式： <ul> <li> 查询当前参数值：</li> </ul> <code>AT+MAC?{CR}{LF}</code> 回应： <code>{CR}{LF}+MAC:mac{CR}{LF}OK{CR}{LF}</code> * 设置： <code>AT+ MAC=mac{CR}{LF}</code> 回应： <code>{CR}{LF}+MAC:mac{CR}{LF}OK{CR}{LF}</code> <ul> <li> 参数：</li> </ul> <code>mac</code>：设备MAC地址，例如FFFFFFFFFFFF <h2>3.5 AT+CIVER</h2> 功能：查询软件版本号 格式： * 查询当前版本值： <code>AT+CIVER?{CR}{LF}</code> 回应： <code>{CR}{LF}+VER:版本号,模块型号，MAC地址{CR}{LF} OK{CR}{LF}</code> <h2>3.6 AT+UART</h2> 功能：设置/查询模块串口参数 格式： * 查询当前参数值： <code>AT+UART?{CR}{LF}</code> 回应： <code>{CR}{LF}+UART: baudrate ,databit,pari,stop{CR}{LF}OK{CR}{LF}</code> * 设置： <code>AT+ UART = baudrate ,databit,pari,stop {CR}{LF}</code> 回应： <code>{CR}{LF}+UART: baudrate ,databit,pari,stop{CR}{LF}OK{CR}{LF}</code> <ul> <li> 参数：</li> </ul> <code>baudrate</code>：串口波特率2400至115200任意数值，出厂默认115200。 <code>databit</code>：数据位5,6,7,8,出厂默认8。 <code>pari</code>：校验位，出厂默认无校验。 <code>0</code>：无校验。 <code>2</code>：偶校验。 <code>stop</code>：停止位，出厂默认0: 1 位停止位。 <code>1</code>: 2位停止位。 <h2>3.7 AT+Z</h2> 功能：控制模块重启 格式： * 设置： <code>AT+Z{CR}{LF}</code> 回应： <code>{CR}{LF}+Z{CR}{LF}OK{CR}{LF}</code> <h2>3.8 AT++++</h2> 功能：控制模块进入透传模式 格式： * 设置： <code>AT++++{CR}{LF}</code> 回应： <code>{CR}{LF}+++{CR}{LF}ret{CR}{LF}</code> <ul> <li> 参数：</li> </ul> <code>ret</code>：模块进入透传结果。 <code>OK</code>：进入透传成功。 <code>ERR</code>：进入透传失败。 <h2>3.9 AT+AUTO+++</h2> 功能：查询/设置模块在连接上后是否自动进入透传模式。 格式： <ul> <li> 查询当前参数值：</li> </ul> <code>AT+AUTO+++?{CR}{LF}</code> 回应： <code>{CR}{LF}+AUTO+++:set{CR}{LF}OK{CR}{LF}</code> * 设置： <code>AT+AUTO+++=set{CR}{LF}</code> 回应： <code>{CR}{LF}+AUTO+++:set {CR}{LF}OK{CR}{LF}</code> <ul> <li> 参数：</li> </ul> <code>set</code>：模块链接后是否自动进入透传。 <code>Y</code>：自动进入透传。 <code>N</code>：不自动进入透传。 操作流程： <pre><code class="language-c">(1) AT+MODE=M (2) AT+CONNADD=1F0907091720,1 (3) AT+AUTO++ (4) AT+FLASH (5) AT+Z</code></pre> <h2>3.10 AT+FLASH</h2> 功能：控制模块存储如下信息到 FLASH： UART参数，MAC（自身地址和默认链接的对端地址）， NAME，当前工作模式（B、C模式），广播间隔，是否做为master角色建立链接时发起绑定，是否自动进入透传，是否自动启用sleep 功能，发射功率。 格式： * 设置： <code>AT+FLASH{CR}{LF}</code> 回应： <code>{CR}{LF}+FLASH{CR}{LF}OK{CR}{LF}</code> <h2>3.11 AT+LINK</h2> 功能：查询模块已连接的链接 格式： <ul> <li> 查询当前参数值：</li> </ul> <code>AT+LINK? {CR}{LF}</code> 回应： <code>{CR}{LF}+LINK{CR}{LF}OK{CR}{LF}</code> <code>Link_ID:{SPACE}id{SPACE}LinkMode:mode{SPACE}Enc:enc{SPACE}PeerAddr:mac{CR}{LF}</code> * 参数： <code>id</code>：链接号，为 0~5 之间的整数。 <code>mode</code>: 在链接中的角色，M 表示做为 Master，S 表示做为 Slaver。 <code>enc</code>: 链接是否为加密链接，Y 表示加密， N 表示不加密。 <code>mac</code>: 已连接设备的地址，若无连接则该项无意义。 <h2>3.12 AT+ENC</h2> 功能：使能/禁止做为 master 建立链接时，启用绑定或加密，使用 AT+FLASH 会记录当前的使能设置，下次上电时会自动启用上次的使能设置。 格式： * 查询： <code>AT+ENC?{CR}{LF}</code> 回应： <code>{CR}{LF}+ENC:role{CR}{LF}OK{CR}{LF}</code> * 设置： <code>AT+ENC=role{CR}{LF}</code> 回应： <code>{CR}{LF}+ENC:role{CR}{LF}OK{CR}{LF}</code> * 参数： <code>role</code>：模块做为 master 建立链接时是否要启动绑定加密 <code>B</code>：设置模块使能做为 master 建立链接时启动绑定操作 <code>M</code>：设置模块使能做为 master 建立链接时启动加密操作 <code>N</code>：设置模块禁止做为 master 建立链接时启动绑定加密 注意：设置为M之前，第一次必须设置为B，与对端执行一次绑定操作，不然直接启动加密操作会造成加密失败。 <h2>3.13 AT+SCAN</h2> 功能：搜索周围的从机 格式： *设置扫描时间和执行一次扫描操作： <code>AT+SCAN{CR}{LF}</code> 或 <code>AT+SCAN=time{CR}{LF}</code> 回应： <code>{CR}{LF}+SCAN:ON{CR}{LF}OK{CR}{LF}{LF}{LF}</code> <code>No: {SPACE}num {SPACE}Addr:mac{SPACE}</code> <code>Type:mac_type{SPACE}Rssi:sizedBm{LF}{LF}{CR}{LF}</code> <code>Scan response: {CR}{LF} data{CR}{LF}</code> * 参数： <code>time</code>：设置扫描的时间，单位：秒。有效值范围 1~100 <code>num</code>：搜索到从设备的索引号（最多显示周围 20 个设备） <code>mac</code>：搜索到从设备的 MAC 地址 <code>mac_type</code>：搜索到从设备的 MAC 地址类型 <code>size</code>：搜索到从设备的信号强度 <code>data</code>：搜索到从设备的扫描回应数据包，若无则显示 NONE <h2>3.14 AT+CONN</h2> 功能：通过搜索到索引号快速建立连接 格式： <ul> <li> 设置当前参数值：</li> </ul> <code>AT+CONN=num{CR}{LF}</code> 回应： <code>{CR}{LF}+CONN:num{CR}{LF}OK{CR}{LF}</code> * 参数： <code>num</code>：通过搜索之后的索引号 <h2>3.15 AT+CONNADD</h2> 功能：设置/查询设备上电默认连接模块的 MAC 地址 格式： <ul> <li> 查询当前参数值：</li> </ul> <code>AT+CONNADD?{CR}{LF}</code> 回应： <code>{CR}{LF}+CONNADD:mac{CR}{LF}OK{CR}{LF}</code> * 设置： <code>AT+CONNADD=mac,mac_type{CR}{LF}</code> 回应： <code>{CR}{LF}+CONNADD:mac,mac_type {CR}{LF}OK{CR}{LF}</code> * 参数： <code>mac</code>：上电默认连接MAC地址 <code>mac_type</code>：上电默认连接MAC地址类型，0：public，1：private 操作流程示例： <pre><code class="language-c">（1）AT+MODE=M （2）AT+CONNADD=1F0907091720,1 （3）AT+FLASH （4）AT+Z</code></pre> <h2>3.16 AT+SEND</h2> 功能：通过某个链接发送数据到对端 格式： * 设置： <code>AT+SEND=link_id,len{CR}{LF}</code> 回应： <code>{CR}{LF}&gt;{CR}{LF}</code> * 参数： <code>link_id</code>：要发送数据的链接号，从 AT+LINK?的回复中得知。 <code>Len</code>: 本次要发送数据的长度。 说明：本条命令发送完毕，设备回复>，表示设备进入单次透传模式，在 host 发送完 len 指定的数据长度之前，不解析命令。发送的数据达到 len 指定长度时，退出单次透传模式。 <h2>3.17 AT+DISCONN</h2> 功能：设置断开当前连接 格式： * 设置： <code>AT+DISCONN=link_id{CR}{LF}</code> 回应: <code>{CR}{LF}+DISCONN: link_id {CR}{LF}OK{CR}{LF}</code> * 参数： <code>link_id</code>，断开链接的链接号或字符‘A’ 范围为 0~5 之间的整数(ASCII 格式)，断开某个链接 <code>‘A’</code>，断开当前所有链接 <h2>3.18 AT+UUID</h2> 功能：设置/查询设备串口服务 UUID 格式： <ul> <li> 查询当前参数值：</li> </ul> <code>AT+ UUID? {CR}{LF}</code> 回应： <pre><code class="language-c">{CR}{LF}+bleUart_Server_Uuid: {CR}{LF}DATA:UUID{CR}{LF}{CR}{LF}+bleUart_Server_Tx_Uuid: {CR}{LF}DATA:UUID{CR}{LF}{CR}{LF}+bleUart_Server_Rx_Uuid: {CR}{LF}DATA:UUID{CR}{LF}OK{CR}{LF}</code></pre> * 设置 <code>AT+ UUID=NUM+UUID{CR}{LF}</code> 回应: <code>{CR}{LF}+bleUart_Server_Uuid:{CR}{LF}DATA:UUID{CR}{LF}{CR}{LF}successful{C R}{LF}</code> 或 <code>{CR}{LF}+bleUart_Server_Tx_Uuid:{CR}{LF}DATA:UUID{CR}{LF}{CR}{LF}successf ul{CR}{LF}</code> 或 <code>{CR}{LF}+bleUart_Server_Rx_Uuid:{CR}{LF}DATA:UUID{CR}{LF}{CR}{LF}successful{CR}{LF}</code> * 参数： NUM:用于区分服务 <ul> <li> AA: bleUart_Server_Uuid: 主服务UUID </li> <li> BB: bleUart_Server_Tx_Uuid：串口读服务，一个 Notify服务 </li> <li>CC: bleUart_Server_Rx_Uuid：串口写服务，一个WriteWithoutResponse服务</li> </ul> <h2>3.19 AT+POWER</h2> 功能：查询/设置模块的射频功率 格式： <ul> <li> 查询当前参数值：</li> </ul> <code>AT+ POWER?{CR}{LF}</code> 回应： <code>{CR}{LF}+POWER:set{CR}{LF}OK{CR}{LF}</code> * 设置： <code>AT+POWER=set{CR}{LF}</code> 回应： <code>{CR}{LF}+POWER:set{CR}{LF}OK{CR}{LF}</code> * 参数： set：模块的射频功率 <code>0</code>：5db(默认) <code>1</code>：2.5db <code>2</code>：0db <code>3</code>：-5db <code>4</code>：-10db <code>5</code>：-17db <h2>3.20 AT+ADVINT</h2> 功能：查询/设置广播间隔 格式： <ul> <li>查询当前参数值：</li> </ul> <code>AT+ADVINT?{CR}{LF}</code> 回应： <code>{CR}{LF}+ADVINT:set{CR}{LF}OK{CR}{LF}</code> * 设置： <code>AT+ADVINT=set{CR}{LF}</code> 回应： <code>{CR}{LF}+ADVINT:set{CR}{LF}OK{CR}{LF}</code> <ul> <li>参数：</li> </ul> set：模块的广播间隔 <code>0</code>：50ms <code>1</code>：100ms <code>2</code>：200ms <code>3</code>：500ms <code>4</code>：1000ms(默认) <code>5</code>：2000ms <h2>3.21 AT+CLR_BOND</h2> 功能：清除所有绑定信息。 格式： * 设置： <code>AT+CLR_BOND{CR}{LF}</code> 回应： <code>{CR}{LF}+CLR_BOND{CR}{LF}OK{CR}{LF}</code> <h2>3.22 AT+CLR_INFO</h2> 功能：清除所有的 AT+FLASH 命令存储的默认参数 格式： * 设置： <code>AT+CLR_INFO{CR}{LF}</code> 回应： <code>{CR}{LF}+CLR_INFO{CR}{LF}OK{CR}{LF}</code> <h1>四、更新记录</h1> <table> <thead> <tr> <th style="text-align: center;">版本</th> <th style="text-align: center;">修订日期</th> <th style="text-align: center;">修订人</th> <th style="text-align: center;">修订内容</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;">V1.0</td> <td style="text-align: center;">2024/4/23</td> <td style="text-align: center;">Allen</td> <td style="text-align: center;">初稿</td> </tr> </tbody> </table>

模组

EW-MOD06指令规格书

页面列表