蓝牙Breeze方案开发指南
更新时间:2018-09-11 15:23:30
概述
阿里巴巴物联网平台定义一套蓝牙通用规范,简化了厂商进行复杂蓝牙设备的开发(如:智能手表,蓝牙门锁等)。该规范对蓝牙广播,服务,通信协议等进行了标准化,简称为蓝牙 Breeze 方案。
蓝牙 Breeze 方案提供了手机端和设备端的 SDK,主要包含设备管理,设备发现,加密通信,大数据传输等功能。并对蓝牙芯片和主流手机进行了严格的认证,保证了兼容性和稳定性。
开发介绍
移动端
开发者在智能生活开放平台,勾选“蓝牙Breeze 方案(阿里蓝牙协议)” 套餐项,平台会自动生成SDK套餐包,最后下载集成开发即可。
移动端 SDK 介绍: iOS开发文档,Android开发文档。
套餐包介绍:详见文档。
设备端
蓝牙 Breeze 方案需要移动端 SDK 和设备端 SDK 配合使用。设备端开发需要根据蓝牙芯片选择不同的 SDK 使用。现在主要通过邮件的方式申请。厂商与商务完成合作签约后,即可进行 SDK 申请。
- 设备端 SDK 介绍:详见文档。
设备绑定
移动端Breeze SDK 包含了设备绑定的接口,请参考开发文档的“用户绑定蓝牙设备”章节。
iOS代码示例:
#import <BreezeBizSDK/LKBreezeBiz.h>
//需要在prepareDeviceInfo:之后调用,绑定设备依赖部分设备信息
[self.breezeBiz userBindDevice:^(NSString *iotId, NSError *error) {
if (error == nil) {
//绑定成功
}
}];
Android代码示例:
BreezeHelper.bindBreezeDevice(mDeviceInfo, new IoTCallback{
@Override
public void onFailure(IoTRequest request, Exception e) {
Log.w(TAG, "onFailure", e);
}
@Override
public void onResponse(IoTRequest request, IoTResponse response) {
mIotId = (String) response.getData();
}
}
数据上下云
Breeze SDK 提供了手机端和蓝牙设备进行数据交互的能力,并没有提供将蓝牙设备数据跟云端打通能力。如果需要实现蓝牙设备与云端的数据交互,通常需要借助手机端的能力。开发者需要使用移动端设备网关 SDK,完成设备数据与云端交互。
- 移动端设备网关 SDK 介绍: iOS开发文档,Android开发文档。
蓝牙设备空中升级
智能生活开放平台提供了完整的设备空中升级(OTA)能力,蓝牙设备的空中升级需要借助蓝牙 OTA SDK 实现。厂商可以通过后台快速地对设备进行固件升级。适用于设备有新的固件需要更新,或者有重大问题需要修复,必须进行固件升级的场景。
- 蓝牙 OTA SDK 介绍: iOS开发文档,Android开发文档。
智能生活开放平台后台蓝牙设备空中升级使用指南
- 登录智能生活开放平台。
- 找到设备所属项目,及项目下设备所属产品。
- 在产品页面,单击“开始开发”进入到开发页面
- 新增固件
- 刚添加到固件必需先验证固件验证才能批量升级,验证时只能从已上报到版本中选择,所以要确保验证之前设备的版本已经上传。当正确输入设备的deviceName和选择版本号,就可以单击“推送”(注意,这个“推送”不会将版本主动推送到手机APP,需要手机APP主动查询),手机APP就可以开始OTA固件验证流程了。
- 固件验证流程完成后(单击了推送),就可以开始批量升级。