# 前言<a name="ZH-CN_TOPIC_0000001808700609"></a>

**概述<a name="section4537382116410"></a>**

本文为首次使用版本的开发人员而写。目的是供开发人员快速掌握文档的整体架构脉络，指导开发人员一步一步深入开发。同时帮助不同的开发人员快速找到自己所需要的文档。

>![](public_sys-resources/icon-notice.gif) **须知：** 
>-   第1章节为版本包文档的目录，描述文档总体的结构。
>-   第2章节为环境搭建部分，包括芯片的评估、开发环境的搭建以及Demo板的使用。
>-   第3章节为基础功能开发章节，包含客户进行开发需要使用到的各部分的文档。
>-   第4章节为调优章节，主要帮助客户在基础开发后进行图像、内存、带宽等方面的调优。
>-   第5章节为特性开发，帮助客户在单个特性开发时能快速找到该特性涉及的所有文档。
>-   第6章节为测试报告，包含功耗、硬件测试报告等供客户参考。

**产品版本<a name="section358mcpsimp"></a>**

与本文档相对应的产品版本如下。

<a name="table361mcpsimp"></a>
<table><thead align="left"><tr id="row366mcpsimp"><th class="cellrowborder" valign="top" width="32%" id="mcps1.1.3.1.1"><p id="p368mcpsimp"><a name="p368mcpsimp"></a><a name="p368mcpsimp"></a>产品名称</p>
</th>
<th class="cellrowborder" valign="top" width="68%" id="mcps1.1.3.1.2"><p id="p370mcpsimp"><a name="p370mcpsimp"></a><a name="p370mcpsimp"></a>产品版本</p>
</th>
</tr>
</thead>
<tbody><tr id="row372mcpsimp"><td class="cellrowborder" valign="top" width="32%" headers="mcps1.1.3.1.1 "><p id="p374mcpsimp"><a name="p374mcpsimp"></a><a name="p374mcpsimp"></a>BS2X</p>
</td>
<td class="cellrowborder" valign="top" width="68%" headers="mcps1.1.3.1.2 "><p id="p376mcpsimp"><a name="p376mcpsimp"></a><a name="p376mcpsimp"></a>V100</p>
</td>
</tr>
</tbody>
</table>

**读者对象<a name="section4378592816410"></a>**

本文档（本指南）主要适用于以下工程师：

-   技术支持工程师
-   软件开发工程师

**符号约定<a name="section133020216410"></a>**

在本文中可能出现下列标志，它们所代表的含义如下。

