微信蓝牙外设协议

1、.：.；微信蓝牙外设协议Project BlueShadow V1.0.3Tencent Confidential文档变卦日志版本变卦日期01初稿2021/10/902针对常见问题，添加阐明2021/10/1803针对常见问题，添加阐明。修正包头构造。2021/11/504第二期初稿添加17条protobuf协议，废弃1条，修正1条2021/11/2605暂时去掉二期的内容17条protobuf，在一期的根底上添加三条协议，并修正auth协议。参与加密解密部分阐明。2021/2/1206修正uuid的规定。补充协议字段和错误码。补充加密部分细节。2021/2/2707修正加密协议，添加例子。补

2、充不加密的协议。补充错误码。2021/3/407 . 1修正proto里的UserId，Challeange字段。2021/3/707 . 2规定低功耗蓝牙广播包必需包含mac地址。InitResp添加可选字段以支持自动同步方式，修正解码失败错误码。2021/4/307 . 3修正SendData， SendDataPush两条协议，添加type字段，用来区分是发送给厂商效力器，还是发送给公众平台效力器。2021/4/240 . 7 . 4修正ble蓝牙service uuid的值。2021/4/250 . 7 . 5公众平台协议手环修正：添加BaseResponse字段。2021/4/301

3、 . 0 . 1提升版本号为1.0.1 Beta2021/6/91 . 0 . 2添加Read Characteristics，以支持ios多app衔接。添加html jsapi支持。公众平台协议手环修正：添加rtc时间支持。废弃一些字段，修正协议名字为SendData，RecvData等。2021/7/151 . 0 . 3添加蓝牙扫描绑定相关规范。2021/8/18目录 TOC o 1-3 h z u HYPERLINK l _Toc396142795 概要 PAGEREF _Toc396142795 h 5 HYPERLINK l _Toc396142796 整体架构 PAGEREF _

4、Toc396142796 h 5 HYPERLINK l _Toc396142797 主要功能 PAGEREF _Toc396142797 h 5 HYPERLINK l _Toc396142798 蓝牙BLE模拟成流 PAGEREF _Toc396142798 h 6 HYPERLINK l _Toc396142799 协议 PAGEREF _Toc396142799 h 7 HYPERLINK l _Toc396142800 1 绑定 PAGEREF _Toc396142800 h 7 HYPERLINK l _Toc396142801 扫码绑定 PAGEREF _Toc396142801

5、 h 8 HYPERLINK l _Toc396142802 蓝牙扫描绑定 PAGEREF _Toc396142802 h 8 HYPERLINK l _Toc396142803 2 扫描和衔接 PAGEREF _Toc396142803 h 9 HYPERLINK l _Toc396142804 3 流 PAGEREF _Toc396142804 h 9 HYPERLINK l _Toc396142805 4 包 PAGEREF _Toc396142805 h 10 HYPERLINK l _Toc396142806 4 包构造 PAGEREF _Toc396142806 h 10 HYPE

6、RLINK l _Toc396142807 5 定长包头 PAGEREF _Toc396142807 h 11 HYPERLINK l _Toc396142808 6 变长包体 PAGEREF _Toc396142808 h 11 HYPERLINK l _Toc396142809 7 身份验证和加密 PAGEREF _Toc396142809 h 12 HYPERLINK l _Toc396142810 8 不加密的方法 PAGEREF _Toc396142810 h 14 HYPERLINK l _Toc396142811 9 会话商定 PAGEREF _Toc396142811 h 15

7、 HYPERLINK l _Toc396142812 10 时序 PAGEREF _Toc396142812 h 15 HYPERLINK l _Toc396142813 11 Read Characteristics PAGEREF _Toc396142813 h 15 HYPERLINK l _Toc396142814 12 其他 PAGEREF _Toc396142814 h 16 HYPERLINK l _Toc396142815 微信的Protobuf协议 PAGEREF _Toc396142815 h 16 HYPERLINK l _Toc396142816 1 概述 PAGERE

