蓝牙mesh接入流程
<h1>蓝牙mesh接入流程</h1>
<ul>
<li><a href="#1">一 酒店项目创建和音箱激活</a></li>
<li><a href="#2">二 蓝牙mesh协议 / 硬件品类规范</a></li>
<li><a href="#3">三 蓝牙mesh接入流程</a></li>
<li><a href="#3.1">3.1 开发者注册</a></li>
<li><a href="#3.2">3.2 接入产品/功能确认</a></li>
<li><a href="#3.3">3.3 模组选择/三元组申请</a></li>
<li><a href="#3.4">3.4 功能开发/调试</a></li>
<li><a href="#3.5">3.5 准入测试</a></li>
<li><a href="#3.6">3.6 寄送样品</a></li>
<li><a href="#3.7">3.7 准出测试</a></li>
<li><a href="#3.8">3.8 采购三元组/生产</a></li>
<li><a href="#4">四 蓝牙mesh开放接口</a></li>
</ul>
<p><h2 id="1"> 一 酒店项目创建和音箱激活</h2></p>
<h3>1.1 酒店项目创建及配置参考：[酒店项目创建及配置](<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Femp-hotel-setting%2Fhotel-create.md">https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Femp-hotel-setting%2Fhotel-create.md</a> "酒店项目创建及配置")</h3>
<h3>1.2 音箱部署与激活参考：[音箱部署与激活](<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Fhotel-device-activation%2Fhotel-app.md">https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Fhotel-device-activation%2Fhotel-app.md</a> "音箱部署与激活")</h3>
<p><h2 id="2"> 二 蓝牙mesh协议 / 硬件品类规范</h2></p>
<h3>2.1 蓝牙mesh协议规范</h3>
<p>详情参考：[蓝牙mesh软件规范](<a href="https://dueros.baidu.com/didp/doc/dueros-bot-platform/dbp-smart-home/ble-mesh/ble-mesh-private_markdown">https://dueros.baidu.com/didp/doc/dueros-bot-platform/dbp-smart-home/ble-mesh/ble-mesh-private_markdown</a> "蓝牙mesh软件规范")</p>
<h3>2.2 硬件品类规范</h3>
<p>详情参考：[蓝牙mesh硬件品类规范](<a href="https://www.showdoc.com.cn/833078369209673/7866017570518650">https://www.showdoc.com.cn/833078369209673/7866017570518650</a> "蓝牙mesh硬件品类规范")</p>
<p><h2 id="3"> 三 蓝牙mesh接入流程</h2></p>
<p><img src="https://dumi-dueros-bj-tob.bj.bcebos.com/amis/2021-11/1636633627243/Snip20211111_62.png" alt="" /></p>
<p><h3 id="3.1"> 3.1 开发者注册</h3></p>
<p>在接入前，开发者需要在DuerOS开放平台上注册成为开发者。</p>
<p>登录小度开放平台 <a href="https://dueros.baidu.com/open">https://dueros.baidu.com/open</a> </p>
<p>右上角注册账号，并完成开发者实名认证，实名认证审核需要 <strong>2个工作日</strong></p>
<p><h3 id="3.2"> 3.2 接入产品/功能确认</h3></p>
<p>开发者确定要接入的产品和实现的功能，并和小度确认</p>
<p>确定要接入开发后，按以下格式发邮件给小度，正式项目立项</p>
<p>小度收到邮件后，<strong>2个工作日</strong> 内回复接入文档、测试用例、准入报告模板，三元组申请表等材料</p>
<pre><code class="language-aidl"> * 收件人：duer-tob-service@baidu.com
* 主题：【蓝牙mesh接入立项】- 公司名称
* 邮件内容：蓝牙mesh项目立项
1、合作方公司名称：
2、设备接入品类：
3、联系人电话：
</code></pre>
<p>目前小度酒店版支持的设备品类如下(待补充的文档联系小度技术)</p>
<table>
<thead>
<tr>
<th>序号</th>
<th>品类名称</th>
<th>品类规范</th>
<th>通讯协议</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>灯（包括球泡灯、灯带、调色灯，调光面板等）</td>
<td>[照明设备](<a href="https://dueros.baidu.com/didp/doc/dueros-bot-platform/dbp-smart-home/ble-mesh/ble-mesh-private_markdown#%E7%85%A7%E6%98%8E%E8%AE%BE%E5%A4%87">https://dueros.baidu.com/didp/doc/dueros-bot-platform/dbp-smart-home/ble-mesh/ble-mesh-private_markdown#%E7%85%A7%E6%98%8E%E8%AE%BE%E5%A4%87</a> "照明设备")</td>
<td>蓝牙mesh</td>
</tr>
<tr>
<td>2</td>
<td>开关面板</td>
<td>[墙壁开关](<a href="https://dueros.baidu.com/didp/doc/dueros-bot-platform/dbp-smart-home/ble-mesh/ble-mesh-private_markdown#%E5%A2%99%E5%A3%81%E5%BC%80%E5%85%B3">https://dueros.baidu.com/didp/doc/dueros-bot-platform/dbp-smart-home/ble-mesh/ble-mesh-private_markdown#%E5%A2%99%E5%A3%81%E5%BC%80%E5%85%B3</a> "墙壁开关")</td>
<td>蓝牙mesh</td>
</tr>
<tr>
<td>3</td>
<td>窗帘面板</td>
<td>[窗帘设备](<a href="https://dueros.baidu.com/didp/doc/dueros-bot-platform/dbp-smart-home/ble-mesh/ble-mesh-private_markdown#%E7%AA%97%E5%B8%98%E8%AE%BE%E5%A4%87">https://dueros.baidu.com/didp/doc/dueros-bot-platform/dbp-smart-home/ble-mesh/ble-mesh-private_markdown#%E7%AA%97%E5%B8%98%E8%AE%BE%E5%A4%87</a> "窗帘设备")</td>
<td>蓝牙mesh</td>
</tr>
<tr>
<td>4</td>
<td>情景面板</td>
<td>待补充</td>
<td>蓝牙mesh</td>
</tr>
<tr>
<td>5</td>
<td>插卡取电</td>
<td>待补充</td>
<td>蓝牙mesh</td>
</tr>
<tr>
<td>6</td>
<td>房务面板</td>
<td>待补充</td>
<td>蓝牙mesh</td>
</tr>
<tr>
<td>7</td>
<td>空调</td>
<td>[空调](<a href="https://www.showdoc.com.cn/page/edit/833078369209673/7866017570518650">https://www.showdoc.com.cn/page/edit/833078369209673/7866017570518650</a> "空调")</td>
<td>蓝牙mesh</td>
</tr>
<tr>
<td>8</td>
<td>门磁</td>
<td>待补充</td>
<td>蓝牙mesh</td>
</tr>
<tr>
<td>9</td>
<td>人体传感器</td>
<td>待补充</td>
<td>蓝牙mesh</td>
</tr>
</tbody>
</table>
<p><h3 id="3.3"> 3.3 模组选择/三元组申请</h3></p>
<h4><strong>3.3.1 关于三元组</strong></h4>
<ul>
<li>三元组：ProductID（一型一密）、Mac地址（一机一密）、Secret（一机一密）</li>
</ul>
<h4><strong>3.3.2 调试&量产三元组申请规则</strong></h4>
<table>
<thead>
<tr>
<th style="text-align: left;"></th>
<th style="text-align: center;">调试三元组</th>
<th style="text-align: center;">量产三元组</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">数量</td>
<td style="text-align: center;">免费20个，需要更多需要工单申请</td>
<td style="text-align: center;">下限500个</td>
</tr>
<tr>
<td style="text-align: left;">提供方式</td>
<td style="text-align: center;">开发者邮件申请</td>
<td style="text-align: center;">完成准入准出后，邮件申请</td>
</tr>
<tr>
<td style="text-align: left;">前提</td>
<td style="text-align: center;">公司（厂商）确定、产品品类确定</td>
<td style="text-align: center;">一般情况下，开发者先申请调试三元组，完成硬件调试、测试后，才会申请量产三元组</td>
</tr>
</tbody>
</table>
<p><strong>3.3.3 发邮件申请三元组</strong></p>
<p>下载：<a href="<a href="https://dumi-dueros-bj-tob.bj.bcebos.com/amis/2021-11/1636601865711/%E8%B0%83%E8%AF%95%E7%94%A8%E4%B8%89%E5%85%83%E7%BB%84%E7%94%B3%E8%AF%B7%E8%A1%A8.xlsx"">https://dumi-dueros-bj-tob.bj.bcebos.com/amis/2021-11/1636601865711/%E8%B0%83%E8%AF%95%E7%94%A8%E4%B8%89%E5%85%83%E7%BB%84%E7%94%B3%E8%AF%B7%E8%A1%A8.xlsx"</a>; target="_blank">测试用三元组申请表</a><br />
并按表格内容填写完整</p>
<p><strong>按以下格式发邮件申请三元组（每个品类一个表）;</strong></p>
<pre><code class="language-aidl"> * 收件人：duer-tob-service@baidu.com;ext_smarthome_audit@baidu.com
* 主题：【蓝牙mesh测试用三元组申请】- 公司名称
* 附件：测试用三元组申请表
* 邮件内容：蓝牙mesh测试用三元组申请
1、合作方公司名称：
2、设备接入品类：
3、联系人电话：
</code></pre>
<p><h3 id="3.4"> 3.4 功能开发/调试</h3></p>
<p>开发者收到测试三元组后，正式开始开发调试，开发过程中小度提供技术支持（可添加邮件签名中的手机号-微信）</p>
<p>（开发样例待补充 ）</p>
<p><h3 id="3.5"> 3.5 准入测试</h3></p>
<p>开发接入完成后，开发者按测试用例完成测试，并填写准入测试报告，录制测试视频
<font color="#dd0000">
（请开发者务必严格测试，因设备问题导致无法顺利准出测试以及需要模组固件更新的，需要重新提供测试报告并重新安排准出测试排期）
</font>
下载<a href="<a href="https://dumi-dueros-bj-tob.bj.bcebos.com/amis/2021-10/1635160178046/%E5%B0%8F%E5%BA%A6IoT%E8%93%9D%E7%89%99mesh%E5%87%86%E5%85%A5%E6%B5%8B%E8%AF%95%E6%8A%A5%E5%91%8A%E6%A8%A1%E6%9D%BF.xlsx"">https://dumi-dueros-bj-tob.bj.bcebos.com/amis/2021-10/1635160178046/%E5%B0%8F%E5%BA%A6IoT%E8%93%9D%E7%89%99mesh%E5%87%86%E5%85%A5%E6%B5%8B%E8%AF%95%E6%8A%A5%E5%91%8A%E6%A8%A1%E6%9D%BF.xlsx"</a>; target="_blank"> 准入测试报告模板</a> </p>
<p><strong>测试用例</strong>（测试用例参考3.2章节邮件回复或从https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Frcu-new%2Fblemesh-access.md 这里的3.5下载）</p>
<p>测试功能正常后，邮件给小度审核</p>
<p>按以下格式发送邮件</p>
<pre><code class="language-aidl"> * 收件人：duer-tob-service@baidu.com
* 主题：【蓝牙mesh准入测试报告】- 公司名称
* 附件添加：1、准入测试报告 2、自测视频
* 邮件内容：
1、合作方公司名称：
2、设备接入品类：
3、联系人电话：
</code></pre>
<p><h3 id="3.6"> 3.6 寄送样品</h3></p>
<p>小度会在收到准入测试报告邮件后 <strong>3个工作日</strong> 内，回复完成准出测试的时间安排</p>
<p>开发者确定测试周期没问题后,寄送样品到小度公司进行准出测试（内附联系方式、运单号、设备清单）</p>
<p>邮寄地址：上海市浦东新区纳贤路701号 百度研发中心 小度技术收 19512345409</p>
<pre><code class="language-aidl"> * 收件人：duer-tob-service@baidu.com
* 主题：【蓝牙mesh样品邮寄】- 公司名称
* 邮件内容：
1、合作方公司名称：
2、快递单号、设备清单
3、联系人电话：
</code></pre>
<p><h3 id="3.7"> 3.7 准出测试</h3></p>
<p>小度收到寄送的样品后，按之前邮件回复的测试排期 <strong>3周内</strong> 完成准出测试，并邮件回复</p>
<p>测试过程中需客户保持电话、邮箱等联系方式的畅通
<font color="#dd0000">
<strong>因产品问题或者需要升级固件导致的准出测试终断，需要开发者问题解决后按</strong>3.5章节<strong>重新邮件发送准入测试报告，小度重新安排测试排期</strong>
</font>
准出测试完成后：小度邮件发送准出测试报告</p>
<p><h3 id="3.8"> 3.8 采购三元组/生产</h3></p>
<p>开发者收到准出测试报告后，厂商正式购买三元组，安排生产。</p>
<p>三元组的采购方式</p>
<p>1、登录<a href="https://dumall.baidu.com/enterprise/product/303215449751646?skuNo=S2092810192023">小度企业购</a>，按需购买三元组</p>
<p>2、下载：<a href="<a href="https://dumi-dueros-bj-tob.bj.bcebos.com/amis/2021-11/1636601865711/%E8%B0%83%E8%AF%95%E7%94%A8%E4%B8%89%E5%85%83%E7%BB%84%E7%94%B3%E8%AF%B7%E8%A1%A8.xlsx"">https://dumi-dueros-bj-tob.bj.bcebos.com/amis/2021-11/1636601865711/%E8%B0%83%E8%AF%95%E7%94%A8%E4%B8%89%E5%85%83%E7%BB%84%E7%94%B3%E8%AF%B7%E8%A1%A8.xlsx"</a>; target="_blank">三元组申请表</a> ，并按表格内容填写完整</p>
<p>按以下格式发邮件</p>
<pre><code class="language-aidl"> * 收件人：duer-tob-service@baidu.com
* 主题：【蓝牙mesh三元组采购】- 公司名称
* 附件：三元组申请表
* 邮件内容：蓝牙mesh三元组采购
1、合作方公司名称：
2、企业购订单号：
3、联系人电话：
4、如需专票，请提供开票信息和发票邮寄地址
</code></pre>
<p><h2 id="4">四 蓝牙mesh开放接口</h2></p>
<p>开发者可以使用蓝牙mesh的开放接口，开发自己装维工具</p>
<p>目前提供的接口可实现的功能包括：</p>
<p>1、设备编辑</p>
<p>2、删除设备</p>
<p>3、同步场景</p>
<p>4、设置组控设备</p>
<p>5、新增虚拟组地址（自定义设备分组）</p>
<p>6、删除虚拟组地址（自定义设备分组）</p>
<p>详情参考：[蓝牙mesh开放接口](<a href="https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Frcu-new%2Fblemesh-device.md">https://dueros.baidu.com/business/emp/view/doc?md=%2Fmd%2Frcu-new%2Fblemesh-device.md</a> "蓝牙mesh开放接口")</p>