<a name="table2622507016410"></a>
<table><thead align="left"><tr id="row1530720816410"><th class="cellrowborder" valign="top" width="20.580000000000002%" id="mcps1.1.3.1.1"><p id="p6450074116410"><a name="p6450074116410"></a><a name="p6450074116410"></a><strong id="b2136615816410"><a name="b2136615816410"></a><a name="b2136615816410"></a>符号</strong></p>
</th>
<th class="cellrowborder" valign="top" width="79.42%" id="mcps1.1.3.1.2"><p id="p5435366816410"><a name="p5435366816410"></a><a name="p5435366816410"></a><strong id="b5941558116410"><a name="b5941558116410"></a><a name="b5941558116410"></a>说明</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="row1372280416410"><td class="cellrowborder" valign="top" width="20.580000000000002%" headers="mcps1.1.3.1.1 "><p id="p3734547016410"><a name="p3734547016410"></a><a name="p3734547016410"></a><a name="image2670064316410"></a><a name="image2670064316410"></a><span><img class="" id="image2670064316410" height="25.270000000000003" width="67.83" src="figures/zh-cn_image_0000001808661601.png"></span></p>
</td>
<td class="cellrowborder" valign="top" width="79.42%" headers="mcps1.1.3.1.2 "><p id="p1757432116410"><a name="p1757432116410"></a><a name="p1757432116410"></a>表示如不避免则将会导致死亡或严重伤害的具有高等级风险的危害。</p>
</td>
</tr>
<tr id="row466863216410"><td class="cellrowborder" valign="top" width="20.580000000000002%" headers="mcps1.1.3.1.1 "><p id="p1432579516410"><a name="p1432579516410"></a><a name="p1432579516410"></a><a name="image4895582316410"></a><a name="image4895582316410"></a><span><img class="" id="image4895582316410" height="25.270000000000003" width="67.83" src="figures/zh-cn_image_0000001808661605.png"></span></p>
</td>
<td class="cellrowborder" valign="top" width="79.42%" headers="mcps1.1.3.1.2 "><p id="p959197916410"><a name="p959197916410"></a><a name="p959197916410"></a>表示如不避免则可能导致死亡或严重伤害的具有中等级风险的危害。</p>
</td>
</tr>
<tr id="row123863216410"><td class="cellrowborder" valign="top" width="20.580000000000002%" headers="mcps1.1.3.1.1 "><p id="p1232579516410"><a name="p1232579516410"></a><a name="p1232579516410"></a><a name="image1235582316410"></a><a name="image1235582316410"></a><span><img class="" id="image1235582316410" height="25.270000000000003" width="67.83" src="figures/zh-cn_image_0000001761622218.png"></span></p>
</td>
<td class="cellrowborder" valign="top" width="79.42%" headers="mcps1.1.3.1.2 "><p id="p123197916410"><a name="p123197916410"></a><a name="p123197916410"></a>表示如不避免则可能导致轻微或中度伤害的具有低等级风险的危害。</p>
</td>
</tr>
<tr id="row5786682116410"><td class="cellrowborder" valign="top" width="20.580000000000002%" headers="mcps1.1.3.1.1 "><p id="p2204984716410"><a name="p2204984716410"></a><a name="p2204984716410"></a><a name="image4504446716410"></a><a name="image4504446716410"></a><span><img class="" id="image4504446716410" height="25.270000000000003" width="67.83" src="figures/zh-cn_image_0000001808700629.png"></span></p>
</td>
<td class="cellrowborder" valign="top" width="79.42%" headers="mcps1.1.3.1.2 "><p id="p4388861916410"><a name="p4388861916410"></a><a name="p4388861916410"></a>用于传递设备或环境安全警示信息。如不避免则可能会导致设备损坏、数据丢失、设备性能降低或其它不可预知的结果。</p>
<p id="p1238861916410"><a name="p1238861916410"></a><a name="p1238861916410"></a>“须知”不涉及人身伤害。</p>
</td>
</tr>
<tr id="row2856923116410"><td class="cellrowborder" valign="top" width="20.580000000000002%" headers="mcps1.1.3.1.1 "><p id="p5555360116410"><a name="p5555360116410"></a><a name="p5555360116410"></a><a name="image799324016410"></a><a name="image799324016410"></a><span><img class="" id="image799324016410" height="25.270000000000003" width="67.83" src="figures/zh-cn_image_0000001761781130.png"></span></p>
</td>
<td class="cellrowborder" valign="top" width="79.42%" headers="mcps1.1.3.1.2 "><p id="p4612588116410"><a name="p4612588116410"></a><a name="p4612588116410"></a>对正文中重点信息的补充说明。</p>
<p id="p1232588116410"><a name="p1232588116410"></a><a name="p1232588116410"></a>“说明”不是安全警示信息，不涉及人身、设备及环境伤害信息。</p>
</td>
</tr>
</tbody>
</table>

**修改记录<a name="section2467512116410"></a>**