8、F _Toc396142816 h 16 HYPERLINK l _Toc396142817 2 命令列表 PAGEREF _Toc396142817 h 16 HYPERLINK l _Toc396142818 3 错误码 PAGEREF _Toc396142818 h 17 HYPERLINK l _Toc396142819 4 JSAPI PAGEREF _Toc396142819 h 19 HYPERLINK l _Toc396142820 函数 PAGEREF _Toc396142820 h 19 HYPERLINK l _Toc396142821 事件 PAGEREF _Toc39

9、6142821 h 21 HYPERLINK l _Toc396142822 附录 PAGEREF _Toc396142822 h 22 HYPERLINK l _Toc396142823 1 ProtoBuf协议引见 PAGEREF _Toc396142823 h 22 HYPERLINK l _Toc396142824 2 蓝牙硬件一些规定 PAGEREF _Toc396142824 h 23 HYPERLINK l _Toc396142825 3 Ios BLE设备的截图 PAGEREF _Toc396142825 h 23 HYPERLINK l _Toc396142826 4 包的二

10、进制例子 PAGEREF _Toc396142826 h 25 HYPERLINK l _Toc396142827 5 包的数据流图 PAGEREF _Toc396142827 h 26 HYPERLINK l _Toc396142828 6 包的时序图 PAGEREF _Toc396142828 h 27 HYPERLINK l _Toc396142829 7 加解密字段 PAGEREF _Toc396142829 h 28 HYPERLINK l _Toc396142830 8 Md5DeviceTypeAndDeviceId的例子 PAGEREF _Toc396142830 h 29 H

11、YPERLINK l _Toc396142831 9 CBC例子 PAGEREF _Toc396142831 h 30 HYPERLINK l _Toc396142832 10 CRC32例子 PAGEREF _Toc396142832 h 31 HYPERLINK l _Toc396142833 11 微信蓝牙外设proto文件 PAGEREF _Toc396142833 h 31 HYPERLINK l _Toc396142834 12 微信公众平台proto文件 PAGEREF _Toc396142834 h 35 HYPERLINK l _Toc396142835 13 JsApi例子

12、 PAGEREF _Toc396142835 h 37概要该文档规范了蓝牙设备和手机上的微信的通讯协议协议支持经典蓝牙和4.0 BLE蓝牙，目前支持ios和andriod两个系统，后续会扩展到其他系统。整体架构厂商效力器和外设，由厂商开发完成。微信会提供效力器的接口以对接厂商的效力器，会提供手机的接口如本文规定的蓝牙协议以对接厂商的外设。主要功能该协议打通了设备和厂商效力器之间的数据链路，也就是支持将设备上的数据发送到厂商的效力器上，也支持将厂商的数据发送到设备。厂商的数据对于微信来说，是黑盒，微信不对设备数据做分析。该协议也打通了设备和微信效力器之间的数据链路。设备和微信效力器之间的数据格式

13、由微信规定，例如登录，新音讯通知等。蓝牙BLE模拟成流微信支持蓝牙BLE。微信规定了蓝牙BLE设备需求先模拟成流(即stream，输入输出流)。经典蓝牙的RFCOMM，就是一个流。流具有的特性有：可以传输无限长度的数据 双工，读写可以并发，互不干扰。显然，蓝牙BLE无法传输无限长度的数据，为了实现这个目的，需求定义一个规范。蓝牙设备需暴露两个特征值Characteristics：Write特征值，Indication特征值。蓝牙设备从Write特征值接受数据，从Indication特征值发送数据。Indication特征值类型是bytes。这里我们商定，把一个特征值一次传输的数据，称为一帧不同

14、类型的特征值一次传输的数据长度是不一样的。留意：运用层上的数据包例如1k大小，会分散成许多帧来传输。蓝牙设备写过程：分帧：假设蓝牙手环上有1k数据，要发给手机微信。由于一个特征值长度有限如20个字节，显然需求分多次才干传输完成。1k数据，要分成1024字节/ 20字节=51 个帧。剩下的4个字节，缺乏一帧20个字节，需补齐为一帧并对剩下的16个字节赋0。总共是52帧。发送第一个帧：把第一个帧的内容放入特征值里面。然后通知手机读取数据，通知有两种方式，Indication 和notify，这里运用Indication方式，即带呼应的通知。当通知完成的时候，可以以为手机曾经读完数据。这就完成了发送

