BS2X指导资料
前言¶
BS2X向用户提供了些示例程序（Sample），用于指导用户快速使用BS2X平台所提供的各类能力及快速产品化（本文档部分示例以BS21为例）。
与本文档对应的产品版本如下。
本文档主要适用以下工程师：
技术支持工程师
软件开发工程师
在本文中可能出现下列标志，它们所代表的含义如下。
|
||
|
||
|
||
|
||
|
||
新增“SLE measure dis”章节内容。 |
||
|
||
|
||
更新“支持的外设Sample列表”小节内容。 |
||
概述¶
BS2X提供的Sample分为轻量级Sample和重量级Sample。
轻量级Sample：用于演示各个外设接口API的使用方法。
重量级Sample：用于模拟各类真实产品以及带BSLE通信类的业务Sample，比如鼠标、键盘、UART DTU等。
说明： Sample还在持续丰富中。
Sample框架¶
总体方案¶
Sample的启动和运行¶
每一个Sample都是以OS任务的形式独立存在。
新加任务或者删除任务的时候不允许修改系统启动相关的逻辑，需要通过编译和链接的方式，做到任务能够与任务启动隔离。
Sample选择¶
通过Kconfig（menuconfig）选择需要编译到系统中的sample，如图1所示。
外设 Sample¶
概述¶
外设Sample基本都属于轻量级Sample，只为演示每一个驱动的完整使用流程。
支持的外设Sample列表¶
支持的外设Sample列表如表1所示，在Kconfig中呈现的界面如图1所示。
表 1 支持的外设Sample列表
ADC¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择ADC Sample，如图1所示；如果当前Sample支持Timer操作，则继续按图2选择，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图3所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
BLINKY¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”或者使用IDE工具单击menuconfig按钮，打开menuconfig配置界面。
在menuconfig界面中选择BLINKY Sample，如图1所示；如果选择Sample使用的管脚，则继续按图2选择，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图3所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
烧录上电复位后串口每隔500ms打印一次“Blinky working”日志。
使用工具量取配置管脚电平状态，如图1所示。
BUTTON¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”或者使用IDE工具单击menuconfig按钮，打开menuconfig配置界面。
在menuconfig界面中选择BUTTON Sample，如图1所示；如果选择Sample使用的管脚，则继续按图2选择，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图3下所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
复位上电后，BUTTON初始化。
单击BUTTON，出现如图1所示日志。
CAN¶
编译¶
在命令行下执行命令“python build.py standard-bs21a-1M menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择CAN Sample，如图1所示；如果需要修改CAN模式，则继续按图2选择，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21a\fwpkg\xxx”路径下，如图3所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
CLOCK¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择CLOCK Sample，如图1所示；选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图2所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
将编译好的版本烧录即可运行。
DMA¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择DMA Sample，如图1所示；如果内存到内存支持使用链表模式，则继续按图2选择，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图3所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
DMA单板执行结果如图1所示，内存到内存使用链表的结果如图2所示。
I2C¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择I2C Sample，如图1所示。
master侧则继续按图2所示选择（如果当前Sample master侧支持使用writeread接口，则继续按图3选择）。
进入到“drivers/drivers”路径下，打开I2C，如图4打开，进入配置中，如图5所示，完成I2C基础配置，此时I2C为轮询模式；可在此基础上修改，将I2C配置为中断模式（图6）、dma模式（图7）、poll_dma切换模式（图8）。
进入到“drivers/chips/Chip Configurations for bs2x"路径下，修改I2C bus口数量。如果使用的bus为1，如图2所示，bus_id为1，则需要将I2C bus数量修改为2，如图9；如果使用的bus为0，则不需要修改bus数。选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图11所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到master侧的板子；同理，slave侧依次执行步骤1~步骤6，但步骤3按图10所示选择，并将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到slave侧的板子。
运行¶
图 2 I2C轮询双板主从交互（master侧使用writeread接口）
I2S¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择I2S Sample，如图1所示。
master侧按图2所示选择，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图4所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到master侧的板子；同理，slave侧依次执行步骤1~4，但3按图3所示选择，并将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到slave侧的板子。
运行¶
I2S双板执行结果如图1所示，I2S运行时添加打印会导致cpu处理不及时，slave接收数据丢失，打印只是去验证master与slave是否正常通信，实际使用过程中不建议添加打印。
I2S DMA¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择I2S DMA Sample，如图1所示。
master侧按图2所示选择，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图4所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到master侧的板子；同理，slave侧依次执行步骤1~4，但步骤3按图3所示选择，并将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到slave侧的板子。
运行¶
I2S DMA双板执行结果如下图1所示。
I2S DMA LLI¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择I2S DMA LLI Sample，如图1所示。
master侧按图2所示选择，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图4所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到master侧的板子；同理，slave侧依次执行步骤1~4，但3按图3所示选择，并将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到slave侧的板子。
运行¶
I2S DMA LLI双板执行结果如下图1所示。
执行该sample时必须打开以图2所示的两个宏。
KEYSCAN¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择KEYSCAN Sample，如图1所示，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图2所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
复位后，按键，串口显示对应的键值，KEYSCAN单板执行结果如下图1所示，仅以六键为例。
PDM¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择PDM Sample，如图1所示；如果需要修改配置选项，则继续按图2选择，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
PDM AMIC¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择PDM AMIC Sample，如图1所示；如果需要修改配置选项，则继续按图2选择，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
PINCTRL¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择PINCTRL Sample，如图1所示；如果需要修改测试管脚，则继续按图2选择，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图3所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
PINCTRL单板执行结果如图1所示。
PWM¶
编译¶
运行¶
QDEC¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择QDEC Sample，如图1所示，如果需要修改QDEC管脚配置选项，则继续按图2配置选择，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图3所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
复位后，转动滚轮，串口显示对应值的变化，QDEC单板执行结果如下图1所示。
RTC¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择RTC Sample，如图1所示，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图2所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
RTC单板执行结果如下图1所示。
SFC¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择SFC Sample，如图1所示，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图2所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
SPI¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择SPI Sample，如图1所示。
master侧则继续按图2所示选择（如果当前Sample master侧支持使用writeread接口，则继续按图3选择），选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图5所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到master侧的板子；同理，slave侧依次执行步骤1~。4，但步骤3按图4所示选择，并将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到slave侧的板子。
运行¶
SPI双板执行结果分以下多种情况：
图 2 SPI双板轮询主从交互（master侧使用writeread接口）
图 5 SPI双板中断主从交互（master侧使用writeread接口）
图 9 SPI双板DMA主从交互（master侧使用writeread接口）
图 11 SPI双板DMA主从交互（两侧均使用writeread接口）
SYSTICK¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择SYSTICK Sample，如图1所示，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图2所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
SYSTICK单板执行结果如下图1所示。
TASK¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择TASK Sample，如图1所示；选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如下图2所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
将编译好的版本烧录即可运行。
TCXO¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择TCXO Sample，如图1所示，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图2所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
TCXO单板执行结果如下图1所示。
TIMER¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择TIMER Sample，如图1所示，选择完成后按“Q”或者“q”选择“y”保存退出。
在menuconfig界面中选择TIMER 驱动，如图2所示，选择软timer个数.
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图3所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
TIMER单板执行结果如图1所示。
UART¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择UART Sample，如图1所示；如果修改当前Sample的某些参数配置，则继续按图2选择，默认为轮询（poll）模式；如果当前UART支持DMA链表传输，则继续按图3所示选择，如果当前Uart支持int传输，则继续按照图4所示选择，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如下图5所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到板子。
运行¶
当前UART Sample使用UART_BUS_1（H0）读写数据，UART_BUS_0（L0）打印日志信息，执行顺序是先通过PC串口给H0口发送一定长度的数据，H0口接收并将数据再次发送出去，在H0的串口上可看到发送和接收的数据，UART单板执行结果如下图1所示（仅以轮询模式为例），UART DMA链表执行结果如图2所示。
UART DMA LLI¶
编译¶
在命令行下执行命令“python build.py standard-bs21 menuconfig”，打开menuconfig配置界面。
在menuconfig界面中选择UART DMA LLI Sample，如图1所示。
master侧按图2所示选择，选择完成后按“Q”或者“q”选择“y”保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图4所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到master侧的板子；同理，slave侧依次执行步骤1~4，但3按图3所示选择，并将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录到slave侧的板子。
运行¶
当前UART Sample默认使用UART_BUS_2（L1）和UART_BUS_2（L1）进行数据交互，版本正常烧录后，将两块板子UART_BUS_2所用的管脚交叉连接（TX接RX，RX接TX），然后同时复位，串口执行结果如图1所示。
WATCHDOG¶
编译¶
运行¶
SLE UART Sample¶
概述¶
B/SLE UART的Sample详细的可分为SLE的UART透传功能和BLE的UART透传功能，其中SLE共支持三种，分别是SLE的UART透传功能，SLE的Low Latency UART透传功能以及SLE的Performance跑流功能，整体的连接关系和数据流图如图1所示。其中SLE UART Sample的三种模式编译通过Kconfig选项控制，默认为SLE的UART透传功能，选中Low Latency选项为SLE的Low Latency UART透传功能，在此基础上选中performance选项为SLE的Performance跑流功能。其他选项功能不变，详情参考“SLE UART Sample”的“编译”。
Server端流程¶
Client端流程¶
编译¶
进入SDK目录，在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”（以编译bs21开发板相应固件为例）。
选择SLE Uart Sample Performance mode(可选项，切换至数传模式)
(Top) → Application → Enable Sample. → Enable the Sample of products. → Support SLE UART sample. → SLE UART Sample Configuration → Select SLE UART sample mode → Select sle uart sample type→ Enable SLE UART low latency sample
(Top) → Application → Enable Sample. → Enable the Sample of products. → Support SLE UART sample. → SLE UART Sample Configuration → Select SLE UART sample mode → Set the currrent sample in PERFORMANCE mode.
在menuconfig界面中选择SLE UART Sample，如图1所示。
在menuconfig界面中选择当前Sample使用的UART BUS，如图3所示。
在menuconfig界面中选择SLE UART Server，如图4所示。
选择完成后按“Q”保存退出。
在命令行执行 ”python build.py standard-bs21-n1100”，或使用IDE编译（编译前确保sdk包内文件的权限），编译出的版本包在“tools\pkg\fwpkg\bs2x”路径下，如图5所示。
重启打开menuconfig配置界面，仿照3～#ZH-CN_TOPIC_0000001837765649/li8164191173710选择SLE UART Client，如图6所示，进行编译，并将版本正常烧录。
烧录及运行¶
版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
准备两块单板，分别作为Server端和Client端，每块单板上将UART-L0和UART-L2与PC通过串口板连接。
通过UART-L0分别将编译好的Server版本和Client版本烧录到单板中。
在PC端分别通过两个串口助手连接两个单板的UART-L2，并且将串口设置到115200波特率，并打开串口。
在两个串口助手上分别输入字符，并且观察对端串口是否可以收到，如果对端可以收到，则表示对通成功。
SLE UART DMA Sample¶
概述¶
SLE UART DMA DEMA用来实现端到端的uart->sle->uart跑流过程，目前支持最大2.2M的跑流速度。整体的连接关系与数据流图如下图所示，其中sle uart dma sample的四种模式通过Kconfig选项控制。SLE支持正常模式和低时延模式，默认使用连接间隔等于25ms的连接模式，每次发送240字节大小数据。
UART驱动支持三个接口的使用，分别是uart_dma_lli接口，uart_raw_data_lli接口和uart_read_by_dma接口，具体使用场景参考下图。
SLE连接支持正常模式和低时延模式，默认使用连接间隔等于25ms的连接模式，每次发送236字节大小数据
整体流程介绍¶
（A端）数据发送端¶
（B端）星闪数据发送端¶
（C端）星闪数据接收端¶
（D端）数据接收端¶
编译流程¶
在命令行下打开menuconfig配置界面，执行命令:./build.py -c standard-bs21-n1100 menuconfig
选择uart配置：
(Top) → Application → Enable Sample. → Enable the Sample of products. → Support SLE UART DMA sample. → SLE UART DMA Sample Configuration → Select UART Config → Choice Target UART DMA Sample Mode
选择想要使用的uart驱动配置，目前支持以下三种UART驱动接口。
(Top) → Application → Enable Sample. → Enable the Sample of products. → Support SLE UART DMA sample. → SLE UART DMA Sample Configuration
配置需要使用的uart串口，BUS1:H0串口，BUS2，L1串口。默认为BUS1，支持最高4M的波特率
请注意同时配置driver config中uart相关串口配置，因为该demo基于uart dma驱动运行，根据需要使用的UART驱动接口，参考下图进行配置。配置详情可参考《BS2XV100 设备驱动 开发指南》“UART”章节部分。
使用H0串口时请关闭日志线程，防止日志与uart使用同一串口异常。
选择目标跑流配置。
先选择想要的星闪模式
(Top) → Application → Enable Sample. → Enable the Sample of products. → Support SLE UART DMA sample. → SLE UART DMA Sample Configuration → Select SLE UART sample mode → Select sle uart sample type
再选择具体的跑流配置
(Top) → Application → Enable Sample. → Enable the Sample of products. → Support SLE UART DMA sample. → SLE UART DMA Sample Configuration → Select SLE UART sample mode → Select sle uart Rate config
使用low latency模式编译版本前请修改nv中em_size大小配置修改，byte4 和 byte5组成em_size的大小,byte6为最大链接数，em size的大小由byte4和byte5两个uint8_t拼接成一个uint16_t的数，高位在byte5，低位在byte4。如下图所示，08,01代表将em size大小设置为264字节大小。
选择需要编译的sample版本，如下图所示，UART Master；UART Master Sle；UART Slave sle；UART Slave分别对应上文uart数据发送端；sle数据发送端；sle数据接收端；uart数据接收端。
烧录及运行¶
烧录：
烧录方法请参考《BS2XV100 HiSpark Studio 使用指南》。
运行：
准备4块单板，分别作为UART数据发送端；SLE数据发送端；SLE数据接收端；UART数据接收端。将UART数据发送端，SLE数据发送端的串口管脚和流控管脚反接；将SLE数据接收端，UART数据接收端的串口管脚和流控管脚反接。默认使用芯片的H0管脚配置。
使用版本烧录工具将版本分别烧到四块单板上。
使用PC串口工具连接到四块单板的L0口上，用于观察数据传输情况。
按顺序启动A->C->D->B四块单板，观察串口日志打印。如果UART数据接收端能按时打印统计数据，则运行正常。
可选参数配置¶
理论跑流速度基于当前配置的最大星闪配置计算得出，实际速度可能受到芯片性能，空口质量等影响。
星闪速度=1秒内调度次数×每次发包字节数×8（比特数）/ 1000（单位换算），如配置3中包长250B，连接间隔1k，理论速度为1000×250×8/1000=2000kbps。
UART跑流速度一般为为波特率×0.6左右。当波特率设置为4000000时，UART可以达到2400kbps速度。
使用说明及限制¶
使用低时延模式时请注意使用支持低时延功能的芯片如282x系列。
受限于芯片rx buffer大小的影响，实际使用低时延模式时请不要设置超过Buffer大小的数据，大于此大小的数据包内容将会出错。
受限于芯片TRx Buffer大小的影响，空口一次传输数据大小有限，使用ssap消息接口发送数据时请参考芯片buffer大小发送数据，防止因为数据包过大分包，或过小导致的空口资源浪费。
当TRx buffer为260时，空口最大数据包大小为252字节。应用层调用接口发送数据时，需要先经过host封装10字节协议层包头，其中包含了tcid,tm_len等信息；从BTC发出时，BTC会封装2字节包头信息，如果开启了加密，需要额外使用4字节MIC长度。综上所述，应用层每次发送数据建议限制在236字节的整数倍及以下大小。
SLE Mouse Sample¶
概述¶
此Sample演示一个真实的基于SLE的鼠标方案。当前鼠标支持滑动、左右按键、滚轮功能。
配置¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”。
在menuconfig界面中进入“application/System mouse Pin Configuration”，如Mouse Pin Config所示。
选择完成后按“Q”、“Y”保存退出。
编译¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”。
在menuconfig界面中选择鼠标Sample，如图2所示。
选择完成后按“Q”保存退出。
使用IDE编译版本，编译出的版本包在“tools\pkg\fwpkg\bs2x”路径下，如图5所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录进鼠标板。
烧录及运行¶
将编译出的鼠标版本和Dongle版本分别烧录到鼠标板和Dongle板中，版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
鼠标板和Dongle分别上电，Dongle采用USB直接插在电脑上的方式上电。
观察鼠标板和Dongle板在UART-H0上的日志信息，如果出现“CONNECTED”表示已经完成连接。
在PC上观察到鼠标移动，按键单击等都能正常工作即表示SLE Mouse功能正常。
使用过程中鼠标或者Dongle重新上电，能够重新连接，并且功能正常。
注意事项¶
须知： 当前版本SDK SLE鼠标只支持paw3395这个传感器，后续会增补更多的传感器支持。
SLE amic vdt with dongle¶
概述¶
此Sample演示一个真实的基于SLE的dongle amic音频方案。整体的连接关系和数据流图如图1所示。
编译¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21 menuconfig”。
在menuconfig界面中选择SLE AMIC Sample，如所图1示。
在menuconfig界面中选择当前SLE type为Server端，如图2所示；如果需要调整adc管脚以及单次uac和dma传输数量，采样率默认是16KHZ，则继续按图3、图4所示选择。选择完成后按“Q”或者“q”保存退出。
使用IDE编译版本，编译出的版本包在“tools\pkg\fwpkg\bs21”路径下，如图6所示。
将编译出的版本按照的“SLE microphone”“烧录及运行”烧录。
重启打开menuconfig配置界面，仿照3～6选择SLE AMIC Client(Dongle)，如图5所示，进行编译，并将版本正常烧录。
烧录及运行¶
SLE microphone¶
概述¶
此Sample演示一个真实的基于SLE的dongle麦克风方案。整体的连接关系和数据流图如图1所示。
编译¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”。
在menuconfig界面中选择SLE Microphone Sample，如图1所示。
在menuconfig界面中选择当前Microphone type为Server端，如图2所示。
在menuconfig界面中选择单次uac传输数量和SLE作为Server端的地址及名称，如图3所示。
选择完成后按“Q”保存退出。
使用IDE编译版本，编译出的版本包在“tools\pkg\fwpkg\bs21”路径下，如下所示。
将编译出的版本按照“SLE microphone”的“烧录及运行”烧录。
重启打开menuconfig配置界面，仿照3～7选择SLE Microphone Client(Dongle)，如所示，进行编译，并将版本正常烧录。
烧录及运行¶
将编译出的麦克风版本烧录到单板中，版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
准备两块单板，分别作为Server端和Client端，分别烧录后串口打印“Connected”，查看设备管理器中会出现一个音频设备。
在PC选择声音设置中选择输入设备，如图1所示。
用Server单板采集声音，pc端耳机中可以听到对应的音频，则表示对通成功。
SLE measure dis¶
概述¶
此Sample基于SLE的测距方案。server端(广播)与client端(扫描)建立sle连接，server端计算出距离。
编译¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”。
在menuconfig界面中选择SLE Measure Dis Sample，如图1所示。
在menuconfig界面中选择Enable SLE MEASURE DIS Server sample，表明当前选择编译的是Server端，如图1所示。
选择完成后按“Q”保存退出。
使用IDE编译版本，编译出的版本包在“tools\pkg\fwpkg\bs2x”路径下，如图3所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”章节进行烧录。
重启打开menuconfig配置界面，仿照图2选择Enable SLE MEASURE DIS Client sample，表明当前选择编译的是Client端，如图2所示，进行编译，并将版本正常烧录。
烧录及运行¶
将编译出的server, client 分别烧录到两块单板中，版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
准备两块单板，分别作为Server端和Client端，分别烧录后串口打印“Connected”。
连接串口，查看server打印，可以看到距离值吐出
校准¶
测试环境：
锚点周围3m范围内空旷无遮挡、无墙体、柱体、金属等遮挡物。
测试方法：
BLE Lowpower Sample¶
概述¶
BLE Lowpower Sample主要展示了低功耗相关回调的注册（图1）、以及睡眠定时器的操作。当时，会触发handler中对应的回调，可在对应的注册函数中实现对应的操作。需要注意的是，sleep只能转换到work，具体3种状态的转换如图2所示。。
编译¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”。
在menuconfig界面中选择BLE UART Sample，如图1所示。
选择完成后按“Q”保存退出。
使用IDE编译版本，编译出的版本包在“tools\pkg\fwpkg\bs2x”路径下，如图2所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录。
烧录及运行¶
版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
准备一块单板，作为Server端，单板上将UART-L0和UART-L2与PC通过串口板连接。
通过UART-L0将编译好的Server版本烧录到单板中。
在PC端通过串口助手连接单板的UART-L2，并且将串口设置到115200波特率，并打开串口。
BLE UART Sample¶
概述¶
BLE UART与SLE UART的实现原理与方案一致，唯一的不同是空口由星闪传输换成了BLE传输，参考“概述”。
编译¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”。
在menuconfig界面中选择BLE UART Sample，如图1所示。
在menuconfig界面中选择当前Sample使用的UART BUS，如图2所示。
在menuconfig界面中选择BLE UART Server，如图3所示。
选择完成后按“Q”保存退出。
使用IDE编译版本，编译出的版本包在“tools\pkg\fwpkg\bs2x”路径下，如图4所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录。
重启打开menuconfig配置界面，仿照2～7选择BLE UART Client，如图5所示，进行编译，并将版本正常烧录。
烧录及运行¶
BLE UART的烧录及运行方法与SLE UART一致，参考“SLE UART Sample”的“烧录及运行”。
BLE Keyboard Sample¶
概述¶
此Sample演示一个真实的基于BLE的无Dongle键盘方案。当前键盘Sample支持两种键盘规格，分别是2×3的矩阵键盘和8×16的矩阵键盘（全键盘）。
编译¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”。
在menuconfig界面中选择BLE键盘Sample，如图1所示。
选择完成后按“Q”保存退出。
使用IDE编译版本，编译出的版本包在“tools\pkg\fwpkg\bs2x”路径下，如图2所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录。
烧录及运行¶
将编译出的键盘版本烧录到键盘板中，版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
键盘板上电。
在电脑（支持BLE键盘）上搜索名称为“ble_keyboard”的设备，并且进行连接。
在PC端打开记事本，并通过键盘输入信息，输入的信息在记事本中可以显示即表示BLE Keyboard功能正常。
使用过程中键盘重新上电，能够重新连接，并且功能正常。
BLE SLE TAG Sample¶
概述¶
此Sample演示的是一个同时支持蓝牙和星闪方案，可进行星闪或者蓝牙的连接。
编译¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”。
在menuconfig界面中选择 Ble Sle tag sample，如图Ble Sle tag sample所示。
选择完成后按“Q”保存退出。
使用sdk编译版本，编译出的版本包在“output\bs21\fwpkg\standard-bs21-n1100”路径下，如图2所示。
将编译出的版本按照“BLE SLE TAG Sample”的“烧录及运行”烧录。
烧录及运行¶
版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
准备一块单板，每块单板上将UART-L0和UART-L2与PC通过串口板连接。
通过UART-L0分别将编译好的Server版本和Client版本烧录到单板中。
在PC端通过串口助手连接单板的UART-L2，并且将串口设置到115200波特率，并打开串口。
上电后可看到设置注册服务和起广播的流程，此时可用一个可扫描的设备连接单板。
BLE Mouse Sample¶
概述¶
此Sample演示一个真实的基于BLE的无Dongle鼠标方案。当前鼠标支持滑动、左右按键、滚轮功能。
编译¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”。
在menuconfig界面中进入“application/System mouse Pin Configuration”，进行鼠标管脚配置，如图1所示。
在menuconfig界面中选择BLE鼠标Sample，如图2所示。
在menuconfig界面中选择BLE鼠标的Sensor，如图3所示。
选择完成后按“Q”、“Y”保存退出。
使用IDE编译版本，编译出的版本包在“tools\pkg\fwpkg\bs21”路径下，如图4所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录进鼠标板。
烧录及运行¶
将编译出的鼠标版本烧录到鼠标板中，版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
鼠标板上电。
在电脑（支持BLE鼠标）上搜索名称为“ble_mouse'”的设备，并且进行连接。
在PC上观察到鼠标移动，按键单击等都能正常工作即表示BLE Mouse功能正常。
使用过程中鼠标重新上电，能够重新连接，并且功能正常。
USB Keyboard Sample¶
概述¶
此sample演示一个真实的基于USB的方案。当前键盘sample支持两种键盘规格，分别是2x3的矩阵键盘和8x16的矩阵键盘（全键盘）。
编译¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”。
在menuconfig界面中选择USB键盘Sample，如图1所示。
选择完成后按“Q”保存退出。
使用IDE编译版本，编译出的版本包在“tools\pkg\fwpkg\bs2x”路径下，如图2所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录。
烧录及运行¶
将编译出的键盘版本烧录到键盘板中，版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
键盘板上电。
如果是非USB供电的单板，将USB与电脑连接。
在PC端打开记事本，并通过键盘输入信息，输入的信息在记事本中可以显示即表示USB Keyboard功能正常。
使用过程中键盘重新上电，能够重新连接，并且功能正常。
USB Mouse Sample¶
概述¶
此Sample演示一个真实的基于USB的无Dongle鼠标方案。当前鼠标支持滑动、左右按键、滚轮功能。
编译¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”。
在menuconfig界面中进入“application/System mouse Pin Configuration”，如图1所示。
选择完成后按“Q”、“Y”保存退出。
使用IDE编译版本，编译出的版本包在“tools\pkg\fwpkg\bs2x”路径下，如图4所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录进鼠标板。
烧录及运行¶
将编译出的鼠标版本烧录到鼠标板中，版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
鼠标板上电。
如果是非USB供电的单板，将USB与电脑连接。
在PC上观察到鼠标移动，按键单击等都能正常工作即表示BLE Mouse功能正常。
使用过程中鼠标重新上电，能够重新连接，并且功能正常。
USB AMIC VDT Sample¶
概述¶
此Sample演示一个USB AMIC 音频数传方案。当前支持16K采样率，16Bits位宽采样。
方案¶
编译¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”。
在menuconfig界面中选择USB AMIC Sample，如图1所示。
在menuconfig界面中选择USB AMIC 相关配置，如图2所示。
选择完成后按“Q”或者 ‘q’保存退出。
使用IDE编译版本，编译出的版本包在“output\bs21\fwpkg\xxx”路径下，如图3所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录。
烧录及运行¶
将编译出的音频数传版本烧录到单板中，版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
RCU¶
概述¶
此Sample演示一个真实的基于SLE、BLE与IR的遥控器方案。当前支持自定义按键规格。
方案¶
编译¶
当前 RCU Sample 支持两种键盘规格。键盘规格的选择在 Keyscan 驱动的 Kconfig 选项中进行。默认配置为 3 行 2 列的六键键盘，用户也可以选择自定义按键规格进行设置。配置选项如图1、图2所示。
编译步骤如下：
打开 menuconfig 配置界面：
在 IDE 工具下打开项目。
单击 KConfig 按钮，进入 menuconfig 配置界面。
选择键盘规格：
在 menuconfig 界面中，导航到键盘规格配置选项。
如果需要使用超过六键的键盘，选择 user config type 选项。如图 键盘选择六键配置、图2所示。
编辑 sdk/application/samples/products/rcu/rcu/keyscan/app_keyscan.c 文件，更改键盘注册配置，以适应自定义的按键布局。
-
在 menuconfig 界面中，导航到 Sample 选项。
选择 SLE RCU Server，如图3所示。
配置 RCU 本地地址，确保与实际使用场景一致。
开启低功耗
在 menuconfig 界面中，导航到低功耗配置选项。
选择开启低功耗模式，如图4。
保存配置：完成所有配置后，单击 Save 按钮保存配置并退出 menuconfig 界面。
编译版本：使用 IDE 编译项目编译出的版本包将位于 output\bs21\fwpkg\bs21-1100-rcu 路径，如图5所示。
烧录RCU Server 版本：将编译出的 RCU Server 版本烧录到板子。
配置RCU Dongle：
编译RCU Dongle 版本：完成所有配置后，单击 Save 按钮保存配置并退出menuconfig界面进行编译。
烧录RCU Dongle 版本
注：在USB初始化后需要在PC中选择麦克风+HID设备，才能完全初始化成功。
编译步骤如下：
在IDE工具下打开menuconfig配置界面，单击KConfig按钮。
在menuconfig界面中选择Sample，选择SLE rcu server，配置RCU本地地址，如图7所示。
在menuconfig界面中选择开启低功耗，如图4所示。
选择完成后单击save保存退出。
使用IDE编译版本，编译出的版本包在"output\bs21\fwpkg\bs21-1100-rcu" 路径下，如图5所示。
将编译出的server版本按照烧录进板子。
编译步骤如下：
烧录及运行¶
烧录¶
将编译出的RCU Server版本与Dongle版本分别烧录到Server与Dongle板中，版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
运行¶
Server与Dongle板子烧录完成后，分别上电，Dongle采用USB直接插在电脑上的方式上电。
Dongle上电后打开声音设置，设置采样率为1通道16KHZ16位如图1所示。
观察Server与Dongle板在串口助手上的日志信息，如果出现"CONNECTED"表示已经完成链接。某些特殊的遥控器需要按”快捷键”发起广播建立连接。
在Server端按下按键，观察Dongle端主机动作，例如音量加减键。
音量测试：按音量加减键，观察主机端音量是否变化。
2方向键测试：将光标定位在文本某一处，按方向键，观察光标方向变化。
语音上报功能：打开主机端麦克风，按遥控器上语音按键，观察麦克风测试窗口是否有声音传入。
潜在错误：
串口工具server端和dongle端都未显示connected ，可能是按键注册失败。
串口工具只有dongle端未显示connected，按键无反应，可能是server连接到其他dongle，重新设置地址。
回连测试：
在RCU与dongle端已建立连接情况下，任何一侧重启会马上回连。
重新烧录RCU server端固件，重启后需要重新连接。
学习功能调测：
进入产测模式：按住同时按住左键和右键，再按住上键。
学习遥控器按键：将被学习遥控器放在星闪遥控器前端2-5cm处，按一下被学习的按键。
退出产测模式：同时按住左键和右键。
星闪遥控器对准可以被"学习遥控器”控制的电视机或机顶盒。
多连接¶
SLE 多连接Sample¶
概述¶
此Sample演示一个真实的基于SLE的多连接方案。可编译client或者server身份的镜像，不可同时具备client和server身份。client上电后自动起扫描，扫描到server会主动发起连接，连接后会循环给server发数据。运行Sample的操作包括：配置编译宏，编译，烧录，上电；Client端与Server端在配置编译宏这个步骤上有不同，其他操作步骤相同。
编译¶
编译分为Client端编译和Server端编译，1个Client连接多个Server。
配置Client编译¶
可以配置的选项包括：mtu长度，连接的Server端数量，Client端的打印串口，Client端的MAC地址，Server端的MAC地址。以上配置可以采用默认配置，Client端的地址信息配置好后，Server端配置的地址不用更改，与Client设置的地址信息保持一致。
编译步骤如下：
在IDE工具下打开“menuconfig”配置界面，单击“KConfig”按钮。
在“menuconfig”界面中选择支持的Sample：“SLE Multi Connections sample”。
在“menuconfig”界面中选择“Enable SLE MULTI_CONN Client sample”。
可以按实际使用修改其他配置项。
选择完成后单击“save”保存退出。
使用IDE编译版本，编译出的版本包在“tools\pkg\fwpkg\bs2x\evb_all.fwpkg”路径下。
将编译出的client版本按照烧录进单板。
配置Server编译¶
可以配置的选项包括：当前server端的索引号， mac地址和名称。
编译步骤如下：
在IDE工具下打开menuconfig”配置界面，单击“KConfig”按钮。
在“menuconfig”界面中选择支持的Sample：“SLE Multi Connections sample”。
在“menuconfig”界面中选择Enable SLE MULTI_CONN Server sample”。
可以按实际使用修改其他配置项,通常只用配置server端的索引号，mac地址和server名称的配置项会自动更新。
选择完成后单击“save”保存退出。
使用IDE编译版本，编译出的版本包在“tools\pkg\fwpkg\bs2x\evb_all.fwpkg”路径下。
将编译出的server版本按照烧录进单板。
烧录及运行¶
烧录¶
将编译出的Server版本与Client版本分别烧录到Server与Client板中，版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
运行¶
Client与Server板子烧录完成后，分别上电。
观察Server与Client板在串口助手上的日志信息，如果出现"CONNECTED"表示已经完成连接。
上电的Server端持续向Client端发送示例数据abcd。
BLE 多连接注意事项¶
在已经连接的状态下，需要在服务发现（包括发现服务、发现特征、发现特征值以及发现描述符）之后开启扫描。
air mouse¶
概述¶
此Sample演示一个真实的基于sle+slp air mouse方案。
编译¶
在命令行下输入“python ./build.py -c bs21e-1100e-slp menuconfig”。
选择需要编译server，就按照1.server设置，需要编译dongle就按照2.dongle设置
server： (Top) → Application → Enable Sample. → Enable the Sample of products. → Support air mouse sample. → Air Mouse Sample Configuration → Select AIR MOUSE type → Enable AIR MOUSE sample
dongle: (Top) → Application → Enable Sample. → Enable the Sample of products. → Support air mouse sample. → Air Mouse Sample Configuration → Select AIR MOUSE type → Enable AIR MOUSE Dongle sample.
选择完成后按“Q”保存退出。
编译“python ./build.py -c bs21e-1100e-slp”。
编译结果在“output/bs21e/fwpkg/bs21e-1100e-slp/bs21e_all_in_one.fwpkg”。
menuconfig选择
编译结果：
烧录¶
版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
运行¶
准备两块单板，分别作为Server端和Client端。
烧录完后，上下电。
查看SLE是否正常连接以及指向功能。
SLE MOUSE with Dongle¶
概述¶
此Sample演示一个真实的基于SLE的鼠标Dongle方案。运行Sample的操作包括：配置编译宏、编译、烧录、上电，可以调整鼠标的上报速率;
dongle端与mouse端在配置编译宏这个步骤上有不同。
编译¶
编译SLE MOUSE¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”。
在menuconfig界面中进入“application/System mouse Pin Configuration”，进行鼠标管脚配置，如图1所示。
在menuconfig界面中选择SLE鼠标Sample，如图2所示。
在menuconfig界面中选择SLE鼠标的，如图3所
选择完成后按“Q”、“Y”保存退出。
使用IDE编译版本，编译出的版本包在“tools\pkg\fwpkg\bs21”路径下，如图4所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录进鼠标板。
编译SLEMOUSE with Dongle¶
在命令行下打开menuconfig配置界面，执行命令“python build.py standard-bs21-n1100 menuconfig”。
在menuconfig界面中选择SLE鼠标Sample，如图1所示。
在menuconfig界面中选择SLE鼠标的，如图2所示。
选择完成后按“Q”、“Y”保存退出。
使用IDE编译版本，编译出的版本包在“tools\pkg\fwpkg\bs21”路径下，如图3所示。
将编译出的版本按照“SLE Mouse Sample”的“烧录及运行”烧录进鼠标板。
烧录及运行¶
将编译出的鼠标版本烧录到鼠标板中，版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
鼠标板上电。
如果是非USB供电的单板，将USB与电脑连接。
在PC上观察到鼠标移动，按键单击等都能正常工作即表示BLE Mouse功能正常。
使用过程中鼠标重新上电，能够重新连接，并且功能正常
SLE OTA dongle¶
概述¶
该sample用于演示使用dongle通过SLE模块进行OTA升级的方案。
编译¶
在SDK根路径输入”python3 build.py standard-bs21-n1100 menuconfig”。
进入”Application”，打开”Enable sample”。
依次选择”Enable the Sample of products”，”Support sle ota dongle sample“。
根据需要在“sle ota dongle Sample Configuration“中配置参数。
保存并退出，执行“python3 build.py standard-bs21-n1100“，开始编译。
烧录及运行¶
版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
game mouse¶
本文档主要介绍星闪鼠标turnkey方案规格及其实现，助力开发者快速上手turnkey方案代码逻辑和相关接口。
概述¶
软件平台实现了对应用软件的底层屏蔽，并对应用软件直接提供API（Application Program Interface）接口完成相应功能。典型的系统框架如图1所示。
该构架可以分为以下几个层次：
APP层
APP层包括SLE通信功能，支持SLE模式、BLE模式与USB模式，支持不同品类。APP层也支持客户基于SDK提供的接口开发其他的应用。
Host层
Host是协议栈的上层实现，是硬件的抽象，包含逻辑链路控制、适配协议、安全管理器、属性协议、通用属性规范及服务等。
Controller层
Controller是协议栈的底层实现，直接和硬件相关，由芯片厂商实现，包括物理层、链路层、主机控制接口等。
外设与驱动层
提供外设、系统相关能力及接口。
turnkey代码目录说明：
├── app_public
├── ble_mouse_server // 蓝牙业务
├── CMakeLists.txt
├── Kconfig
├── mouse_button // 8k鼠标按键
├── mouse_data_transfer_manage.c // 鼠标数据传输
├── mouse_data_transfer_manage.h
├── mouse_flash // 读写flash
├── mouse_key // 2k鼠标按键
├── mouse_light // led灯控制
├── mouse_log.h
├── mouse_mac_rules // 切换通道时，mac地址管理
├── mouse_mode_manage.c // 蓝牙、星闪、有线模式管理，mouse task入口
├── mouse_mode_manage.h
├── mouse_power // 电源和低功耗
├── mouse_sensor // sensor相关
├── mouse_status // 广播、配对、断连处理
├── mouse_usb // usb初始化、接收处理
├── mouse_wheel // 滚轮
├── sfc_flash
├── sle_low_latency_service.c // 星闪鼠标low latency服务
├── sle_low_latency_service.h
├── sle_mouse_client // 星闪鼠标client端管理
├── sle_mouse_dongle.c // 星闪鼠标dongle task入口
├── sle_mouse_dongle.h
└── sle_mouse_server // 星闪鼠标server端管理
编译¶
烧录及运行¶
将编译出的TurnkeyMouse Server版本与Dongle版本分别烧录到Server与Dongle板中，版本烧录方法请参见《BS2XV100 HiSpark Studio 使用指南》。
各模块的详细功能可参照文档《BS2XV100 星闪鼠标应用方案开发 用户指南》。
BLE UUID¶
概述¶
本文档主要介绍BLE UUID sample所提供的接口以及编译方法。此sample只提供接口，不能直接，需要由使用者调用相关接口使用。
编译¶
使用此sample相关接口需要配置menuconfig，具体配置步骤如下：
单击“KConfig”按钮。
单击“Application”。
单击“Enable Sample”。
单击“Enable the Sample BT”。
单击“Support BLE Sample”。
单击“Support Ble uuid server sample”。
回到vsocde中，单击“Build”进行编译。
接口¶
表 1 接口清单
errcode_t ble_uuid_server_send_report_by_uuid(const uint8_t *data, uint8_t len); |
|
errcode_t ble_uuid_server_send_report_by_handle(uint16_t attr_handle, const uint8_t *data, uint8_t len); |
|
接口详细信息见sdk：application/samples/bt/ble/ble_uuid_server/inc。