小度蓝牙mesh接入流程

• 一 酒店项目创建和音箱激活
• 二 蓝牙mesh协议 / 硬件品类规范
• 三 蓝牙mesh接入流程
• 3.1 开发者注册
• 3.2 接入产品/功能确认
• 3.3 申请测试三元组
• 3.4 功能开发/调试
• 3.5 准入测试
• 3.6 寄送样品
• 3.7 准出测试
• 3.8 采购三元组/生产
• 四 蓝牙mesh开放接口

一 酒店项目创建和音箱激活

1.1 酒店项目创建及配置参考：酒店项目创建及配置

1.2 音箱部署与激活参考：音箱部署与激活

二 蓝牙mesh协议 / 硬件品类规范

2.1 蓝牙mesh协议规范

详情参考：蓝牙mesh软件规范

2.2 硬件品类规范

详情参考：蓝牙mesh硬件品类规范

三 蓝牙mesh接入流程

3.1 开发者注册

在接入前，开发者需要在DuerOS开放平台上注册成为开发者。

登录小度开放平台 https://dueros.baidu.com/open

右上角注册账号，并完成开发者实名认证，实名认证审核需要 2个工作日

3.2 接入产品/功能确认

开发者确定要接入的产品和实现的功能，并和小度确认

确定要接入开发后，按以下格式发邮件给小度，正式项目立项

小度收到邮件后，2个工作日 内回复接入文档、测试用例、准入报告模板，三元组申请表等材料

 * 收件人：duer-tob-service@baidu.com
 * 主题：【蓝牙mesh接入立项】- 公司名称
 * 邮件内容：蓝牙mesh项目立项
    1、合作方公司名称：
    2、设备接入品类：
    3、联系人电话：

目前小度酒店版支持的设备品类如下(待补充的文档联系小度技术)

3.3 申请测试三元组

3.3.1 关于三元组

蓝牙Mesh设备接入小度生态，需要进行安全认证，小度目前使用Static OOB方案，以三元组方案实现。

• 包含内容： 三元组包含三个字段：ProductId、Mac、Secret，一机一密。
• 如何申请： 开发者在小度智能家居开放平台进行产品创建、定义、调试，在“硬件调试”的“调试中心”可免费获取40个调试三元组。开发者需要将调试三元组烧录在模组中，用于开发调试。调试完成并准出测试通过后，开发者可根据平台提示联系小度商务沟通购买量产三元组。
• 如何使用： 设备进入配网状态，和小度智能音箱/智能屏/中控屏交互三元组，三元组作为key用于计算认证信息，认证完成后才可以加入被智能控制。

3.3.2 调试&量产三元组申请规则

三元组的申请可以登录：小度IOT平台：https://dueros.baidu.com/openiot 自助申请

IOT平台的使用说明参考：平台介绍 、 操作指南

备注：

IOT平台申请三元组时，如果新建的设备iot上没有您需要的芯片型号,可以先用别的型号代替

如果新建产品时没有您需要的品类，需要按本文档 3.3.3章节发邮件申请

3.3.3 发邮件申请三元组

下载：测试用三元组申请表
并按表格内容填写完整

按以下格式发邮件申请三元组（每个品类一个表）,我们会在收到邮件后的 2个工作日 内完成审核，并发放测试用三元组

 * 收件人：duer-tob-service@baidu.com;ext_smarthome_audit@baidu.com
 * 主题：【蓝牙mesh测试用三元组申请】- 公司名称
 * 附件：测试用三元组申请表
 * 邮件内容：蓝牙mesh测试用三元组申请
   1、合作方公司名称：
   2、设备接入品类：
   3、联系人电话：

3.4 功能开发/调试

开发者收到测试三元组后，正式开始开发调试,开发过程中遇到问题，可以微信扫描下面二维码提交工单，我们收到后回复，疑难问题联系开发者共同解决

开发者还可以通过:小度音箱屏幕下划-设置-帮助反馈中的二维码 提交工单

3.5 准入测试

说明：厂家和百度联调完成之后，厂商需要对产品进行完整的准入测试。主要是：功能测试、性能测试

3.5.1 模组免测

如果开发者使用已经在小度完成准出的模组，按提测邮件模板提供准入测试报告、自测视频

下载：准入准出免测信息提交模板 填写完整和提测邮件一起发送，小度核实后给予模组免测

3.5.2 音箱与设备要求

• 厂商需要提供完整的测试报告和验收视频/， 视频中需要包括配网、控制、状态上报等基本功能
• 开发者测试的时候，未来项目要使用的音箱型号都要做适配测试
• 设备测试所需要用到的【用例】，从 3.5.3章节的表格中下载
• 若使用的是没经过小度准出的模组，开发者需要邮寄样机给小度做准出测试，需要邮寄的样机数量可以参考下表准备，具体数量小度会在提测邮件之后回复

• 新接入品类或者厂家新增的设备型号，需提供小度进行准出测试
• 准入测试报告，参考下表准入测试报告模板

3.5.3 准备准出测试

自测完成后按【准入邮件模板】的格式，给小度发邮件申请准出测试

（请开发者务必严格测试，因设备问题导致无法顺利准出测试以及需要模组固件更新的，需要重新提供测试报告并重新安排准出测试排期）

3.6 寄送样品

小度会在收到准入测试报告邮件后 3个工作日 内，回复完成准出测试的时间安排

开发者确定测试周期没问题后,寄送样品到小度公司进行准出测试（内附联系方式、运单号、设备清单）

邮寄地址：上海市浦东新区纳贤路701号 百度研发中心 小度技术收 19512345409

 * 收件人：duer-tob-service@baidu.com
 * 主题：【蓝牙mesh样品邮寄】- 公司名称
 * 邮件内容：
   1、合作方公司名称：
   2、快递单号、设备清单
   3、联系人电话：

3.7 准出测试

小度收到寄送的样品后，按之前邮件回复的测试排期 三周内 完成准出测试，并邮件回复

测试过程中需客户保持电话、邮箱等联系方式的畅通

因产品问题或者需要升级固件导致的准出测试终断，需要开发者问题解决后按3.5章节重新邮件发送准入测试报告，小度重新安排测试排期

准出测试完成后：小度邮件发送准出测试报告

3.8 采购三元组/生产

开发者收到准出测试报告后，厂商正式购买三元组，安排生产。

三元组的采购方式

1、线下方式：联系小度商务采购三元组，小度收到邮件后，由商务同学联系签订合同及发放三元组
按以下格式发邮件采购三元组

 * 收件人：duer-tob-service@baidu.com
 * 主题：【蓝牙mesh三元组采购】- 公司名称
 * 邮件内容：蓝牙mesh三元组采购
   1、合作方公司名称：
   2、需要采购的品类和三元组数量清单：
   3、联系人电话：

2、线上方式：小度商城采购三元组（上线中）

四 蓝牙mesh开放接口

开发者可以使用蓝牙mesh的开放接口，开发自己装维工具

目前提供的接口可实现的功能包括：

1、获取设备列表

2、设备编辑

3、删除设备

4、同步场景

5、设置组控设备

6、新增虚拟组地址（自定义设备分组）

7、删除虚拟组地址（自定义设备分组）

8.控制设备接口

详情参考：蓝牙mesh开放接口 、 客控设备控制接口