15、第一个帧。按照2的步骤，依次发送剩下的帧。蓝牙设备读过程：当蓝牙设备发现读特征值收到数据的时候，就接纳数据，并追加到设备的buf里。留意：蓝牙设备必需等微信app订阅了Characteristics之后，才干indicate数据，否者会呵斥设备发送数据丧失的问题。协议1 绑定用户绑定设备有两种方式：扫码和蓝牙扫描。这两种方式都需求先向微信公众平台注册授权设备详细api参见公众平台文档。扫码绑定用户经过扫描设备二维码绑定设备获取二维码的方法见公众平台文档。用户场景：用户翻开扫一扫界面，扫码设备二维码，出现公众号页面。用户点击关注，进展绑定设备。扫码绑定并不需求设备在身边。蓝牙扫描绑定用户经过扫描

16、周边的蓝牙设备进展绑定。用户场景可确认设备：用户先关注公众号，点击绑定设备，进入绑定阐明页。同时，微信开场扫描设备。用户操作设备确认如点击设备上的按钮，或者双击设备，设备广播特殊的包称为确认包，微信监听到包之后，开场关注并绑定。蓝牙扫描绑定需求设备在身边。蓝牙扫描绑定的设备分为两种：可确认如有按钮，或者可以双击的设备。大部分设备属于可确认设备。无法确认的设备无法确认的设备，出于平安性的思索，可用扫码绑定可确认的设备，当用户进展设备确认时如双击手环，或者按按钮，需求广播特殊的包称为确认包，详细格式见附录。2 扫描和衔接进入特定界面后，微信会开场扫描设备。低功耗蓝牙设备需求在广播包里广播：微信规定

17、的service uuid详细见附录。厂商自定义字段里，包含mac地址详细见附录。并且需求包含指定的Characteristics详细见附录。Andriod经典蓝牙设备需求暴露一个指定uuid的rfcomm效力详细见附录。Ios经典蓝牙需求经过mfi认证，并且SerialNumber需为mac地址字符串方式。扫描到设备后，微信会衔接设备Ios经典蓝牙需求用户手动在设置界面里面衔接上设备。3 流经典蓝牙运用RFCOMM通讯是个流，蓝牙BLE也模拟成流。4 包流之上运载的是一个紧接着一个的业务逻辑的数据包。数据包的发送方和接受方：设备厂商效力器，或者设备微信效力器。把设备-厂商效力器/微信效力器的

18、恳求称为Req，回包称为Resp。一个恳求，对应着一个回包。把厂商效力器/微信效力器-设备的恳求称为PushReq，没有回包即没有PushResp这样的包。4 包构造由定长包头和变长包体组成。变长包体Protoalbuf打包的二进制数据定长包头struct BpFixHeadunsigned char bMagicNumber;unsigned char bVer;unsigned short nLength;unsigned short nCmdId;unsigned short nSeq;包包的二进制例子见附录。5 定长包头字段类型阐明bMagicNumberunsigned char填0

19、 xFEbVerunsigned char包格式版本号，填1nLengthunsigned short为包头+包体的长度nCmdIdunsigned short命令号，如ECI_req_auth，ECI_resp_sendDataToManufacturerSvr等nSequnsigned short递增。一个Req对应一个Resp，并且它们的nSeq一样，并且永不为0。Push的nSeq永远为0；6 变长包体为Protobufprotobuf的引见见附录打包的构造。例如AuthReq。一个包体里面只需一个Req，或者一个Resp，或者一个PushReq。每个Req/Resp/PushReq都

20、有对应的EmCmdId，例如AuthReq的命令号为ECI_req_auth。详细的定义见附录。7 身份验证和加密为保证数据平安，一切命令都需求加密。加密算法选用aes 128位，并运用cbc方式，pkcs7填充。初始向量为密钥。详细验证和加密的步骤如下：设备需求烧一个Key128位到硬件上，微信效力器也要记录下这个Key。一个设备deiveId+deviceType独一确定一个设备，对应一个Key。key要维护好类似用户密码，银行卡账号密码，千万不要印刷出来或者打印出来。对于设备来说，手机和效力器可看成一个黑盒。设备和手机效力器之间，经过Auth命令，运用key，最终，把sessionKey

