luluxie / weixin-iot

一些原创的与微信硬件开发有关的小工具，分享出来方便更多开发者。

微信蓝牙设备模拟器

• ble-simulator.js 微信运动，微信蓝牙设备发现模拟器。可模拟微信运动步数上报，设备发现逻辑。

• zb-simulator.js 摇一摇周边模拟器。可模拟真实的iBeacon设备，在微信摇一摇周边中出现。

蓝牙协议模拟器

ble-simulator.js

基于对微信AirSync蓝牙协议的理解写的模拟器，主要用于演示BLE设备与微信的通讯原理，方便其它开发者快速了解和上手。

微信有专属的蓝牙Service UUID，同时还有指定的特征值要实现才能被微信识别和发现。如果是开发微信运动精简协议，还需要多两个特征值。

// 微信蓝牙服务和特征值专属UUID
var WX_SERVICE_UUID = 'FEE7';
var WX_CHARC_UUID_WRITE = 'FEC7';
var WX_CHARC_UUID_INDICATE = 'FEC8';
var WX_CHARC_UUID_READ = 'FEC9';
// 微信运动精简协议专属UUID
var WERUN_PEDOMETER_UUID = 'FEA1';
var WERUN_TARGET_UUID = 'FEA2';

主要特性

微信运动

• 支持模拟微信运动精简协议

设备发现

• 支持模拟微信蓝牙近场发现

使用方法

Step 1

$ sudo node ble-simulator.js

Step 2

打开AirSyncDebugger工具点击扫描蓝牙设备, 点击精简协议, 点击记步器测试。测试通过后设备即可被微信发现，同时也支持了微信运动的接入。

接入微信

如果只是调试蓝牙协议的话Step 1和Step 2即可。Step 3和Step 4也可以预先完成，此两步主要在微信硬件平台登记产品型号，和获得接口授权。Step 4会消耗授权配额，微信针对每个型号都有授权配额，认证前默认只有100个，需要后续免费申请才可获得更多。

Step 3

要让微信运动可以添加该设备为数据源，还需要在微信硬件平台中录入该设备基本信息，图标，默认显示名称等。在申请到的公众号后台开通“设备功能”插件，即可以添加一款新设备。

公众号需要做过微信认证，如果只是临时开发调试用，也可以使用公众号测试账号：

http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login

添加设备时，需要指明接入方案:

• 微信硬件云标准接入方案
  • 设备直连微信硬件云通道
  • 厂商云连接微信硬件云通道
• 平台基础接入方案

接入微信运动精简协议，选平台基础接入方案即可。

Step 4

登记成功后会得到一个微信硬件的型号编码即PRODUCT_ID，准备好公众号的appid,access_token,设备MAC地址列表等。

1.通过调用微信的设备编号API接口，得到设备编号。请求参数中PRODUCT_ID即型号编码。

https://api.weixin.qq.com/device/getqrcode?access_token=ACCESS_TOKEN&product_id=PRODUCT_ID

2.通过调用微信的授权接口将设备MAC更新到设备编号上。

https://api.weixin.qq.com/device/authorize_device?access_token=ACCESS_TOKEN

摇一摇模拟器

zb-simulator.js

快速模拟一个标准的iBeacon设备，运行时可以在微信摇一摇>周边中出现。需要在微信摇一摇网站注册设备，并得到UUID,Major,Minor等参数才可以被微信识别。

主要特性

微信摇一摇

• 支持微信摇一摇周边

使用方法

Step 1

在微信摇一摇周边网站注册新的iBeacon设备，等待审核。

https://zb.weixin.qq.com/

审核通过后得到UUID,Major,Minor等参数，在zb-simulator.js中更新对应的三个参数。

var uuid = 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'; 
var major = XXXXX; // 0x0000 - 0xffff
var minor = XXXX; // 0x0000 - 0xffff

Step 2

$ sudo node zb-simulator.js

Step 3

打开微信进入摇一摇, 等待周边页面出现后摇一摇手机。即可摇出模拟的设备。

依赖

推荐在Linux环境下运行，系统需要有蓝牙适配器和bluez蓝牙工具包。bleno库主要完成BLE设备的服务与特征值构建，在非Linux环境下运行时需要满足bleno的依赖条件。

Linux

• bluez
• libbluetooth-dev
• nodejs

Node.js modules

• bleno
• bleadvertise

测试环境

代码已经在以下环境运行测试通过

软件环境

• bluez 版本 4.101
• nodejs 版本 4.4.5
• bleno 版本 0.4.0
• bleadvertise 版本 0.1.1

硬件环境

项目	参数
平台	Raspberry Pi 2 Model B
OS	Ubuntu 14.04.4
内核	3.18.0-20-rpi2
蓝牙模块	CSR Bluetooth 4.0 USB module

备注

AirSyncDebugger是微信提供的蓝牙协议调试工具。

weixin-iot's Issues

Characteristics with value can be read only

---

MAC=00:1a:7d:da:71:13, DevName=微信互联硬件, LocalName=WeChat BLE

on -> stateChange poweredOn
on -> advertisingStart success
/usr/local/lib/node_modules/bleno/lib/characteristic.js:16
throw new Error('Characteristics with value can be read only!');
^

Error: Characteristics with value can be read only!
at Characteristic (/usr/local/lib/node_modules/bleno/lib/characteristic.js:16:11)
at new WeRunPedoMeterChar (/home/karlzheng/Desktop/server_maitain/online/hoct_wx_sec/work/debug_wx_req/weixin-iot/ble-simulator.js:100:28)
at new WxBLEService (/home/karlzheng/Desktop/server_maitain/online/hoct_wx_sec/work/debug_wx_req/weixin-iot/ble-simulator.js:196:23)
at Bleno. (/home/karlzheng/Desktop/server_maitain/online/hoct_wx_sec/work/debug_wx_req/weixin-iot/ble-simulator.js:235:23)
at emitOne (events.js:77:13)
at Bleno.emit (events.js:169:7)
at Bleno.onAdvertisingStart (/usr/local/lib/node_modules/bleno/lib/bleno.js:159:8)
at emitOne (events.js:77:13)
at emit (events.js:169:7)
at BlenoBindings.onAdvertisingStart (/usr/local/lib/node_modules/bleno/lib/hci-socket/bindings.js:134:8)

ubuntu16.04 sudo node ble-simulator.js 错误

`module.js:435
return process.dlopen(module, path._makeLong(filename));
^

Error: Module version mismatch. Expected 46, got 48.
at Error (native)
at Object.Module._extensions..node (module.js:435:18)
at Module.load (module.js:344:32)
at Function.Module._load (module.js:301:12)
at Module.require (module.js:354:17)
at require (internal/module.js:12:17)
at Object. (/home/iking/wearable/weixin-iot-master/node_modules/bluetooth-hci-socket/lib/native.js:3:15)
at Module._compile (module.js:410:26)
at Object.Module._extensions..js (module.js:417:10)
at Module.load (module.js:344:32)
`

精简协议测试链接错误

airsyncdebug --->精简协议--->计步器测试错误log：
DiscoverService error: Disciver services error,connected BluetoothGATT failed.