<a name="table1557726816410"></a>
<table><thead align="left"><tr id="row2942532716410"><th class="cellrowborder" valign="top" width="20.72%" id="mcps1.1.4.1.1"><p id="p3778275416410"><a name="p3778275416410"></a><a name="p3778275416410"></a>文档版本</p>
</th>
<th class="cellrowborder" valign="top" width="26.119999999999997%" id="mcps1.1.4.1.2"><p id="p5627845516410"><a name="p5627845516410"></a><a name="p5627845516410"></a>发布日期</p>
</th>
<th class="cellrowborder" valign="top" width="53.16%" id="mcps1.1.4.1.3"><p id="p2382284816410"><a name="p2382284816410"></a><a name="p2382284816410"></a>修改说明</p>
</th>
</tr>
</thead>
<tbody><tr id="row13478102715166"><td class="cellrowborder" valign="top" width="20.72%" headers="mcps1.1.4.1.1 "><p id="p18478727121616"><a name="p18478727121616"></a><a name="p18478727121616"></a>03</p>
</td>
<td class="cellrowborder" valign="top" width="26.119999999999997%" headers="mcps1.1.4.1.2 "><p id="p1547817278169"><a name="p1547817278169"></a><a name="p1547817278169"></a>2025-05-30</p>
</td>
<td class="cellrowborder" valign="top" width="53.16%" headers="mcps1.1.4.1.3 "><p id="p11478162711168"><a name="p11478162711168"></a><a name="p11478162711168"></a>更新交付文档目录及文档结构。</p>
</td>
</tr>
<tr id="row515235613913"><td class="cellrowborder" valign="top" width="20.72%" headers="mcps1.1.4.1.1 "><p id="p515295693920"><a name="p515295693920"></a><a name="p515295693920"></a>02</p>
</td>
<td class="cellrowborder" valign="top" width="26.119999999999997%" headers="mcps1.1.4.1.2 "><p id="p4152145623913"><a name="p4152145623913"></a><a name="p4152145623913"></a>2025-01-14</p>
</td>
<td class="cellrowborder" valign="top" width="53.16%" headers="mcps1.1.4.1.3 "><p id="p10152145616394"><a name="p10152145616394"></a><a name="p10152145616394"></a>更新“<a href="文档目录.md">文档目录</a>”小节内容。</p>
</td>
</tr>
<tr id="row113672513293"><td class="cellrowborder" valign="top" width="20.72%" headers="mcps1.1.4.1.1 "><p id="p23680516295"><a name="p23680516295"></a><a name="p23680516295"></a>01</p>
</td>
<td class="cellrowborder" valign="top" width="26.119999999999997%" headers="mcps1.1.4.1.2 "><p id="p83681951102912"><a name="p83681951102912"></a><a name="p83681951102912"></a>2024-05-15</p>
</td>
<td class="cellrowborder" valign="top" width="53.16%" headers="mcps1.1.4.1.3 "><p id="p169114261115"><a name="p169114261115"></a><a name="p169114261115"></a>第一次正式版本发布。</p>
</td>
</tr>
<tr id="row5947359616410"><td class="cellrowborder" valign="top" width="20.72%" headers="mcps1.1.4.1.1 "><p id="p447mcpsimp"><a name="p447mcpsimp"></a><a name="p447mcpsimp"></a>00B01</p>
</td>
<td class="cellrowborder" valign="top" width="26.119999999999997%" headers="mcps1.1.4.1.2 "><p id="p449mcpsimp"><a name="p449mcpsimp"></a><a name="p449mcpsimp"></a>2024-01-26</p>
</td>
<td class="cellrowborder" valign="top" width="53.16%" headers="mcps1.1.4.1.3 "><p id="p451mcpsimp"><a name="p451mcpsimp"></a><a name="p451mcpsimp"></a>第一次临时版本发布。</p>
</td>
</tr>
</tbody>
</table>

# 文档目录<a name="ZH-CN_TOPIC_0000001808661561"></a>

在ReleaseDoc/目录下：