21、下发给到设备。Auth的步骤为：设备发送AuthReq，里面的字段有MD5(deviceType+deviceId)假设设备算md5很费事的话，建议先算好，直接烧进设备里面，另一个字段为AES加密的一段buffer详细字段细节在附录描叙。微信发送回包AuthResp，里面的字段有用AES加密的含有sessionkey的一段buffer详细字段细节在附录描叙。设备解密这段buffer可得到SessionKey。设备和手机之间，就经过sessionKey来加解密包。AuthReq， AuthResp之后的一切命令，例如InitReq, InitResponse，SendDataToManufatu

22、rSvrReq，SendDataToManufacturerSvrResponse，ManufacturerSvrSendDataPush等都需求加解密。加密只针对变长包体，不需求加密定长包头。为了提高平安性，设备可再进一步的验证手机能否可信。设备在InitReq里填入Challeange一个4字节的随机数random4，手机将在InitResp里面前往ChalleangeAnswer一个4字节的数，值为crc32(random4)。设备验证ChalleangeAnswer能否正确。假设是，阐明手机是可信的。身份验证和加解密大体的流程图为：另外有一些细节：当sessionKey过期，手机对设备

23、的一切恳求都前往错误码 EEC_sessionTimeout，要求设备重做一次auth。当发现解密设备的包失败时，前往 EEC_decode。这种情况下，通常是sessionkey过期，或者是设备程序有问题。8 不加密的方法为了降低设备厂商的接入难度，加快产品进程，微信客户端同时支持不加密的方式。但是，这个只是在测试阶段可用，正式的设备发布出去的时候，都要求加密。步骤如下：将AuthReq里的AesSign字段付空。发送AuthReq。收到AuthResp之后，忽略掉AesSessionKey字段。将InitReq里的Challeange字段随意付一个值。发送InitReq。收到InitRes

24、p，忽略掉ChalleangeAnswer字段。随后的包都不需求加解密。9 会话商定设备连上微信之后，需求发送AuthReq，等收到胜利的回包之后，接着还要发送InitReq，并收到胜利的回包之后，才干正常发送数据。假设设备没有auth，手机对设备的一切恳求都前往错误码 EEC_needAuth。当出现解包异常的时候，直接断开衔接。Push类的包seq永远为0。Req类和Resp类的包的seq永不为0。效力器可随时发送Push包。厂商效力器发送的Push包留意Push包是没有回包的，即没有PushResp，假设需求设备的回包，需求由厂商本人实现。详细方法如：厂商发送ManufacturerSv

25、rSendDataPush给设备，设备收到push后，向厂商效力器发送一个SendDataToManufatureSvrReq。这时厂商效力器可知道设备收到了push，并且可以从Req里获得设备的回应数据。10 时序时序图请见附录。11 Read Characteristics设备需求再微信的service下面，暴露一个read character，内容为6字节的mac地址。当ios上的其他app衔接上设备时，设备不会再广播，微信会读取该特征值，以确定能否要衔接该设备。12 其他目前规定了一些根底的协议，更多的协议等待补充。微信的Protobuf协议1 概述变长包体部分，运用的是Protobu

26、f定义的协议。Protobuf文件见附录。里面规定了设备和微信客户端之间的命令。2 命令列表称号描叙Auth登录Init初始化SendData设备发送数据给厂商或微信公众平台或微信客户端。当type为空或者等于0时，表示发送给厂商效力器。当type为10001时，表示发送给微信客户端html5设备会话界面。当type为其他时，表示发送给公众平台效力器。详细的定义请看 附录：微信公众平台proto文件。举个例子，type等于1时，表示手环数据。RecvDataPush厂商或微信客户端或微信公众平台发送数据给设备当type为空或者等于0时，表示厂商发送设备。当type为10001时，表示收到微信客

