模块联系我们页面设计

WH-BLE102软件设计手册http://www.
mokuai.
cn上海稳恒电子科技有限公司http://www.
mokuai.
cn第1页共36页WH-BLE102软件设计手册文件版本:V1.
0.
3WH-BLE102软件设计手册http://www.
mokuai.
cn上海稳恒电子科技有限公司http://www.
mokuai.
cn第2页共36页产品特点与USR-BLE100功能及封装相兼容支持BLE4.
2协议,向下兼容平均200uA低功耗广播模式,平均500nA休眠模式,多种唤醒方式主从一体,快速切换多种配置方式,串口AT指令,透传AT指令支持1对多广播模式,内置iBeacon协议支持Mesh组网,快速实现蓝牙自组网络蓝牙转UART数据传输1.
7V~3.
6V单电源供电超远的传输距离,模块对传最大发射功率下可达100米,手机对模块最大发射功率下可达140米支持128bit格式UUID修改,可与其他厂家模块通信WH-BLE102软件设计手册http://www.
mokuai.
cn上海稳恒电子科技有限公司http://www.
mokuai.
cn第3页共36页目录WH-BLE102软件设计手册11.
产品概述.
51.
1.
产品简介.
51.
2.
模块基本参数.
52.
产品功能.
72.
1.
用户配置流程.
82.
2.
工作模式.
82.
2.
1.
主设备模式.
92.
2.
2.
从设备模式.
102.
2.
3.
广播模式.
112.
2.
4.
Mesh组网模式.
122.
3.
打包机制.
132.
4.
iBeacon协议.
142.
5.
低功耗模式.
172.
6.
密码配对验证.
182.
7.
数据传输加密.
192.
8.
断线重连.
192.
9.
指示灯状态.
203.
设置方法.
213.
1.
AT指令配置.
213.
1.
1.
串口AT指令.
213.
1.
2.
透传AT指令.
223.
1.
3.
AT指令概述.
223.
1.
4.
AT指令集.
233.
1.
4.
1.
AT+NAME.
243.
1.
4.
2.
AT+MODE.
243.
1.
4.
3.
AT+MAC.
243.
1.
4.
4.
AT+CIVER.
253.
1.
4.
5.
AT+TPL.
253.
1.
4.
6.
AT+PASS.
253.
1.
4.
7.
AT+PASSEN263.
1.
4.
8.
AT+UART.
263.
1.
4.
9.
AT+UARTTM.
273.
1.
4.
10.
AT+AUTOSLEEP.
273.
1.
4.
11.
AT+DEEPSLEEP273.
1.
4.
12.
AT+HIBERNATE.
283.
1.
4.
13.
AT+HELLO.
283.
1.
4.
14.
AT+ENTM283.
1.
4.
15.
AT+RELOAD.
283.
1.
4.
16.
AT+Z293.
1.
4.
17.
AT+LINK293.
1.
4.
18.
AT+SCAN.
29WH-BLE102软件设计手册http://www.
mokuai.
cn上海稳恒电子科技有限公司http://www.
mokuai.
cn第4页共36页3.
1.
4.
19.
AT+CONN293.
1.
4.
20.
AT+CONNADD.
303.
1.
4.
21.
AT+DISCONN.
303.
1.
4.
22.
AT+ADP.
303.
1.
4.
23.
AT+ADPTIM313.
1.
4.
24.
AT+AUTOCONN313.
1.
4.
25.
AT+MAXPUT.
313.
1.
4.
26.
AT+TRENC.
323.
1.
4.
27.
AT+IBEACON.
323.
1.
4.
28.
AT+UUID.
334.
联系方式.
345.
免责声明.
356.
更新历史.
36WH-BLE102软件设计手册http://www.
mokuai.
cn第5页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn1.
产品概述1.
1.
产品简介WH-BLE102模块是一款超低功耗蓝牙4.
2模块,可用于点对点数据透明传输及加密传输,用户无需关心传输协议,只需要进行简单的设置就可以进行通讯.
本模块主从一体,用户既可以使用两个模块设置一主一从进行数据透传,还可以根据标准的BLE协议开发手机APP进行连接通讯.
本模块支持一对多广播,用户只需简单设置就可以将模块设置为一个广播信号发射端设备,同时内置iBeacon协议,简单的配置就可以作为一个iBeacon设备使用.
模块同时支持128bit格式UUID修改,可兼容其他厂家模块通信.
是一款多功能,简单,可靠,兼容性强的物联网传输模块.
图1.
模块基本功能传输图1.
2.
模块基本参数表1WH-BLE102模块基本参数分类项目指标无线参数无线标准802.
15.
1蓝牙规范V4.
2频率范围2.
402GHz-2.
480GHz发射功率-14dBm至+8dBm用户可通过AT指令配置接收灵敏度-85dBm天线选项外置:I-PEX连接器内置:板载天线WH-BLE102软件设计手册http://www.
mokuai.
cn第6页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn硬件参数数据接口UART:1200bps-921600bps工作电压1.
7V~3.
6V工作电流500nA~10mA工作温度-40℃-85℃存储温度-40℃-85℃尺寸18.
2*26.
7*3(mm)软件参数设备类型主设备/从设备安全机制128位AES引擎数据加密PC1加密工作模式主设备模式,从设备模式,广播模式,Mesh组网设置命令AT+命令结构用户配置串口AT命令,透传AT指令客户应用软件支持客户定制应用软件WH-BLE102软件设计手册http://www.
mokuai.
cn第7页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn2.
产品功能本章介绍一下WH-BLE102所具有的功能,下图是模块的功能的整体框图,可以帮助您对产品有一个总体的认识.
图2.
WH-BLE102功能框图WH-BLE102软件设计手册http://www.
mokuai.
cn第8页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn2.
1.
用户配置流程WH-BLE102模块上电启动后,会根据用户预先设置好的参数,进入设置的工作模式,按预设的串口参数打开串口.
用户需要预设的参数有:工作模式主设备模式从设备模式广播模式Mesh组网模式默认连接参数连接的设备MAC地址串口参数波特率数据位检验位停止位配置UUID用户配置完所有参数后重启,模块就可以按照设置的参数工作了.
下面的章节将具体对每一部分进行介绍.
2.
2.
工作模式WH-BLE102共有四种工作模式:主设备模式,从设备模式,广播模式,Mesh组网模式.
主设备模式WH-BLE102支持主设备模式,可以与一个从设备进行连接.
在此模式下可以对周围设备进行搜索并选择需要连接的从设备进行连接.
同时可以设置默认连接从设备的MAC地址,这样模块上电之后就可以自动查找此模块并进行连接.
从设备模式WH-BLE102支持从设备模式,在此模式下完全符合BLE4.
2协议,用户可以根据协议自己开发APP.
此模式下包含一个串口收发的Service,用户可以通过UUID找到它,里面有两个通道,分别是读和写.
用户可以操作这两个通道进行数据的传输.
如果用户使用WH-BLE102的主设备与该从设备相连接,那么就无需关注里面的协议,两个设备直接就可以进行数据的透明传输,为用户建立一个简单的无线传输通道.
广播模式WH-BLE102支持广播模式,在这种模式下模块可以一对多进行广播.
用户可以通过AT指令设置模块广播的数据,模块可以在低功耗模式下持续的进行广播,并且可以自定义广播时间间隔,应用于极低功耗,小数据量,单向传输的应用场合,比如无线抄表,室内定位等功能.
Mesh组网模式WH-BLE102支持Mesh组网模式,在这种模式下模块可以实现简单的自组网络,每个模块只需要设置相同的通讯密码就可以加入到同一网络当中,每一个模块都可以发起数据,每个模块可以收到数据并且进行回复.
并且不需要网关,即使某一个设备出现故障也会跳过并选择最近的设备进行传输.
WH-BLE102软件设计手册http://www.
mokuai.
cn第9页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn2.
2.
1.
主设备模式在此模式下,用户可以控制模块对周围进行搜索,可以发现周围的从机设备,并且可以快速与其进行连接,如果要进行透传,需要配合使用我们的从设备模式的模块.
若想与其它厂家从设备进行连接透传,则需要两个设备拥有相同的UUID,我们的模块提供修改UUID功能(配置UUID只支持128bit格式),用户可以自行修改以用来连接不同厂家的从设备.
用户不需要关注串口数据与无线数据包之间的数据转换过程,只需通过简单的参数设置,即可实现主设备串口与从设备串口之间的数据透明通信.
主机连接从设备可以分为2种方式:第一种采用搜索的方式,最多可以搜索周围20个从设备,使用前需要设置如下参数:(1)设置工作模式为主设备模式AT+MODE=M(2)开启搜索模式AT+SCAN(3)如果搜索到从设备,假如序号是1,可以使用快速连接命令进行连接.
AT+CONN=1(4)完成设置后,等待指示灯常亮即代表连接成功,此时两个串口可以进行数据的透明传输.
图3.
主设备扫描示意图第二种方式如果已知所需连接的从设备的MAC地址也可以采用下面的方式进行连接:(1)使用MAC绑定AT指令设置模块上电默认连接从设备的MAC地址,只能设置一个默认连接MAC地址.
AT+CONNADD=FFFFFFFFFF11(2)设置完成之后使用重启指令重启模块,模块重启之后会搜索并连接设置的从设备的地址,若周围不存在与所设默认连接MAC地址一致的模块,则模块正常工作,不会进行连接.
AT+ZWH-BLE102软件设计手册http://www.
mokuai.
cn第10页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn图4.
设置默认连接MAC地址:用户想要进行一对一的透明数据传输,默认情况下需要使用我们的主设备连接我们的从设备,若想连接其他公司的从设备,需知道该从设备的UUID,并配置我们主设备的UUID(配置UUID只支持128bit格式),配置相同才可以进行通信.
但是我们的从设备支持标准的BLE协议,用户可以自己开发,具体信息下面从设备模式会进行讲解.
:固件目前只支持128bit格式UUID修改,若需要16bit或32bit格式UUID修改,请联系我们技术支持沟通定制支持.
(技术支持网站:http://www.
mokuai.
cn/support.
html)2.
2.
2.
从设备模式在此模式下,用户需要将模块的工作模式设置为从设备模式.
用户如果自己开发APP需要我们模块的UUID进行连接,我们的模块拥有修改UUID的功能(配置UUID只支持128bit格式),用户可以自行修改以用来配合特定APP或主设备.
我们提供APP连接的示例程序.
(1)设置模块工作模式为从设备,指令为AT+MODE=S(2)用户可以通过下面指令查询模块的连接情况AT+LINK(3)用户也可以使用下面指令将现在连接断开AT+DISCONN(4)用户如果不想模块被发现和连接,可以使用下面指令关闭广播数据AT+ADP=OFFWH-BLE102软件设计手册http://www.
mokuai.
cn第11页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn图5.
从设备被扫描示意图图6.
主从数据透传示意图2.
2.
3.
广播模式在此模式下,用户可以设置模块进行小数据量广播,用户需要在APP开发时调用BLE标准的接口进行获取,数据需要使用AT指令进行设置,模块本身只作为发射端,不作为接收端,若想作为同时作为发送端和接收端,请联系我们技术支持沟通定制支持.
(技术支持网站:http://www.
mokuai.
cn/support.
html)(1)首先将模块模式设置到广播模式AT+MODE=B(2)使用AT指令设置模块要发送的数据,数据位16进制长度不超过32字节,广播格式请参考IBEACON协议.
AT+IBEACON=B9407F30F5F8466EAFF925556B57FE6D,12,06,56(3)通过蓝牙监听软件可以获取到监听的数据包,如下:WH-BLE102软件设计手册http://www.
mokuai.
cn第12页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn图7.
广播数据设置图客户若想手机端接收广播,可参看Android软件BLEReader.
关于iBeacon功能在后面的章节中有详细的介绍.
图8.
一对多广播示意图2.
2.
4.
Mesh组网模式WH-BLE102支持Mesh组网模式,可以简单的将多个模块加入到网络中来,利用星型网络和中继技术,每个网络可以连接超过65000个节点,网络和网络还可以互连,最终可将无数蓝牙模块通过手机、平板电脑或PC进行互联或直接操控.
并且不需要网关,即使某一个设备出现故障也会跳过并选择最近的设备进行传输.
整个联网过程只需要设备上电并设置通讯密码就可以自动组网,真正实现简单互联.
(1)首先我们需要设置通讯密码,模块间联网靠密码进行区分AT+PASS=123456(2)将模块模式切换到Mesh组网模式AT+MODE=F(3)此时模块会自动重启,模块进入组网模式(4)此时我们将多个模块按照这种方式进行设置,当一个模块串口发送数据时,周围靠近的模块就会收到,WH-BLE102软件设计手册http://www.
mokuai.
cn第13页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn然后将其输出到串口.
(5)当收到数据的设备需要回复时直接串口发送,最终第一次发送的模块会收到回复,完成网络内部通讯.
:由于组网的原理所以导致每次发送的数量不大于20字节,并且传输过程中会有一定时间的延迟(根据信号强度等决定),并且不能确保数据准确的送达,请根据实际应用环境进行调整.
注意:在每次发送数据前请加两个::(两个冒号),例如要发送的数据为1234,则实际需要输入的为::1234为尽可能保证数据能够准确的送达,模块采用了重传机制,在一定时间内会多次发送数据,请用户在传输过程完毕之后再次发送其它数据,保证数据传输的完整性和数据传输的流畅性.
图9.
Mesh组网示意图2.
3.
打包机制低功耗蓝牙模块本身定位于小数据量的数据传输.
针对不同的串口波特率,BLE连接间隔以及不同的发包间隔,模块将有不同的数据吞吐能力.
但是无论如何都不会超过理论的4Kbyte/s,测试表明转发速率在1.
5Kbyte/s以下,漏包几率比较低,安全起见无论高速还是低速,都建议在上层做校验重传处理.
WH-BLE102的串口一次最多可以接收512字节的数据包,模块会根据数据包的大小自动分包发送,按照标准每个无线包的最大载荷为20个字节.
移动设备发往模块的数据包,必须自行分包(1-20字节/包)发送,模块收到无线包后,会依次转发到模块的串口.
模块内部有两种发包机制,一种是按照标准的20个字节/包,另一种是100个字节/包,后者只能应用于使用我们的模块进行一主一从的数据透传.
如果使用APP与从机进行通讯请选择20个字节/包,在这里有专门的AT指令进行设置.
设置方式如下:AT+MAXPUT=OFF如果使用一主一从进行透传可以将其设置为ONAT+MAXPUT=ON对于串口的打包速度也可以使用AT指令进行设置,串口默认打包速度为100毫秒,用户可以根据使用情况进行设置,合理的打包速度可以减少连包的出现(详细设置方式参看指令AT+UARTTM).
设置方式如下:AT+UARTTM=10WH-BLE102软件设计手册http://www.
mokuai.
cn第14页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn:出厂默认打包机制为100字节/包.
当串口包采用大于100byte小于512byte的大包时.
串口数据可以一次被接收,但需要预留模块通过蓝牙发送数据的时间,否则会出现追尾的现象.
Android5.
0以下版本底层限制每包最大传输量为20字节,IOS限制每包最大传输量为182字节,与我们设备通信每包最大字节数为155字节,客户使用移动端设备向模块发送数据时,请自行分包发送.
蓝牙握手间隔为7.
5ms~50ms,发送间隔建议大于该时间,因为只有在蓝牙握手时才会进行数据收发,若发送间隔小于握手间隔,则会出现丢包或追尾现象.
长时间间隔的优势是显著地降低功耗,而短时间间隔的优势是可以更快的收发数据.
客户需在两者之间进行取舍,我们所设握手间隔偏向于降低功耗,若客户需求提高速率,请联系我们技术支持沟通定制支持.
(技术支持网站:http://www.
mokuai.
cn/support.
html)2.
4.
iBeacon协议WH-BLE102使用BLE广播技术向周围发送自己特有的ID,接收到该ID的应用软件会根据该ID采取一些行动.
比如,在店铺里设置iBeacon通信模块的话,便可让iPhone和iPad上运行一资讯告知服务器,或者由服务器向顾客发送折扣券及进店积分.
此外,还可以在家电发生故障或停止工作时使用iBeacon向应用软件发送资讯.
微信现在也支持iBeacon功能,在后台注册设备的ID,当使用摇一摇功能时,接收到符合注册ID的设备时会推送相关的信息.
同时现在非常流行的蓝牙钥匙挂件,可以通过App和手机的陀螺仪定位模块的位置,用于室内的定位.
iBeacon协议有四个参数组成,分别是UUID,Major,Minor,TXpower.
UUID这是将你所有的beacon与其他人的beacon设备区别开的ID,例如,目前在商店里某个区域分布着多个beacon形成一条"链带",用于为顾客提供特定的服务,那么归属于同一条"链带"的beacon将分配到相同的UUID.
为这条"链带"设计的专用应用程序将会在后台使用这个UUID扫描到这条"链带"中的beacon设备.
major编号:用于将相关的beacon标识为一组.
例如,一个商店中的所有beacon将会分配到相同的major编号.
通过这种方式,应用程序就能够知道顾客位于哪一家商店.
minor标号:用于标识特定的beacon设备.
例如一个商店中的每一个beacon设备都拥有唯一的minor编号,这样你才能够知道顾客位于商店中的哪个位置.
TXpower:用于确定你和beacon之间距离有多近,是距离设备1米测得的信号强度值(RSSI).
假如接收到的信号强度减弱了,那么我们可能在远离.
只要知道1米距离的RSSI,以及当前的RSSI(我们可以从接收到的信号中一块获取到这些信息),那么计算出当前的距离是可能的.
(用作广播时,rssi的广播数据值为256-rssi,并非实际输入的值,即若设置56,实际广播出来的数值为C8也就是200)WH-BLE102提供了非常简单的指令进行设置:(1)设置模块的工作模式为广播模式AT+MODE=B(2)设置iBeacon协议的必备参数AT+IBEACON=B9407F30F5F8466EAFF925556B57FE6D,1,1,175(3)重启模块AT+ZWH-BLE102软件设计手册http://www.
mokuai.
cn第15页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn图10.
发散式一对多广播(4)设置好之后我们需要使用一个通用的APP进行简单的测试,测试的环境是IOS系统,测试软件:LocateBeacon首先打开手机的蓝牙,然后打开APP图11.
LocateBeacon操作界面(5)选择第一个功能打开,如果模块工作正常,就可以显示刚才设置模块的具体信息和当前的距离.
WH-BLE102软件设计手册http://www.
mokuai.
cn第16页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn图12.
LocateBeacon操作界面(6)移动手机和模块的距离可以看到手机上的距离发生变化,当离开或者再次进入到识别范围后就可以收到推送的信息.
(7)此软件只是一个调试工具,用户需要根据自己的应用进行开发,或者加入微信摇一摇平台来实现更多的功能.
:由于信号的波动,以及物理空间复杂的环境因素,iBeacon的距离测算并不是十分精准.
苹果也是把结果放在一个概率范围内,分成immediate(约小于1米),Near(约1米~3米),Far(较远),Unknown(未知,一般出现在启动阶段,或者因为某些原因无法判断),由苹果提供的数据发现,定位在3米以内较精确.
图13.
iBeacon协议示意图WH-BLE102软件设计手册http://www.
mokuai.
cn第17页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn2.
5.
低功耗模式WH-BLE102带有多种的低功耗模式,可以为电池供电的用户提供更长的使用时间.
第一种低功耗模式是自动睡眠模式,此模式用户使用AT指令进行设置进入睡眠的时间,当无连接,串口无数据的情况下等待时间超过设置的时间,模块自动进入睡眠模式,此模式下模块蓝牙正常广播,可以进行连接,串口数据可以随时唤醒模块.
可以使用如下指令进行设置:AT+AUTOSLEEP=ON,4第二种低功耗模式是深度睡眠模式,此模式需要使用AT指令进入,进入之后蓝牙依然可以广播,可以进行连接,两种唤醒方式,分别是建立连接和唤醒引脚唤醒.
此模式下功耗可以达到200uA左右,是大多数从机工作的模式.
可以使用如下指令进行设置:AT+DEEPSLEEP第三种低功耗模式是休眠模式,此模式依然使用AT命令进入,此模式下任何外设都不会工作,功耗可以达到500nA左右,唤醒方式通过唤醒引脚进行唤醒.
AT+HIBERNATE表2低功耗模式对比表低功耗模式功耗(mA)唤醒方式仍正常工作的功能AUTOSLEEP最大值3.
40平均值2.
06串口数据随时进行唤醒可以正常广播,建立连接,响应AT指令DEEPSLEEP最大值2.
01平均值0.
200建立连接或引脚唤醒可以正常广播,建立连接,不响应AT指令HIBERNATE最大值0.
00075平均值0.
00048引脚唤醒任何外设都不会工作,不响应AT指令:此处的低功耗只是对于从机模式及广播模式来说,主机并没有低功耗一说,主机不工作时完全可以让其停止运行,需要时再启动并开启搜索进行建立连接.
使用引脚进行唤醒时,串口会打印WakeUP信息,若打印WakeUP信息则表示模块正常唤醒,若未打印WakeUP信息则表示模块未正常唤醒,请重新进行引脚唤醒操作.
WH-BLE102软件设计手册http://www.
mokuai.
cn第18页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn2.
6.
密码配对验证WH-BLE102为保证设备的安全性,提供了密码配对机制,此功能需要使用AT指令进行开启,当此功能开启后,如果手机等设备搜索到该模块并进行连接时,需要在10S内通过透传Service的Write服务先写入6位数的密码后才可以保持连接,并且进行数据的传输.
如果密码输入错误或者超时都会将该设备断开连接.
如果使用我们的主设备连接我们的从设备,只需要在连接建立后通过主设备的串口发送6位数的密码后开始通讯.
开启方式如下:AT+PASSEN=ON图14.
密码配对验证流程图:默认配对密码为000000六个零.
WH-BLE102软件设计手册http://www.
mokuai.
cn第19页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn2.
7.
数据传输加密WH-BLE102为保证数据传输的安全性,数据传输过程中可以选择使用明文传输和加密传输.
可以使用AT指令开启加密传输,加密开启后串口数据会被输入的密码串进行PC1加密,接收数据的模块只有拥有同样的密码才能正确的进行数据的解密,确保了数据传输过程中的安全性.
加密采用标准PC1加密,客户若需要自己开发APP并使用加密传输,可以向我们的技术支持索要加密字进行开发.
客户如果使用我们的模块进行一主一从数据透传只需要在两个模块进行如下的设置即可:AT+TRENC=ON设置两个模块的密码保持一致AT+PASS=123456此时两个模块建立连接之后进行数据传输时,串口接收的数据被加密,数据输出到串口之前被解密.
防止数据传输中被人获取.
图15.
数据传输加密示意图2.
8.
断线重连WH-BLE102为保证模块连接的稳定性,预防可能出现的断电等异常现象,模块设计了断线重连机制.
用户可以通过AT指令打开断线重连功能,若因断电或信号干扰等异常现象导致模块之间断开连接,当异常干扰消失,模块工作环境恢复正常时,模块主机会自动搜索刚刚断线的从机模块,当发现从机模块后,会自动进行连接操作,尽可能减少数据的丢失,提高系统稳定性.
设置开启/关闭断线重连指令:AT+AUTOCONN=ON断线重连机制存在于模块主机模式下,当用户只使用我们模块做从机时该机制无意义,从机无法主动连接主机.
可以通过操作手动扫描(参看2.
2.
1章节,主机连接第一种模式)或关闭断线重连来终止此操作.
WH-BLE102软件设计手册http://www.
mokuai.
cn第20页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn2.
9.
指示灯状态WH-BLE102模块有一个指示灯,在模块不同的状态有不同的显示情况,具体显示情况如下图所示:表3指示灯状态信息表模块状态指示灯状态主机搜索1秒闪烁3次从机广播1秒闪烁1次1秒闪烁1次连接建立常亮低功耗模式熄灭注意:1.
link灯低电平有效,表中所说常亮实际引脚状态为低电平.
WH-BLE102软件设计手册http://www.
mokuai.
cn第21页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn3.
设置方法3.
1.
AT指令配置AT+指令是指,在命令模式下用户通过UART与模块进行命令传递的指令集,后面将详细讲解AT+指令的使用格式.
上电启动成功后,可以通过UART对模块进行设置.
模块的缺省UART口参数为:波特率57600、无校验、8位数据位、1位停止位.
3.
1.
1.
串口AT指令WH-BLE102模块具有多种工作模式,启动时模块自动进入设置的模式,用户可以通过串口命令把模块切换到命令行(AT指令)模式.
从其他模式切换到命令模式需要在串口上输入"+++a",模块在收到"+++a"后会返回一个确认码"a+ok",当在串口发现这个打印信息后即说明模块进入了命令行模式.
当进入命令后可以按照我们的AT格式发送相应的指令即可.
图16.
进入命令模式返回结果示意图在输入"+++"和确认码"a"时,没有回显,如下图所示.
输入"+++"和"a"需要在一定时间内完成,以减少正常工作时误进入命令模式的概率.
具体要求如下:图17.
+++a时序图要求:T1>打包间隔,T2,T3:表示必须包含的部分[]:表示可选的部分2.
命令消息AT+[op][para-1,para-2,para-3,para-4…]AT+:命令消息前缀;[op]:指令操作符,指定是参数设置或查询;"=":表示参数设置"NULL":表示查询[para-n]:参数设置时的输入,如查询则不需要;:结束符,回车,ASCII码0X0D;:结束符,换行,ASCII码0X0A;3.
响应消息+[op][para-1,para-2,para-3,para-4…]+:响应消息前缀;RSP:响应字符串,包括:"OK":表示成功"ERR":表示失败[para-n]:查询时返回参数或出错时错误码:ASCII码0x0d;:ASCII码0x0a;4.
错误码表4错误码列表错误码说明-1无效的命令格式-2无效的参数NOATCMD无效的命令WH-BLE102软件设计手册http://www.
mokuai.
cn第23页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn3.
1.
4.
AT指令集表5AT+指令列表指令说明通用指令NAME查询/设置模块的名称MODE查询/设置模块的模式MAC查询模块的MAC地址CIVER查询软件版本号TPL查询/设置模块发射功率PASS设置/查询模块密码PASSEN设置/查询配对验证UART设置/查询模块串口参数UARTTM设置/查询串口打包时间AUTOSLEEP设置/查询自动睡眠DEEPSLEEP设置进入超低功耗模式HIBERNATE设置进入休眠模式HELLO设置/查询开机欢迎语ENTM退出命令模式RELOAD恢复出厂默认参数Z控制模块重启连接指令LINK查询模块连接状态SCAN搜索周围的从机CONN通过搜索到索引号快速建立连接CONNADD设置/查询设备上电默认连接模块的MAC地址DISCONN设置断开当前连接ADP设置/查询设备模块是否进行广播ADPTIM设置/查询模块自定义广播速度AUTOCONN设置/查询模块断线自动重连特色功能MAXPUT使能/禁用最大输出TRENC使能/禁用PC1加密传输IBEACON设置/查询iBeacon功能UUID设置/查询模块的UUIDWH-BLE102软件设计手册http://www.
mokuai.
cn第24页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn3.
1.
4.
1.
AT+NAME功能:查询/设置模块的名称格式:查询当前参数值:AT+NAME{CR}{LF}回应:{CR}{LF}+NAME:name{CR}{LF}OK{CR}{LF}设置:AT+NAME=name{CR}{LF}回应:{CR}{LF}+NAME:name{CR}{LF}OK{CR}{LF}参数:name:模块的名称(限制长度1~15字节)设置举例:例如要设置模块名称为WH-BLE102,则需设置如下AT+NAME=WH-BLE102{CR}{LF}上式中的{CR}{LF}即回车换行.
3.
1.
4.
2.
AT+MODE功能:查询/设置模块的工作模式格式:查询当前参数值:AT+MODE{CR}{LF}回应:{CR}{LF}+MODE:mode{CR}{LF}OK{CR}{LF}设置:AT+MODE=mode{CR}{LF}回应:{CR}{LF}+MODE:mode{CR}{LF}OK{CR}{LF}参数:mode:模块的工作模式M:主设备模式,查询显示Mast,设置参数为M或mS:从设备模式,查询显示Slave,设置参数为S或sB:设置广播模式或iBeacon模式,查询显示iBeacon,设置参数为B或bF:Mesh组网模式,查询显示Mesh,设置参数为F或f3.
1.
4.
3.
AT+MAC功能:查询模块MAC地址.
格式:查询当前参数值:AT+MAC{CR}{LF}WH-BLE102软件设计手册http://www.
mokuai.
cn第25页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn回应:{CR}{LF}+MAC:mac{CR}{LF}OK{CR}{LF}参数:mac:设备MAC地址,例如FFFFFFFFFFFF3.
1.
4.
4.
AT+CIVER功能:查询软件版本号格式:查询当前参数值:AT+CIVER{CR}{LF}回应:{CR}{LF}+VER:版本号{CR}{LF}OK{CR}{LF}3.
1.
4.
5.
AT+TPL功能:查询/设置模块发射功率.
格式:查询当前参数值:AT+TPL{CR}{LF}回应:{CR}{LF}+TPL:num->size{CR}{LF}{CR}{LF}OK{CR}{LF}设置:AT+TPL=size{CR}{LF}回应:{CR}{LF}+TPL:size{CR}{LF}{CR}{LF}OK{CR}{LF}参数:num:发射功能等级1~8size:模块发射功率:1:-14dbm2:-11dbm3:-8dbm4:-5dbm5:-2dbm6:+2dbm7:+4dbm8:+8dbm注意:设置完成后需重启模块才可生效.
3.
1.
4.
6.
AT+PASS功能:设置/查询模块密码格式:查询当前参数值:AT+PASS{CR}{LF}WH-BLE102软件设计手册http://www.
mokuai.
cn第26页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn回应:{CR}{LF}+PASS:password{CR}{LF}OK{CR}{LF}设置:AT+PASS=password{CR}{LF}回应:{CR}{LF}+PASS:password{CR}{LF}OK{CR}{LF}参数:password:模块6位通讯密码,出厂默认为0000003.
1.
4.
7.
AT+PASSEN功能:查询/设置是否使能连接验证,当开启使能后主机连接到使能验证的从机后需要在十秒钟内发送6位通讯密码,超时或者密码错误会被断开连接格式:查询当前参数值:AT+PASSEN{CR}{LF}回应:{CR}{LF}+PASSEN:status{CR}{LF}OK{CR}{LF}设置:AT+PASSEN=status{CR}{LF}回应:{CR}{LF}+PASSEN:status{CR}{LF}OK{CR}{LF}参数:status:连接配对使能状态,包括:"on":使能"off":禁止3.
1.
4.
8.
AT+UART功能:设置/查询模块串口参数格式:查询当前参数值:AT+UART{CR}{LF}回应:{CR}{LF}+UART:baudrate,databit,pari,stop{CR}{LF}OK{CR}{LF}设置:AT+UART=baudrate,databit,pari,stop{CR}{LF}回应:{CR}{LF}+UART:baudrate,databit,pari,stop{CR}{LF}OK{CR}{LF}参数:baudrate:串口波特率1200~921600,出厂默认57600databit:数据位5,6,7,8,出厂默认8pari:校验位,出厂默认无校验0:无校验1:奇校验WH-BLE102软件设计手册http://www.
mokuai.
cn第27页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn2:偶校验stop:停止位,出厂默认1停止位0:1位停止位1:2位停止位3.
1.
4.
9.
AT+UARTTM功能:设置/查询串口打包时间格式:查询当前参数值:AT+UARTTM{CR}{LF}回应:{CR}{LF}+UARTTM:time{CR}{LF}OK{CR}{LF}设置:AT+UARTTM=time{CR}{LF}回应:{CR}{LF}+UARTTM:time{CR}{LF}OK{CR}{LF}参数:time:串口打包时间=tine*10ms,默认打包时间100毫秒(即默认参数值为10),参数范围为1~1000.
3.
1.
4.
10.
AT+AUTOSLEEP功能:设置/查询自动睡眠格式:查询当前参数值:AT+AUTOSLEEP{CR}{LF}回应:{CR}{LF}+AUTOSLEEP:{CR}{LF}AUTO:status{CR}{LF}Time:time*5s{CR}{LF}OK{CR}{LF}设置:AT+AUTOSLEEP=status,time{CR}{LF}回应:{CR}{LF}+AUTOSLEEP:status,time{CR}{LF}OK{CR}{LF}参数:status:是否开启自动睡眠功能ON:开启OFF:关闭time:自动睡眠等待时间,等待时间等于time*5秒,出厂默认参数5,参数范围1~1003.
1.
4.
11.
AT+DEEPSLEEP功能:设置进入超低功耗模式格式:设置:WH-BLE102软件设计手册http://www.
mokuai.
cn第28页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cnAT+DEEPSLEEP{CR}{LF}回应:{CR}{LF}+DEEPSLEEP:{CR}{LF}OK{CR}{LF}3.
1.
4.
12.
AT+HIBERNATE功能:设置进入休眠模式格式:设置当前参数值:AT+HIBERNATE{CR}{LF}回应:{CR}{LF}+HIBERNATE:{CR}{LF}OK{CR}{LF}3.
1.
4.
13.
AT+HELLO功能:设置/查询开机欢迎语格式:查询当前参数值:AT+HELLO{CR}{LF}回应:{CR}{LF}+HELLO:string{CR}{LF}OK{CR}{LF}设置:AT+HELLO=string{CR}{LF}回应:{CR}{LF}+HELLO:string{CR}{LF}OK{CR}{LF}参数:string:开启欢迎语,长度限制0~20字节,设置空则无开机欢迎语3.
1.
4.
14.
AT+ENTM功能:退出命令模式退出命令模式格式:设置当前参数值:AT+ENTM{CR}{LF}回应:{CR}{LF}+ENTM:OK{CR}{LF}OK{CR}{LF}3.
1.
4.
15.
AT+RELOAD功能:恢复出厂默认参数格式:设置当前参数值:AT+RELOAD{CR}{LF}回应:{CR}{LF}+RELOAD:OK{CR}{LF}OK{CR}{LF}WH-BLE102软件设计手册http://www.
mokuai.
cn第29页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn3.
1.
4.
16.
AT+Z功能:控制模块重启格式:设置当前参数值:AT+Z{CR}{LF}回应:{CR}{LF}+RST:OK{CR}{LF}OK{CR}{LF}3.
1.
4.
17.
AT+LINK功能:查询模块连接状态格式:查询当前参数值:AT+LINK{CR}{LF}回应:{CR}{LF}PeerAddr:MAC{CR}{LF}Rssi:RssidBm{CR}{LF}+LINK:status{CR}{LF}OK{CR}{LF}参数:MAC:已连接设备的地址,若无连接则不回应该项Rssi:已连接设备的信号强度,若无连接则不回应该项status:模块连接状态OnLine:连接成功OffLine:模块未连接3.
1.
4.
18.
AT+SCAN功能:搜索周围的从机格式:查询当前参数值:AT+SCAN{CR}{LF}回应:{CR}{LF}+SCAN:ON{CR}{LF}OK{CR}{LF}{LF}{LF}No:numAddr:macRssi:sizedBm{LF}{LF}参数:num:搜索到从设备的索引号(最多显示周围20个设备)mac:搜索到从设备的MAC地址size:搜索到从设备的信号强度3.
1.
4.
19.
AT+CONN功能:通过搜索到索引号快速建立连接格式:设置当前参数值:AT+CONN=num{CR}{LF}WH-BLE102软件设计手册http://www.
mokuai.
cn第30页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn回应:{CR}{LF}+CONN:num{CR}{LF}OK{CR}{LF}参数:num:通过搜索之后的索引号3.
1.
4.
20.
AT+CONNADD功能:设置/查询设备上电默认连接模块的MAC地址格式:查询当前参数值:AT+CONNADD{CR}{LF}回应:{CR}{LF}+CONNADD:mac{CR}{LF}OK{CR}{LF}设置:AT+CONNADD=mac{CR}{LF}回应:{CR}{LF}+CONNADD:mac{CR}{LF}OK{CR}{LF}参数:mac:上电默认连接MAC地址3.
1.
4.
21.
AT+DISCONN功能:设置断开当前连接格式:设置:AT+DISCONN{CR}{LF}回应:{CR}{LF}+DISCONN:OK{CR}{LF}OK{CR}{LF}3.
1.
4.
22.
AT+ADP功能:设置/查询设备模块是否进行广播格式:查询当前参数值:AT+ADP{CR}{LF}回应:{CR}{LF}+ADP:status{CR}{LF}OK{CR}{LF}设置:AT+ADP=status{CR}{LF}回应:{CR}{LF}+ADP:status{CR}{LF}OK{CR}{LF}参数:status:设置模块是否开启广播ON:开启广播OFF:关闭广播WH-BLE102软件设计手册http://www.
mokuai.
cn第31页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn3.
1.
4.
23.
AT+ADPTIM功能:设置/查询模块的自定义广播速度格式:查询当前参数值:AT+ADPTIM{CR}{LF}回应:{CR}{LF}+ADPTIM:time{CR}{LF}OK{CR}{LF}设置:AT+ADPTIM=time{CR}{LF}回应:{CR}{LF}+ADPTIM:time{CR}{LF}OK{CR}{LF}参数:time:模块广播速度自定义广播时间间隔的基数为10ms,即time=10时广播间隔为100ms.
范围10~1024注意:设置完自定义广播速度后需重启模块,否则本次设置不能够立即生效.
3.
1.
4.
24.
AT+AUTOCONN功能:使能/禁用断线自动重连功能格式:查询当前参数值:AT+AUTOCONN{CR}{LF}回应:{CR}{LF}+AUTOCONN:status{CR}{LF}OK{CR}{LF}设置:AT+AUTOCONN=status{CR}{LF}回应:{CR}{LF}+AUTOCONN:status{CR}{LF}OK{CR}{LF}参数:status:断线自动重连功能状态,包括:ON:使能OFF:禁止3.
1.
4.
25.
AT+MAXPUT功能:使能/禁用最大输出格式:查询当前参数值:AT+MAXPUT{CR}{LF}回应:{CR}{LF}+MAXPUT:status{CR}{LF}OK{CR}{LF}设置:WH-BLE102软件设计手册http://www.
mokuai.
cn第32页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cnAT+MAXPUT=status{CR}{LF}回应:{CR}{LF}+MAXPUT:status{CR}{LF}OK{CR}{LF}参数:status:最大输出状态,包括:ON:使能OFF:禁用注意:出厂默认开启最大输出3.
1.
4.
26.
AT+TRENC功能:查询/设置数据加密传输格式:查询当前参数值:AT+TRENC{CR}{LF}回应:{CR}{LF}+TRENC:status{CR}{LF}OK{CR}{LF}设置:AT+TRENC=status{CR}{LF}回应:{CR}{LF}+TRENC:status{CR}{LF}OK{CR}{LF}参数:status:模块加密传输,包括:ON:使能OFF:禁止3.
1.
4.
27.
AT+IBEACON功能:设置/查询iBeacon功能格式:查询当前参数值:AT+IBEACON{CR}{LF}回应:{CR}{LF}+iBeacon:{CR}{LF}UUID:uuid,{CR}{LF}Major:major,Minor:minor,Rssi:rssi{CR}{LF}{CR}{LF}OK{CR}{LF}设置:AT+IBEACON=uuid,major,minor,rssi{CR}{LF}回应:{CR}{LF}+iBeacon:{CR}{LF}UUID:uuid,{CR}{LF}Major:major,Minor:minor,Rssi:rssi{CR}{LF}{CR}{LF}OK{CR}{LF}参数:uuid:iBeacon设备识别码major:major编号minor:minor标号rssi:距离一米是的信号强度(设置时不考虑负号)WH-BLE102软件设计手册http://www.
mokuai.
cn第33页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn3.
1.
4.
28.
AT+UUID功能:设置/查询设备串口服务UUID格式:查询当前参数值:AT+UUID{CR}{LF}回应:{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}设置AT+UUID=NUM+UUID{CR}{LF}回应:{CR}{LF}+bleUart_Server_Uuid:{CR}{LF}DATA:UUID{CR}{LF}{CR}{LF}successful{CR}{LF}或{CR}{LF}+bleUart_Server_Tx_Uuid:{CR}{LF}DATA:UUID{CR}{LF}{CR}{LF}successful{CR}{LF}或{CR}{LF}+bleUart_Server_Rx_Uuid:{CR}{LF}DATA:UUID{CR}{LF}{CR}{LF}successful{CR}{LF}参数:NUM:用于区分服务AA:bleUart_Server_Uuid:主服务UUIDBB:bleUart_Server_Tx_Uuid:串口读服务,一个Notify服务CC:bleUart_Server_Rx_Uuid:串口写服务,一个WriteWithoutResponse服务WH-BLE102软件设计手册http://www.
mokuai.
cn第34页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn4.
联系方式公司:上海稳恒电子科技有限公司地址:上海市闵行区秀文路898号西子国际五号楼611室网址:http://www.
mokuai.
cn邮箱:sales@mokuai.
cn电话:021-52960996或者021-52960879使命:做芯片到产品的桥梁愿景:全球有影响力的模块公司价值观:信任专注创新产品观:稳定的基础上追求高性价比WH-BLE102软件设计手册http://www.
mokuai.
cn第35页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn5.
免责声明本文档提供有关WH-BLE102产品的信息,本文档未授予任何知识产权的许可,并未以明示或暗示,或以禁止发言或其它方式授予任何知识产权许可.
除在其产品的销售条款和条件声明的责任之外,我公司概不承担任何其它责任.
并且,我公司对本产品的销售和/或使用不作任何明示或暗示的担保,包括对产品的特定用途适用性,适销性或对任何专利权,版权或其它知识产权的侵权责任等均不作担保.
本公司可能随时对产品规格及产品描述做出修改,恕不另行通知.
WH-BLE102软件设计手册http://www.
mokuai.
cn第36页共36页上海稳恒电子科技有限公司http://www.
mokuai.
cn6.
更新历史2017-12-11V1.
0.
0初版建立2017-12-15V1.
0.
1修正部分描述2017-12-27V1.
0.
2修正串口部分描述2017-05-25V1.
0.
3优化低功耗模式,修改部分AT指令参数(AUTOSLEEP,ADPTIM,TPL,UARTTM)