```
├── 01.软件资料                #软件开发相关文档 
│   ├── BS2XV100 AT命令使用指南 
│   ├── BS2X DFU升级 APK开发指南
│   ├── BS2XV100 DFX软件 开发指南
│   ├── BS2XV100 EFUSE 使用指南
│   ├── BS2XV100 NFC TAG 软件开发指导书 
│   ├── BS2XV100 NV存储用户指南
│   ├── BS2XV100 SDK 开发指南
│   ├── BS2XV100 SDK接口变更 说明书
│   ├── BS2XV100 SDK 开发指南
│   ├── BS2XV100 USB HID复合设备 开发指南
│   ├── BS2XV100 代码框架说明  
│   ├── BS2XV100 低功耗 开发指南
│   ├── BS2XV100 低功耗FAQ
│   ├── BS2XV100 低功耗sample 使用指南
│   ├── BS2XV100 功率配置 说明书
│   ├── BS2XV100 升级方案使用指南
│   ├── BS2XV100 星闪应用层SLE-Link协议    
│   ├── BS2XV100 星闪鼠标应用方案开发 用户指南    
│   ├── BS2XV100 红外学习使用指南
│   ├── BS2xV100 星闪软件开发指导书
│   ├── BS2XV100 蓝牙软件开发指导书                   
│   ├── BS2XV100 设备驱动开发指南  
│   └── BS2XV100 音频编解码开发 指导书   
├── 02.工具资料                 #工具相关文档                 
│   ├──BS2XV100 BurnTool工具使用指导书 
│   ├──BS2XV100 BurnTool工具 烧写协议说明  
│   ├──BS2XV100 DebugKits工具使用指南    
│   └──BS2XV100 HiSpark Studio 使用指南                        
└── 03.调测资料                 #调测相关文档      
│   ├── BS2XV100 BLE BQB认证测试 指导书 
│   ├── BS2XV100 SDK Sample使用指南              
│   ├── BS2XV100 SDK二次开发网络安全 注意事项             
│   ├── BS2XV100 SDK开发环境搭建用户指南
│   ├── BS2XV100 产测指导书
│   ├── BS2XV100 产线整机测试 工具指导书
│   ├── BS2XV100 内存维测 指导书
│   ├── BS2XV100 功耗 测试指南
│   ├── BS2XV100 单板冒烟测试指南
│   ├── BS2XV100 射频 AT测试指南
│   ├── BS2XV100 常用工具 使用指南
│   ├── BS2XV100 常见问题FAQ
│   ├── BS2XV100 抗干扰环境搭建 测试指南
│   ├── BS2XV100 星闪射频测试仪表 用户指南
│   ├── BS2XV100 星闪认证测试 指导书
│   ├── BS2XV100 维测 指导书
└── 04.硬件资料
│   └── 参考设计
│   │    ├── BS2X_REF_2024-09-25.pdf
│   │    ├── BS2xREF_view_locked.brd
│   │    ├── 参考设计PCB说明.txt
│   ├── BS2XV100 DK2用户 使用说明
│   ├── BS2XV100 DK用户 使用说明
│   ├── BS2XV100 USB眼图测试 指导书
│   ├── BS2XV100 硬件指南

```

# 环境搭建<a name="ZH-CN_TOPIC_0000001761622194"></a>





## 芯片规格评估<a name="ZH-CN_TOPIC_0000002222195805"></a>

芯片硬件规格描述文档。

ReleaseDoc\\04 硬件资料\\BS2XV100 硬件指南.pdf

## 开发板介绍<a name="ZH-CN_TOPIC_0000002222310205"></a>

DK单板使用说明。

ReleaseDoc\\04 硬件资料\\BS2XV100 DK2用户 使用说明.pdf

ReleaseDoc\\04 硬件资料\\BS2XV100 DK用户 使用说明.pdf

## 开发环境搭建<a name="ZH-CN_TOPIC_0000002186750086"></a>

-   说明软件开发环境搭建、SDK目录结构、SDK编译、Demo APP编写和镜像烧录。

    ReleaseDoc\\03 调测资料\\BS2XV100 SDK开发环境搭建 用户指南.pdf