27、户端html5设备会话界面的数据。当type为其他时，表示公众平台发送给设备。详细的定义请看 附录：微信公众平台proto文件。举个例子，type等于1时，表示手环数据。SwitchViewPush微信客户端进入退出界面的通知SwitchBackgroudPush微信客户端进入退出后台的通知3 错误码Proto里的错误码EEC_system微信客户端普通的错误EEC_needAuth设备未登录。需求登录。EEC_sessionTimeoutsessionKey超时。需求重新登录。EEC_decode微信客户端解proto失败。能够是设备端打包代码有bug。EEC_deviceIsBlock微信

28、客户端一段时间之内制止设备的恳求。通常是设备某些异常行为引起，如短时间多次登录，大量发送数据等。EEC_serviceUnAvalibleInBackgroundios处于后台方式，无法正常效力EEC_deviceProtoVersionNeedUpdate设备的proto版本过老，需求更新EEC_phoneProtoVersionNeedUpdate微信客户端的proto版本过老，需求更新EEC_maxReqInQueue设备发送了多个恳求，并且没有收到回包。微信客户端恳求队列拥塞。EEC_userExitWxAccount用户退出微信帐号。为正数时详细见微信公众平台。固定包头里的错误码：固

29、定包头里的错误码放在cmdid字段里。当设备收到这样的错误码后，可以经过seq查出是那个命令失败。目前只需一个错误码。ECI_err_decode微信客户端解密包体失败。通常是由于sessionKey过时，需求重新做一次auth，也能够是设备加密代码有bug。4 JSAPI微信提供javascript api，允许从Html页面直接获取设备形状，并收发设备的数据，而不需求经过效力器。实时性要求高的蓝牙设备例如遥控汽车可采用这种方式。当SendData的type为EDDT_wxDeviceHtmlChatView时，表示设备发送数据给Html页面。当RecvDataPush的type为EDDT_

30、wxDeviceHtmlChatView设备收到html发过来的数据。Jsapi包括函数和事件两部分。详细如下：函数函数名hdInit描叙初始化设备库参数无前往值err_msg： hdInit:ok 胜利， hdInit:fail 失败minVersion：当前微信客户端支持的最小jsapi版本maxVersion：当前微信客户端支持的最大jsapi版本函数名hdRelease描叙封锁设备库参数无前往值err_msg：hdRelease:ok 胜利， hdRelease:fail 失败。函数名hdGetDeviceInfos描叙获取设备信息参数无前往值err_msg：hdGetDeviceIn

31、fos:ok 胜利， hdGetDeviceInfos:fail 失败。deviceInfos：deviceInfos : deviceId:myDevice1, state:connected, deviceId:myDevice2, state:connected deviceInfos包含多个deviceInfo，每个deviceInfo形如：deviceId:myDevice1, state:connected。函数名hdSendDataToDevice描叙发送数据给设备参数deviceId必填：设备iddata必填：数据，经过base64编码后的字符串。前往值err_msg：hdSe

32、ndDataToDevice:ok 胜利， hdSendDataToDevice:fail 失败。事件 事件名hdOnReceveDataFromDevice描叙接纳到设备数据参数deviceId：设备iddata：数据，经过base64编码后的字符串。事件名hdOnDeviceStateChanged描叙接纳到设备数据参数deviceId：设备idstate：connecting 衔接中， connected 衔接上，disconnected 衔接断开。运用例子见附录。附录1 ProtoBuf协议引见ProtoBuf是google提供的一套开源的软件协议。它主要作用是把c/c+的struct

33、打包成为二进制数据，或者把二进制数据解包成c/c+的struct。详细运用过程为：1. 定义proto文件2. 经过工具把.proto文件编译成.h, .c文件里面包含struct和函数 3 调用.h文件里的封包解包函数官方网站为： HYPERLINK httpsdevelopers.google/protocol-buffers/docs/overview httpsdevelopers.google/protocol-buffers/docs/overview HYPERLINK code.google/p/protobuf/ code.google/p/protobuf/ HYPERLI

