Cypress微信硬件平台开发手册.pdfVIP

Cypress 微信硬件平台开发手册 (版本：v0.2) 1. 微信硬件平台介绍 微信智硬件平台是微信推出的连接硬件设备的物联网解决方案。微信硬件平台提供的 AirSync 技术，使BLE 设备能够便捷的与微信进行互联和通讯，用户可以通过微信公众号查 看和控制自己的BLE 设备，比如手环、净水器等。 BLE 设备通过扫描设备二维码的形式与用户建立对应关系，产品厂家因此可以准确的了解 到设备用户的相关信息。 Cypress 的BLE 产品支持微信硬件平台，已经通过微信官方认证测试。本手册将介绍利用 Cypress BLE 开发微信BLE 产品的步骤。 2. 微信BLE 产品开发流程 2.1. BLE 产品接入微信流程 微信硬件功能基于微信公众号进行实现，所以需要先为该产品申请一个公众号。该公 众号将是产品的宣传窗口，产品推出后，通过扫描产品二维码即关注该公众号，同时 所有的BLE 产品与微信的通信都在该公众号中进行。 2.2. 申请公众服务号 微信公众号申请地址为：。公众号分为三类，包括订阅号， 服务号和企业号。微信硬件平台需要使用服务号，并要求该服务号通过企业资质认 证。 通过认证的服务号才可以开通BLE 设备功能。开通服务号免费，认证服务号需要提供 企业资质，并收取一定费用。 2.3. 开通设备，添加产品 获得认证服务号以后，在公众号后台控制面板开通设备功能，如下图： 然后在 “设备功能”页面添加一个设备。 微信官网 （/wiki/new/index.html?page=5-1-3 ）详细描述了演示 步骤，请对照进行操作。 添加设备后，将看到页面上已经显示出该设备，并附有初始100 个配额。如下图所 示。 2.4. 代码开发 至此，我们已经在微信平台上开通了一个产品，下面我们就可以针对这个产品进行开 发。注意，此时该款产品最多添加100 个产品ID 配额，一旦通过认证，就可以获得更 多的配额。 微信平台支持使用开发者测试账号进行初期测试开发，测试账号默认开通设备功能， 不需要额外申请和认证服务号。微信用户均可以利用自己的微信号注册一个测试公众 号，测试账号最多只能添加一个设备。测试账户申请地址： /debug/cgi-bin/sandbox?t=sandbox/login 基于Cypress 参考代码的代码开发在下两节具体讲解。 2.5. 产品认证 产品开发完毕，需要在微信官网提交产品信息并向微信寄送产品样品。微信测试通过 以后，可以授权该产品为微信认证过的产品，可以在产品上添加微信硬件平台的图 标。 在2.3 小节中提到的设备管理页面，可以进行设备认证。 3. 微信产品开发架构 3.1. BLE 产品与微信通信模型 BLE 设备与微信通信的通信链路如下图： BLE 设备 （智能手表）通过AirSync 协议通过BLE 与手机微信 （包括Android 和 iOS ）建立连接和通信，微信与后台微信服务器是紧密连接，微信服务器可以进一 步将消息转发给厂商服务器。 同时，厂商的服务器也可以将消息通过微信传给BLE 设备。 BLE 设备与微信进行通信，显示界面可以是微信客户端，也可以是一个运行在微信 框架的一个网页。 两种模式的通信模型如下图： Figure 1：微信通信模型 上图中的元素分成三个部分，最左侧的是BLE 设备，中间的是手机微信客户端，它 包含App 或者HTML 网页，右侧的则是远程服务器。 灰色的“微信App”和“微信服务器”是不对用户开放的，开发者不能对这两部分做任 何改动。 绿色的“BLE 设备” ，“微信网页” 以及“客户服务器”则是构建一个微信BLE 设备的主 要工作。 BLE 设备与微信App 是通过BLE 接口连接和通信，微信网页与BLE 设备之间是 JSAPI 接口，微信网页与客户端服务器是以Ajax 技术进行通信，客户服务器与微信 服务器则是以微信提供的公众平台接口进行通信。 图中加粗的红色箭头表示开发者需要去实现的工作，灰色的箭头线条表示不需要开 发人员干预的部分。 微信App 与微信网页是两个独立的操作界面，它们均能实现蓝牙连接、断开、收 发数据的功能。下面对这两种通信界面进行分析。 3