《自组网蓝牙(BLE-Mesh)模块(微信版)使用指南v1.3.1》由会员分享,可在线阅读,更多相关《自组网蓝牙(BLE-Mesh)模块(微信版)使用指南v1.3.1(35页珍藏版)》请在金锄头文库上搜索。
1、密级:公开资料LONG-SGMI天玖隆科技LONGSEMI-BLE-T01刍组网透传蓝牙模块(微信版)使用指南Version 1.3(适用固件版本:V1.0.3)深圳市天玖隆科技有限公司2015年2月10日 LONG;SMJLONGSEMI-BLE-T01自组网透传蓝牙模块使用指南1. 概述 12. 应用 12.1模块与微信APP连接通信13. 使用说明 33.1模块出厂默认配置33.2数据透明传输33.2.1 工作准备 33.2.2 数据发送33.2.3数据接收33.2.4工作模式选择43.3 AT 指令 43.3.1 指令格式43.3.2 指令约束 53.3.3 AT 指令集 53.3.4
2、微信接口 AT指令说明74. 模块封装与引脚定义 75. 性能指标 95.1 功耗 96. 电气特性 11附录A串口指令说明12附录B操作错误码 28深圳市天玖隆科技有限公司Longsemi Technology Co.丄td.# LONG;SMJLONGSEMI-BLE-T01自组网透传蓝牙模块使用指南深圳市天玖隆科技有限公司Longsemi Technology Co.,Ltd.# LONG;SMJLONGSEMI-BLE-T01自组网透传蓝牙模块使用指南1概述BLE-T01智能蓝牙模块是基于TI CC2540芯片设计的兼容蓝牙4.0低功耗(BLE)单模蓝牙模块。它主要应用于智能穿戴式设备
3、、便携式医疗设备、运动 健身设备、智慧家庭、消费电子、工业控制等,可满足低功耗、低时延、近距离 无线数据通信的要求。BLE-T01组网透传蓝牙模块(微信版河以让开发者无须了 解低功耗蓝牙协议,直接使用类似串口通信方式、开发支持低功耗蓝牙通信和微 信平台的智能产品。本文档是BLE-T01组网透传蓝牙模块(微信版)的使用说明文档,包括模块 的主要功能、应用场景、使用方法、逻辑结构、硬件接口及各项指标特性。另外,原厂对外提供基于透传模块的C语言示例。该示例工作在支持微信事件响应的模式下。示例的使用请参考 wxLib说明V1.0。2. 应用BLE-T01组网透传蓝牙模块可以把所有来自外部 MCU的串口
4、透传数据通过 BLE无线信道透明传输给微信 APP,再传送给厂商的服务器。厂商服务器的数 据也可以通过微信APP透传给外部MCU。2.1模块与微信 APP连接通信在模块和微信APP进行通信前,需要在微信后台对模块进行授权(具体操 作方法请参考微信后台接口文档),然后通过 AT指令配置模块和微信接口相关 的参数,如认证方式,MD5码等。模块出厂默认上电后自动广播,当设置好相 关的参数后,打开微信的公众平台,微信 APP便会自动的连接模块了。原理框 图如图2.1。MCU DC3 3VRX/P0 2 ” 1TX/P0 3 ,COHWP1.1 B.11 II Bl a 口LONGSEMIBLE-TOV
5、Bluetooth4 0*DATAOLJT/P0.5注:实线为必接线,虚线可根据需求考虑是否使用图2.1模块与手机连接通信深圳市天玖隆科技有限公司Longsemi Technology Co.,Ltd.# LONG;SMJLONGSEMI-BLE-T01自组网透传蓝牙模块使用指南3. 使用说明3.1模块出厂默认配置BLE-T01组网透传蓝牙模块(微信版)的出厂默认配置如下表:参数默认值串口配置115200bps , no parity, one stop bit模块名字BDE_WEIXIN_TTM ”模块状态广播广播间隔200ms发射功率0dbmTX延迟发送5ms3.2数据透明传输3.2.1
6、工作准备开发者在应用开发前,需参考第四章模块封装引脚定义和2.1节的描述将MCU和透传模块连接好,确保 MCU和模块的串口能正常通信。另外,模块支 持两种工作模式。一种是支持微信事件响应模式,另一种是完全透传模式。由 P1 3脚决定,因为模块上申复位前就需要根据自己想要的工作模式来确定好 P1 3电平。3.2.2数据发送MCU 在向模块发送串口数据前需先拉低WU/P0.4 引脚来唤醒模块。延迟.2ms后,再发送数据。在数据发送期间,WU/P0.4必须始终保持为低电平,数据发送完毕后再拉高 WU/P0.4引脚,使其可以进入睡眠,降低功耗。每次向模块连续发送的串口数据不要超过 200个字节。3.2
7、.3数据接收模块在向MCU发送串口数据之前会自动拉低 P0.5引脚以通知 MCU接收 数据。数据发送期间P0.5弓I脚保持为低电平。待全部串口数据发送完毕后,P0.5 弓丨脚将被拉高。324工作模式选择模块支持两种工作模式:支持微信事件响应模式、完全透传模式。支持微信事件响应模式 在这种模式下,模块会主动向 MCU发送连接、断开连接、微信认证结果、 微信事件等AT指令。完全透传模式在这种模式下,除了响应 MCU发送的AT请求外,模块不会主动的向 MCU 发送AT指令。模块会将接收到的厂商数据直接通过串口转发给MCU。两种模式是通过模块的P1.3引脚来选择的。在模块上电复位时,如果P1.3为低电
8、平,模块会进入支持微信事件响应的工作模式。否则会进入完全透传的工作模式。在模块正常工作后,P1.3电平的改变将不会导致工作模式 的切换。即P1.3的电平需要在复位前就确定好。用户需要根据自己的实际需求来选择这两个模式。如果用户的产品是需 要获取微信支持的事件,如手机型号,手机平台,公众号页面切换等信息, 就需要选择 支持微信事件响应模式”;如果用户的产品只关注产品和微信公 众号之间的用户数据交互。则只需要选择”完全透传模式”。在这种模式下, 对用户的MCU来说,就相当于在MCU和微信公众号之间接了一根串口线。 这种方式也大大的简化了 MCU的操作。3.3 AT指令BLE-T01组网透传蓝牙模块
9、(微信版)的串口数据流中包含两种数据类型:AT指令和透传数据。利用模块丰富的 AT指令集,开发者可以设置模块的波特率、 广播和连接间隔,开启或关闭广播,断开连接等。模块的指令数据和透传数据在同一数据流中,因此指令数据需要一定的指令封装格式和指令约束条件,以便模块能从串口数据流中分离出指令数据。3.3.1指令格式BLE-T01组网透传蓝牙模块(微信版)的指令数据是ASCII码。它由四部分组成,如下所示:指令开始标志指令码参数列表指令结束标志指令开始标志:AT+这三个连续的字符用于指示一个指令包的开始。指令码:深圳市天玖隆科技有限公司Longsemi Technology Co.,Ltd.# Lo
10、n?;sgmiLONGSEMI-BLE-T01自组网透传蓝牙模块使用指南指令的具体标识,用于区分不同的指令。女口 :setBR。参数列表:不同的指令有不同的参数、不同的参数数目(大于等于0)。指令中每两个参数间需要用空格分隔。指令码和参数列表之间也需要用空格分隔。指令结束标志:rn0这3个字符(即回车符、换行符和空字符)用于指示一个指令包的结束。例:设置模块为从设备:AT+setBR 9600rn0”其中,” AT+为指令开始标志;” setBR为指令码,表示切换角色操作;”9600 ” 为参数,表示将模块的串口波特率设置为9600bps ; ”0”为指令结束标志。332指令约束使用BLE-T
11、01组网透传蓝牙模块(微信版)的指令数据有三个约束条件:1)一条完整的指令应该要被连续地发送到模块,或一条完整的指令的发送总时间不能超过300ms。(在9600bps波特率下,发送一个字节大约需要1ms,连续发送60个字节大约需要60ms。而一条正确的指令的长度一般在 30个 字节之内,因此只要字节是连续发送地就不必担心指令超时问题)2)AT+ ”和”0”之间的数据不能超过50个字节。3)使用正确的、已定义了的指令码。如:“ AT+etbr0”数据包会被理解为透传数据,因为setbr(br没有大写)不是正确的指令码。注意事项:透传模块的指令数据和透传数据在同一个数据流中,指令数据只 会作用到模
12、块状态参数切换。当开发者希望将指令数据作为透传数据传输到另一 端设备时,可使用 sendData 指令来实现。3.3.3 AT指令集透传模块拥有丰富的AT指令集。外部MCU发送到模块的指令:指令码功能setName设置模块名字getName获取模块名字setBR设置波特率getBR获取波特率setTxDly设置串口输出延时getTxDly获取串口输出延时setDBM设置发射功率getDBM获取发射功率setAdvI nt设置广播间隔getAdvI nt获取广播间隔setAdvData设置广播数据getAdvData获取广播数据setAdv开启/关闭广播setC onnlnt设置连接参数getC
13、 onnlnt获取连接参数getAddr获取模块的地址disc onnect断开连接getStatus查询模块当前状态saveC on figure保存当前配置clearC on figure清除保存的配置sen dData发送指定长度的透传数据getVers ion获取模块固件版本号getRemoteAddr获取连接另一方设备的地址setC onnln tEx离线配置连接参数getC onnln tEx获取当前连接参数配置setAuthMode设置微信认证方式getAuthMode获取微信认证方式setMD5设置MD5码getMD5获取MD5码setDevID设置设备IDgetDevID获取
14、设备IDsetAesKey设置AES128密钥模块发送给外部MCU的响应指令指令码功能支持的工作模式ok操作成功支持微信事件响应模式完全透传模式err操作失败支持微信事件响应模式完全透传模式conn连接响应支持微信事件响应模式disc onn断开连接响应支持微信事件响应模式update更新连接参数响应支持微信事件响应模式完全透传模式auth微信登录结果响应支持微信事件响应模式recvData接收微信Push数据响应支持微信事件响应模式sendFin发送结果响应支持微信事件响应模式switchView切换公众号页面响应支持微信事件响应模式switchBkg微信进入后台响应支持微信事件响应模式透传模块的AT指令使用说明参见 附录A334微信接口 AT指令说明BLE-T01组网透传蓝牙模块(微信版)实现了微信GATT Service的完整规范。 用户只需要简单的配置一下模块的相关参数,就能实现和微信APP的连接通信。在模块和微信APP连接前,需要在后台对模块进行授权。授权方法请参考 微信后台接口文档。授权结束后,配置模块过程如下:1. 设置微信认