34、NK code.google/p/protobuf-c/ code.google/p/protobuf-c/其他相关例子和工具见附件。2 蓝牙硬件一些规定称号值ServiceUUID0 xFEE7该uuid经蓝牙官方授权Write Characteristics UUID0 xFEC7Indicate Characteristics UUID0 xFEC8Read Characteristics UUID0 xFEC9Andriod RFCOMM UUIDe5b152ed-6b46-09e9-4678-665e9a972cbcIos经典蓝牙的iap层的SerialNumber必需赋值，且等于m

35、ac地址字符串方式。低功耗蓝牙的广播包的manufature specific data里必需包含mac地址6字节，并且以mac地址结尾。并且manufature specific data长度需大于等于8字节最前两个字节为company id，没有的话随意填。可确认设备确实认包的manufature specific data需以下面格式结尾：0 xfe 0 x01 0 x01 + mac地址6字节3 Ios BLE设备的截图LightBlue是一个Iphone上的app。这是设备的截屏。请下载App并检查： 1. serviceId能否正确 2. characteristics能否正确包括

36、uuid和属性 3. 能否在manufature data最尾部带上了mac地址。 4 包的二进制例子Req接受两种格式：20字节对齐补零格式，不对齐格式。以AuthReq为例子不加密：20字节对齐补零ble特征值有些芯片只能发送固定20个字节，20字节剩下的部分补零feMagicNumber01版本号00 3b总长度 2711命令号0001Seq变长包体：0a 00 12 10 b4 3f 12 04 2a 02 e0 1c 2b dd 7d 02 90 62 13 a3 18 80 80 04 20 01 28 01 32 10 00 00 00 00 00 00 00 00 00 00

37、00 00 00 00 00 00 62 03 41 4d 33补齐：00留意：这里的包长度为003b(即59字节)，由于20字节对齐，导致总长为60字节。不对齐经典蓝牙没有对齐问题，某些ble芯片也没有对齐问题feMagicNumber01版本号00 3b总长度 2711命令号 0001Seq 变长包体：0a 00 12 10 b4 3f 12 04 2a 02 e0 1c 2b dd 7d 02 90 62 13 a3 18 80 80 04 20 01 28 01 32 10 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 62 03 41

38、 4d 33以AuthResp为例子：feMagicNumber01版本号000e总长度 4e21命令号0001Seq 包体：0a020800 12005 包的数据流图6 包的时序图最简单的时序图：Push包插入的时序图多Req包并且有push包插入的时序图：留意：多个Req包时，到达厂商效力器的先后顺序不能保证。同样多Resp包的情况下，到达外设的顺序也不能保证。7 加解密字段AuthReq里的AesSign字段 = AESRan | Seq | CRC32 ( DeviceId | Ran | Seq )设备消费一个随机数Ran ( 4字节 )，留意：随机数应尽量随机假设设备有才干获得当前

39、的时间戳，那么运用时间戳作为Seq ( 4字节 )，否那么，运用一个从0开场递增的序列号，保证每次auth的Seq递增将Ran和Seq拼接到DeviceId不含DeviceType后得到二进制串1变长计算二进制串1的CRC32 ( 4字节 )将Ran、Seq、CRC值按顺序拼接得到12字节的二进制串2，运用设备key对二进制传2进展AES加密，得到16字节的AesSignAuthResp里的AesSessionKey字段 = AES (SessionKey )设备auth胜利后将获得一个32字节的AesSessionKey字段，运用设备key做AES解密后可得到16字节的明文内容.该内容为se

40、ssionKey。InitReq里的Challeange字段为随机数(4字节，记为Random3)InitResp里的ChalleangeAnswer字段为CRC32(Random3)。上述身份认证和加密的方式为0 x1版本，对应AuthReq里面的AuthMethod字段。该版本未来能够晋级。8 Md5DeviceTypeAndDeviceId的例子Md5DeviceTypeAndDeviceId为16字节二进制数据。假设deviceType为：gh_d53f87f298e5，deviceId为：test_device。将deviceType+deviceId拼起来，不算0：md5(gh_d

41、53f87f298e5test_device,32) = 0 x26cdd942b8ee68b022cc53bba16c70399 CBC例子Key 为字符串 “3141592653589793Iv和Key一样。数据 : CBCpkcs7结果 : 数据: CBCpkcs7结果 : 数据: CBCpkcs7 结果:10 CRC32例子多项式为：0 xedb88320L字符串test_device_ios的crc32为：0 x02e312f3。11 微信蓝牙外设proto文件/ proto version: 1.0.2package MmBp;enum EmCmdId ECI_none = 0;