-   说明软件镜像烧录详细步骤。

    ReleaseDoc\\02 工具资料\\BS2XV100 BurnTool工具使用指导书.pdf

-   说明日志调试工具搭建。

    ReleaseDoc\\02 工具资料\\BS2XV100 DebugKits工具使用指南.pdf

-   说明window ID编译工具使用。

    ReleaseDoc\\02 工具资料\\BS2XV100 HiSpark Studio 使用指南.pdf

## SDK包使用<a name="ZH-CN_TOPIC_0000002186909770"></a>

SDK开发相关内容，包括SDK架构、接口实现机制与使用说明。

ReleaseDoc\\01 软件资料\\BS2XV100 SDK 开发指南.pdf

ReleaseDoc\\01 软件资料\\BS2XV100 SDK接口变更 说明书.pdf

# 基础功能开发<a name="ZH-CN_TOPIC_0000001761622210"></a>



## 基础业务开发<a name="ZH-CN_TOPIC_0000002186763470"></a>

-   向开发者提供接入和使用星闪低功耗的相关接口。

    ReleaseDoc\\01 软件资料\\BS2XV100 星闪软件开发指导书.pdf

-   向开发者提供接入和使用低功耗蓝牙的相关接口。

    ReleaseDoc\\01 软件资料\\BS2XV100 蓝牙软件开发指导书.pdf

-   SDK的模块框架及说明，帮助开发者快速上手BS2X的SDK开发。

    ReleaseDoc\\01 软件资料\\BS2XV100 代码框架说明.pdf

-   提供供了一些示例程序（Sample），用于指导用户快速使用BS2X平台所提供的各类能力及快速产品化。

    ReleaseDoc\\03 调测资料\\BS2XV100 SDK Sample使用指南.pdf

## 命令行说明<a name="ZH-CN_TOPIC_0000002186923130"></a>

AT命令说明文档。

ReleaseDoc\\01 软件资料\\BS2XV100 AT命令 使用指南.pdf

# 调优<a name="ZH-CN_TOPIC_0000001808700593"></a>

-   对PLT的各类业务，提供内存维测指导。

    ReleaseDoc\\03 调测资料\\BS2XV100 内存维测 指导书.pdf

-   低功耗调测时可能遇到的问题解决方法，用户调测低功耗时遇到问题可以进行参考。

    ReleaseDoc\\01 软件资料\\BS2XV100 低功耗 FAQ.pdf

# 特性开发<a name="ZH-CN_TOPIC_0000002222323581"></a>




## 常用功能开发<a name="ZH-CN_TOPIC_0000002186939192"></a>

-   SDK开发介绍。

    ReleaseDoc\\01 软件资料\\BS2XV100 SDK 开发指南.pdf

-   BS2XV100通过API（Application Programming Interface）向开发者提供音频编解码的相关接口，包括编码器初始化及销毁接口、命令配置接口、编码一帧接口、解码一帧接口。

    ReleaseDoc\\01 软件资料\\BS2XV100 音频编解码开发 指导书.pdf

-   设备驱动开发的相关内容，主要包括工作原理、按场景描述接口使用方法和注意事项。

    ReleaseDoc\\01 软件资料\\BS2XV100 设备驱动开发指南.pdf

-   BS2XV100 升级流程以及相关工具的操作指导。

    ReleaseDoc\\01 软件资料\\BS2XV100 升级方案 使用指南.pdf

-   BS2XV100 通过API（Application Programming Interface）向开发者提供 NFC TAG的相关接口。

    ReleaseDoc\\01 软件资料\\BS2XV100 NFC TAG 软件开发指导书.pdf

-   针对 BS2X 芯片中 NV 存储模块的使用进行介绍。

    ReleaseDoc\\01 软件资料\\BS2XV100 NV存储 用户指南.pdf

