微信硬件平台蓝牙demo需求剖析.pdf

背景 由于微信硬件平台文档建设的需要，我们要开发一个蓝牙的demo 程序给开发者学习。 目标 微信自己开发的 demo 分开发板和服务器两部分。 1. 该demo 尽量简单并且完整，以让开发者对硬件平台开发的关键点一目了然。 2. 该demo 很容易移植到设备厂家的设备和服务器上 （即不要用有license 风险的库，，需 要额外购买的商业库，很复杂庞大的开源库）。 3. 该demo 将以开源代码方式发布。 芯片厂商开发的 demo 只需要完成开发板部分，服务器部分由微信提供。 1. 该demo 尽量简单并且完整，以让开发者对硬件平台开发的关键点一目了然。 2. 该demo 很容易移植到设备厂家的设备上 （即不要用有license 风险的库，非芯片厂商本 身提供的需要额外购买的其他商业库，很复杂庞大的开源库） 3. 该demo 将以开源代码方式发布 （芯片厂商的库不需要开源）。 需求说明 该demo 实现一个蓝牙硬件公众号。 详细功能如下： 绑定设备 用户使用微信，扫描设备二维码，点击绑定设备。 连接设备 用户进入公众号，微信自动连接设备。 该公众号具有简单的两个功能： 1. 点灯，灭灯： 该公众号只有两个菜单：点灯，灭灯。当用户点击“点灯”菜单时，设备上的灯变 亮。当用户点击“灭灯”菜单是，设备上的灯灭掉。 2. 接收设备的数据： 当设备按下按钮时，向微信发送一个文本消息。服务器收到消息后，下发一条消息 到公众号里，内容为：收到设备发送的消息：xxxxx （xxxx 为设备发过来的消息）。 实现流程图 实现协议 包 包由包头，包体组成。 包头 字段 类型 说明 magicCode unsigned char[2] 两字节，固定为fecf version unsigned short 两字节，目前填1 totalLength unsigned short 两字节，包头加包体长度 cmdId unsigned short 两字节，命令号 seq unsigned short 两字节，序列号。 errorCode unsigned short 两字节，错误码。当命令为resp 的时候有意义， 其他情况下赋值为0 。 包体根据不同的命令，有不同的值。 命令 有三种包： a. Req : req 表示设备向服务器的一个请求，服务器必须回复一个resp。 b. Resp：服务器对设备的请求的回复。 c. Push：服务器通知设备。设备不需要回复服务器。 Req 的命令号加上0x1000 就是对应resp 的命令号。 命令 sendTextReq （0x01 ） 含义 发送数据到服务器。 包体 可见字符，utf-8 编码。 命令 sendTextResp （0x1001 ） 含义 发送数据到服务器的回包。 包体 可见字符，utf-8 编码。可为空。 命令 openLightPush （0x2001 ） 含义 服务器通知设备点灯。 包体 空。 命令 closeLightPush （0x2002 ） 含义 服务器通知设备灭灯。 包体 空。 Seq 包头里的Seq 表示一个命令序号。 a. Req 命令：seq 不能为零，设备每发一个req 请求，必须seq+1 。每个请求里的序号和对 应的回包里的序号相同。 b. Resp 命令：回包的序号和请求里的序号相同。 c. push：序号为零。 Demo 实现说明 点灯/灭灯： 当设备收到openLightPush 的时候，设备点灯。 当设备收到closeLightPush 的时候，设备灭灯。 发送文本数据： 当设备上按下按钮的时候，设备发送sendTextReq 到服务器上，内容为小于40 字的文本（例 如helloworld）。 服务器收到该文本，会回复一个sendTextResp 给设备，内容为收到的文本（例如helloworld）， 并且，下发一条消息给到微信