42、/ req： 蓝牙设备 - 微信/厂商效力器 ECI_req_auth = 10001; / 登录 ECI_req_sendData = 10002; / 蓝牙设备发送数据给微信或厂商 ECI_req_init = 10003; / 初始化 / resp：微信/厂商效力器 - 蓝牙设备 ECI_resp_auth = 20001; ECI_resp_sendData = 20002; ECI_resp_init = 20003; / push：微信/厂商效力器 - 蓝牙设备 ECI_push_recvData = 30001; / 微信或厂商发送数据给蓝牙设备 ECI_push_switchV

43、iew = 30002; / 进入/退出界面 ECI_push_switchBackgroud = 30003; / 切换后台 ECI_err_decode = 29999; / 解密失败的错误码。留意：这不是cmdid。为节省固定包头大小，这种特殊的错误码放在包头的cmdid字段。enum EmErrorCode EEC_system = -1; / 通用的错误 EEC_needAuth = -2; / 设备未登录 EEC_sessionTimeout = -3; / session超时，需求重新登录 EEC_decode = -4; / proto解码失败 EEC_deviceIsBloc

44、k = -5; / 设备出现异常，导致被微信暂时性制止登录 EEC_serviceUnAvalibleInBackground = -6; / ios处于后台方式，无法正常效力 EEC_deviceProtoVersionNeedUpdate = -7; / 设备的proto版本过老，需求更新 EEC_phoneProtoVersionNeedUpdate = -8; / 微信客户端的proto版本过老，需求更新 EEC_maxReqInQueue = -9; / 设备发送了多个恳求，并且没有收到回包。微信客户端恳求队列拥塞。 EEC_userExitWxAccount = -10; / 用户

45、退出微信帐号。message BaseRequest message BaseResponse required int32 ErrCode = 1; optional string ErrMsg = 2;message BasePush / req, resp =/ 登录 message AuthRequest required BaseRequest BaseRequest = 1; required bytes Md5DeviceTypeAndDeviceId = 2; / deviceType加deviceId的md5，16字节的二进制数据 required int32 ProtoVe

46、rsion = 3; / 设备支持的本proto文件的版本号，第一个字节表示最小版本，第二个字节表示小版本，第三字节表示大版本。版本号为1.0.0的话，应该填：0 x010000；1.2.3的话，填成0 x010203。 required int32 AuthProto = 4; / 填1 required int32 AuthMethod = 5; / 验证和加密的版本号，当前填1 required bytes AesSign = 6; / 详细生成方法见文档 optional string TimeZone = 10; / 废弃 optional string Language = 11;

47、 / 废弃 optional string DeviceName = 12; / 废弃message AuthResponse required BaseResponse BaseResponse = 1; required bytes AesSessionKey = 2;/ 初始化 enum EmInitRespFieldFilter EIRFF_userNickName = 0 x1; EIRFF_platformType = 0 x2; EIRFF_model = 0 x4; EIRFF_os = 0 x8; EIRFF_time = 0 x10; EIRFF_timeZone = 0

48、x20; EIRFF_timeString = 0 x40;/ 微信衔接上设备时，处于什么情景enum EmInitScence EIS_deviceChat = 1; / 聊天 EIS_autoSync = 2; / 自动同步message InitRequest required BaseRequest BaseRequest = 1; optional bytes RespFieldFilter = 2; / 当一个bit被设置就表示要resp的某个字段：见EmInitRespFieldFilter。 optional bytes Challenge = 3; / 设备用来验证手机能否平