-   BS2X USB HID 复合设备的两种实现方式。

    ReleaseDoc\\01 软件资料\\BS2XV100 USB HID复合设备 开发指南.pdf

-   绍BS2X DFX 功能及使用指南，包括 DIAG 维测功能、死机诊断、Dump 解析等，方便用户进行业务维测及死机分析。

    ReleaseDoc\\01 软件资料\\BS2XV100 DFX软件 开发指南.pdf

-   二次开发网络安全介绍。

    ReleaseDoc\\03 调测资料\\BS2XV100 SDK二次开发网络安全 注意事项.pdf

## 低功耗开发<a name="ZH-CN_TOPIC_0000002222225253"></a>

-   低功耗模式及应用开发指导。

    ReleaseDoc\\01 软件资料\\BS2XV100 低功耗 开发指南.pdf

-   低功耗调测时可能遇到的问题解决方法。

    ReleaseDoc\\01 软件资料\\BS2XV100 低功耗 FAQ.pdf

-   低功耗sample的使用方法。

    ReleaseDoc\\01 软件资料\\BS2XV100 低功耗sample 使用指南.pdf

-   各种场景下功率调整方式以及具体的操作指导。

    ReleaseDoc\\01 软件资料\\BS2XV100 功率配置 说明书.pdf

## 鼠标应用方案开发<a name="ZH-CN_TOPIC_0000002222339665"></a>

介绍星闪鼠标应用方案规格及其实现，帮助快速熟悉 应用方案代码逻辑和相关接口。

ReleaseDoc\\01 软件资料\\BS2XV100 星闪鼠标应用方案开发 用户指南.pdf

# 测试报告<a name="ZH-CN_TOPIC_0000002222209185"></a>



## 测试指导<a name="ZH-CN_TOPIC_0000002186779544"></a>

-   针对BS2X所应用产品如何通过BQB认证以及提供建议。

    ReleaseDoc\\03 调测资料\\BS2XV100 BLE BQB认证测试指导书.pdf

-   介绍产品产线装备端BS2X相关的测试指导，主要包括镜像烧录、射频测试、晶体校准等产线测试相关信息。

    ReleaseDoc\\03 调测资料\\BS2XV100 产测 指导书.pdf

-   针对PLT的各类业务，提供内存维测指导。

    ReleaseDoc\\03 调测资料\\BS2XV100 内存维测 指导书.pdf

-   BS2XV100功耗测试的操作与测试过程中需要注意的事项。

    ReleaseDoc\\03 调测资料\\BS2XV100 功耗 测试指南.pdf

-   介绍BS2XV100的射频非信令相关的测试指南和注意事项。

    ReleaseDoc\\03 调测资料\\BS2XV100 射频 AT测试指南.pdf

-   介绍BS2XV100星闪射频测试仪表使用指南和注意事项。

    ReleaseDoc\\03 调测资料\\BS2XV100 星闪射频测试仪表 用户指南.pdf

-   对BS2X所应用产品如何通过星闪认证以及提供建议。

    ReleaseDoc\\03 调测资料\\星闪认证测试 指导书.pdf

-   主要介绍 MP\_Tool 的使用方法。用于指导用户快速使用 MP\_Tool 工具进行产线功能测试

    ReleaseDoc\\03 调测资料\\BS2XV100 产线整机测试 工具指导书.pdf

-   BS2X平台日志分析指导，包括平台日志分类、重启场景、panic类型等。

    ReleaseDoc\\03 调测资料\\BS2XV100 维测 指导书.pdf

-   BS2X 所应用产品的抗干扰简易环境测试指导，主要包括环境搭建及测试相关信息。

    ReleaseDoc\\03 调测资料\\BS2XV100 抗干扰环境搭建 测试指南.pdf

## 测试数据<a name="ZH-CN_TOPIC_0000002186939200"></a>

请联系技术支持人员获取。