49、安。为设备随机生成的四个字节。enum EmPlatformType EPT_ios = 1; EPT_andriod = 2; EPT_wp = 3; EPT_s60v3 = 4; EPT_s60v5 = 5; EPT_s40 = 6; EPT_bb = 7;message InitResponse required BaseResponse BaseResponse = 1; required uint32 UserIdHigh = 2; / 微信誉户Id高32位 required uint32 UserIdLow = 3; / 微信誉户Id低32位 optional uint32 Cha

50、lleangeAnswer = 4; / 手机回复设备的挑战。为设备生成的字节的crc32。 optional EmInitScence InitScence = 5; / 微信衔接上设备时，处于什么情景。假设该字段为空，表示处于EIS_deviceChat下。 optional uint32 AutoSyncMaxDurationSecond = 6; / 自动同步最多继续多长，微信就会封锁衔接。0 xffffffff表示无限长。 optional string UserNickName = 11; / 微信誉户昵称 optional EmPlatformType PlatformType

51、= 12; / 手机平台 optional string Model = 13; / 手机硬件型号 optional string Os = 14; / 手机os版本 optional int32 Time = 15; / 手机当前时间 optional int32 TimeZone = 16; / 手机当前时区 optional string TimeString = 17; / 手机当前时间，格式如202102281005285，详细字段意义为2021年022月2828号10点05分钟28秒5星期五。星期一为1，星期天为7。/ 设备发送数据给微信或厂商 / 设备数据类型enum EmDev

52、iceDataType EDDT_manufatureSvr = 0; / 厂商自定义数据 EDDT_wxWristBand = 1; / 微信公众平台手环数据 EDDT_wxDeviceHtmlChatView = 10001; / 微信客户端设备html5会话界面数据message SendDataRequest required BaseRequest BaseRequest = 1; required bytes Data = 2; optional EmDeviceDataType Type = 3; / 数据类型(如厂商自定义数据，或公众平台规定的手环数据，或微信客户端设备html

53、5会话界面数据等。不填，或者等于0的时候，表示设备发送厂商自定义数据到厂商效力器。message SendDataResponse required BaseResponse BaseResponse = 1; optional bytes Data = 2;/ push =/ 微信或厂商发送数据给蓝牙设备 message RecvDataPush required BasePush BasePush = 1; required bytes Data = 2; optional EmDeviceDataType Type = 3; / 数据类型(如厂商自定义数据，或公众平台规定的手环数据，或微

54、信客户端设备html5会话界面数据等。不填，或者等于0的时候，表示设备收到厂商自定义数据。/ 微信客户端进入退出界面的通知 enum EmSwitchViewOp ESVO_enter = 1; ESVO_exit = 2;enum EmViewId EVI_deviceChatView = 1; / 微信客户端设备号会话界面 EVI_deviceChatHtmlView = 2; / 微信客户端设备号Html5会话界面。留意：只需当H5界面自动和设备衔接上之后，才会发送push。message SwitchViewPush required BasePush BasePush = 1; re

55、quired EmSwitchViewOp SwitchViewOp = 2; / 进入或者退出View required EmViewId ViewId = 3; / view的idenum EmSwitchBackgroundOp ESBO_enterBackground = 1; / 进入后台 ESBO_enterForground = 2; / 进入前台 ESBO_sleep = 3; / 后台休眠/ 微信客户端进入退出后台的通知 message SwitchBackgroudPush required BasePush BasePush = 1; required EmSwitchB

56、ackgroundOp SwitchBackgroundOp = 2;12 微信公众平台proto文件/ type=1，手环类package mmbp_open;message BaseResponseoptional int32 errcode = 1;optional string errmsg = 2;message WristbandRequest message StepDataItemoptional uint32 Step = 1;optional uint32 Timestamp = 2;optional uint32 TimeStampRtcYear = 3;optional uint32 TimeStampRtcMonth = 4;optional uint32 TimeStampRtcDay = 5;optional uint32 TimeStampRtcHour = 6;optional uint32 TimeStampRtcMinute = 7;optional uint32 TimeStampRtcSecond = 8;repeated StepDataItem