Bouffalo Lab Docs - 用户贡献 [zh-cn]

Demo:Basical case

2025-08-11T09:39:37Z

武楷轩：

== 前言 ==
'''该页面将介绍一些较为简单基础的测试case 功能，目前包括 freertos；log等级输出；boot2；这一小节将会为您先详细介绍如何编译烧录如何下载烧录工具等基本信息。'''

=== 源码编译: ===
在对应 Case 的文件夹下有一个 README.md 文件，该文件中根据不同的开发板型号有不同编译的参数，例如 bl616 ：
- BL616/BL618

```
make CHIP=bl616 BOARD=bl616dk
```
#以上为README文件中的内容，根据内容直接执行对应make编译指令即可
make如果成功，你会在终端看到：

[[文件:Make success.png]]

Generate .../bouffalo_sdk/examples/freertos/build/build_out/freertos_bl616.bin（示例） '''代表生成了对应可供烧录的固件'''。

=== 开发板烧录： ===
执行make命令后，在该文件夹下会生成一个build目录，在文件夹中有一个生成的固件 freertos_bl616.bin ，该文件用于烧录直接使用（类似于keil生成的.hex文件）。

其具体路径为 '''.../bouffalo_sdk/examples/freertos/build/build_out/freertos_bl616.bin'''

==== 下载烧录工具： ====
下载BLDevCube工具：下载后解压即可直接使用。

<nowiki>https://dev.bouffalolab.com/</nowiki>

'''烧录具体步骤：'''

Step1：打开DevCube选择对应开发板型号。
[[文件:烧录Step1.png|无|缩略图|300x300像素]]
Step2：选择对应的 .bin 文件，选择对应的串口。

[[文件:烧录Step2.png|887x887像素]]

'''注意：要选择IOT并勾选enable'''

Step3：

'''按住boot键按一下复位键（按复位时boot键不松开），然后点击Create & Download'''。查看下方的输出信息是否烧录成功。

== Demo:FreeRTOS ==
在Bouffalo SDK上使用FreeRTOS APP

=== 源码介绍： ===
该文件的源码在 bouffalo_sdk/examples/freertos/main.c中，该测试 demo 简单测试了一些组件，包括Semaphore，Mutex，Queue，Priority 的基本简单测试。

测试分为两个阶段：

阶段一以消费者生产者模型测试'''信号量'''和'''信号队列'''组件，共生成三个Task。阶段结束后Task自动销毁。

阶段二以共简单共享资源简单测试Task争夺临界资源的方式测试'''互斥量'''，途中高优先级的任务将启动并占用CPU一段时间以此测试抢占'''任务调度'''。

'''源码部分输出：'''
[FREERTOS_TEST CONSOLE] ===== PHASE 1: Queue/Semaphore Test =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task]: Starting consumer tasks...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task]: Starting producer task...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: task started
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: task started
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: received msg (task:1, ts:1)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: received msg (task:1, ts:501)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: received msg (task:1, ts:1001)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: queue empty
.....
[FREERTOS_TEST CONSOLE] ===== PHASE 2: Priority/Mutex Test =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] Starting High Priority task...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] Starting Shared Resource tasks...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Attempt to acquire mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 1
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Attempt to acquire mutex
.....
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Attempt to acquire mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [High Priority Task]: High priority task running
[FREERTOS_TEST CONSOLE] [I][MAIN] [High Priority Task]: Completed
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 5
.....
[FREERTOS_TEST CONSOLE] ===== END PHASE 2 =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 11
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] All Test Complete.

== Demo:bflog ==

=== Demo介绍： ===
该部分代码储存在 bouffalo_sdk/examples/bflog/barebone_sync 路径下，主要测试该开发板不同级别的log输出功能；

filter对输出日志的过滤功能。bflog分为五个级别，分别为：
{| class="wikitable"
!'''日志等级'''
!'''说明'''
!'''基本应用场景'''
|-
|'''FATL'''
|致命错误（Fatal）
|系统无法继续运行的灾难性事件（如核心崩溃、数据损坏），需立即人工干预并终止程序。
|-
|'''ERRO'''
|错误（Error）
|影响当前操作的关键错误（如功能失效、外部服务异常），但系统仍可部分运行，需尽快处理。
|-
|'''WARN'''
|警告（Warning）
|非关键性异常或潜在风险（如配置降级、资源不足），需关注但无需立即行动。
|-
|'''INFO'''
|信息（Info）
|常规运行状态记录（如服务启动、关键操作完成），用于监控系统健康状态。
|-
|'''DBUG'''
|调试（Debug）
|开发/测试阶段的详细运行细节（如变量值、逻辑分支），用于定位问题原因。
|-
|'''TRAC'''
|跟踪（Trace）
|最细粒度的执行路径追踪（如函数调用栈、循环过程），用于深度分析复杂逻辑。
|}
----

=== barebone_sync： ===
该部分主要是裸机测试了以上的各个等级log输出，filter过滤。

'''部分输出：'''<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================

============================== enable all output

[FATL][ 25338][2022-12-16 17:51:40][main.c:main:130]<MAIN> hello world this is fatal error
[ERRO][ 25858][2022-12-16 17:51:40][main.c:main:131]<MAIN> hello world this is error
[WARN][ 26355][2022-12-16 17:51:40][main.c:main:132]<MAIN> hello world this is warning
[INFO][ 26864][2022-12-16 17:51:40][main.c:main:133]<MAIN> hello world this is information
[DBUG][ 27374][2022-12-16 17:51:40][main.c:main:134]<MAIN> hello world this is degug information
[TRAC][ 27934][2022-12-16 17:51:40][main.c:main:135]<MAIN> hello world this is trace information
[FATL][ 28492][2022-12-16 17:51:40][log_test.c:test_log:13]<TEST> hello test this is fatal error
[ERRO][ 29049][2022-12-16 17:51:40][log_test.c:test_log:14]<TEST> hello test this is error
[WARN][ 29580][2022-12-16 17:51:40][log_test.c:test_log:15]<TEST> hello test this is warning
[INFO][ 30119][2022-12-16 17:51:40][log_test.c:test_log:16]<TEST> hello test this is information
[DBUG][ 30660][2022-12-16 17:51:40][log_test.c:test_log:17]<TEST> hello test this is degug information
[TRAC][ 31248][2022-12-16 17:51:40][log_test.c:test_log:18]<TEST> hello test this is trace information

============================== enable only MAIN output

[FATL][ 1031983][2022-12-16 17:51:41][log_test.c:test_log:13]<TEST> hello test this is fatal error
[ERRO][ 1032537][2022-12-16 17:51:41][log_test.c:test_log:14]<TEST> hello test this is error
[WARN][ 1033066][2022-12-16 17:51:41][log_test.c:test_log:15]<TEST> hello test this is warning
[INFO][ 1033606][2022-12-16 17:51:41][log_test.c:test_log:16]<TEST> hello test this is information
[DBUG][ 1034146][2022-12-16 17:51:41][log_test.c:test_log:17]<TEST> hello test this is degug information
[TRAC][ 1034736][2022-12-16 17:51:41][log_test.c:test_log:18]<TEST> hello test this is trace information

============================== disable all output

</syntaxhighlight>

=== freertos_async： ===
该部分测试了在FreeRTOS下log的输出是否正常。

该case创建了两个任务，消费者和生产者，从信号队列中进行获取和放入的经典场景来测试log。

消费者任务和生产者任务具体代码放在同目录下的： thread_consumer; thread_producer;中。

'''部分输出：'''

== Demo:helloworld ==

=== Demo介绍： ===
该demo测试基本日志等级输出，该Demo是对bflog加了一层封装，比如控制日志输出等级，控制是否使用严重等级颜色输出。

保存路径： bouffalo_sdk/examples/helloworld

在当前默认情况下的输出如下：
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information
hello world fatal raw
hello world error raw
hello world warning raw
hello world information raw
通过代码对应可以看到部分代码没有输出，部分代码有颜色而部分代码没有颜色。没有输出的部分是因为 LOG_LEVEL 的定义级别导致没有输出：
#if (CONFIG_LOG_LEVEL >= 4)
#define LOG_D(...) BFLOG_D((void *)&__bflog_recorder, __VA_ARGS__)
#define LOG_RD(...) BFLOG_RD((void *)&__bflog_recorder, __VA_ARGS__)
#else
#define LOG_D(...) ((void)0)
#define LOG_RD(...) ((void)0)
#endif

#if (CONFIG_LOG_LEVEL >= 5)
#define LOG_T(...) BFLOG_T((void *)&__bflog_recorder, __VA_ARGS__)
#define LOG_RT(...) BFLOG_RT((void *)&__bflog_recorder, __VA_ARGS__)
#else
#define LOG_T(...) ((void)0)
#define LOG_RT(...) ((void)0)
#endif
是否有颜色则取决于是否带有R,在引用文件中可以看到：
#define BFLOG_RF(_log, ...) BFLOG_X(_log, BFLOG_LEVEL_RAW | BFLOG_LEVEL_FATAL, (BFLOG_TAG), ##__VA_ARGS__)
以上配置可以在同级目录下的 proj.conf 中。

== Demo:log_dbg_assert ==
这部分代码和Demo:helloworld 基本一致，但是多了测试断言输出的功能。

保存在 SDK 下的： bouffalo_sdk/examples/log_dbg_assert

在代码中先进行了一个阶乘的递归函数，每一次递归以及判读啊都会输出断言信息以此测试断言输出。

示例输出：<syntaxhighlight lang="bash" line="1">
[I][MAIN] message = "hellokszhdfoiasjdkjnskjxnvuiolashdfoinaskjldfnvklasjhdfi213489o71234589073298dfl;asjdlfnkjzxncvhasdlkfljhasjkldjhnvjkaslndfvkljashdlifhui"
[I][MAIN] message (size: 138):
00000000: 68 65 6c 6c 6f 6b 73 7a 68 64 66 6f 69 61 73 6a 'hellokszhdfoiasj'
00000010: 64 6b 6a 6e 73 6b 6a 78 6e 76 75 69 6f 6c 61 73 'dkjnskjxnvuiolas'
00000020: 68 64 66 6f 69 6e 61 73 6b 6a 6c 64 66 6e 76 6b 'hdfoinaskjldfnvk'
00000030: 6c 61 73 6a 68 64 66 69 32 31 33 34 38 39 6f 37 'lasjhdfi213489o7'
00000040: 31 32 33 34 35 38 39 30 37 33 32 39 38 64 66 6c '1234589073298dfl'
00000050: 3b 61 73 6a 64 6c 66 6e 6b 6a 7a 78 6e 63 76 68 ';asjdlfnkjzxncvh'
00000060: 61 73 64 6c 6b 66 6c 6a 68 61 73 6a 6b 6c 64 6a 'asdlkfljhasjkldj'
00000070: 68 6e 76 6a 6b 61 73 6c 6e 64 66 76 6b 6c 6a 61 'hnvjkaslndfvklja'
00000080: 73 68 64 6c 69 66 68 75 69 00 'shdlifhui.'
[I][MAIN] 3 * a = 6 (0x6)
[I][MAIN] numbers = [7,13,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,] (length: 512)
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = true
[I][MAIN] 1 = 1 (0x1)
[I][MAIN] n * factorial(n - 1) = 2 (0x2)
[I][MAIN] n * factorial(n - 1) = 6 (0x6)
[I][MAIN] n * factorial(n - 1) = 24 (0x18)
[I][MAIN] factorial(4) = 24 (0x18)
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = true
[I][MAIN] 1 = 1 (0x1)

.......

1 == factorial(4) but 1 = 1 , factorial(4) = 24
error handler
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information
hello world fatal raw
hello world error raw
hello world warning raw
hello world information raw
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information

</syntaxhighlight>

== Demo:boot2 isp ==
这部分代码是一个bootloader程序，具备 '''安全启动'''、'''双分区更新'''、'''压缩支持'''、'''多核管理''' 等工业级特性。

该demo存放在 SDK 下的：/home/user/FromGit/bouffalo_sdk/examples/boot2_isp 路径下。

=== 主要功能 ===

# '''分区表'''：读取并验证分区表（<code>pt_table_stuff</code>），确定活动分区（<code>active_id</code>）支持 A/B 双分区设计，实现无缝固件更新和回滚处理分区条目，包括固件位置、大小、版本号
# '''固件加载与启动'''：该程序会根据分区表加载固件到内存支持压缩固件：XZ 格式的解压<code>blsp_boot2_check_xz_fw</code> 多核支持： <code>BLSP_BOOT2_CPU_GROUP_MAX</code> 定义 CPU 数量
# '''固件更新'''：OTA 更新：将新固件从临时分区复制到主分区防回滚（Anti-Rollback）：防止降级到不安全版本支持 USB/UART 烧录模式，对应代码：<code>bflb_eflash_loader_main</code>
# '''安全'''：SHA-256 校验具有固件完整性检查

您可以在开发板存在其他 App 的同时烧录该 bin ,'''这并不会覆盖掉你的程序，而是只为开发板更换 bootloader'''.

== Demo：mbedtls ==

=== Demo介绍： ===
这段代码对tls中的加密功能进行了全面的自检测，保证mbedtls库可以正常在平台上运行。

保存在 SDK 下的 bouffalo_sdk/examples/mbedtls

'''ECDH测试'''

函数：<code>mbedtls_ecdh_test</code>

'''测试内容'''：客户端和服务器分别生成公私钥对。客户端和服务器分别计算共享密钥。验证客户端和服务器计算的共享密钥是否一致

'''ECDSA测试'''

函数：<code>mbedtls_ecdsa_test</code>

'''测试内容'''：生成 ECDSA 密钥对。使用私钥对哈希值进行签名，生成签名。使用公钥验证签名的正确性。

'''涉及的算法'''：ECDSA数字签名；哈希算法：SHA-256。

'''AES测试'''

函数：<code>mbedtls_aes_test</code>

'''测试内容'''：测试 AES 的 ECB、CBC 和 CTR三种模式。验证解密后的数据是否与原始数据一致。

'''SHA测试'''

函数：<code>mbedtls_sha_test</code>

'''测试内容'''：测试 SHA-1、SHA-256 和 SHA-512 三种哈希算法。对输入数据进行哈希计算，输出哈希值

示例输出：<syntaxhighlight lang="bash" line="1">
===========================
SHA-1 test #1: passed
SHA-1 test #2: passed
SHA-1 test #3: passed

SHA-224 test #1: passed
SHA-224 test #2: passed
SHA-224 test #3: passed
SHA-256 test #1: passed
SHA-256 test #2: passed
SHA-256 test #3: passed

SHA-384 test #1: passed
SHA-384 test #2: passed
SHA-384 test #3: passed
SHA-512 test #1: passed
SHA-512 test #2: passed
SHA-512 test #3: passed
=========== ecdh test ================
setup rng ... ok
select ecp group SECP256R1 ... ok
Get public key time=33ms
1. ecdh client generate public parameter:
04 BC C2 58 06 F0 C1 A2 AC 83 C2 4F C5 CD 9C ED
A8 C3 8D C1 CF 3E 5B 52 0C 81 E1 50 15 D2 FE A1
AE 30 62 A9 6F E3 72 97 3B E0 12 A4 EC C2 2F 22
63 E3 AC 81 91

..........

aes ctr 192 block:1000 enc cost time:331 us
aes ctr 192 block:1000 dec cost time:329 us
test aes ctr 256
aes ctr 256 block:1000 enc cost time:354 us
aes ctr 256 block:1000 dec cost time:354 us

=========== sha test ================
sha1 block:1000 cost time:415 us
sha256 block:1000 cost time:268 us
sha512 block:1000 cost time:236 us
mbedtls test success

</syntaxhighlight>

== Demo:memheap ==

=== Demo介绍： ===
该demo主要测试申请和释放内存memory 的功能是否正常。在当前代码下，程序会不断申请释放无休止直到将内存消耗殆尽。

保存在 SDK 下的： bouffalo_sdk/examples/memheap

示例输出：<syntaxhighlight lang="bash" line="1">
ptr :hello123456789123456789123456789
get memory :411520 byte
free memory :411520 byte
remain 25244 byte
ptr :hello123456789123456789123456789
get memory :411648 byte
free memory :411648 byte
remain 25116 byte
ptr :hello123456789123456789123456789
get memory :411776 byte
free memory :411776 byte
remain 24988 byte

......

ptr :hello123456789123456789123456789
get memory :433920 byte
free memory :433920 byte
remain 2844 byte
ptr :hello123456789123456789123456789
get memory :434048 byte
free memory :434048 byte
tlsf malloc 434176 bytes failed at function bflb_malloc using heap base:0x62fc5554
remain 436900 byte
try to get 434176 byte memory failed!
memheap test fail

</syntaxhighlight>

== Demo:partition ==

=== Demo介绍： ===
该demo主要测试分区表获取和输出。所以这里主要要烧录whole bin,否则没有烧录分区表会导致失败。

示例输出：<syntaxhighlight lang="bash" line="1">
======= PtTable_Config @0x62fc3cc8=======
magicCode 0x54504642; version 0x0000; entryCnt 8; age 0; crc32 0xE38928F3
idx type device active_index name Address[0] Address[1] Length[0] Length[1] age
[00] 16 0 0 Boot2 0x00000000 0x00000000 0x0000e000 0x00000000 0
[01] 00 0 0 FW 0x00010000 0x00210000 0x00200000 0x00168000 0
[02] 10 0 0 mfg 0x00210000 0x00000000 0x00168000 0x00000000 0
[03] 02 0 0 media 0x00378000 0x00000000 0x00071000 0x00000000 0
[04] 03 0 0 PSM 0x003e9000 0x00000000 0x00008000 0x00000000 0
[05] 04 0 0 KEY 0x003f1000 0x00000000 0x00002000 0x00000000 0
[06] 05 0 0 DATA 0x003f3000 0x00000000 0x00005000 0x00000000 0
[07] 06 0 0 factory 0x003f8000 0x00000000 0x00008000 0x00000000 0

</syntaxhighlight>其中：索引的 0 和 1 分别代表不同的区，一个是活跃的当前正在使用的，另一个是备份的用于当升级失败回滚的。

== Demo:efuse_trim ==

=== Demo介绍： ===
该Demo主要用于验证efuse中储存的修剪数值是否正确，这些修剪值用于矫正一些模块。

保存在SDK下： bouffalo_sdk/examples/peripherals/efuse/efuse_trim

=== 代码解读： ===

# '''初始化和设备获取'''：
#* 调用 <code>board_init()</code> 初始化硬件板级配置。
#* 使用 <code>bflb_device_get_by_name("ef_ctrl")</code> 获取 eFuse 控制设备的句柄。
# '''修剪值读取和验证'''：
#* 定义了一个数组 <code>trim_list</code>，然后遍历 <code>trim_list</code>，调用 <code>bflb_ef_ctrl_read_common_trim</code> 读取每个修剪值。
#* 如果修剪值有效，则进一步验证其奇偶校验。如果校验通过，打印修剪值；否则提示校验错误。
#* 如果修剪值无效，提示未找到。
'''示例输出：'''<syntaxhighlight lang="bash">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================

eFuse read trim value case!
trim rc32m value=108!
trim rc32k value=273!
trim tsen value=2149!
case finished!

</syntaxhighlight>

== Demo:i2s_es8311 ==
该Demo的主要用途是实现音频数据采集和播放。主要功能是初始化并配置 I2S 接口和 ES8311 音频编解码器，以实现音频数据的传输和处理。

保存在SDK下：bouffalo_sdk/examples/peripherals/i2s/i2s_es8311

=== 代码解读： ===

# '''硬件初始化'''：调用 <code>board_init()</code> 初始化硬件板级配置。初始化 GPIO 引脚<code>i2s_gpio_init()</code>，为 I2S 和 I2C 接口分配功能引脚。
# '''主时钟输出'''：调用 <code>mclk_out_init()</code> 配置 I2S 的主时钟输出，为外部音频设备ES8311提供时钟信号。
# '''ES8311 音频编解码器初始化'''：配置 ES8311 的工作模式。调用 <code>es8311_init()</code> 初始化 ES8311，并设置音量。启动 ES8311 的 ADC 和 DAC 模块。
# '''I2S 和 DMA 初始化'''：调用 <code>i2s_dma_init()</code> 初始化 I2S 接口和 DMA 通道。配置 DMA 通道，启动 DMA 通道，开始音频数据的传输和接收。
'''示例输出：'''<syntaxhighlight lang="bash" line="1">
===========================
es8311 init
read chip id failed!
SET: volume:70%
i2s init
dma init
dma lli init
tx dma lli num: 2
rx dma lli num: 2
tc done
rx done
tc done
rx done
tc done
rx done
tc done
rx done
</syntaxhighlight>

== Demo:printf ==
该demo主要测试基本printf功能是否完整，正常。

保存在SDK 下：bouffalo_sdk/examples/printf

=== 测试的主要功能包括： ===

# 格式化标志(Flags)测试：

* <code>test_space_flag</code>: 测试空格标志( )的格式化
* <code>test_plus_flag</code>: 测试加号标志(<code>+</code>)的格式化
* <code>test_zero_flag</code>: 测试零填充标志(<code>0</code>)的格式化
* <code>test_minus_flag</code>: 测试左对齐标志(<code>-</code>)的格式化
* <code>test_sharp_flag</code>: 测试井号标志(<code>#</code>)的格式化

# 宽度和精度测试：

* <code>test_width</code>: 测试基本宽度指定
* <code>test_width_20</code>: 测试20字符宽度的格式化
* <code>test_padding_20</code>: 测试20字符填充
* <code>test_padding_dot_20</code>: 测试带小数点的20字符填充

# 数值类型测试：

* <code>test_integer_types</code>: 测试各种整数类型(int, long, long long等)
* <code>test_floating_point_specifiers_precision_and_flags</code>: 测试浮点数的精度和标志
* <code>test_pointer</code>: 测试指针类型的打印

# 特殊情况测试：

* <code>test_infinity_and_not_a_number_values</code>: 测试无穷大和NaN值的打印
* <code>test_tiny_floating_point_values</code>: 测试极小浮点数的打印

# 字符串相关测试：

* <code>test_string_length</code>: 测试字符串长度限制打印
'''示例输出：'''<syntaxhighlight lang="bash" line="1">
test 26 begin >>>>>>>>>>>
53000atest-20 bit
53000atest-20 bit
0.33
0.33
1
1
foo
foo

00004
00004
hi x
hi x
00123
00123
-67224.546875000000000000
-67224.546875000000000000
0.33
0.33
3.33e-01
3.33e-01
0.000000e+00
0.000000e+00
-0.000000e+00
-0.000000e+00
test 26 end >>>>>>>>>>>>>

test 27 begin >>>>>>>>>>>
30 30 30 30
30 30 30 30
30 30 30 30
30 30 30 30
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
281474976710656 281474976710656 281474976710656 281474976710656
281474976710656 281474976710656 281474976710656 281474976710656
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
1234567891234567 1234567891234567 1234567891234567 1234567891234567
1234567891234567 1234567891234567 1234567891234567 1234567891234567
test 27 end >>>>>>>>>>>>>

test 28 begin >>>>>>>>>>>
30 30 30 30
30 30 30 30
30 30 30 30
30 30 30 30
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 -9223372036854775807
281474976710656 281474976710656 281474976710656 281474976710656
281474976710656 281474976710656 281474976710656 281474976710656
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
1234567891234567 1234567891234567 1234567891234567 1234567891234567
1234567891234567 1234567891234567 1234567891234567 1234567891234567
test 28 end >>>>>>>>>>>>>
</syntaxhighlight>

== Demo Shell： ==
该部分代码测试了在裸机和带'''freertos'''操作系统两种情况下串口的终端功能测试。

这部分代码存放在SDK的 bouffalo_sdk/examples/shell 路径下。

=== Demo:shell_os ===
<syntaxhighlight lang="bash" line="1">
burst wrap cmd 0x77
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
bouffalolab />
bouffalolab />
bouffalolab />help
shell commands list:
test
free
memtrace
help
mfg
reboot
sysver

bouffalolab />
</syntaxhighlight>

=== Demo:shell_no_os ===
<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
bouffalolab />
bouffalolab />
bouffalolab />
bouffalolab />help
shell commands list:
test
free
memtrace
help
ps
mfg
reboot
sysver

bouffalolab />
</syntaxhighlight>

== Demo:pmu ==

=== Demo介绍： ===
这部分Demo主要测试了开发板的两种休眠模式。Hibernation 休眠模式和 Power down sleep 深度休眠模式，其中，HBN 是更深层次的休眠每次唤醒都从头执行，除了SRAM保持区其余都不储存。适合长时间关机，实时性低。

而 PDS 是中层次的休眠，唤醒从断线执行，而且保留寄存器，SRAM 和部分外设的信息。适合段是关机，比如每秒唤醒一次，实时性更高。

保存在SDK下：bouffalo_sdk/examples/pmu/xxxx/其中 xxxx 是开发板对应的型号。

=== Demo:hbn_rtc: ===
<syntaxhighlight lang="bash" line="1">
qe write len 0x02
cread support 0x01
cread code 0x20
burst wrap cmd 0x77
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
enter hbn mode
</syntaxhighlight>

=== Demo:pds_rtc: ===
<syntaxhighlight lang="bash" line="1">
ead reg cmd1 0x35
write reg cmd0 0x01
write reg cmd1 0x01
qe write len 0x02
cread support 0x01
cread code 0x20
burst wrap cmd 0x77
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
enter pds mode

</syntaxhighlight>这两个Demo 中有配有RTC,会不断的唤醒和睡眠。

== Demo:wo ==

=== Demo介绍： ===
保存在SDK 下：bouffalo_sdk/examples/peripherals/wo/wo_int

该Demo测试了博流Bouffalo芯片中WO(Waveform Output)外设的中断功能。

测试包括：

# WO外设的三种中断类型的触发和处理
# WO外设的配置参数设置
# 不同数据量下的FIFO操作
# 中断屏蔽和解除屏蔽功能
# WO外设的使能和禁用功能

示例输出：<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
interrupt end!
interrupt fifo!
interrupt fifo!
interrupt fer!
interrupt fer!
</syntaxhighlight>

== Demo:wdg ==
该Demo 主要测试watch dog 看门狗外设的基本功能。

保存在SDK下： bouffalo_sdk/examples/peripherals/wdg/wdg_int
测试的主要功能点：

# 看门狗定时功能：验证在配置的时间范围内是否正确触发中断验证计数器复位功能是否正常工作
# 中断处理机制：中断触发的及时性中断清除功能中断标志的正确设置
# 时间控制精度：1秒内不触发中断的准确性 2秒时正确触发中断的准确性

示例输出：<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
Watchdog interrupt test
Delay 1s, wdg interrupt not arrive, pass
Delay 2s, wdg interrupt arrived, pass

</syntaxhighlight>

Demo:Basical case

2025-08-11T09:30:47Z

武楷轩：

Demo:Basical case

2025-08-11T09:28:50Z

武楷轩：

== 前言 ==
'''该页面将介绍一些较为简单基础的测试case 功能，目前包括 freertos；log等级输出；boot2；这一小节将会为您先详细介绍如何编译烧录如何下载烧录工具等基本信息。'''

=== 源码编译: ===
在对应 Case 的文件夹下有一个 README.md 文件，该文件中根据不同的开发板型号有不同编译的参数，例如 bl616 ：
- BL616/BL618

```
make CHIP=bl616 BOARD=bl616dk
```
#以上为README文件中的内容，根据内容直接执行对应make编译指令即可
make如果成功，你会在终端看到：

[[文件:Make success.png]]

Generate .../bouffalo_sdk/examples/freertos/build/build_out/freertos_bl616.bin（示例） '''代表生成了对应可供烧录的固件'''。

=== 开发板烧录： ===
执行make命令后，在该文件夹下会生成一个build目录，在文件夹中有一个生成的固件 freertos_bl616.bin ，该文件用于烧录直接使用（类似于keil生成的.hex文件）。

其具体路径为 '''.../bouffalo_sdk/examples/freertos/build/build_out/freertos_bl616.bin'''

==== 下载烧录工具： ====
下载BLDevCube工具：下载后解压即可直接使用。

<nowiki>https://dev.bouffalolab.com/</nowiki>

'''烧录具体步骤：'''

Step1：打开DevCube选择对应开发板型号。
[[文件:烧录Step1.png|无|缩略图|300x300像素]]
Step2：选择对应的 .bin 文件，选择对应的串口。

[[文件:烧录Step2.png|887x887像素]]

'''注意：要选择IOT并勾选enable'''

Step3：

'''按住boot键按一下复位键（按复位时boot键不松开），然后点击Create & Download'''。查看下方的输出信息是否烧录成功。

== Demo:FreeRTOS ==
在Bouffalo SDK上使用FreeRTOS APP

=== 源码介绍： ===
该文件的源码在 bouffalo_sdk/examples/freertos/main.c中，该测试 demo 简单测试了一些组件，包括Semaphore，Mutex，Queue，Priority 的基本简单测试。

测试分为两个阶段：

阶段一以消费者生产者模型测试'''信号量'''和'''信号队列'''组件，共生成三个Task。阶段结束后Task自动销毁。

阶段二以共简单共享资源简单测试Task争夺临界资源的方式测试'''互斥量'''，途中高优先级的任务将启动并占用CPU一段时间以此测试抢占'''任务调度'''。

=== 源码部分输出： ===
[FREERTOS_TEST CONSOLE] ===== PHASE 1: Queue/Semaphore Test =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task]: Starting consumer tasks...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task]: Starting producer task...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: task started
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: task started
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: received msg (task:1, ts:1)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: received msg (task:1, ts:501)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: received msg (task:1, ts:1001)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: queue empty
.....
[FREERTOS_TEST CONSOLE] ===== PHASE 2: Priority/Mutex Test =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] Starting High Priority task...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] Starting Shared Resource tasks...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Attempt to acquire mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 1
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Attempt to acquire mutex
.....
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Attempt to acquire mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [High Priority Task]: High priority task running
[FREERTOS_TEST CONSOLE] [I][MAIN] [High Priority Task]: Completed
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 5
.....
[FREERTOS_TEST CONSOLE] ===== END PHASE 2 =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 11
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] All Test Complete.

== Demo:bflog ==

=== Demo介绍： ===
该部分代码储存在 bouffalo_sdk/examples/bflog/barebone_sync 路径下，主要测试该开发板不同级别的log输出功能；

filter对输出日志的过滤功能。bflog分为五个级别，分别为：
{| class="wikitable"
!'''日志等级'''
!'''说明'''
!'''基本应用场景'''
|-
|'''FATL'''
|致命错误（Fatal）
|系统无法继续运行的灾难性事件（如核心崩溃、数据损坏），需立即人工干预并终止程序。
|-
|'''ERRO'''
|错误（Error）
|影响当前操作的关键错误（如功能失效、外部服务异常），但系统仍可部分运行，需尽快处理。
|-
|'''WARN'''
|警告（Warning）
|非关键性异常或潜在风险（如配置降级、资源不足），需关注但无需立即行动。
|-
|'''INFO'''
|信息（Info）
|常规运行状态记录（如服务启动、关键操作完成），用于监控系统健康状态。
|-
|'''DBUG'''
|调试（Debug）
|开发/测试阶段的详细运行细节（如变量值、逻辑分支），用于定位问题原因。
|-
|'''TRAC'''
|跟踪（Trace）
|最细粒度的执行路径追踪（如函数调用栈、循环过程），用于深度分析复杂逻辑。
|}
----

=== barebone_sync： ===
该部分主要是裸机测试了以上的各个等级log输出，filter过滤。

'''部分输出：'''<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================

============================== enable all output

[FATL][ 25338][2022-12-16 17:51:40][main.c:main:130]<MAIN> hello world this is fatal error
[ERRO][ 25858][2022-12-16 17:51:40][main.c:main:131]<MAIN> hello world this is error
[WARN][ 26355][2022-12-16 17:51:40][main.c:main:132]<MAIN> hello world this is warning
[INFO][ 26864][2022-12-16 17:51:40][main.c:main:133]<MAIN> hello world this is information
[DBUG][ 27374][2022-12-16 17:51:40][main.c:main:134]<MAIN> hello world this is degug information
[TRAC][ 27934][2022-12-16 17:51:40][main.c:main:135]<MAIN> hello world this is trace information
[FATL][ 28492][2022-12-16 17:51:40][log_test.c:test_log:13]<TEST> hello test this is fatal error
[ERRO][ 29049][2022-12-16 17:51:40][log_test.c:test_log:14]<TEST> hello test this is error
[WARN][ 29580][2022-12-16 17:51:40][log_test.c:test_log:15]<TEST> hello test this is warning
[INFO][ 30119][2022-12-16 17:51:40][log_test.c:test_log:16]<TEST> hello test this is information
[DBUG][ 30660][2022-12-16 17:51:40][log_test.c:test_log:17]<TEST> hello test this is degug information
[TRAC][ 31248][2022-12-16 17:51:40][log_test.c:test_log:18]<TEST> hello test this is trace information

============================== enable only MAIN output

[FATL][ 1031983][2022-12-16 17:51:41][log_test.c:test_log:13]<TEST> hello test this is fatal error
[ERRO][ 1032537][2022-12-16 17:51:41][log_test.c:test_log:14]<TEST> hello test this is error
[WARN][ 1033066][2022-12-16 17:51:41][log_test.c:test_log:15]<TEST> hello test this is warning
[INFO][ 1033606][2022-12-16 17:51:41][log_test.c:test_log:16]<TEST> hello test this is information
[DBUG][ 1034146][2022-12-16 17:51:41][log_test.c:test_log:17]<TEST> hello test this is degug information
[TRAC][ 1034736][2022-12-16 17:51:41][log_test.c:test_log:18]<TEST> hello test this is trace information

============================== disable all output

</syntaxhighlight>

=== freertos_async： ===
该部分测试了在FreeRTOS下log的输出是否正常。

该case创建了两个任务，消费者和生产者，从信号队列中进行获取和放入的经典场景来测试log。

消费者任务和生产者任务具体代码放在同目录下的： thread_consumer; thread_producer;中。

'''部分输出：'''

== Demo:helloworld ==

=== Demo介绍： ===
该demo测试基本日志等级输出，该Demo是对bflog加了一层封装，比如控制日志输出等级，控制是否使用严重等级颜色输出。

保存路径： bouffalo_sdk/examples/helloworld

在当前默认情况下的输出如下：
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information
hello world fatal raw
hello world error raw
hello world warning raw
hello world information raw
通过代码对应可以看到部分代码没有输出，部分代码有颜色而部分代码没有颜色。没有输出的部分是因为 LOG_LEVEL 的定义级别导致没有输出：
#if (CONFIG_LOG_LEVEL >= 4)
#define LOG_D(...) BFLOG_D((void *)&__bflog_recorder, __VA_ARGS__)
#define LOG_RD(...) BFLOG_RD((void *)&__bflog_recorder, __VA_ARGS__)
#else
#define LOG_D(...) ((void)0)
#define LOG_RD(...) ((void)0)
#endif

#if (CONFIG_LOG_LEVEL >= 5)
#define LOG_T(...) BFLOG_T((void *)&__bflog_recorder, __VA_ARGS__)
#define LOG_RT(...) BFLOG_RT((void *)&__bflog_recorder, __VA_ARGS__)
#else
#define LOG_T(...) ((void)0)
#define LOG_RT(...) ((void)0)
#endif
是否有颜色则取决于是否带有R,在引用文件中可以看到：
#define BFLOG_RF(_log, ...) BFLOG_X(_log, BFLOG_LEVEL_RAW | BFLOG_LEVEL_FATAL, (BFLOG_TAG), ##__VA_ARGS__)
以上配置可以在同级目录下的 proj.conf 中。

== Demo:log_dbg_assert ==
这部分代码和Demo:helloworld 基本一致，但是多了测试断言输出的功能。

保存在 SDK 下的： bouffalo_sdk/examples/log_dbg_assert

在代码中先进行了一个阶乘的递归函数，每一次递归以及判读啊都会输出断言信息以此测试断言输出。

示例输出：<syntaxhighlight lang="bash" line="1">
[I][MAIN] message = "hellokszhdfoiasjdkjnskjxnvuiolashdfoinaskjldfnvklasjhdfi213489o71234589073298dfl;asjdlfnkjzxncvhasdlkfljhasjkldjhnvjkaslndfvkljashdlifhui"
[I][MAIN] message (size: 138):
00000000: 68 65 6c 6c 6f 6b 73 7a 68 64 66 6f 69 61 73 6a 'hellokszhdfoiasj'
00000010: 64 6b 6a 6e 73 6b 6a 78 6e 76 75 69 6f 6c 61 73 'dkjnskjxnvuiolas'
00000020: 68 64 66 6f 69 6e 61 73 6b 6a 6c 64 66 6e 76 6b 'hdfoinaskjldfnvk'
00000030: 6c 61 73 6a 68 64 66 69 32 31 33 34 38 39 6f 37 'lasjhdfi213489o7'
00000040: 31 32 33 34 35 38 39 30 37 33 32 39 38 64 66 6c '1234589073298dfl'
00000050: 3b 61 73 6a 64 6c 66 6e 6b 6a 7a 78 6e 63 76 68 ';asjdlfnkjzxncvh'
00000060: 61 73 64 6c 6b 66 6c 6a 68 61 73 6a 6b 6c 64 6a 'asdlkfljhasjkldj'
00000070: 68 6e 76 6a 6b 61 73 6c 6e 64 66 76 6b 6c 6a 61 'hnvjkaslndfvklja'
00000080: 73 68 64 6c 69 66 68 75 69 00 'shdlifhui.'
[I][MAIN] 3 * a = 6 (0x6)
[I][MAIN] numbers = [7,13,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,] (length: 512)
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = true
[I][MAIN] 1 = 1 (0x1)
[I][MAIN] n * factorial(n - 1) = 2 (0x2)
[I][MAIN] n * factorial(n - 1) = 6 (0x6)
[I][MAIN] n * factorial(n - 1) = 24 (0x18)
[I][MAIN] factorial(4) = 24 (0x18)
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = true
[I][MAIN] 1 = 1 (0x1)

.......

1 == factorial(4) but 1 = 1 , factorial(4) = 24
error handler
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information
hello world fatal raw
hello world error raw
hello world warning raw
hello world information raw
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information

</syntaxhighlight>

== Demo:boot2 isp ==
这部分代码是一个bootloader程序，具备 '''安全启动'''、'''双分区更新'''、'''压缩支持'''、'''多核管理''' 等工业级特性。

该demo存放在 SDK 下的：/home/user/FromGit/bouffalo_sdk/examples/boot2_isp 路径下。

=== 主要功能 ===

# '''分区表'''：读取并验证分区表（<code>pt_table_stuff</code>），确定活动分区（<code>active_id</code>）支持 A/B 双分区设计，实现无缝固件更新和回滚处理分区条目，包括固件位置、大小、版本号
# '''固件加载与启动'''：该程序会根据分区表加载固件到内存支持压缩固件：XZ 格式的解压<code>blsp_boot2_check_xz_fw</code> 多核支持： <code>BLSP_BOOT2_CPU_GROUP_MAX</code> 定义 CPU 数量
# '''固件更新'''：OTA 更新：将新固件从临时分区复制到主分区防回滚（Anti-Rollback）：防止降级到不安全版本支持 USB/UART 烧录模式，对应代码：<code>bflb_eflash_loader_main</code>
# '''安全'''：SHA-256 校验具有固件完整性检查

您可以在开发板存在其他 App 的同时烧录该 bin ,'''这并不会覆盖掉你的程序，而是只为开发板更换 bootloader'''.

== Demo：mbedtls ==

=== Demo介绍： ===
这段代码对tls中的加密功能进行了全面的自检测，保证mbedtls库可以正常在平台上运行。

保存在 SDK 下的 bouffalo_sdk/examples/mbedtls

=== ECDH测试 ===
函数：<code>mbedtls_ecdh_test</code>

'''测试内容'''：客户端和服务器分别生成公私钥对。客户端和服务器分别计算共享密钥。验证客户端和服务器计算的共享密钥是否一致

=== ECDSA测试 ===
函数：<code>mbedtls_ecdsa_test</code>

'''测试内容'''：生成 ECDSA 密钥对。使用私钥对哈希值进行签名，生成签名。使用公钥验证签名的正确性。

'''涉及的算法'''：ECDSA数字签名；哈希算法：SHA-256。

=== AES测试 ===
函数：<code>mbedtls_aes_test</code>

'''测试内容'''：测试 AES 的 ECB、CBC 和 CTR三种模式。验证解密后的数据是否与原始数据一致。

=== SHA测试 ===
函数：<code>mbedtls_sha_test</code>

'''测试内容'''：测试 SHA-1、SHA-256 和 SHA-512 三种哈希算法。对输入数据进行哈希计算，输出哈希值

示例输出：<syntaxhighlight lang="bash" line="1">
===========================
SHA-1 test #1: passed
SHA-1 test #2: passed
SHA-1 test #3: passed

SHA-224 test #1: passed
SHA-224 test #2: passed
SHA-224 test #3: passed
SHA-256 test #1: passed
SHA-256 test #2: passed
SHA-256 test #3: passed

SHA-384 test #1: passed
SHA-384 test #2: passed
SHA-384 test #3: passed
SHA-512 test #1: passed
SHA-512 test #2: passed
SHA-512 test #3: passed
=========== ecdh test ================
setup rng ... ok
select ecp group SECP256R1 ... ok
Get public key time=33ms
1. ecdh client generate public parameter:
04 BC C2 58 06 F0 C1 A2 AC 83 C2 4F C5 CD 9C ED
A8 C3 8D C1 CF 3E 5B 52 0C 81 E1 50 15 D2 FE A1
AE 30 62 A9 6F E3 72 97 3B E0 12 A4 EC C2 2F 22
63 E3 AC 81 91

..........

aes ctr 192 block:1000 enc cost time:331 us
aes ctr 192 block:1000 dec cost time:329 us
test aes ctr 256
aes ctr 256 block:1000 enc cost time:354 us
aes ctr 256 block:1000 dec cost time:354 us

=========== sha test ================
sha1 block:1000 cost time:415 us
sha256 block:1000 cost time:268 us
sha512 block:1000 cost time:236 us
mbedtls test success

</syntaxhighlight>

== Demo:memheap ==

=== Demo介绍： ===
该demo主要测试申请和释放内存memory 的功能是否正常。在当前代码下，程序会不断申请释放无休止直到将内存消耗殆尽。

保存在 SDK 下的： bouffalo_sdk/examples/memheap

示例输出：<syntaxhighlight lang="bash" line="1">
ptr :hello123456789123456789123456789
get memory :411520 byte
free memory :411520 byte
remain 25244 byte
ptr :hello123456789123456789123456789
get memory :411648 byte
free memory :411648 byte
remain 25116 byte
ptr :hello123456789123456789123456789
get memory :411776 byte
free memory :411776 byte
remain 24988 byte

......

ptr :hello123456789123456789123456789
get memory :433920 byte
free memory :433920 byte
remain 2844 byte
ptr :hello123456789123456789123456789
get memory :434048 byte
free memory :434048 byte
tlsf malloc 434176 bytes failed at function bflb_malloc using heap base:0x62fc5554
remain 436900 byte
try to get 434176 byte memory failed!
memheap test fail

</syntaxhighlight>

== Demo:partition ==

=== Demo介绍： ===
该demo主要测试分区表获取和输出。所以这里主要要烧录whole bin,否则没有烧录分区表会导致失败。

示例输出：<syntaxhighlight lang="bash" line="1">
======= PtTable_Config @0x62fc3cc8=======
magicCode 0x54504642; version 0x0000; entryCnt 8; age 0; crc32 0xE38928F3
idx type device active_index name Address[0] Address[1] Length[0] Length[1] age
[00] 16 0 0 Boot2 0x00000000 0x00000000 0x0000e000 0x00000000 0
[01] 00 0 0 FW 0x00010000 0x00210000 0x00200000 0x00168000 0
[02] 10 0 0 mfg 0x00210000 0x00000000 0x00168000 0x00000000 0
[03] 02 0 0 media 0x00378000 0x00000000 0x00071000 0x00000000 0
[04] 03 0 0 PSM 0x003e9000 0x00000000 0x00008000 0x00000000 0
[05] 04 0 0 KEY 0x003f1000 0x00000000 0x00002000 0x00000000 0
[06] 05 0 0 DATA 0x003f3000 0x00000000 0x00005000 0x00000000 0
[07] 06 0 0 factory 0x003f8000 0x00000000 0x00008000 0x00000000 0

</syntaxhighlight>其中：索引的 0 和 1 分别代表不同的区，一个是活跃的当前正在使用的，另一个是备份的用于当升级失败回滚的。

== Demo:efuse_trim ==

=== Demo介绍： ===
该Demo主要用于验证efuse中储存的修剪数值是否正确，这些修剪值用于矫正一些模块。

保存在SDK下： bouffalo_sdk/examples/peripherals/efuse/efuse_trim

=== 代码解读： ===

# '''初始化和设备获取'''：
#* 调用 <code>board_init()</code> 初始化硬件板级配置。
#* 使用 <code>bflb_device_get_by_name("ef_ctrl")</code> 获取 eFuse 控制设备的句柄。
# '''修剪值读取和验证'''：
#* 定义了一个数组 <code>trim_list</code>，然后遍历 <code>trim_list</code>，调用 <code>bflb_ef_ctrl_read_common_trim</code> 读取每个修剪值。
#* 如果修剪值有效，则进一步验证其奇偶校验。如果校验通过，打印修剪值；否则提示校验错误。
#* 如果修剪值无效，提示未找到。

=== 示例输出： ===
<syntaxhighlight lang="bash">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================

eFuse read trim value case!
trim rc32m value=108!
trim rc32k value=273!
trim tsen value=2149!
case finished!

</syntaxhighlight>

== Demo:i2s_es8311 ==
该Demo的主要用途是实现音频数据采集和播放。主要功能是初始化并配置 I2S 接口和 ES8311 音频编解码器，以实现音频数据的传输和处理。

保存在SDK下：bouffalo_sdk/examples/peripherals/i2s/i2s_es8311

=== 代码解读： ===

# '''硬件初始化'''：调用 <code>board_init()</code> 初始化硬件板级配置。初始化 GPIO 引脚<code>i2s_gpio_init()</code>，为 I2S 和 I2C 接口分配功能引脚。
# '''主时钟输出'''：调用 <code>mclk_out_init()</code> 配置 I2S 的主时钟输出，为外部音频设备ES8311提供时钟信号。
# '''ES8311 音频编解码器初始化'''：配置 ES8311 的工作模式。调用 <code>es8311_init()</code> 初始化 ES8311，并设置音量。启动 ES8311 的 ADC 和 DAC 模块。
# '''I2S 和 DMA 初始化'''：调用 <code>i2s_dma_init()</code> 初始化 I2S 接口和 DMA 通道。配置 DMA 通道，启动 DMA 通道，开始音频数据的传输和接收。

=== 示例输出： ===
<syntaxhighlight lang="bash" line="1">
===========================
es8311 init
read chip id failed!
SET: volume:70%
i2s init
dma init
dma lli init
tx dma lli num: 2
rx dma lli num: 2
tc done
rx done
tc done
rx done
tc done
rx done
tc done
rx done
</syntaxhighlight>

== Demo:printf ==
该demo主要测试基本printf功能是否完整，正常。

保存在SDK 下：bouffalo_sdk/examples/printf

=== 测试的主要功能包括： ===

# 格式化标志(Flags)测试：

* <code>test_space_flag</code>: 测试空格标志( )的格式化
* <code>test_plus_flag</code>: 测试加号标志(<code>+</code>)的格式化
* <code>test_zero_flag</code>: 测试零填充标志(<code>0</code>)的格式化
* <code>test_minus_flag</code>: 测试左对齐标志(<code>-</code>)的格式化
* <code>test_sharp_flag</code>: 测试井号标志(<code>#</code>)的格式化

# 宽度和精度测试：

* <code>test_width</code>: 测试基本宽度指定
* <code>test_width_20</code>: 测试20字符宽度的格式化
* <code>test_padding_20</code>: 测试20字符填充
* <code>test_padding_dot_20</code>: 测试带小数点的20字符填充

# 数值类型测试：

* <code>test_integer_types</code>: 测试各种整数类型(int, long, long long等)
* <code>test_floating_point_specifiers_precision_and_flags</code>: 测试浮点数的精度和标志
* <code>test_pointer</code>: 测试指针类型的打印

# 特殊情况测试：

* <code>test_infinity_and_not_a_number_values</code>: 测试无穷大和NaN值的打印
* <code>test_tiny_floating_point_values</code>: 测试极小浮点数的打印

# 字符串相关测试：

* <code>test_string_length</code>: 测试字符串长度限制打印

=== 示例输出： ===
<syntaxhighlight lang="bash" line="1">
test 26 begin >>>>>>>>>>>
53000atest-20 bit
53000atest-20 bit
0.33
0.33
1
1
foo
foo

00004
00004
hi x
hi x
00123
00123
-67224.546875000000000000
-67224.546875000000000000
0.33
0.33
3.33e-01
3.33e-01
0.000000e+00
0.000000e+00
-0.000000e+00
-0.000000e+00
test 26 end >>>>>>>>>>>>>

test 27 begin >>>>>>>>>>>
30 30 30 30
30 30 30 30
30 30 30 30
30 30 30 30
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
281474976710656 281474976710656 281474976710656 281474976710656
281474976710656 281474976710656 281474976710656 281474976710656
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
1234567891234567 1234567891234567 1234567891234567 1234567891234567
1234567891234567 1234567891234567 1234567891234567 1234567891234567
test 27 end >>>>>>>>>>>>>

test 28 begin >>>>>>>>>>>
30 30 30 30
30 30 30 30
30 30 30 30
30 30 30 30
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 -9223372036854775807
281474976710656 281474976710656 281474976710656 281474976710656
281474976710656 281474976710656 281474976710656 281474976710656
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
1234567891234567 1234567891234567 1234567891234567 1234567891234567
1234567891234567 1234567891234567 1234567891234567 1234567891234567
test 28 end >>>>>>>>>>>>>
</syntaxhighlight>

== Demo Shell： ==
该部分代码测试了在裸机和带'''freertos'''操作系统两种情况下串口的终端功能测试。

这部分代码存放在SDK的 bouffalo_sdk/examples/shell 路径下。

=== Demo:shell_os ===
<syntaxhighlight lang="bash" line="1">
burst wrap cmd 0x77
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
bouffalolab />
bouffalolab />
bouffalolab />help
shell commands list:
test
free
memtrace
help
mfg
reboot
sysver

bouffalolab />
</syntaxhighlight>

=== Demo:shell_no_os ===
<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
bouffalolab />
bouffalolab />
bouffalolab />
bouffalolab />help
shell commands list:
test
free
memtrace
help
ps
mfg
reboot
sysver

bouffalolab />
</syntaxhighlight>

== Demo:pmu ==

=== Demo介绍： ===
这部分Demo主要测试了开发板的两种休眠模式。Hibernation 休眠模式和 Power down sleep 深度休眠模式，其中，HBN 是更深层次的休眠每次唤醒都从头执行，除了SRAM保持区其余都不储存。适合长时间关机，实时性低。

而 PDS 是中层次的休眠，唤醒从断线执行，而且保留寄存器，SRAM 和部分外设的信息。适合段是关机，比如每秒唤醒一次，实时性更高。

保存在SDK下：bouffalo_sdk/examples/pmu/xxxx/其中 xxxx 是开发板对应的型号。

=== Demo:hbn_rtc: ===
<syntaxhighlight lang="bash" line="1">
qe write len 0x02
cread support 0x01
cread code 0x20
burst wrap cmd 0x77
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
enter hbn mode
</syntaxhighlight>

=== Demo:pds_rtc: ===
<syntaxhighlight lang="bash" line="1">
ead reg cmd1 0x35
write reg cmd0 0x01
write reg cmd1 0x01
qe write len 0x02
cread support 0x01
cread code 0x20
burst wrap cmd 0x77
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
enter pds mode

</syntaxhighlight>这两个Demo 中有配有RTC,会不断的唤醒和睡眠。

== Demo:wo ==

=== Demo介绍： ===
保存在SDK 下：bouffalo_sdk/examples/peripherals/wo/wo_int

该Demo测试了博流Bouffalo芯片中WO(Waveform Output)外设的中断功能。

测试包括：

# WO外设的三种中断类型的触发和处理
# WO外设的配置参数设置
# 不同数据量下的FIFO操作
# 中断屏蔽和解除屏蔽功能
# WO外设的使能和禁用功能

示例输出：<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
interrupt end!
interrupt fifo!
interrupt fifo!
interrupt fer!
interrupt fer!
</syntaxhighlight>

首页

2025-08-11T09:16:56Z

武楷轩：/* Demos */

= Getting Started =

* [https://github.com/bouffalolab/bouffalo_sdk 如何获取SDK]
* [[如何在Ubuntu上搭建编译环境]]
* [[如何在Windows上搭建编译环境]]
* [[如何获取开发板]]
* [[烧录固件到开发板]]

= Bouffalo SDK =
'''BouffaloSDK''' 是 Bouffalo Lab 提供的 IOT 和 MCU 软件开发包，支持博流智能所有系列芯片，也是 '''bl_mcu_sdk''' 和 '''bl_iot_sdk''' 的结合体。

[[文件:BouffaloSDK.png|无框|600x600像素]]

= Peripherals =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[I2S]]
*[[I2C]]
*[[CVBS]]
*[[Watchdog]]
*[[GSM/GPRS]]
*[[Codec]]
*[[PCIe]]
*[[GPIO]]
*[[eMMC]]
|width="32%" valign="top" align="left"|
*[[WiFi]]
*[[LED]]
*[[Serial port]]
*[[PWM]]
*[[SPI]]
*[[USB OTG]]
*[[LCD]]
*[[CPU]]
*[[Network]]
|width="32%" valign="top" align="left"|
*[[Bluetooth]]
*[[HDMI]]
*[[Camera]]
*[[Memory]]
*[[RTC]]
*[[EEPROM]]
*[[MIPI-DSI]]
*[[NPU]]
*[[VPU]]
|}

= Products =
{| border="0" cellpadding="10" width="100%"
|-
|width="50%" valign="top" align="left"|
* [[BL602]]
* [[BL702]]
* [[BL618]]
* [[BL606P]]
|width="50%" valign="top" align="left"|
* [[BL702L]]
* [[BL616]]
|}

= Develop Boards =
* BL602EVB

= Application Notes =
* [[SDIOWIFI架构和开发手册]]
* [[BL616低功耗开发手册]]
* [[USB Wi-Fi用户手册]]

= Demos =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[Demo:FreeRTOS]]
* [[Demo:wifi sta]]
* [[Demo:boot2_isp]]
* [[Demo:helloworld]]
* [[Demo:smartconfig ble]]
|width="32%" valign="top" align="left"|
*[[Demo:DMA]]
* [[Demo:Btble]]
* [[Demo:coremark]]
* [[Demo:littlefs]]
* [[Demo:posix freertos]]
|width="32%" valign="top" align="left"|
*[[Demo:Flash]]
* [[Demo:Basical case]]
* [[Demo:dsp]]
* [[Demo:cks]]
|}

Demo:posix freertos

2025-08-11T09:15:48Z

武楷轩：创建页面，内容为“=== Demo介绍： === 保存在SDK下：bouffalo_sdk/examples/posix/freertos 这段代码主要测试了两个POSIX标准接口在FreeRTOS环境下的功能实现：消息队列(Message Queue)和信号量(Semaphore)。 === Posix标准： === '''这是一个接口标准'''，由于Linux的各种版本发布非常非常多，导致如果没有标准，那么一个软件要适配所有发行版本的难度极高。IEEE组织设定了一个标准，这解释了…”

=== Demo介绍： ===
保存在SDK下：bouffalo_sdk/examples/posix/freertos

这段代码主要测试了两个POSIX标准接口在FreeRTOS环境下的功能实现：消息队列(Message Queue)和信号量(Semaphore)。

=== Posix标准： ===
'''这是一个接口标准'''，由于Linux的各种版本发布非常非常多，导致如果没有标准，那么一个软件要适配所有发行版本的难度极高。IEEE组织设定了一个标准，这解释了为什么个个Linux的命令比如ls clear cd mkdir 等基本命令可以通用。

=== 代码分析： ===

# 消息队列测试 (<code>mqueues_test.c</code>):
#* 创建两个消息队列mq1和mq2
#* 创建4个线程：send1、send2和rev1、rev2
#* 每个发送者发送3条不同优先级的消息
#* 每个接收者接收3条消息
# 测试重点：消息队列的基本操作：<code>mq_open</code>、<code>mq_send</code>、<code>mq_receive</code>、<code>mq_close</code>、<code>mq_unlink</code> 非阻塞模式<code>O_NONBLOCK</code>的工作情况

# 信号量测试 (<code>semaphores_test.c</code>):
#* 实现了一个经典的生产者-消费者模型
#* <code>occupied</code>: 控制缓冲区可用空间
#* <code>empty</code>: 控制缓冲区已使用空间
#* <code>lock</code>: 互斥锁保护缓冲区访问
# 测试重点：信号量的基本操作：<code>sem_init</code>、<code>sem_wait</code>、<code>sem_post</code>、<code>sem_destroy</code>,多线程同步和互斥机制，生产者-消费者问题的正确处理

=== 示例输出： ===
<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
[OS] Starting proc_hellow_entry task...
Enter into send_1
[1] send 'msg test 1' in thread send_1.
[2] send 'msg test 2' in thread send_1.
[3] send 'msg test 3' in thread send_1.
Enter into send_2
[1] send 'msg test 1' in thread send_2.
[2] send 'msg test Enter into receive_1
[1] receive 'msg test 1' in thread receive_1.
[2] receive 'msg test 2' in thread receive_1.
[3] receive 'msg test 3' in thread receive_1.
Enter into receive_2
[1] receiv2' in thread send_2.
[3] send 'msg test 3' in thread send_2.
e 'msg test 1' in thread receive_2.
[2] receive 'msg test 2' in thread receive_2.
[3] receive 'msg test 3' in thread receive_2.
mq PASS
producer has added 0 to the buffer[0]
producer has added 100 to the buffer[1]
producer has added 200 to the buffer[2]
producer has added 300 to the buffer[3]
producer has added 400 to the buffer[4]
consumer has taken 0 from buffer[0]
consumer has taken 100 from buffer[1]
consumer has taken 200 from buffer[2]
consumer has taken 300 from buffer[3]
consumer has taken 400 from buffer[4]
producer has added 500 to the buffer[0]
producer has added 600 to the buffer[1]
producer has added 700 to the buffer[2]
producer has added 800 to the buffer[3]
producer has added 900 to the buffer[4]
consumer has taken 500 from buffer[0]
consumer has taken 600 from buffer[1]
consumer has taken 700 from buffer[2]
consumer has taken 800 from buffer[3]
consumer has taken 900 from buffer[4]
sema PASS
</syntaxhighlight>

Demo:Basical case

2025-08-11T09:01:04Z

武楷轩：SHELL HBN PDS

== 前言 ==
'''该页面将介绍一些较为简单基础的测试case 功能，目前包括 freertos；log等级输出；boot2；这一小节将会为您先详细介绍如何编译烧录如何下载烧录工具等基本信息。'''

=== 源码编译: ===
在对应 Case 的文件夹下有一个 README.md 文件，该文件中根据不同的开发板型号有不同编译的参数，例如 bl616 ：
- BL616/BL618

```
make CHIP=bl616 BOARD=bl616dk
```
#以上为README文件中的内容，根据内容直接执行对应make编译指令即可
make如果成功，你会在终端看到：

[[文件:Make success.png]]

Generate .../bouffalo_sdk/examples/freertos/build/build_out/freertos_bl616.bin（示例） '''代表生成了对应可供烧录的固件'''。

=== 开发板烧录： ===
执行make命令后，在该文件夹下会生成一个build目录，在文件夹中有一个生成的固件 freertos_bl616.bin ，该文件用于烧录直接使用（类似于keil生成的.hex文件）。

其具体路径为 '''.../bouffalo_sdk/examples/freertos/build/build_out/freertos_bl616.bin'''

==== 下载烧录工具： ====
下载BLDevCube工具：下载后解压即可直接使用。

<nowiki>https://dev.bouffalolab.com/</nowiki>

'''烧录具体步骤：'''

Step1：打开DevCube选择对应开发板型号。
[[文件:烧录Step1.png|无|缩略图|300x300像素]]
Step2：选择对应的 .bin 文件，选择对应的串口。

[[文件:烧录Step2.png|887x887像素]]

'''注意：要选择IOT并勾选enable'''

Step3：

'''按住boot键按一下复位键（按复位时boot键不松开），然后点击Create & Download'''。查看下方的输出信息是否烧录成功。

== Demo:FreeRTOS ==
在Bouffalo SDK上使用FreeRTOS APP

=== 源码介绍： ===
该文件的源码在 bouffalo_sdk/examples/freertos/main.c中，该测试 demo 简单测试了一些组件，包括Semaphore，Mutex，Queue，Priority 的基本简单测试。

测试分为两个阶段：

阶段一以消费者生产者模型测试'''信号量'''和'''信号队列'''组件，共生成三个Task。阶段结束后Task自动销毁。

阶段二以共简单共享资源简单测试Task争夺临界资源的方式测试'''互斥量'''，途中高优先级的任务将启动并占用CPU一段时间以此测试抢占'''任务调度'''。

=== 源码部分输出： ===
[FREERTOS_TEST CONSOLE] ===== PHASE 1: Queue/Semaphore Test =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task]: Starting consumer tasks...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task]: Starting producer task...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: task started
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: task started
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: received msg (task:1, ts:1)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: received msg (task:1, ts:501)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: received msg (task:1, ts:1001)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: queue empty
.....
[FREERTOS_TEST CONSOLE] ===== PHASE 2: Priority/Mutex Test =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] Starting High Priority task...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] Starting Shared Resource tasks...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Attempt to acquire mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 1
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Attempt to acquire mutex
.....
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Attempt to acquire mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [High Priority Task]: High priority task running
[FREERTOS_TEST CONSOLE] [I][MAIN] [High Priority Task]: Completed
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 5
.....
[FREERTOS_TEST CONSOLE] ===== END PHASE 2 =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 11
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] All Test Complete.

== Demo:bflog ==

=== Demo介绍： ===
该部分代码储存在 bouffalo_sdk/examples/bflog/barebone_sync 路径下，主要测试该开发板不同级别的log输出功能；

filter对输出日志的过滤功能。bflog分为五个级别，分别为：
{| class="wikitable"
!'''日志等级'''
!'''说明'''
!'''基本应用场景'''
|-
|'''FATL'''
|致命错误（Fatal）
|系统无法继续运行的灾难性事件（如核心崩溃、数据损坏），需立即人工干预并终止程序。
|-
|'''ERRO'''
|错误（Error）
|影响当前操作的关键错误（如功能失效、外部服务异常），但系统仍可部分运行，需尽快处理。
|-
|'''WARN'''
|警告（Warning）
|非关键性异常或潜在风险（如配置降级、资源不足），需关注但无需立即行动。
|-
|'''INFO'''
|信息（Info）
|常规运行状态记录（如服务启动、关键操作完成），用于监控系统健康状态。
|-
|'''DBUG'''
|调试（Debug）
|开发/测试阶段的详细运行细节（如变量值、逻辑分支），用于定位问题原因。
|-
|'''TRAC'''
|跟踪（Trace）
|最细粒度的执行路径追踪（如函数调用栈、循环过程），用于深度分析复杂逻辑。
|}
----

=== barebone_sync： ===
该部分主要是裸机测试了以上的各个等级log输出，filter过滤。

'''部分输出：'''<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================

============================== enable all output

[FATL][ 25338][2022-12-16 17:51:40][main.c:main:130]<MAIN> hello world this is fatal error
[ERRO][ 25858][2022-12-16 17:51:40][main.c:main:131]<MAIN> hello world this is error
[WARN][ 26355][2022-12-16 17:51:40][main.c:main:132]<MAIN> hello world this is warning
[INFO][ 26864][2022-12-16 17:51:40][main.c:main:133]<MAIN> hello world this is information
[DBUG][ 27374][2022-12-16 17:51:40][main.c:main:134]<MAIN> hello world this is degug information
[TRAC][ 27934][2022-12-16 17:51:40][main.c:main:135]<MAIN> hello world this is trace information
[FATL][ 28492][2022-12-16 17:51:40][log_test.c:test_log:13]<TEST> hello test this is fatal error
[ERRO][ 29049][2022-12-16 17:51:40][log_test.c:test_log:14]<TEST> hello test this is error
[WARN][ 29580][2022-12-16 17:51:40][log_test.c:test_log:15]<TEST> hello test this is warning
[INFO][ 30119][2022-12-16 17:51:40][log_test.c:test_log:16]<TEST> hello test this is information
[DBUG][ 30660][2022-12-16 17:51:40][log_test.c:test_log:17]<TEST> hello test this is degug information
[TRAC][ 31248][2022-12-16 17:51:40][log_test.c:test_log:18]<TEST> hello test this is trace information

============================== enable only MAIN output

[FATL][ 1031983][2022-12-16 17:51:41][log_test.c:test_log:13]<TEST> hello test this is fatal error
[ERRO][ 1032537][2022-12-16 17:51:41][log_test.c:test_log:14]<TEST> hello test this is error
[WARN][ 1033066][2022-12-16 17:51:41][log_test.c:test_log:15]<TEST> hello test this is warning
[INFO][ 1033606][2022-12-16 17:51:41][log_test.c:test_log:16]<TEST> hello test this is information
[DBUG][ 1034146][2022-12-16 17:51:41][log_test.c:test_log:17]<TEST> hello test this is degug information
[TRAC][ 1034736][2022-12-16 17:51:41][log_test.c:test_log:18]<TEST> hello test this is trace information

============================== disable all output

</syntaxhighlight>

=== freertos_async： ===
该部分测试了在FreeRTOS下log的输出是否正常。

该case创建了两个任务，消费者和生产者，从信号队列中进行获取和放入的经典场景来测试log。

消费者任务和生产者任务具体代码放在同目录下的： thread_consumer; thread_producer;中。

'''部分输出：'''

== Demo:helloworld ==

=== Demo介绍： ===
该demo测试基本日志等级输出，该Demo是对bflog加了一层封装，比如控制日志输出等级，控制是否使用严重等级颜色输出。

保存路径： bouffalo_sdk/examples/helloworld

在当前默认情况下的输出如下：
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information
hello world fatal raw
hello world error raw
hello world warning raw
hello world information raw
通过代码对应可以看到部分代码没有输出，部分代码有颜色而部分代码没有颜色。没有输出的部分是因为 LOG_LEVEL 的定义级别导致没有输出：
#if (CONFIG_LOG_LEVEL >= 4)
#define LOG_D(...) BFLOG_D((void *)&__bflog_recorder, __VA_ARGS__)
#define LOG_RD(...) BFLOG_RD((void *)&__bflog_recorder, __VA_ARGS__)
#else
#define LOG_D(...) ((void)0)
#define LOG_RD(...) ((void)0)
#endif

#if (CONFIG_LOG_LEVEL >= 5)
#define LOG_T(...) BFLOG_T((void *)&__bflog_recorder, __VA_ARGS__)
#define LOG_RT(...) BFLOG_RT((void *)&__bflog_recorder, __VA_ARGS__)
#else
#define LOG_T(...) ((void)0)
#define LOG_RT(...) ((void)0)
#endif
是否有颜色则取决于是否带有R,在引用文件中可以看到：
#define BFLOG_RF(_log, ...) BFLOG_X(_log, BFLOG_LEVEL_RAW | BFLOG_LEVEL_FATAL, (BFLOG_TAG), ##__VA_ARGS__)
以上配置可以在同级目录下的 proj.conf 中。

== Demo:log_dbg_assert ==
这部分代码和Demo:helloworld 基本一致，但是多了测试断言输出的功能。

保存在 SDK 下的： bouffalo_sdk/examples/log_dbg_assert

在代码中先进行了一个阶乘的递归函数，每一次递归以及判读啊都会输出断言信息以此测试断言输出。

示例输出：<syntaxhighlight lang="bash" line="1">
[I][MAIN] message = "hellokszhdfoiasjdkjnskjxnvuiolashdfoinaskjldfnvklasjhdfi213489o71234589073298dfl;asjdlfnkjzxncvhasdlkfljhasjkldjhnvjkaslndfvkljashdlifhui"
[I][MAIN] message (size: 138):
00000000: 68 65 6c 6c 6f 6b 73 7a 68 64 66 6f 69 61 73 6a 'hellokszhdfoiasj'
00000010: 64 6b 6a 6e 73 6b 6a 78 6e 76 75 69 6f 6c 61 73 'dkjnskjxnvuiolas'
00000020: 68 64 66 6f 69 6e 61 73 6b 6a 6c 64 66 6e 76 6b 'hdfoinaskjldfnvk'
00000030: 6c 61 73 6a 68 64 66 69 32 31 33 34 38 39 6f 37 'lasjhdfi213489o7'
00000040: 31 32 33 34 35 38 39 30 37 33 32 39 38 64 66 6c '1234589073298dfl'
00000050: 3b 61 73 6a 64 6c 66 6e 6b 6a 7a 78 6e 63 76 68 ';asjdlfnkjzxncvh'
00000060: 61 73 64 6c 6b 66 6c 6a 68 61 73 6a 6b 6c 64 6a 'asdlkfljhasjkldj'
00000070: 68 6e 76 6a 6b 61 73 6c 6e 64 66 76 6b 6c 6a 61 'hnvjkaslndfvklja'
00000080: 73 68 64 6c 69 66 68 75 69 00 'shdlifhui.'
[I][MAIN] 3 * a = 6 (0x6)
[I][MAIN] numbers = [7,13,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,] (length: 512)
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = true
[I][MAIN] 1 = 1 (0x1)
[I][MAIN] n * factorial(n - 1) = 2 (0x2)
[I][MAIN] n * factorial(n - 1) = 6 (0x6)
[I][MAIN] n * factorial(n - 1) = 24 (0x18)
[I][MAIN] factorial(4) = 24 (0x18)
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = true
[I][MAIN] 1 = 1 (0x1)

.......

1 == factorial(4) but 1 = 1 , factorial(4) = 24
error handler
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information
hello world fatal raw
hello world error raw
hello world warning raw
hello world information raw
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information

</syntaxhighlight>

== Demo:boot2 isp ==
这部分代码是一个bootloader程序，具备 '''安全启动'''、'''双分区更新'''、'''压缩支持'''、'''多核管理''' 等工业级特性。

该demo存放在 SDK 下的：/home/user/FromGit/bouffalo_sdk/examples/boot2_isp 路径下。

=== 主要功能 ===

# '''分区表'''：读取并验证分区表（<code>pt_table_stuff</code>），确定活动分区（<code>active_id</code>）支持 A/B 双分区设计，实现无缝固件更新和回滚处理分区条目，包括固件位置、大小、版本号
# '''固件加载与启动'''：该程序会根据分区表加载固件到内存支持压缩固件：XZ 格式的解压<code>blsp_boot2_check_xz_fw</code> 多核支持： <code>BLSP_BOOT2_CPU_GROUP_MAX</code> 定义 CPU 数量
# '''固件更新'''：OTA 更新：将新固件从临时分区复制到主分区防回滚（Anti-Rollback）：防止降级到不安全版本支持 USB/UART 烧录模式，对应代码：<code>bflb_eflash_loader_main</code>
# '''安全'''：SHA-256 校验具有固件完整性检查

您可以在开发板存在其他 App 的同时烧录该 bin ,'''这并不会覆盖掉你的程序，而是只为开发板更换 bootloader'''.

== Demo：mbedtls ==

=== Demo介绍： ===
这段代码对tls中的加密功能进行了全面的自检测，保证mbedtls库可以正常在平台上运行。

保存在 SDK 下的 bouffalo_sdk/examples/mbedtls

=== ECDH测试 ===
函数：<code>mbedtls_ecdh_test</code>

'''测试内容'''：客户端和服务器分别生成公私钥对。客户端和服务器分别计算共享密钥。验证客户端和服务器计算的共享密钥是否一致

=== ECDSA测试 ===
函数：<code>mbedtls_ecdsa_test</code>

'''测试内容'''：生成 ECDSA 密钥对。使用私钥对哈希值进行签名，生成签名。使用公钥验证签名的正确性。

'''涉及的算法'''：ECDSA数字签名；哈希算法：SHA-256。

=== AES测试 ===
函数：<code>mbedtls_aes_test</code>

'''测试内容'''：测试 AES 的 ECB、CBC 和 CTR三种模式。验证解密后的数据是否与原始数据一致。

=== SHA测试 ===
函数：<code>mbedtls_sha_test</code>

'''测试内容'''：测试 SHA-1、SHA-256 和 SHA-512 三种哈希算法。对输入数据进行哈希计算，输出哈希值

示例输出：<syntaxhighlight lang="bash" line="1">
===========================
SHA-1 test #1: passed
SHA-1 test #2: passed
SHA-1 test #3: passed

SHA-224 test #1: passed
SHA-224 test #2: passed
SHA-224 test #3: passed
SHA-256 test #1: passed
SHA-256 test #2: passed
SHA-256 test #3: passed

SHA-384 test #1: passed
SHA-384 test #2: passed
SHA-384 test #3: passed
SHA-512 test #1: passed
SHA-512 test #2: passed
SHA-512 test #3: passed
=========== ecdh test ================
setup rng ... ok
select ecp group SECP256R1 ... ok
Get public key time=33ms
1. ecdh client generate public parameter:
04 BC C2 58 06 F0 C1 A2 AC 83 C2 4F C5 CD 9C ED
A8 C3 8D C1 CF 3E 5B 52 0C 81 E1 50 15 D2 FE A1
AE 30 62 A9 6F E3 72 97 3B E0 12 A4 EC C2 2F 22
63 E3 AC 81 91

..........

aes ctr 192 block:1000 enc cost time:331 us
aes ctr 192 block:1000 dec cost time:329 us
test aes ctr 256
aes ctr 256 block:1000 enc cost time:354 us
aes ctr 256 block:1000 dec cost time:354 us

=========== sha test ================
sha1 block:1000 cost time:415 us
sha256 block:1000 cost time:268 us
sha512 block:1000 cost time:236 us
mbedtls test success

</syntaxhighlight>

== Demo:memheap ==

=== Demo介绍： ===
该demo主要测试申请和释放内存memory 的功能是否正常。在当前代码下，程序会不断申请释放无休止直到将内存消耗殆尽。

保存在 SDK 下的： bouffalo_sdk/examples/memheap

示例输出：<syntaxhighlight lang="bash" line="1">
ptr :hello123456789123456789123456789
get memory :411520 byte
free memory :411520 byte
remain 25244 byte
ptr :hello123456789123456789123456789
get memory :411648 byte
free memory :411648 byte
remain 25116 byte
ptr :hello123456789123456789123456789
get memory :411776 byte
free memory :411776 byte
remain 24988 byte

......

ptr :hello123456789123456789123456789
get memory :433920 byte
free memory :433920 byte
remain 2844 byte
ptr :hello123456789123456789123456789
get memory :434048 byte
free memory :434048 byte
tlsf malloc 434176 bytes failed at function bflb_malloc using heap base:0x62fc5554
remain 436900 byte
try to get 434176 byte memory failed!
memheap test fail

</syntaxhighlight>

== Demo:partition ==

=== Demo介绍： ===
该demo主要测试分区表获取和输出。所以这里主要要烧录whole bin,否则没有烧录分区表会导致失败。

示例输出：<syntaxhighlight lang="bash" line="1">
======= PtTable_Config @0x62fc3cc8=======
magicCode 0x54504642; version 0x0000; entryCnt 8; age 0; crc32 0xE38928F3
idx type device active_index name Address[0] Address[1] Length[0] Length[1] age
[00] 16 0 0 Boot2 0x00000000 0x00000000 0x0000e000 0x00000000 0
[01] 00 0 0 FW 0x00010000 0x00210000 0x00200000 0x00168000 0
[02] 10 0 0 mfg 0x00210000 0x00000000 0x00168000 0x00000000 0
[03] 02 0 0 media 0x00378000 0x00000000 0x00071000 0x00000000 0
[04] 03 0 0 PSM 0x003e9000 0x00000000 0x00008000 0x00000000 0
[05] 04 0 0 KEY 0x003f1000 0x00000000 0x00002000 0x00000000 0
[06] 05 0 0 DATA 0x003f3000 0x00000000 0x00005000 0x00000000 0
[07] 06 0 0 factory 0x003f8000 0x00000000 0x00008000 0x00000000 0

</syntaxhighlight>其中：索引的 0 和 1 分别代表不同的区，一个是活跃的当前正在使用的，另一个是备份的用于当升级失败回滚的。

== Demo:efuse_trim ==

=== Demo介绍： ===
该Demo主要用于验证efuse中储存的修剪数值是否正确，这些修剪值用于矫正一些模块。

保存在SDK下： bouffalo_sdk/examples/peripherals/efuse/efuse_trim

=== 代码解读： ===

# '''初始化和设备获取'''：
#* 调用 <code>board_init()</code> 初始化硬件板级配置。
#* 使用 <code>bflb_device_get_by_name("ef_ctrl")</code> 获取 eFuse 控制设备的句柄。
# '''修剪值读取和验证'''：
#* 定义了一个数组 <code>trim_list</code>，然后遍历 <code>trim_list</code>，调用 <code>bflb_ef_ctrl_read_common_trim</code> 读取每个修剪值。
#* 如果修剪值有效，则进一步验证其奇偶校验。如果校验通过，打印修剪值；否则提示校验错误。
#* 如果修剪值无效，提示未找到。

=== 示例输出： ===
<syntaxhighlight lang="bash">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================

eFuse read trim value case!
trim rc32m value=108!
trim rc32k value=273!
trim tsen value=2149!
case finished!

</syntaxhighlight>

== Demo:i2s_es8311 ==
该Demo的主要用途是实现音频数据采集和播放。主要功能是初始化并配置 I2S 接口和 ES8311 音频编解码器，以实现音频数据的传输和处理。

保存在SDK下：bouffalo_sdk/examples/peripherals/i2s/i2s_es8311

=== 代码解读： ===

# '''硬件初始化'''：调用 <code>board_init()</code> 初始化硬件板级配置。初始化 GPIO 引脚<code>i2s_gpio_init()</code>，为 I2S 和 I2C 接口分配功能引脚。
# '''主时钟输出'''：调用 <code>mclk_out_init()</code> 配置 I2S 的主时钟输出，为外部音频设备ES8311提供时钟信号。
# '''ES8311 音频编解码器初始化'''：配置 ES8311 的工作模式。调用 <code>es8311_init()</code> 初始化 ES8311，并设置音量。启动 ES8311 的 ADC 和 DAC 模块。
# '''I2S 和 DMA 初始化'''：调用 <code>i2s_dma_init()</code> 初始化 I2S 接口和 DMA 通道。配置 DMA 通道，启动 DMA 通道，开始音频数据的传输和接收。

=== 示例输出： ===
<syntaxhighlight lang="bash" line="1">
===========================
es8311 init
read chip id failed!
SET: volume:70%
i2s init
dma init
dma lli init
tx dma lli num: 2
rx dma lli num: 2
tc done
rx done
tc done
rx done
tc done
rx done
tc done
rx done
</syntaxhighlight>

== Demo:printf ==
该demo主要测试基本printf功能是否完整，正常。

保存在SDK 下：bouffalo_sdk/examples/printf

=== 测试的主要功能包括： ===

# 格式化标志(Flags)测试：

* <code>test_space_flag</code>: 测试空格标志( )的格式化
* <code>test_plus_flag</code>: 测试加号标志(<code>+</code>)的格式化
* <code>test_zero_flag</code>: 测试零填充标志(<code>0</code>)的格式化
* <code>test_minus_flag</code>: 测试左对齐标志(<code>-</code>)的格式化
* <code>test_sharp_flag</code>: 测试井号标志(<code>#</code>)的格式化

# 宽度和精度测试：

* <code>test_width</code>: 测试基本宽度指定
* <code>test_width_20</code>: 测试20字符宽度的格式化
* <code>test_padding_20</code>: 测试20字符填充
* <code>test_padding_dot_20</code>: 测试带小数点的20字符填充

# 数值类型测试：

* <code>test_integer_types</code>: 测试各种整数类型(int, long, long long等)
* <code>test_floating_point_specifiers_precision_and_flags</code>: 测试浮点数的精度和标志
* <code>test_pointer</code>: 测试指针类型的打印

# 特殊情况测试：

* <code>test_infinity_and_not_a_number_values</code>: 测试无穷大和NaN值的打印
* <code>test_tiny_floating_point_values</code>: 测试极小浮点数的打印

# 字符串相关测试：

* <code>test_string_length</code>: 测试字符串长度限制打印

=== 示例输出： ===
<syntaxhighlight lang="bash" line="1">
test 26 begin >>>>>>>>>>>
53000atest-20 bit
53000atest-20 bit
0.33
0.33
1
1
foo
foo

00004
00004
hi x
hi x
00123
00123
-67224.546875000000000000
-67224.546875000000000000
0.33
0.33
3.33e-01
3.33e-01
0.000000e+00
0.000000e+00
-0.000000e+00
-0.000000e+00
test 26 end >>>>>>>>>>>>>

test 27 begin >>>>>>>>>>>
30 30 30 30
30 30 30 30
30 30 30 30
30 30 30 30
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
281474976710656 281474976710656 281474976710656 281474976710656
281474976710656 281474976710656 281474976710656 281474976710656
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
1234567891234567 1234567891234567 1234567891234567 1234567891234567
1234567891234567 1234567891234567 1234567891234567 1234567891234567
test 27 end >>>>>>>>>>>>>

test 28 begin >>>>>>>>>>>
30 30 30 30
30 30 30 30
30 30 30 30
30 30 30 30
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 -9223372036854775807
281474976710656 281474976710656 281474976710656 281474976710656
281474976710656 281474976710656 281474976710656 281474976710656
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
1234567891234567 1234567891234567 1234567891234567 1234567891234567
1234567891234567 1234567891234567 1234567891234567 1234567891234567
test 28 end >>>>>>>>>>>>>
</syntaxhighlight>

== Demo Shell： ==
该部分代码测试了在裸机和带'''freertos'''操作系统两种情况下串口的终端功能测试。

这部分代码存放在SDK的 bouffalo_sdk/examples/shell 路径下。

=== Demo:shell_os ===
<syntaxhighlight lang="bash" line="1">
burst wrap cmd 0x77
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
bouffalolab />
bouffalolab />
bouffalolab />help
shell commands list:
test
free
memtrace
help
mfg
reboot
sysver

bouffalolab />
</syntaxhighlight>

=== Demo:shell_no_os ===
<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
bouffalolab />
bouffalolab />
bouffalolab />
bouffalolab />help
shell commands list:
test
free
memtrace
help
ps
mfg
reboot
sysver

bouffalolab />
</syntaxhighlight>

== Demo:pmu ==

=== Demo介绍： ===
这部分Demo主要测试了开发板的两种休眠模式。Hibernation 休眠模式和 Power down sleep 深度休眠模式，其中，HBN 是更深层次的休眠每次唤醒都从头执行，除了SRAM保持区其余都不储存。适合长时间关机，实时性低。

而 PDS 是中层次的休眠，唤醒从断线执行，而且保留寄存器，SRAM 和部分外设的信息。适合段是关机，比如每秒唤醒一次，实时性更高。

保存在SDK下：bouffalo_sdk/examples/pmu/xxxx/其中 xxxx 是开发板对应的型号。

=== Demo:hbn_rtc: ===
<syntaxhighlight lang="bash" line="1">
qe write len 0x02
cread support 0x01
cread code 0x20
burst wrap cmd 0x77
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
enter hbn mode
</syntaxhighlight>

=== Demo:pds_rtc: ===
<syntaxhighlight lang="bash" line="1">
ead reg cmd1 0x35
write reg cmd0 0x01
write reg cmd1 0x01
qe write len 0x02
cread support 0x01
cread code 0x20
burst wrap cmd 0x77
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
enter pds mode

</syntaxhighlight>这两个Demo 中有配有RTC,会不断的唤醒和睡眠。

Demo:Basical case

2025-08-11T08:29:40Z

武楷轩：printf

== 前言 ==
'''该页面将介绍一些较为简单基础的测试case 功能，目前包括 freertos；log等级输出；boot2；这一小节将会为您先详细介绍如何编译烧录如何下载烧录工具等基本信息。'''

=== 源码编译: ===
在对应 Case 的文件夹下有一个 README.md 文件，该文件中根据不同的开发板型号有不同编译的参数，例如 bl616 ：
- BL616/BL618

```
make CHIP=bl616 BOARD=bl616dk
```
#以上为README文件中的内容，根据内容直接执行对应make编译指令即可
make如果成功，你会在终端看到：

[[文件:Make success.png]]

Generate .../bouffalo_sdk/examples/freertos/build/build_out/freertos_bl616.bin（示例） '''代表生成了对应可供烧录的固件'''。

=== 开发板烧录： ===
执行make命令后，在该文件夹下会生成一个build目录，在文件夹中有一个生成的固件 freertos_bl616.bin ，该文件用于烧录直接使用（类似于keil生成的.hex文件）。

其具体路径为 '''.../bouffalo_sdk/examples/freertos/build/build_out/freertos_bl616.bin'''

==== 下载烧录工具： ====
下载BLDevCube工具：下载后解压即可直接使用。

<nowiki>https://dev.bouffalolab.com/</nowiki>

'''烧录具体步骤：'''

Step1：打开DevCube选择对应开发板型号。
[[文件:烧录Step1.png|无|缩略图|300x300像素]]
Step2：选择对应的 .bin 文件，选择对应的串口。

[[文件:烧录Step2.png|887x887像素]]

'''注意：要选择IOT并勾选enable'''

Step3：

'''按住boot键按一下复位键（按复位时boot键不松开），然后点击Create & Download'''。查看下方的输出信息是否烧录成功。

== Demo:FreeRTOS ==
在Bouffalo SDK上使用FreeRTOS APP

=== 源码介绍： ===
该文件的源码在 bouffalo_sdk/examples/freertos/main.c中，该测试 demo 简单测试了一些组件，包括Semaphore，Mutex，Queue，Priority 的基本简单测试。

测试分为两个阶段：

阶段一以消费者生产者模型测试'''信号量'''和'''信号队列'''组件，共生成三个Task。阶段结束后Task自动销毁。

阶段二以共简单共享资源简单测试Task争夺临界资源的方式测试'''互斥量'''，途中高优先级的任务将启动并占用CPU一段时间以此测试抢占'''任务调度'''。

=== 源码部分输出： ===
[FREERTOS_TEST CONSOLE] ===== PHASE 1: Queue/Semaphore Test =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task]: Starting consumer tasks...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task]: Starting producer task...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: task started
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: task started
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: received msg (task:1, ts:1)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: received msg (task:1, ts:501)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: received msg (task:1, ts:1001)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: queue empty
.....
[FREERTOS_TEST CONSOLE] ===== PHASE 2: Priority/Mutex Test =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] Starting High Priority task...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] Starting Shared Resource tasks...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Attempt to acquire mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 1
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Attempt to acquire mutex
.....
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Attempt to acquire mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [High Priority Task]: High priority task running
[FREERTOS_TEST CONSOLE] [I][MAIN] [High Priority Task]: Completed
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 5
.....
[FREERTOS_TEST CONSOLE] ===== END PHASE 2 =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 11
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] All Test Complete.

== Demo:bflog ==

=== Demo介绍： ===
该部分代码储存在 bouffalo_sdk/examples/bflog/barebone_sync 路径下，主要测试该开发板不同级别的log输出功能；

filter对输出日志的过滤功能。bflog分为五个级别，分别为：
{| class="wikitable"
!'''日志等级'''
!'''说明'''
!'''基本应用场景'''
|-
|'''FATL'''
|致命错误（Fatal）
|系统无法继续运行的灾难性事件（如核心崩溃、数据损坏），需立即人工干预并终止程序。
|-
|'''ERRO'''
|错误（Error）
|影响当前操作的关键错误（如功能失效、外部服务异常），但系统仍可部分运行，需尽快处理。
|-
|'''WARN'''
|警告（Warning）
|非关键性异常或潜在风险（如配置降级、资源不足），需关注但无需立即行动。
|-
|'''INFO'''
|信息（Info）
|常规运行状态记录（如服务启动、关键操作完成），用于监控系统健康状态。
|-
|'''DBUG'''
|调试（Debug）
|开发/测试阶段的详细运行细节（如变量值、逻辑分支），用于定位问题原因。
|-
|'''TRAC'''
|跟踪（Trace）
|最细粒度的执行路径追踪（如函数调用栈、循环过程），用于深度分析复杂逻辑。
|}
----

=== barebone_sync： ===
该部分主要是裸机测试了以上的各个等级log输出，filter过滤。

'''部分输出：'''<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================

============================== enable all output

[FATL][ 25338][2022-12-16 17:51:40][main.c:main:130]<MAIN> hello world this is fatal error
[ERRO][ 25858][2022-12-16 17:51:40][main.c:main:131]<MAIN> hello world this is error
[WARN][ 26355][2022-12-16 17:51:40][main.c:main:132]<MAIN> hello world this is warning
[INFO][ 26864][2022-12-16 17:51:40][main.c:main:133]<MAIN> hello world this is information
[DBUG][ 27374][2022-12-16 17:51:40][main.c:main:134]<MAIN> hello world this is degug information
[TRAC][ 27934][2022-12-16 17:51:40][main.c:main:135]<MAIN> hello world this is trace information
[FATL][ 28492][2022-12-16 17:51:40][log_test.c:test_log:13]<TEST> hello test this is fatal error
[ERRO][ 29049][2022-12-16 17:51:40][log_test.c:test_log:14]<TEST> hello test this is error
[WARN][ 29580][2022-12-16 17:51:40][log_test.c:test_log:15]<TEST> hello test this is warning
[INFO][ 30119][2022-12-16 17:51:40][log_test.c:test_log:16]<TEST> hello test this is information
[DBUG][ 30660][2022-12-16 17:51:40][log_test.c:test_log:17]<TEST> hello test this is degug information
[TRAC][ 31248][2022-12-16 17:51:40][log_test.c:test_log:18]<TEST> hello test this is trace information

============================== enable only MAIN output

[FATL][ 1031983][2022-12-16 17:51:41][log_test.c:test_log:13]<TEST> hello test this is fatal error
[ERRO][ 1032537][2022-12-16 17:51:41][log_test.c:test_log:14]<TEST> hello test this is error
[WARN][ 1033066][2022-12-16 17:51:41][log_test.c:test_log:15]<TEST> hello test this is warning
[INFO][ 1033606][2022-12-16 17:51:41][log_test.c:test_log:16]<TEST> hello test this is information
[DBUG][ 1034146][2022-12-16 17:51:41][log_test.c:test_log:17]<TEST> hello test this is degug information
[TRAC][ 1034736][2022-12-16 17:51:41][log_test.c:test_log:18]<TEST> hello test this is trace information

============================== disable all output

</syntaxhighlight>

=== freertos_async： ===
该部分测试了在FreeRTOS下log的输出是否正常。

该case创建了两个任务，消费者和生产者，从信号队列中进行获取和放入的经典场景来测试log。

消费者任务和生产者任务具体代码放在同目录下的： thread_consumer; thread_producer;中。

'''部分输出：'''

== Demo:helloworld ==

=== Demo介绍： ===
该demo测试基本日志等级输出，该Demo是对bflog加了一层封装，比如控制日志输出等级，控制是否使用严重等级颜色输出。

保存路径： bouffalo_sdk/examples/helloworld

在当前默认情况下的输出如下：
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information
hello world fatal raw
hello world error raw
hello world warning raw
hello world information raw
通过代码对应可以看到部分代码没有输出，部分代码有颜色而部分代码没有颜色。没有输出的部分是因为 LOG_LEVEL 的定义级别导致没有输出：
#if (CONFIG_LOG_LEVEL >= 4)
#define LOG_D(...) BFLOG_D((void *)&__bflog_recorder, __VA_ARGS__)
#define LOG_RD(...) BFLOG_RD((void *)&__bflog_recorder, __VA_ARGS__)
#else
#define LOG_D(...) ((void)0)
#define LOG_RD(...) ((void)0)
#endif

#if (CONFIG_LOG_LEVEL >= 5)
#define LOG_T(...) BFLOG_T((void *)&__bflog_recorder, __VA_ARGS__)
#define LOG_RT(...) BFLOG_RT((void *)&__bflog_recorder, __VA_ARGS__)
#else
#define LOG_T(...) ((void)0)
#define LOG_RT(...) ((void)0)
#endif
是否有颜色则取决于是否带有R,在引用文件中可以看到：
#define BFLOG_RF(_log, ...) BFLOG_X(_log, BFLOG_LEVEL_RAW | BFLOG_LEVEL_FATAL, (BFLOG_TAG), ##__VA_ARGS__)
以上配置可以在同级目录下的 proj.conf 中。

== Demo:log_dbg_assert ==
这部分代码和Demo:helloworld 基本一致，但是多了测试断言输出的功能。

保存在 SDK 下的： bouffalo_sdk/examples/log_dbg_assert

在代码中先进行了一个阶乘的递归函数，每一次递归以及判读啊都会输出断言信息以此测试断言输出。

示例输出：<syntaxhighlight lang="bash" line="1">
[I][MAIN] message = "hellokszhdfoiasjdkjnskjxnvuiolashdfoinaskjldfnvklasjhdfi213489o71234589073298dfl;asjdlfnkjzxncvhasdlkfljhasjkldjhnvjkaslndfvkljashdlifhui"
[I][MAIN] message (size: 138):
00000000: 68 65 6c 6c 6f 6b 73 7a 68 64 66 6f 69 61 73 6a 'hellokszhdfoiasj'
00000010: 64 6b 6a 6e 73 6b 6a 78 6e 76 75 69 6f 6c 61 73 'dkjnskjxnvuiolas'
00000020: 68 64 66 6f 69 6e 61 73 6b 6a 6c 64 66 6e 76 6b 'hdfoinaskjldfnvk'
00000030: 6c 61 73 6a 68 64 66 69 32 31 33 34 38 39 6f 37 'lasjhdfi213489o7'
00000040: 31 32 33 34 35 38 39 30 37 33 32 39 38 64 66 6c '1234589073298dfl'
00000050: 3b 61 73 6a 64 6c 66 6e 6b 6a 7a 78 6e 63 76 68 ';asjdlfnkjzxncvh'
00000060: 61 73 64 6c 6b 66 6c 6a 68 61 73 6a 6b 6c 64 6a 'asdlkfljhasjkldj'
00000070: 68 6e 76 6a 6b 61 73 6c 6e 64 66 76 6b 6c 6a 61 'hnvjkaslndfvklja'
00000080: 73 68 64 6c 69 66 68 75 69 00 'shdlifhui.'
[I][MAIN] 3 * a = 6 (0x6)
[I][MAIN] numbers = [7,13,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,] (length: 512)
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = true
[I][MAIN] 1 = 1 (0x1)
[I][MAIN] n * factorial(n - 1) = 2 (0x2)
[I][MAIN] n * factorial(n - 1) = 6 (0x6)
[I][MAIN] n * factorial(n - 1) = 24 (0x18)
[I][MAIN] factorial(4) = 24 (0x18)
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = true
[I][MAIN] 1 = 1 (0x1)

.......

1 == factorial(4) but 1 = 1 , factorial(4) = 24
error handler
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information
hello world fatal raw
hello world error raw
hello world warning raw
hello world information raw
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information

</syntaxhighlight>

== Demo:boot2 isp ==
这部分代码是一个bootloader程序，具备 '''安全启动'''、'''双分区更新'''、'''压缩支持'''、'''多核管理''' 等工业级特性。

该demo存放在 SDK 下的：/home/user/FromGit/bouffalo_sdk/examples/boot2_isp 路径下。

=== 主要功能 ===

# '''分区表'''：读取并验证分区表（<code>pt_table_stuff</code>），确定活动分区（<code>active_id</code>）支持 A/B 双分区设计，实现无缝固件更新和回滚处理分区条目，包括固件位置、大小、版本号
# '''固件加载与启动'''：该程序会根据分区表加载固件到内存支持压缩固件：XZ 格式的解压<code>blsp_boot2_check_xz_fw</code> 多核支持： <code>BLSP_BOOT2_CPU_GROUP_MAX</code> 定义 CPU 数量
# '''固件更新'''：OTA 更新：将新固件从临时分区复制到主分区防回滚（Anti-Rollback）：防止降级到不安全版本支持 USB/UART 烧录模式，对应代码：<code>bflb_eflash_loader_main</code>
# '''安全'''：SHA-256 校验具有固件完整性检查

您可以在开发板存在其他 App 的同时烧录该 bin ,'''这并不会覆盖掉你的程序，而是只为开发板更换 bootloader'''.

== Demo：mbedtls ==

=== Demo介绍： ===
这段代码对tls中的加密功能进行了全面的自检测，保证mbedtls库可以正常在平台上运行。

保存在 SDK 下的 bouffalo_sdk/examples/mbedtls

=== ECDH测试 ===
函数：<code>mbedtls_ecdh_test</code>

'''测试内容'''：客户端和服务器分别生成公私钥对。客户端和服务器分别计算共享密钥。验证客户端和服务器计算的共享密钥是否一致

=== ECDSA测试 ===
函数：<code>mbedtls_ecdsa_test</code>

'''测试内容'''：生成 ECDSA 密钥对。使用私钥对哈希值进行签名，生成签名。使用公钥验证签名的正确性。

'''涉及的算法'''：ECDSA数字签名；哈希算法：SHA-256。

=== AES测试 ===
函数：<code>mbedtls_aes_test</code>

'''测试内容'''：测试 AES 的 ECB、CBC 和 CTR三种模式。验证解密后的数据是否与原始数据一致。

=== SHA测试 ===
函数：<code>mbedtls_sha_test</code>

'''测试内容'''：测试 SHA-1、SHA-256 和 SHA-512 三种哈希算法。对输入数据进行哈希计算，输出哈希值

示例输出：<syntaxhighlight lang="bash" line="1">
===========================
SHA-1 test #1: passed
SHA-1 test #2: passed
SHA-1 test #3: passed

SHA-224 test #1: passed
SHA-224 test #2: passed
SHA-224 test #3: passed
SHA-256 test #1: passed
SHA-256 test #2: passed
SHA-256 test #3: passed

SHA-384 test #1: passed
SHA-384 test #2: passed
SHA-384 test #3: passed
SHA-512 test #1: passed
SHA-512 test #2: passed
SHA-512 test #3: passed
=========== ecdh test ================
setup rng ... ok
select ecp group SECP256R1 ... ok
Get public key time=33ms
1. ecdh client generate public parameter:
04 BC C2 58 06 F0 C1 A2 AC 83 C2 4F C5 CD 9C ED
A8 C3 8D C1 CF 3E 5B 52 0C 81 E1 50 15 D2 FE A1
AE 30 62 A9 6F E3 72 97 3B E0 12 A4 EC C2 2F 22
63 E3 AC 81 91

..........

aes ctr 192 block:1000 enc cost time:331 us
aes ctr 192 block:1000 dec cost time:329 us
test aes ctr 256
aes ctr 256 block:1000 enc cost time:354 us
aes ctr 256 block:1000 dec cost time:354 us

=========== sha test ================
sha1 block:1000 cost time:415 us
sha256 block:1000 cost time:268 us
sha512 block:1000 cost time:236 us
mbedtls test success

</syntaxhighlight>

== Demo:memheap ==

=== Demo介绍： ===
该demo主要测试申请和释放内存memory 的功能是否正常。在当前代码下，程序会不断申请释放无休止直到将内存消耗殆尽。

保存在 SDK 下的： bouffalo_sdk/examples/memheap

示例输出：<syntaxhighlight lang="bash" line="1">
ptr :hello123456789123456789123456789
get memory :411520 byte
free memory :411520 byte
remain 25244 byte
ptr :hello123456789123456789123456789
get memory :411648 byte
free memory :411648 byte
remain 25116 byte
ptr :hello123456789123456789123456789
get memory :411776 byte
free memory :411776 byte
remain 24988 byte

......

ptr :hello123456789123456789123456789
get memory :433920 byte
free memory :433920 byte
remain 2844 byte
ptr :hello123456789123456789123456789
get memory :434048 byte
free memory :434048 byte
tlsf malloc 434176 bytes failed at function bflb_malloc using heap base:0x62fc5554
remain 436900 byte
try to get 434176 byte memory failed!
memheap test fail

</syntaxhighlight>

== Demo:partition ==

=== Demo介绍： ===
该demo主要测试分区表获取和输出。所以这里主要要烧录whole bin,否则没有烧录分区表会导致失败。

示例输出：<syntaxhighlight lang="bash" line="1">
======= PtTable_Config @0x62fc3cc8=======
magicCode 0x54504642; version 0x0000; entryCnt 8; age 0; crc32 0xE38928F3
idx type device active_index name Address[0] Address[1] Length[0] Length[1] age
[00] 16 0 0 Boot2 0x00000000 0x00000000 0x0000e000 0x00000000 0
[01] 00 0 0 FW 0x00010000 0x00210000 0x00200000 0x00168000 0
[02] 10 0 0 mfg 0x00210000 0x00000000 0x00168000 0x00000000 0
[03] 02 0 0 media 0x00378000 0x00000000 0x00071000 0x00000000 0
[04] 03 0 0 PSM 0x003e9000 0x00000000 0x00008000 0x00000000 0
[05] 04 0 0 KEY 0x003f1000 0x00000000 0x00002000 0x00000000 0
[06] 05 0 0 DATA 0x003f3000 0x00000000 0x00005000 0x00000000 0
[07] 06 0 0 factory 0x003f8000 0x00000000 0x00008000 0x00000000 0

</syntaxhighlight>其中：索引的 0 和 1 分别代表不同的区，一个是活跃的当前正在使用的，另一个是备份的用于当升级失败回滚的。

== Demo:efuse_trim ==

=== Demo介绍： ===
该Demo主要用于验证efuse中储存的修剪数值是否正确，这些修剪值用于矫正一些模块。

保存在SDK下： bouffalo_sdk/examples/peripherals/efuse/efuse_trim

=== 代码解读： ===

# '''初始化和设备获取'''：
#* 调用 <code>board_init()</code> 初始化硬件板级配置。
#* 使用 <code>bflb_device_get_by_name("ef_ctrl")</code> 获取 eFuse 控制设备的句柄。
# '''修剪值读取和验证'''：
#* 定义了一个数组 <code>trim_list</code>，然后遍历 <code>trim_list</code>，调用 <code>bflb_ef_ctrl_read_common_trim</code> 读取每个修剪值。
#* 如果修剪值有效，则进一步验证其奇偶校验。如果校验通过，打印修剪值；否则提示校验错误。
#* 如果修剪值无效，提示未找到。

=== 示例输出： ===
<syntaxhighlight lang="bash">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================

eFuse read trim value case!
trim rc32m value=108!
trim rc32k value=273!
trim tsen value=2149!
case finished!

</syntaxhighlight>

== Demo:i2s_es8311 ==
该Demo的主要用途是实现音频数据采集和播放。主要功能是初始化并配置 I2S 接口和 ES8311 音频编解码器，以实现音频数据的传输和处理。

保存在SDK下：bouffalo_sdk/examples/peripherals/i2s/i2s_es8311

=== 代码解读： ===

# '''硬件初始化'''：调用 <code>board_init()</code> 初始化硬件板级配置。初始化 GPIO 引脚<code>i2s_gpio_init()</code>，为 I2S 和 I2C 接口分配功能引脚。
# '''主时钟输出'''：调用 <code>mclk_out_init()</code> 配置 I2S 的主时钟输出，为外部音频设备ES8311提供时钟信号。
# '''ES8311 音频编解码器初始化'''：配置 ES8311 的工作模式。调用 <code>es8311_init()</code> 初始化 ES8311，并设置音量。启动 ES8311 的 ADC 和 DAC 模块。
# '''I2S 和 DMA 初始化'''：调用 <code>i2s_dma_init()</code> 初始化 I2S 接口和 DMA 通道。配置 DMA 通道，启动 DMA 通道，开始音频数据的传输和接收。

=== 示例输出： ===
<syntaxhighlight lang="bash" line="1">
===========================
es8311 init
read chip id failed!
SET: volume:70%
i2s init
dma init
dma lli init
tx dma lli num: 2
rx dma lli num: 2
tc done
rx done
tc done
rx done
tc done
rx done
tc done
rx done
</syntaxhighlight>

== Demo:printf ==
该demo主要测试基本printf功能是否完整，正常。

保存在SDK 下：bouffalo_sdk/examples/printf

=== 测试的主要功能包括： ===

# 格式化标志(Flags)测试：

* <code>test_space_flag</code>: 测试空格标志( )的格式化
* <code>test_plus_flag</code>: 测试加号标志(<code>+</code>)的格式化
* <code>test_zero_flag</code>: 测试零填充标志(<code>0</code>)的格式化
* <code>test_minus_flag</code>: 测试左对齐标志(<code>-</code>)的格式化
* <code>test_sharp_flag</code>: 测试井号标志(<code>#</code>)的格式化

# 宽度和精度测试：

* <code>test_width</code>: 测试基本宽度指定
* <code>test_width_20</code>: 测试20字符宽度的格式化
* <code>test_padding_20</code>: 测试20字符填充
* <code>test_padding_dot_20</code>: 测试带小数点的20字符填充

# 数值类型测试：

* <code>test_integer_types</code>: 测试各种整数类型(int, long, long long等)
* <code>test_floating_point_specifiers_precision_and_flags</code>: 测试浮点数的精度和标志
* <code>test_pointer</code>: 测试指针类型的打印

# 特殊情况测试：

* <code>test_infinity_and_not_a_number_values</code>: 测试无穷大和NaN值的打印
* <code>test_tiny_floating_point_values</code>: 测试极小浮点数的打印

# 字符串相关测试：

* <code>test_string_length</code>: 测试字符串长度限制打印

=== 示例输出： ===
<syntaxhighlight lang="bash" line="1">
test 26 begin >>>>>>>>>>>
53000atest-20 bit
53000atest-20 bit
0.33
0.33
1
1
foo
foo

00004
00004
hi x
hi x
00123
00123
-67224.546875000000000000
-67224.546875000000000000
0.33
0.33
3.33e-01
3.33e-01
0.000000e+00
0.000000e+00
-0.000000e+00
-0.000000e+00
test 26 end >>>>>>>>>>>>>

test 27 begin >>>>>>>>>>>
30 30 30 30
30 30 30 30
30 30 30 30
30 30 30 30
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
281474976710656 281474976710656 281474976710656 281474976710656
281474976710656 281474976710656 281474976710656 281474976710656
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
1234567891234567 1234567891234567 1234567891234567 1234567891234567
1234567891234567 1234567891234567 1234567891234567 1234567891234567
test 27 end >>>>>>>>>>>>>

test 28 begin >>>>>>>>>>>
30 30 30 30
30 30 30 30
30 30 30 30
30 30 30 30
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
-9223372036854775807 -9223372036854775807 -9223372036854775807 -9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 9223372036854775807
9223372036854775807 9223372036854775807 9223372036854775807 -9223372036854775807
281474976710656 281474976710656 281474976710656 281474976710656
281474976710656 281474976710656 281474976710656 281474976710656
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
18446744073709551615 18446744073709551615 18446744073709551615 18446744073709551615
1234567891234567 1234567891234567 1234567891234567 1234567891234567
1234567891234567 1234567891234567 1234567891234567 1234567891234567
test 28 end >>>>>>>>>>>>>
</syntaxhighlight>

Demo:Basical case

2025-08-11T08:03:33Z

武楷轩：

== 前言 ==
'''该页面将介绍一些较为简单基础的测试case 功能，目前包括 freertos；log等级输出；boot2；这一小节将会为您先详细介绍如何编译烧录如何下载烧录工具等基本信息。'''

=== 源码编译: ===
在对应 Case 的文件夹下有一个 README.md 文件，该文件中根据不同的开发板型号有不同编译的参数，例如 bl616 ：
- BL616/BL618

```
make CHIP=bl616 BOARD=bl616dk
```
#以上为README文件中的内容，根据内容直接执行对应make编译指令即可
make如果成功，你会在终端看到：

[[文件:Make success.png]]

Generate .../bouffalo_sdk/examples/freertos/build/build_out/freertos_bl616.bin（示例） '''代表生成了对应可供烧录的固件'''。

=== 开发板烧录： ===
执行make命令后，在该文件夹下会生成一个build目录，在文件夹中有一个生成的固件 freertos_bl616.bin ，该文件用于烧录直接使用（类似于keil生成的.hex文件）。

其具体路径为 '''.../bouffalo_sdk/examples/freertos/build/build_out/freertos_bl616.bin'''

==== 下载烧录工具： ====
下载BLDevCube工具：下载后解压即可直接使用。

<nowiki>https://dev.bouffalolab.com/</nowiki>

'''烧录具体步骤：'''

Step1：打开DevCube选择对应开发板型号。
[[文件:烧录Step1.png|无|缩略图|300x300像素]]
Step2：选择对应的 .bin 文件，选择对应的串口。

[[文件:烧录Step2.png|887x887像素]]

'''注意：要选择IOT并勾选enable'''

Step3：

'''按住boot键按一下复位键（按复位时boot键不松开），然后点击Create & Download'''。查看下方的输出信息是否烧录成功。

== Demo:FreeRTOS ==
在Bouffalo SDK上使用FreeRTOS APP

=== 源码介绍： ===
该文件的源码在 bouffalo_sdk/examples/freertos/main.c中，该测试 demo 简单测试了一些组件，包括Semaphore，Mutex，Queue，Priority 的基本简单测试。

测试分为两个阶段：

阶段一以消费者生产者模型测试'''信号量'''和'''信号队列'''组件，共生成三个Task。阶段结束后Task自动销毁。

阶段二以共简单共享资源简单测试Task争夺临界资源的方式测试'''互斥量'''，途中高优先级的任务将启动并占用CPU一段时间以此测试抢占'''任务调度'''。

=== 源码部分输出： ===
[FREERTOS_TEST CONSOLE] ===== PHASE 1: Queue/Semaphore Test =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task]: Starting consumer tasks...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task]: Starting producer task...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: task started
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: task started
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: received msg (task:1, ts:1)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: received msg (task:1, ts:501)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: received msg (task:1, ts:1001)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: queue empty
.....
[FREERTOS_TEST CONSOLE] ===== PHASE 2: Priority/Mutex Test =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] Starting High Priority task...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] Starting Shared Resource tasks...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Attempt to acquire mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 1
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Attempt to acquire mutex
.....
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Attempt to acquire mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [High Priority Task]: High priority task running
[FREERTOS_TEST CONSOLE] [I][MAIN] [High Priority Task]: Completed
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 5
.....
[FREERTOS_TEST CONSOLE] ===== END PHASE 2 =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 11
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] All Test Complete.

== Demo:bflog ==

=== Demo介绍： ===
该部分代码储存在 bouffalo_sdk/examples/bflog/barebone_sync 路径下，主要测试该开发板不同级别的log输出功能；

filter对输出日志的过滤功能。bflog分为五个级别，分别为：
{| class="wikitable"
!'''日志等级'''
!'''说明'''
!'''基本应用场景'''
|-
|'''FATL'''
|致命错误（Fatal）
|系统无法继续运行的灾难性事件（如核心崩溃、数据损坏），需立即人工干预并终止程序。
|-
|'''ERRO'''
|错误（Error）
|影响当前操作的关键错误（如功能失效、外部服务异常），但系统仍可部分运行，需尽快处理。
|-
|'''WARN'''
|警告（Warning）
|非关键性异常或潜在风险（如配置降级、资源不足），需关注但无需立即行动。
|-
|'''INFO'''
|信息（Info）
|常规运行状态记录（如服务启动、关键操作完成），用于监控系统健康状态。
|-
|'''DBUG'''
|调试（Debug）
|开发/测试阶段的详细运行细节（如变量值、逻辑分支），用于定位问题原因。
|-
|'''TRAC'''
|跟踪（Trace）
|最细粒度的执行路径追踪（如函数调用栈、循环过程），用于深度分析复杂逻辑。
|}
----

=== barebone_sync： ===
该部分主要是裸机测试了以上的各个等级log输出，filter过滤。

'''部分输出：'''<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================

============================== enable all output

[FATL][ 25338][2022-12-16 17:51:40][main.c:main:130]<MAIN> hello world this is fatal error
[ERRO][ 25858][2022-12-16 17:51:40][main.c:main:131]<MAIN> hello world this is error
[WARN][ 26355][2022-12-16 17:51:40][main.c:main:132]<MAIN> hello world this is warning
[INFO][ 26864][2022-12-16 17:51:40][main.c:main:133]<MAIN> hello world this is information
[DBUG][ 27374][2022-12-16 17:51:40][main.c:main:134]<MAIN> hello world this is degug information
[TRAC][ 27934][2022-12-16 17:51:40][main.c:main:135]<MAIN> hello world this is trace information
[FATL][ 28492][2022-12-16 17:51:40][log_test.c:test_log:13]<TEST> hello test this is fatal error
[ERRO][ 29049][2022-12-16 17:51:40][log_test.c:test_log:14]<TEST> hello test this is error
[WARN][ 29580][2022-12-16 17:51:40][log_test.c:test_log:15]<TEST> hello test this is warning
[INFO][ 30119][2022-12-16 17:51:40][log_test.c:test_log:16]<TEST> hello test this is information
[DBUG][ 30660][2022-12-16 17:51:40][log_test.c:test_log:17]<TEST> hello test this is degug information
[TRAC][ 31248][2022-12-16 17:51:40][log_test.c:test_log:18]<TEST> hello test this is trace information

============================== enable only MAIN output

[FATL][ 1031983][2022-12-16 17:51:41][log_test.c:test_log:13]<TEST> hello test this is fatal error
[ERRO][ 1032537][2022-12-16 17:51:41][log_test.c:test_log:14]<TEST> hello test this is error
[WARN][ 1033066][2022-12-16 17:51:41][log_test.c:test_log:15]<TEST> hello test this is warning
[INFO][ 1033606][2022-12-16 17:51:41][log_test.c:test_log:16]<TEST> hello test this is information
[DBUG][ 1034146][2022-12-16 17:51:41][log_test.c:test_log:17]<TEST> hello test this is degug information
[TRAC][ 1034736][2022-12-16 17:51:41][log_test.c:test_log:18]<TEST> hello test this is trace information

============================== disable all output

</syntaxhighlight>

=== freertos_async： ===
该部分测试了在FreeRTOS下log的输出是否正常。

该case创建了两个任务，消费者和生产者，从信号队列中进行获取和放入的经典场景来测试log。

消费者任务和生产者任务具体代码放在同目录下的： thread_consumer; thread_producer;中。

'''部分输出：'''

== Demo:helloworld ==

=== Demo介绍： ===
该demo测试基本日志等级输出，该Demo是对bflog加了一层封装，比如控制日志输出等级，控制是否使用严重等级颜色输出。

保存路径： bouffalo_sdk/examples/helloworld

在当前默认情况下的输出如下：
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information
hello world fatal raw
hello world error raw
hello world warning raw
hello world information raw
通过代码对应可以看到部分代码没有输出，部分代码有颜色而部分代码没有颜色。没有输出的部分是因为 LOG_LEVEL 的定义级别导致没有输出：
#if (CONFIG_LOG_LEVEL >= 4)
#define LOG_D(...) BFLOG_D((void *)&__bflog_recorder, __VA_ARGS__)
#define LOG_RD(...) BFLOG_RD((void *)&__bflog_recorder, __VA_ARGS__)
#else
#define LOG_D(...) ((void)0)
#define LOG_RD(...) ((void)0)
#endif

#if (CONFIG_LOG_LEVEL >= 5)
#define LOG_T(...) BFLOG_T((void *)&__bflog_recorder, __VA_ARGS__)
#define LOG_RT(...) BFLOG_RT((void *)&__bflog_recorder, __VA_ARGS__)
#else
#define LOG_T(...) ((void)0)
#define LOG_RT(...) ((void)0)
#endif
是否有颜色则取决于是否带有R,在引用文件中可以看到：
#define BFLOG_RF(_log, ...) BFLOG_X(_log, BFLOG_LEVEL_RAW | BFLOG_LEVEL_FATAL, (BFLOG_TAG), ##__VA_ARGS__)
以上配置可以在同级目录下的 proj.conf 中。

== Demo:log_dbg_assert ==
这部分代码和Demo:helloworld 基本一致，但是多了测试断言输出的功能。

保存在 SDK 下的： bouffalo_sdk/examples/log_dbg_assert

在代码中先进行了一个阶乘的递归函数，每一次递归以及判读啊都会输出断言信息以此测试断言输出。

示例输出：<syntaxhighlight lang="bash" line="1">
[I][MAIN] message = "hellokszhdfoiasjdkjnskjxnvuiolashdfoinaskjldfnvklasjhdfi213489o71234589073298dfl;asjdlfnkjzxncvhasdlkfljhasjkldjhnvjkaslndfvkljashdlifhui"
[I][MAIN] message (size: 138):
00000000: 68 65 6c 6c 6f 6b 73 7a 68 64 66 6f 69 61 73 6a 'hellokszhdfoiasj'
00000010: 64 6b 6a 6e 73 6b 6a 78 6e 76 75 69 6f 6c 61 73 'dkjnskjxnvuiolas'
00000020: 68 64 66 6f 69 6e 61 73 6b 6a 6c 64 66 6e 76 6b 'hdfoinaskjldfnvk'
00000030: 6c 61 73 6a 68 64 66 69 32 31 33 34 38 39 6f 37 'lasjhdfi213489o7'
00000040: 31 32 33 34 35 38 39 30 37 33 32 39 38 64 66 6c '1234589073298dfl'
00000050: 3b 61 73 6a 64 6c 66 6e 6b 6a 7a 78 6e 63 76 68 ';asjdlfnkjzxncvh'
00000060: 61 73 64 6c 6b 66 6c 6a 68 61 73 6a 6b 6c 64 6a 'asdlkfljhasjkldj'
00000070: 68 6e 76 6a 6b 61 73 6c 6e 64 66 76 6b 6c 6a 61 'hnvjkaslndfvklja'
00000080: 73 68 64 6c 69 66 68 75 69 00 'shdlifhui.'
[I][MAIN] 3 * a = 6 (0x6)
[I][MAIN] numbers = [7,13,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,] (length: 512)
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = true
[I][MAIN] 1 = 1 (0x1)
[I][MAIN] n * factorial(n - 1) = 2 (0x2)
[I][MAIN] n * factorial(n - 1) = 6 (0x6)
[I][MAIN] n * factorial(n - 1) = 24 (0x18)
[I][MAIN] factorial(4) = 24 (0x18)
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = true
[I][MAIN] 1 = 1 (0x1)

.......

1 == factorial(4) but 1 = 1 , factorial(4) = 24
error handler
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information
hello world fatal raw
hello world error raw
hello world warning raw
hello world information raw
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information

</syntaxhighlight>

== Demo:boot2 isp ==
这部分代码是一个bootloader程序，具备 '''安全启动'''、'''双分区更新'''、'''压缩支持'''、'''多核管理''' 等工业级特性。

该demo存放在 SDK 下的：/home/user/FromGit/bouffalo_sdk/examples/boot2_isp 路径下。

=== 主要功能 ===

# '''分区表'''：读取并验证分区表（<code>pt_table_stuff</code>），确定活动分区（<code>active_id</code>）支持 A/B 双分区设计，实现无缝固件更新和回滚处理分区条目，包括固件位置、大小、版本号
# '''固件加载与启动'''：该程序会根据分区表加载固件到内存支持压缩固件：XZ 格式的解压<code>blsp_boot2_check_xz_fw</code> 多核支持： <code>BLSP_BOOT2_CPU_GROUP_MAX</code> 定义 CPU 数量
# '''固件更新'''：OTA 更新：将新固件从临时分区复制到主分区防回滚（Anti-Rollback）：防止降级到不安全版本支持 USB/UART 烧录模式，对应代码：<code>bflb_eflash_loader_main</code>
# '''安全'''：SHA-256 校验具有固件完整性检查

您可以在开发板存在其他 App 的同时烧录该 bin ,'''这并不会覆盖掉你的程序，而是只为开发板更换 bootloader'''.

== Demo：mbedtls ==

=== Demo介绍： ===
这段代码对tls中的加密功能进行了全面的自检测，保证mbedtls库可以正常在平台上运行。

保存在 SDK 下的 bouffalo_sdk/examples/mbedtls

=== ECDH测试 ===
函数：<code>mbedtls_ecdh_test</code>

'''测试内容'''：客户端和服务器分别生成公私钥对。客户端和服务器分别计算共享密钥。验证客户端和服务器计算的共享密钥是否一致

=== ECDSA测试 ===
函数：<code>mbedtls_ecdsa_test</code>

'''测试内容'''：生成 ECDSA 密钥对。使用私钥对哈希值进行签名，生成签名。使用公钥验证签名的正确性。

'''涉及的算法'''：ECDSA数字签名；哈希算法：SHA-256。

=== AES测试 ===
函数：<code>mbedtls_aes_test</code>

'''测试内容'''：测试 AES 的 ECB、CBC 和 CTR三种模式。验证解密后的数据是否与原始数据一致。

=== SHA测试 ===
函数：<code>mbedtls_sha_test</code>

'''测试内容'''：测试 SHA-1、SHA-256 和 SHA-512 三种哈希算法。对输入数据进行哈希计算，输出哈希值

示例输出：<syntaxhighlight lang="bash" line="1">
===========================
SHA-1 test #1: passed
SHA-1 test #2: passed
SHA-1 test #3: passed

SHA-224 test #1: passed
SHA-224 test #2: passed
SHA-224 test #3: passed
SHA-256 test #1: passed
SHA-256 test #2: passed
SHA-256 test #3: passed

SHA-384 test #1: passed
SHA-384 test #2: passed
SHA-384 test #3: passed
SHA-512 test #1: passed
SHA-512 test #2: passed
SHA-512 test #3: passed
=========== ecdh test ================
setup rng ... ok
select ecp group SECP256R1 ... ok
Get public key time=33ms
1. ecdh client generate public parameter:
04 BC C2 58 06 F0 C1 A2 AC 83 C2 4F C5 CD 9C ED
A8 C3 8D C1 CF 3E 5B 52 0C 81 E1 50 15 D2 FE A1
AE 30 62 A9 6F E3 72 97 3B E0 12 A4 EC C2 2F 22
63 E3 AC 81 91

..........

aes ctr 192 block:1000 enc cost time:331 us
aes ctr 192 block:1000 dec cost time:329 us
test aes ctr 256
aes ctr 256 block:1000 enc cost time:354 us
aes ctr 256 block:1000 dec cost time:354 us

=========== sha test ================
sha1 block:1000 cost time:415 us
sha256 block:1000 cost time:268 us
sha512 block:1000 cost time:236 us
mbedtls test success

</syntaxhighlight>

== Demo:memheap ==

=== Demo介绍： ===
该demo主要测试申请和释放内存memory 的功能是否正常。在当前代码下，程序会不断申请释放无休止直到将内存消耗殆尽。

保存在 SDK 下的： bouffalo_sdk/examples/memheap

示例输出：<syntaxhighlight lang="bash" line="1">
ptr :hello123456789123456789123456789
get memory :411520 byte
free memory :411520 byte
remain 25244 byte
ptr :hello123456789123456789123456789
get memory :411648 byte
free memory :411648 byte
remain 25116 byte
ptr :hello123456789123456789123456789
get memory :411776 byte
free memory :411776 byte
remain 24988 byte

......

ptr :hello123456789123456789123456789
get memory :433920 byte
free memory :433920 byte
remain 2844 byte
ptr :hello123456789123456789123456789
get memory :434048 byte
free memory :434048 byte
tlsf malloc 434176 bytes failed at function bflb_malloc using heap base:0x62fc5554
remain 436900 byte
try to get 434176 byte memory failed!
memheap test fail

</syntaxhighlight>

== Demo:partition ==

=== Demo介绍： ===
该demo主要测试分区表获取和输出。所以这里主要要烧录whole bin,否则没有烧录分区表会导致失败。

示例输出：<syntaxhighlight lang="bash" line="1">
======= PtTable_Config @0x62fc3cc8=======
magicCode 0x54504642; version 0x0000; entryCnt 8; age 0; crc32 0xE38928F3
idx type device active_index name Address[0] Address[1] Length[0] Length[1] age
[00] 16 0 0 Boot2 0x00000000 0x00000000 0x0000e000 0x00000000 0
[01] 00 0 0 FW 0x00010000 0x00210000 0x00200000 0x00168000 0
[02] 10 0 0 mfg 0x00210000 0x00000000 0x00168000 0x00000000 0
[03] 02 0 0 media 0x00378000 0x00000000 0x00071000 0x00000000 0
[04] 03 0 0 PSM 0x003e9000 0x00000000 0x00008000 0x00000000 0
[05] 04 0 0 KEY 0x003f1000 0x00000000 0x00002000 0x00000000 0
[06] 05 0 0 DATA 0x003f3000 0x00000000 0x00005000 0x00000000 0
[07] 06 0 0 factory 0x003f8000 0x00000000 0x00008000 0x00000000 0

</syntaxhighlight>其中：索引的 0 和 1 分别代表不同的区，一个是活跃的当前正在使用的，另一个是备份的用于当升级失败回滚的。

== Demo:efuse_trim ==

=== Demo介绍： ===
该Demo主要用于验证efuse中储存的修剪数值是否正确，这些修剪值用于矫正一些模块。

保存在SDK下： bouffalo_sdk/examples/peripherals/efuse/efuse_trim

=== 代码解读： ===

# '''初始化和设备获取'''：
#* 调用 <code>board_init()</code> 初始化硬件板级配置。
#* 使用 <code>bflb_device_get_by_name("ef_ctrl")</code> 获取 eFuse 控制设备的句柄。
# '''修剪值读取和验证'''：
#* 定义了一个数组 <code>trim_list</code>，然后遍历 <code>trim_list</code>，调用 <code>bflb_ef_ctrl_read_common_trim</code> 读取每个修剪值。
#* 如果修剪值有效，则进一步验证其奇偶校验。如果校验通过，打印修剪值；否则提示校验错误。
#* 如果修剪值无效，提示未找到。

=== 示例输出： ===
<syntaxhighlight lang="bash">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================

eFuse read trim value case!
trim rc32m value=108!
trim rc32k value=273!
trim tsen value=2149!
case finished!

</syntaxhighlight>

== Demo:i2s_es8311 ==
该Demo的主要用途是实现音频数据采集和播放。主要功能是初始化并配置 I2S 接口和 ES8311 音频编解码器，以实现音频数据的传输和处理。

保存在SDK下：bouffalo_sdk/examples/peripherals/i2s/i2s_es8311

=== 代码解读： ===

# '''硬件初始化'''：调用 <code>board_init()</code> 初始化硬件板级配置。初始化 GPIO 引脚<code>i2s_gpio_init()</code>，为 I2S 和 I2C 接口分配功能引脚。
# '''主时钟输出'''：调用 <code>mclk_out_init()</code> 配置 I2S 的主时钟输出，为外部音频设备ES8311提供时钟信号。
# '''ES8311 音频编解码器初始化'''：配置 ES8311 的工作模式。调用 <code>es8311_init()</code> 初始化 ES8311，并设置音量。启动 ES8311 的 ADC 和 DAC 模块。
# '''I2S 和 DMA 初始化'''：调用 <code>i2s_dma_init()</code> 初始化 I2S 接口和 DMA 通道。配置 DMA 通道，启动 DMA 通道，开始音频数据的传输和接收。

=== 示例输出： ===
<syntaxhighlight lang="bash" line="1">
===========================
es8311 init
read chip id failed!
SET: volume:70%
i2s init
dma init
dma lli init
tx dma lli num: 2
rx dma lli num: 2
tc done
rx done
tc done
rx done
tc done
rx done
tc done
rx done
</syntaxhighlight>

Demo:Basical case

2025-08-11T05:48:00Z

武楷轩：efuse

首页

2025-08-07T07:25:06Z

武楷轩：/* Demos */

= Getting Started =

* [https://github.com/bouffalolab/bouffalo_sdk 如何获取SDK]
* [[如何在Ubuntu上搭建编译环境]]
* [[如何在Windows上搭建编译环境]]
* [[如何获取开发板]]
* [[烧录固件到开发板]]

= Bouffalo SDK =
'''BouffaloSDK''' 是 Bouffalo Lab 提供的 IOT 和 MCU 软件开发包，支持博流智能所有系列芯片，也是 '''bl_mcu_sdk''' 和 '''bl_iot_sdk''' 的结合体。

[[文件:BouffaloSDK.png|无框|600x600像素]]

= Peripherals =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[I2S]]
*[[I2C]]
*[[CVBS]]
*[[Watchdog]]
*[[GSM/GPRS]]
*[[Codec]]
*[[PCIe]]
*[[GPIO]]
*[[eMMC]]
|width="32%" valign="top" align="left"|
*[[WiFi]]
*[[LED]]
*[[Serial port]]
*[[PWM]]
*[[SPI]]
*[[USB OTG]]
*[[LCD]]
*[[CPU]]
*[[Network]]
|width="32%" valign="top" align="left"|
*[[Bluetooth]]
*[[HDMI]]
*[[Camera]]
*[[Memory]]
*[[RTC]]
*[[EEPROM]]
*[[MIPI-DSI]]
*[[NPU]]
*[[VPU]]
|}

= Products =
{| border="0" cellpadding="10" width="100%"
|-
|width="50%" valign="top" align="left"|
* [[BL602]]
* [[BL702]]
* [[BL618]]
* [[BL606P]]
|width="50%" valign="top" align="left"|
* [[BL702L]]
* [[BL616]]
|}

= Develop Boards =
* BL602EVB

= Application Notes =
* [[SDIOWIFI架构和开发手册]]
* [[BL616低功耗开发手册]]
* [[USB Wi-Fi用户手册]]

= Demos =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[Demo:FreeRTOS]]
* [[Demo:wifi sta]]
* [[Demo:boot2_isp]]
* [[Demo:helloworld]]
* [[Demo:smartconfig ble]]
|width="32%" valign="top" align="left"|
*[[Demo:DMA]]
* [[Demo:Btble]]
* [[Demo:coremark]]
* [[Demo:littlefs]]
|width="32%" valign="top" align="left"|
*[[Demo:Flash]]
* [[Demo:Basical case]]
* [[Demo:dsp]]
* [[Demo:cks]]
|}

Demo:smartconfig ble

2025-08-07T07:24:22Z

武楷轩：

== Demo介绍： ==
该Demo使用BLE 蓝牙通讯技术实现从手机端操控目标设备进行WIFI配网。

该Demo 保存在SDK下的：bouffalo_sdk/examples/wifi/sta/smartconfig_ble 路经下。

其中，手机 APK 放在该目录下的blsync 目录中。

== 主要功能分析 ==

=== 1. BLE 配网与同步 ===

* 通过 BLE 广播和连接，实现手机等设备与目标设备的配对和通信。
* BLE 端通过 <code>blsync_ble_app.c</code> 管理 BLE 广播、连接、数据同步、Wi-Fi 配网等流程。
* 支持 BLE 端发起 Wi-Fi 扫描、连接、断开、状态查询等操作，并通过 BLE 通道将结果回传给上位机或手机。

=== 2. Wi-Fi 智能配网 ===

* 通过 BLE 通道下发 Wi-Fi SSID、密码等信息，设备自动连接到指定的 Wi-Fi 路由器。
* 支持 Wi-Fi 扫描，获取周围可用的 Wi-Fi 列表，并通过 BLE 返回给手机端。
* 支持 Wi-Fi 连接状态、IP 地址、网关、掩码等信息的查询和回传。

另外：<code>payload.c</code>、<code>transfer.c</code>、<code>encrypt_layer.c</code> 等文件实现了 BLE 配网协议的数据封装、分包、加密、解密、校验、ACK 等机制，保证 BLE 通信过程中的数据完整性和安全性。

=== 当配网正确时的输出： ===
<syntaxhighlight lang="bash" line="1">
[I][MAIN] Starting wifi ...
[I][MAIN] Starting fhost ...
Read slot:0
get sta mac: b4:0e:cf:2e:90:fb
Read slot:0
get ap mac: b4:0e:cf:2e:90:fb
fhost_cntrl_start:3489
fhost_cntrl_start:3492
[I][MAIN] [APP] [EVT] wifi_event_handler, CODE_WIFI_ON_INIT_DONE
wifi_mgmr_set_country_code:code = CN, channel24G_num:13, channel5G_num:0
[I][MAIN] [APP] [EVT] wifi_event_handler, CODE_WIFI_ON_MGMR_DONE
SIGTERM is NOT supported yet!
SIGHUP is NOT supported yet!
blsync_connected
Exchange mtu size pending.
Exchange successful //代表蓝牙连接成功
event type 0, id 9
Recevied indication to wifi scan

...........

=================================================================
[I][MAIN] [APP] [EVT] wifi_event_handler, CODE_WIFI_ON_CONNECTED
========================== Keyram Config ========================
start 08 -->> end 11; nVAP 02; max 31
========================== Keyram Dump =========================
[id] MAC Address Key Len VLan ID Default Key Hexdump(16Bytes MAX)
[00] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[01] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[02] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[03] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[04] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[05] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[06] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[07] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[08] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[09] 58:41:20:A8:4F:FC 64-Bit 01 1 00000000 00000000 00000000 00000000
[10] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[11] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
========================== MAC Address =========================
MAC B4:0E:CF:2E:90:FB Mask 00:00:00:00:00:00
BSSID 58:41:20:A8:4F:FC Mask 00:00:00:00:00:00
start dhcping ...
wpa_supplicant_ctrl_iface_msg_cb: cmd send succeded, txt is State### ASSOCIATED -> COMPLETED
[WPA] CTRL-EVENT-SUBNET-STATUS-UPDATE status=0
event type 0, id 13
Recevied indication to wifi state get
Connected
</syntaxhighlight>

== APK操作： ==
注意保证你的WIFI是打开的，点击对应设备 '''blsync''' 进行连接。

[[文件:Ble apk 2.jpg|670x670像素]]

'''进入后连接成功的界面：'''

[[文件:Ble apk 1.jpg|670x670像素]]

'''点击扫描配网后：'''

[[文件:Ble 3.jpg|670x670像素]]

Demo:smartconfig ble

2025-08-07T07:22:02Z

武楷轩：

== Demo介绍： ==
该Demo使用BLE 蓝牙通讯技术实现从手机端操控目标设备进行WIFI配网。

该Demo 保存在SDK下的：bouffalo_sdk/examples/wifi/sta/smartconfig_ble 路经下。

其中，手机 APK 放在该目录下的blsync 目录中。

== 主要功能分析 ==

=== 1. BLE 配网与同步 ===

* 通过 BLE 广播和连接，实现手机等设备与目标设备的配对和通信。
* BLE 端通过 <code>blsync_ble_app.c</code> 管理 BLE 广播、连接、数据同步、Wi-Fi 配网等流程。
* 支持 BLE 端发起 Wi-Fi 扫描、连接、断开、状态查询等操作，并通过 BLE 通道将结果回传给上位机或手机。

=== 2. Wi-Fi 智能配网 ===

* 通过 BLE 通道下发 Wi-Fi SSID、密码等信息，设备自动连接到指定的 Wi-Fi 路由器。
* 支持 Wi-Fi 扫描，获取周围可用的 Wi-Fi 列表，并通过 BLE 返回给手机端。
* 支持 Wi-Fi 连接状态、IP 地址、网关、掩码等信息的查询和回传。

另外：<code>payload.c</code>、<code>transfer.c</code>、<code>encrypt_layer.c</code> 等文件实现了 BLE 配网协议的数据封装、分包、加密、解密、校验、ACK 等机制，保证 BLE 通信过程中的数据完整性和安全性。

=== 当配网正确时的输出： ===
<syntaxhighlight lang="bash" line="1">
[I][MAIN] Starting wifi ...
[I][MAIN] Starting fhost ...
Read slot:0
get sta mac: b4:0e:cf:2e:90:fb
Read slot:0
get ap mac: b4:0e:cf:2e:90:fb
fhost_cntrl_start:3489
fhost_cntrl_start:3492
[I][MAIN] [APP] [EVT] wifi_event_handler, CODE_WIFI_ON_INIT_DONE
wifi_mgmr_set_country_code:code = CN, channel24G_num:13, channel5G_num:0
[I][MAIN] [APP] [EVT] wifi_event_handler, CODE_WIFI_ON_MGMR_DONE
SIGTERM is NOT supported yet!
SIGHUP is NOT supported yet!
blsync_connected
Exchange mtu size pending.
Exchange successful //代表蓝牙连接成功
event type 0, id 9
Recevied indication to wifi scan

...........

=================================================================
[I][MAIN] [APP] [EVT] wifi_event_handler, CODE_WIFI_ON_CONNECTED
========================== Keyram Config ========================
start 08 -->> end 11; nVAP 02; max 31
========================== Keyram Dump =========================
[id] MAC Address Key Len VLan ID Default Key Hexdump(16Bytes MAX)
[00] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[01] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[02] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[03] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[04] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[05] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[06] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[07] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[08] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[09] 58:41:20:A8:4F:FC 64-Bit 01 1 00000000 00000000 00000000 00000000
[10] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[11] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
========================== MAC Address =========================
MAC B4:0E:CF:2E:90:FB Mask 00:00:00:00:00:00
BSSID 58:41:20:A8:4F:FC Mask 00:00:00:00:00:00
start dhcping ...
wpa_supplicant_ctrl_iface_msg_cb: cmd send succeded, txt is State### ASSOCIATED -> COMPLETED
[WPA] CTRL-EVENT-SUBNET-STATUS-UPDATE status=0
event type 0, id 13
Recevied indication to wifi state get
Connected
</syntaxhighlight>

== APK操作： ==
注意保证你的WIFI是打开的，点击对应设备 '''blsync''' 进行连接。

[[文件:Ble apk 2.jpg|670x670像素]]

'''进入后连接成功的界面：'''

[[index.php?title=文件:Ble_apk_1.jpg|链接=文件:Ble_apk_1.jpg|670x670像素]]

'''点击扫描配网后：'''

[[index.php?title=文件:Ble_3.jpg|链接=文件:Ble_3.jpg|670x670像素]]

Demo:smartconfig ble

2025-08-07T07:20:09Z

武楷轩：创建页面，内容为“== Demo介绍： == 该Demo使用BLE 蓝牙通讯技术实现从手机端操控目标设备进行WIFI配网。该Demo 保存在SDK下的：bouffalo_sdk/examples/wifi/sta/smartconfig_ble 路经下。其中，手机 APK 放在该目录下的blsync 目录中。 == 主要功能分析 == === 1. BLE 配网与同步 === * 通过 BLE 广播和连接，实现手机等设备与目标设备的配对和通信。 * BLE 端通过 <code>blsync_ble_app.c</code> 管理…”

== Demo介绍： ==
该Demo使用BLE 蓝牙通讯技术实现从手机端操控目标设备进行WIFI配网。

该Demo 保存在SDK下的：bouffalo_sdk/examples/wifi/sta/smartconfig_ble 路经下。

其中，手机 APK 放在该目录下的blsync 目录中。

== 主要功能分析 ==

=== 1. BLE 配网与同步 ===

* 通过 BLE 广播和连接，实现手机等设备与目标设备的配对和通信。
* BLE 端通过 <code>blsync_ble_app.c</code> 管理 BLE 广播、连接、数据同步、Wi-Fi 配网等流程。
* 支持 BLE 端发起 Wi-Fi 扫描、连接、断开、状态查询等操作，并通过 BLE 通道将结果回传给上位机或手机。

=== 2. Wi-Fi 智能配网 ===

* 通过 BLE 通道下发 Wi-Fi SSID、密码等信息，设备自动连接到指定的 Wi-Fi 路由器。
* 支持 Wi-Fi 扫描，获取周围可用的 Wi-Fi 列表，并通过 BLE 返回给手机端。
* 支持 Wi-Fi 连接状态、IP 地址、网关、掩码等信息的查询和回传。

另外：<code>payload.c</code>、<code>transfer.c</code>、<code>encrypt_layer.c</code> 等文件实现了 BLE 配网协议的数据封装、分包、加密、解密、校验、ACK 等机制，保证 BLE 通信过程中的数据完整性和安全性。

=== 当配网正确时的输出： ===
<syntaxhighlight lang="bash" line="1">
[I][MAIN] Starting wifi ...
[I][MAIN] Starting fhost ...
Read slot:0
get sta mac: b4:0e:cf:2e:90:fb
Read slot:0
get ap mac: b4:0e:cf:2e:90:fb
fhost_cntrl_start:3489
fhost_cntrl_start:3492
[I][MAIN] [APP] [EVT] wifi_event_handler, CODE_WIFI_ON_INIT_DONE
wifi_mgmr_set_country_code:code = CN, channel24G_num:13, channel5G_num:0
[I][MAIN] [APP] [EVT] wifi_event_handler, CODE_WIFI_ON_MGMR_DONE
SIGTERM is NOT supported yet!
SIGHUP is NOT supported yet!
blsync_connected
Exchange mtu size pending.
Exchange successful //代表蓝牙连接成功
event type 0, id 9
Recevied indication to wifi scan

...........

=================================================================
[I][MAIN] [APP] [EVT] wifi_event_handler, CODE_WIFI_ON_CONNECTED
========================== Keyram Config ========================
start 08 -->> end 11; nVAP 02; max 31
========================== Keyram Dump =========================
[id] MAC Address Key Len VLan ID Default Key Hexdump(16Bytes MAX)
[00] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[01] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[02] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[03] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[04] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[05] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[06] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[07] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[08] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[09] 58:41:20:A8:4F:FC 64-Bit 01 1 00000000 00000000 00000000 00000000
[10] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
[11] FF:FF:FF:FF:FF:FF 64-Bit 00 0 00000000 00000000 00000000 00000000
========================== MAC Address =========================
MAC B4:0E:CF:2E:90:FB Mask 00:00:00:00:00:00
BSSID 58:41:20:A8:4F:FC Mask 00:00:00:00:00:00
start dhcping ...
wpa_supplicant_ctrl_iface_msg_cb: cmd send succeded, txt is State### ASSOCIATED -> COMPLETED
[WPA] CTRL-EVENT-SUBNET-STATUS-UPDATE status=0
event type 0, id 13
Recevied indication to wifi state get
Connected
</syntaxhighlight>

== APK操作： ==
注意保证你的WIFI是打开的，点击对应设备 '''blsync''' 进行连接。

[[文件:Ble apk 2.jpg|670x670像素]]

进入后连接成功的界面：
[[文件:Ble apk 1.jpg|670x670像素]]
点击扫描配网后：
[[文件:Ble 3.jpg|左|670x670像素]]

文件:Ble 3.jpg

2025-08-07T07:19:05Z

武楷轩：

文件:Ble apk 2.jpg

2025-08-07T07:15:11Z

武楷轩：

文件:Ble apk 1.jpg

2025-08-07T07:12:42Z

武楷轩：

首页

2025-08-06T08:09:39Z

武楷轩：/* Demos */

= Getting Started =

* [https://github.com/bouffalolab/bouffalo_sdk 如何获取SDK]
* [[如何在Ubuntu上搭建编译环境]]
* [[如何在Windows上搭建编译环境]]
* [[如何获取开发板]]
* [[烧录固件到开发板]]

= Bouffalo SDK =
'''BouffaloSDK''' 是 Bouffalo Lab 提供的 IOT 和 MCU 软件开发包，支持博流智能所有系列芯片，也是 '''bl_mcu_sdk''' 和 '''bl_iot_sdk''' 的结合体。

[[文件:BouffaloSDK.png|无框|600x600像素]]

= Peripherals =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[I2S]]
*[[I2C]]
*[[CVBS]]
*[[Watchdog]]
*[[GSM/GPRS]]
*[[Codec]]
*[[PCIe]]
*[[GPIO]]
*[[eMMC]]
|width="32%" valign="top" align="left"|
*[[WiFi]]
*[[LED]]
*[[Serial port]]
*[[PWM]]
*[[SPI]]
*[[USB OTG]]
*[[LCD]]
*[[CPU]]
*[[Network]]
|width="32%" valign="top" align="left"|
*[[Bluetooth]]
*[[HDMI]]
*[[Camera]]
*[[Memory]]
*[[RTC]]
*[[EEPROM]]
*[[MIPI-DSI]]
*[[NPU]]
*[[VPU]]
|}

= Products =
{| border="0" cellpadding="10" width="100%"
|-
|width="50%" valign="top" align="left"|
* [[BL602]]
* [[BL702]]
* [[BL618]]
* [[BL606P]]
|width="50%" valign="top" align="left"|
* [[BL702L]]
* [[BL616]]
|}

= Develop Boards =
* BL602EVB

= Application Notes =
* [[SDIOWIFI架构和开发手册]]
* [[BL616低功耗开发手册]]
* [[USB Wi-Fi用户手册]]

= Demos =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[Demo:FreeRTOS]]
* [[Demo:wifi sta]]
* [[Demo:boot2_isp]]
* [[Demo:helloworld]]
|width="32%" valign="top" align="left"|
*[[Demo:DMA]]
* [[Demo:Btble]]
* [[Demo:coremark]]
* [[Demo:littlefs]]
|width="32%" valign="top" align="left"|
*[[Demo:Flash]]
* [[Demo:Basical case]]
* [[Demo:dsp]]
* [[Demo:cks]]
|}

Demo:cks

2025-08-06T08:09:06Z

武楷轩：创建页面，内容为“== 介绍： == 这部分 Demo 主要测试了开发板上的软件和硬件 CheckSum 也就是校验和。保存在 SDK 下的：'''bouffalo_sdk/examples/peripherals/cks 。''' == Demo:cks_dma == === 测试内容 === # '''软件校验和计算'''：使用 <code>sw_chksum</code> 函数通过纯软件方式计算校验和。测试软件计算校验和的时间和结果。 # '''硬件校验和计算'''：使用 <code>bflb_cks_compute</code> 函数通过硬…”

== 介绍： ==
这部分 Demo 主要测试了开发板上的软件和硬件 CheckSum 也就是校验和。

保存在 SDK 下的：'''bouffalo_sdk/examples/peripherals/cks 。'''

== Demo:cks_dma ==

=== 测试内容 ===

# '''软件校验和计算'''：使用 <code>sw_chksum</code> 函数通过纯软件方式计算校验和。测试软件计算校验和的时间和结果。
# '''硬件校验和计算'''：使用 <code>bflb_cks_compute</code> 函数通过硬件模块计算校验和。测试硬件计算校验和的时间和结果。
# '''DMA（直接内存访问）辅助的硬件校验和计算'''：使用 DMA 将数据传输到硬件校验和模块，并通过 <code>bflb_cks_compute</code> 计算校验和。测试 DMA 辅助硬件计算校验和的时间和结果。

=== 示例输出 ===
<syntaxhighlight lang="bash" line="1">
CKS normal case:

--->>> case1 test
Pass
Pass

--->>> case2 test
Pass
Pass

--->>> case3 test
Pass
Pass

--->>> case4 test
Pass
Pass

--->>> case5 test
software checksum time=5us
sw_cks is 61b8
hardware checksum time=2us
hw_cks is 61b8
Pass

end
</syntaxhighlight>

== Demo:cks_normal ==

=== 测试内容 ===

# '''校验和计算的正确性'''：验证硬件校验和计算结果是否与预期值一致。比较硬件校验和与软件校验和的结果。
# '''大小端模式的支持'''：测试硬件校验和模块在小端（Little Endian）和大端（Big Endian）模式下的计算结果。
# '''性能测试'''：测试硬件校验和与软件校验和的计算时间，比较两者的性能差异。
# '''多数据段校验'''：测试硬件校验和模块对多段数据的累加校验功能。

=== 示例输出： ===
<syntaxhighlight lang="bash" line="1">
CKS normal case:

--->>> case1 test
Pass
Pass

--->>> case2 test
Pass
Pass

--->>> case3 test
Pass
Pass

--->>> case4 test
Pass
Pass

--->>> case5 test
software checksum time=5us
sw_cks is 61b8
hardware checksum time=2us
hw_cks is 61b8
Pass

end
</syntaxhighlight>

Demo:Basical case

2025-08-06T07:37:25Z

武楷轩：partition

Demo:Basical case

2025-08-05T09:11:28Z

武楷轩：

Demo:Basical case

2025-08-05T09:09:21Z

武楷轩：mbedtls

首页

2025-08-05T07:23:49Z

武楷轩：/* Demos */

= Getting Started =

* [https://github.com/bouffalolab/bouffalo_sdk 如何获取SDK]
* [[如何在Ubuntu上搭建编译环境]]
* [[如何在Windows上搭建编译环境]]
* [[如何获取开发板]]
* [[烧录固件到开发板]]

= Bouffalo SDK =
'''BouffaloSDK''' 是 Bouffalo Lab 提供的 IOT 和 MCU 软件开发包，支持博流智能所有系列芯片，也是 '''bl_mcu_sdk''' 和 '''bl_iot_sdk''' 的结合体。

[[文件:BouffaloSDK.png|无框|600x600像素]]

= Peripherals =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[I2S]]
*[[I2C]]
*[[CVBS]]
*[[Watchdog]]
*[[GSM/GPRS]]
*[[Codec]]
*[[PCIe]]
*[[GPIO]]
*[[eMMC]]
|width="32%" valign="top" align="left"|
*[[WiFi]]
*[[LED]]
*[[Serial port]]
*[[PWM]]
*[[SPI]]
*[[USB OTG]]
*[[LCD]]
*[[CPU]]
*[[Network]]
|width="32%" valign="top" align="left"|
*[[Bluetooth]]
*[[HDMI]]
*[[Camera]]
*[[Memory]]
*[[RTC]]
*[[EEPROM]]
*[[MIPI-DSI]]
*[[NPU]]
*[[VPU]]
|}

= Products =
{| border="0" cellpadding="10" width="100%"
|-
|width="50%" valign="top" align="left"|
* [[BL602]]
* [[BL702]]
* [[BL618]]
* [[BL606P]]
|width="50%" valign="top" align="left"|
* [[BL702L]]
* [[BL616]]
|}

= Develop Boards =
* BL602EVB

= Application Notes =
* [[SDIOWIFI架构和开发手册]]
* [[BL616低功耗开发手册]]
* [[USB Wi-Fi用户手册]]

= Demos =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[Demo:FreeRTOS]]
* [[Demo:wifi sta]]
* [[Demo:boot2_isp]]
* [[Demo:helloworld]]
|width="32%" valign="top" align="left"|
*[[Demo:DMA]]
* [[Demo:Btble]]
* [[Demo:coremark]]
* [[Demo:littlefs]]
|width="32%" valign="top" align="left"|
*[[Demo:Flash]]
* [[Demo:Basical case]]
* [[Demo:dsp]]
|}

Demo:Basical case

2025-08-05T07:23:06Z

武楷轩：

Demo:Basical case

2025-08-05T07:17:53Z

武楷轩：

Demo:Basical case

2025-08-05T07:16:09Z

武楷轩：Basical 1

== 前言 ==
'''该页面将介绍一些较为简单基础的测试case 功能，目前包括 freertos；log等级输出；boot2；这一小节将会为您先详细介绍如何编译烧录如何下载烧录工具等基本信息。'''

=== 源码编译: ===
在该文件夹下有一个README.md文件，该文件中根据不同的开发板型号有不同编译的参数，例如bl616 ：
- BL616/BL618

```
make CHIP=bl616 BOARD=bl616dk
```
#以上为README文件中的内容，根据内容直接执行对应make编译指令即可
make如果成功，你会在终端看到：

Generate .../bouffalo_sdk/examples/freertos/build/build_out/freertos_bl616.bin '''代表生成了对应可供烧录的固件'''。

=== 开发板烧录： ===
执行make命令后，在该文件夹下会生成一个build目录，在文件夹中有一个生成的固件 freertos_bl616.bin ，该文件用于烧录直接使用（类似于keil生成的.hex文件）。

其具体路径为 '''.../bouffalo_sdk/examples/freertos/build/build_out/freertos_bl616.bin'''

==== 下载烧录工具： ====
下载BLDevCube工具：下载后解压即可直接使用。

<nowiki>https://dev.bouffalolab.com/</nowiki>

'''烧录具体步骤：'''

Step1：打开DevCube选择对应开发板型号。

Step2：选择对应的 .bin 文件，选择对应的串口。

'''注意：要选择IOT并勾选enable'''

Step3：

'''按住boot键按一下复位键（按复位时boot键不松开），然后点击Create & Download'''。查看下方的输出信息是否烧录成功。

== Demo:FreeRTOS ==
在Bouffalo SDK上使用FreeRTOS APP

=== 源码介绍： ===
该文件的源码在 bouffalo_sdk/examples/freertos/main.c中，该测试 demo 简单测试了一些组件，包括Semaphore，Mutex，Queue，Priority 的基本简单测试。

测试分为两个阶段：

阶段一以消费者生产者模型测试'''信号量'''和'''信号队列'''组件，共生成三个Task。阶段结束后Task自动销毁。

阶段二以共简单共享资源简单测试Task争夺临界资源的方式测试'''互斥量'''，途中高优先级的任务将启动并占用CPU一段时间以此测试抢占'''任务调度'''。

=== 源码部分输出： ===
[FREERTOS_TEST CONSOLE] ===== PHASE 1: Queue/Semaphore Test =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task]: Starting consumer tasks...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task]: Starting producer task...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: task started
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: task started
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: received msg (task:1, ts:1)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: received msg (task:1, ts:501)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: message send success
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: received msg (task:1, ts:1001)
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: queue empty
.....
[FREERTOS_TEST CONSOLE] ===== PHASE 2: Priority/Mutex Test =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 1]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Consumer 2]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Producer 1]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] Starting High Priority task...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] Starting Shared Resource tasks...
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Attempt to acquire mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 1
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Attempt to acquire mutex
.....
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Attempt to acquire mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [High Priority Task]: High priority task running
[FREERTOS_TEST CONSOLE] [I][MAIN] [High Priority Task]: Completed
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 5
.....
[FREERTOS_TEST CONSOLE] ===== END PHASE 2 =====
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Aquired.
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: value = 11
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Holding mutex for 500ms
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 4]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Release mutex
[FREERTOS_TEST CONSOLE] [I][MAIN] [Mutex Task 3]: Exiting due to phase change
[FREERTOS_TEST CONSOLE] [I][MAIN] [Process Task] All Test Complete.

== Demo:bflog ==

=== Demo介绍： ===
该部分代码储存在 bouffalo_sdk/examples/bflog/barebone_sync 路径下，主要测试该开发板不同级别的log输出功能；

filter对输出日志的过滤功能。bflog分为五个级别，分别为：
{| class="wikitable"
!'''日志等级'''
!'''说明'''
!'''基本应用场景'''
|-
|'''FATL'''
|致命错误（Fatal）
|系统无法继续运行的灾难性事件（如核心崩溃、数据损坏），需立即人工干预并终止程序。
|-
|'''ERRO'''
|错误（Error）
|影响当前操作的关键错误（如功能失效、外部服务异常），但系统仍可部分运行，需尽快处理。
|-
|'''WARN'''
|警告（Warning）
|非关键性异常或潜在风险（如配置降级、资源不足），需关注但无需立即行动。
|-
|'''INFO'''
|信息（Info）
|常规运行状态记录（如服务启动、关键操作完成），用于监控系统健康状态。
|-
|'''DBUG'''
|调试（Debug）
|开发/测试阶段的详细运行细节（如变量值、逻辑分支），用于定位问题原因。
|-
|'''TRAC'''
|跟踪（Trace）
|最细粒度的执行路径追踪（如函数调用栈、循环过程），用于深度分析复杂逻辑。
|}

=== barebone_sync： ===
该部分主要是裸机测试了以上的各个等级log输出，filter过滤。

'''部分输出：'''<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================

============================== enable all output

[FATL][ 25338][2022-12-16 17:51:40][main.c:main:130]<MAIN> hello world this is fatal error
[ERRO][ 25858][2022-12-16 17:51:40][main.c:main:131]<MAIN> hello world this is error
[WARN][ 26355][2022-12-16 17:51:40][main.c:main:132]<MAIN> hello world this is warning
[INFO][ 26864][2022-12-16 17:51:40][main.c:main:133]<MAIN> hello world this is information
[DBUG][ 27374][2022-12-16 17:51:40][main.c:main:134]<MAIN> hello world this is degug information
[TRAC][ 27934][2022-12-16 17:51:40][main.c:main:135]<MAIN> hello world this is trace information
[FATL][ 28492][2022-12-16 17:51:40][log_test.c:test_log:13]<TEST> hello test this is fatal error
[ERRO][ 29049][2022-12-16 17:51:40][log_test.c:test_log:14]<TEST> hello test this is error
[WARN][ 29580][2022-12-16 17:51:40][log_test.c:test_log:15]<TEST> hello test this is warning
[INFO][ 30119][2022-12-16 17:51:40][log_test.c:test_log:16]<TEST> hello test this is information
[DBUG][ 30660][2022-12-16 17:51:40][log_test.c:test_log:17]<TEST> hello test this is degug information
[TRAC][ 31248][2022-12-16 17:51:40][log_test.c:test_log:18]<TEST> hello test this is trace information

============================== enable only MAIN output

[FATL][ 1031983][2022-12-16 17:51:41][log_test.c:test_log:13]<TEST> hello test this is fatal error
[ERRO][ 1032537][2022-12-16 17:51:41][log_test.c:test_log:14]<TEST> hello test this is error
[WARN][ 1033066][2022-12-16 17:51:41][log_test.c:test_log:15]<TEST> hello test this is warning
[INFO][ 1033606][2022-12-16 17:51:41][log_test.c:test_log:16]<TEST> hello test this is information
[DBUG][ 1034146][2022-12-16 17:51:41][log_test.c:test_log:17]<TEST> hello test this is degug information
[TRAC][ 1034736][2022-12-16 17:51:41][log_test.c:test_log:18]<TEST> hello test this is trace information

============================== disable all output

</syntaxhighlight>

=== freertos_async： ===
该部分测试了在FreeRTOS下log的输出是否正常。

该case创建了两个任务，消费者和生产者，从信号队列中进行获取和放入的经典场景来测试log。

消费者任务和生产者任务具体代码放在同目录下的： thread_consumer; thread_producer;中。

'''部分输出：'''

== Demo:helloworld ==

=== Demo介绍： ===
该demo测试基本日志等级输出，该Demo是对bflog加了一层封装，比如控制日志输出等级，控制是否使用严重等级颜色输出。

保存路径： bouffalo_sdk/examples/helloworld

在当前默认情况下的输出如下：
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information
hello world fatal raw
hello world error raw
hello world warning raw
hello world information raw
通过代码对应可以看到部分代码没有输出，部分代码有颜色而部分代码没有颜色。没有输出的部分是因为 LOG_LEVEL 的定义级别导致没有输出：
#if (CONFIG_LOG_LEVEL >= 4)
#define LOG_D(...) BFLOG_D((void *)&__bflog_recorder, __VA_ARGS__)
#define LOG_RD(...) BFLOG_RD((void *)&__bflog_recorder, __VA_ARGS__)
#else
#define LOG_D(...) ((void)0)
#define LOG_RD(...) ((void)0)
#endif

#if (CONFIG_LOG_LEVEL >= 5)
#define LOG_T(...) BFLOG_T((void *)&__bflog_recorder, __VA_ARGS__)
#define LOG_RT(...) BFLOG_RT((void *)&__bflog_recorder, __VA_ARGS__)
#else
#define LOG_T(...) ((void)0)
#define LOG_RT(...) ((void)0)
#endif
是否有颜色则取决于是否带有R,在引用文件中可以看到：
#define BFLOG_RF(_log, ...) BFLOG_X(_log, BFLOG_LEVEL_RAW | BFLOG_LEVEL_FATAL, (BFLOG_TAG), ##__VA_ARGS__)
以上配置可以在同级目录下的 proj.conf 中。

== Demo:log_dbg_assert ==
这部分代码和Demo:helloworld 基本一致，但是多了测试断言输出的功能。

保存在 SDK 下的： bouffalo_sdk/examples/log_dbg_assert

在代码中先进行了一个阶乘的递归函数，每一次递归以及判读啊都会输出断言信息以此测试断言输出。

示例输出：<syntaxhighlight lang="bash" line="1">
[I][MAIN] message = "hellokszhdfoiasjdkjnskjxnvuiolashdfoinaskjldfnvklasjhdfi213489o71234589073298dfl;asjdlfnkjzxncvhasdlkfljhasjkldjhnvjkaslndfvkljashdlifhui"
[I][MAIN] message (size: 138):
00000000: 68 65 6c 6c 6f 6b 73 7a 68 64 66 6f 69 61 73 6a 'hellokszhdfoiasj'
00000010: 64 6b 6a 6e 73 6b 6a 78 6e 76 75 69 6f 6c 61 73 'dkjnskjxnvuiolas'
00000020: 68 64 66 6f 69 6e 61 73 6b 6a 6c 64 66 6e 76 6b 'hdfoinaskjldfnvk'
00000030: 6c 61 73 6a 68 64 66 69 32 31 33 34 38 39 6f 37 'lasjhdfi213489o7'
00000040: 31 32 33 34 35 38 39 30 37 33 32 39 38 64 66 6c '1234589073298dfl'
00000050: 3b 61 73 6a 64 6c 66 6e 6b 6a 7a 78 6e 63 76 68 ';asjdlfnkjzxncvh'
00000060: 61 73 64 6c 6b 66 6c 6a 68 61 73 6a 6b 6c 64 6a 'asdlkfljhasjkldj'
00000070: 68 6e 76 6a 6b 61 73 6c 6e 64 66 76 6b 6c 6a 61 'hnvjkaslndfvklja'
00000080: 73 68 64 6c 69 66 68 75 69 00 'shdlifhui.'
[I][MAIN] 3 * a = 6 (0x6)
[I][MAIN] numbers = [7,13,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,] (length: 512)
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = true
[I][MAIN] 1 = 1 (0x1)
[I][MAIN] n * factorial(n - 1) = 2 (0x2)
[I][MAIN] n * factorial(n - 1) = 6 (0x6)
[I][MAIN] n * factorial(n - 1) = 24 (0x18)
[I][MAIN] factorial(4) = 24 (0x18)
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = false
[I][MAIN] n <= 1 = true
[I][MAIN] 1 = 1 (0x1)

.......

1 == factorial(4) but 1 = 1 , factorial(4) = 24
error handler
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information
hello world fatal raw
hello world error raw
hello world warning raw
hello world information raw
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information

</syntaxhighlight>

== Demo:boot2 isp ==
这部分代码是一个bootloader程序，具备 '''安全启动'''、'''双分区更新'''、'''压缩支持'''、'''多核管理''' 等工业级特性。

该demo存放在 SDK 下的：/home/user/FromGit/bouffalo_sdk/examples/boot2_isp 路径下。

=== 主要功能 ===

# '''分区表'''：
#* 读取并验证分区表（<code>pt_table_stuff</code>），确定活动分区（<code>active_id</code>）
#* 支持 A/B 双分区设计，实现无缝固件更新和回滚
#* 处理分区条目，包括固件位置、大小、版本号
# '''固件加载与启动'''：
#* 该程序会根据分区表加载固件到内存
#* 支持压缩固件：XZ 格式的解压<code>blsp_boot2_check_xz_fw</code>
#* 多核支持： <code>BLSP_BOOT2_CPU_GROUP_MAX</code> 定义 CPU 数量
# '''固件更新'''：
#* OTA 更新：将新固件从临时分区复制到主分区
#* 防回滚（Anti-Rollback）：防止降级到不安全版本
#* 支持 USB/UART 烧录模式，对应代码：<code>bflb_eflash_loader_main</code>
# '''安全'''：
#* SHA-256 校验
#* 具有固件完整性检查

您可以在开发板存在其他 App 的同时烧录该 bin ,'''这并不会覆盖掉你的程序，而是只为开发板更换 bootloader'''.

Demo:bflog

2025-08-05T07:01:05Z

武楷轩：武楷轩移动页面Demo:bflog至Demo:Basical case

#重定向 [[Demo:Basical case]]

Demo:Basical case

2025-08-05T07:01:05Z

武楷轩：武楷轩移动页面Demo:bflog至Demo:Basical case

=== Demo介绍： ===
该部分代码储存在 bouffalo_sdk/examples/bflog/barebone_sync 路径下，主要测试该开发板不同级别的log输出功能；

filter对输出日志的过滤功能。bflog分为五个级别，分别为：
{| class="wikitable"
!'''日志等级'''
!'''说明'''
!'''基本应用场景'''
|-
|'''FATL'''
|致命错误（Fatal）
|系统无法继续运行的灾难性事件（如核心崩溃、数据损坏），需立即人工干预并终止程序。
|-
|'''ERRO'''
|错误（Error）
|影响当前操作的关键错误（如功能失效、外部服务异常），但系统仍可部分运行，需尽快处理。
|-
|'''WARN'''
|警告（Warning）
|非关键性异常或潜在风险（如配置降级、资源不足），需关注但无需立即行动。
|-
|'''INFO'''
|信息（Info）
|常规运行状态记录（如服务启动、关键操作完成），用于监控系统健康状态。
|-
|'''DBUG'''
|调试（Debug）
|开发/测试阶段的详细运行细节（如变量值、逻辑分支），用于定位问题原因。
|-
|'''TRAC'''
|跟踪（Trace）
|最细粒度的执行路径追踪（如函数调用栈、循环过程），用于深度分析复杂逻辑。
|}

=== barebone_sync： ===
该部分主要是裸机测试了以上的各个等级log输出，filter过滤。

'''部分输出：'''<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================

============================== enable all output

[FATL][ 25338][2022-12-16 17:51:40][main.c:main:130]<MAIN> hello world this is fatal error
[ERRO][ 25858][2022-12-16 17:51:40][main.c:main:131]<MAIN> hello world this is error
[WARN][ 26355][2022-12-16 17:51:40][main.c:main:132]<MAIN> hello world this is warning
[INFO][ 26864][2022-12-16 17:51:40][main.c:main:133]<MAIN> hello world this is information
[DBUG][ 27374][2022-12-16 17:51:40][main.c:main:134]<MAIN> hello world this is degug information
[TRAC][ 27934][2022-12-16 17:51:40][main.c:main:135]<MAIN> hello world this is trace information
[FATL][ 28492][2022-12-16 17:51:40][log_test.c:test_log:13]<TEST> hello test this is fatal error
[ERRO][ 29049][2022-12-16 17:51:40][log_test.c:test_log:14]<TEST> hello test this is error
[WARN][ 29580][2022-12-16 17:51:40][log_test.c:test_log:15]<TEST> hello test this is warning
[INFO][ 30119][2022-12-16 17:51:40][log_test.c:test_log:16]<TEST> hello test this is information
[DBUG][ 30660][2022-12-16 17:51:40][log_test.c:test_log:17]<TEST> hello test this is degug information
[TRAC][ 31248][2022-12-16 17:51:40][log_test.c:test_log:18]<TEST> hello test this is trace information

============================== enable only MAIN output

[FATL][ 1031983][2022-12-16 17:51:41][log_test.c:test_log:13]<TEST> hello test this is fatal error
[ERRO][ 1032537][2022-12-16 17:51:41][log_test.c:test_log:14]<TEST> hello test this is error
[WARN][ 1033066][2022-12-16 17:51:41][log_test.c:test_log:15]<TEST> hello test this is warning
[INFO][ 1033606][2022-12-16 17:51:41][log_test.c:test_log:16]<TEST> hello test this is information
[DBUG][ 1034146][2022-12-16 17:51:41][log_test.c:test_log:17]<TEST> hello test this is degug information
[TRAC][ 1034736][2022-12-16 17:51:41][log_test.c:test_log:18]<TEST> hello test this is trace information

============================== disable all output

</syntaxhighlight>

=== freertos_async： ===
该部分测试了在FreeRTOS下log的输出是否正常。

该case创建了两个任务，消费者和生产者，从信号队列中进行获取和放入的经典场景来测试log。

消费者任务和生产者任务具体代码放在同目录下的： thread_consumer; thread_producer;中。

'''部分输出：'''

Demo:lmac154

2025-08-05T06:18:12Z

武楷轩：lmac154

=== Demo介绍： ===
该Demo根据IEEE 802.15.4标准的无线通信实现了数据链路层的基本无限通讯协议。

该Demo是构建上层无线通信协议的'''起点'''。你可以直接在其MAC层基础上开发Zigbee网络层，或通过替换物理层驱动适配LoRa，亦或实现自定义的轻量级IoT协议。

保存在SDK 下的 bouffalo_sdk/examples/lmac154

代码：代码部分主要做了RF 也就是频射相关的初始化，然后通过每秒发包来测试TX或者RX的吞吐量。

=== 示例输出： ===
<syntaxhighlight lang="bash" line="1">
[I][rfparam] tcap_tsen[10]: -3,-4,20,39,39,40,41,42,43,44,
[I][rfparam] tcap_cap[11]: 28,29,30,31,32,33,34,35,36,37,38,
[OS] Starting lmac154 example task...
[OS] Starting OS Scheduler...
RF (channel 12) Init
Tx Power: 15dBm
CCA: 0, RSSI: -120dBm

TX Done (STATUS: 0, SN: 0x00)

No Ack

TX Done (STATUS: 0, SN: 0x00)

No Ack

</syntaxhighlight>

首页

2025-08-05T02:58:39Z

武楷轩：/* Demos */

= Getting Started =

* [https://github.com/bouffalolab/bouffalo_sdk 如何获取SDK]
* [[如何在Ubuntu上搭建编译环境]]
* [[如何在Windows上搭建编译环境]]
* [[如何获取开发板]]
* [[烧录固件到开发板]]

= Bouffalo SDK =
'''BouffaloSDK''' 是 Bouffalo Lab 提供的 IOT 和 MCU 软件开发包，支持博流智能所有系列芯片，也是 '''bl_mcu_sdk''' 和 '''bl_iot_sdk''' 的结合体。

[[文件:BouffaloSDK.png|无框|600x600像素]]

= Peripherals =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[I2S]]
*[[I2C]]
*[[CVBS]]
*[[Watchdog]]
*[[GSM/GPRS]]
*[[Codec]]
*[[PCIe]]
*[[GPIO]]
*[[eMMC]]
|width="32%" valign="top" align="left"|
*[[WiFi]]
*[[LED]]
*[[Serial port]]
*[[PWM]]
*[[SPI]]
*[[USB OTG]]
*[[LCD]]
*[[CPU]]
*[[Network]]
|width="32%" valign="top" align="left"|
*[[Bluetooth]]
*[[HDMI]]
*[[Camera]]
*[[Memory]]
*[[RTC]]
*[[EEPROM]]
*[[MIPI-DSI]]
*[[NPU]]
*[[VPU]]
|}

= Products =
{| border="0" cellpadding="10" width="100%"
|-
|width="50%" valign="top" align="left"|
* [[BL602]]
* [[BL702]]
* [[BL618]]
* [[BL606P]]
|width="50%" valign="top" align="left"|
* [[BL702L]]
* [[BL616]]
|}

= Develop Boards =
* BL602EVB

= Application Notes =
* [[SDIOWIFI架构和开发手册]]
* [[BL616低功耗开发手册]]
* [[USB Wi-Fi用户手册]]

= Demos =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[Demo:FreeRTOS]]
* [[Demo:wifi sta]]
* [[Demo:boot2_isp]]
* [[Demo:helloworld]]
|width="32%" valign="top" align="left"|
*[[Demo:DMA]]
* [[Demo:Btble]]
* [[Demo:coremark]]
* [[Demo:littlefs]]
|width="32%" valign="top" align="left"|
*[[Demo:Flash]]
* [[Demo:bflog]]
* [[Demo:dsp]]
|}

Demo:littlefs

2025-08-05T02:58:05Z

武楷轩：littlefs

=== Demo介绍： ===
该部分demo主要测试了开发板的文件系统是否正常运行。对文件进行基本的创建读写来完成测试。

这部分代码存放在SDK下的： bouffalo_sdk/examples/littlefs

'''注意：这部分代码需要完整的 XIP init ，也就是说需要分区表，所以在执行玩基本的 make 编译后必须进行马 make whole 然后烧录 whole bin文件。'''

=== 示例输出： ===
<syntaxhighlight lang="bash" line="1">
burst wrap cmd 0x77
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
Active Partition[0] consumed 596 Bytes
======= PtTable_Config @0x62fc6880=======
magicCode 0x54504642; version 0x0000; entryCnt 8; age 0; crc32 0xE38928F3
idx type device active_index name Address[0] Address[1] Length[0] Length[1] age
[00] 16 0 0 Boot2 0x00000000 0x00000000 0x0000e000 0x00000000 0
[01] 00 0 0 FW 0x00010000 0x00210000 0x00200000 0x00168000 0
[02] 10 0 0 mfg 0x00210000 0x00000000 0x00168000 0x00000000 0
[03] 02 0 0 media 0x00378000 0x00000000 0x00071000 0x00000000 0
[04] 03 0 0 PSM 0x003e9000 0x00000000 0x00008000 0x00000000 0
[05] 04 0 0 KEY 0x003f1000 0x00000000 0x00002000 0x00000000 0
[06] 05 0 0 DATA 0x003f3000 0x00000000 0x00005000 0x00000000 0
[07] 06 0 0 factory 0x003f8000 0x00000000 0x00008000 0x00000000 0
bouffalolab />[MTD] >>>>>> Hanlde info Dump >>>>>>
name PSM
id 0
offset 0x003e9000(4100096)
size 0x00008000(32Kbytes)
xip_addr 0xa03d8000
[MTD] <<<<<< Hanlde info End <<<<<<
[I][LFS] Found valid PSM partition, XIP addr a03d8000, flash addr 003e9000, size 32768
[I][LFS] mount success
boot_count: 8

</syntaxhighlight>输出首先是分区表的信息，其中包括：活跃分区表索引；Bootloader 的区域；主要代码存放区域等等。

下方是XIP INIT 中的一些信息，和程序输出，其中 mount success 可以表示该程序执行是成功的。

首页

2025-08-04T09:09:56Z

武楷轩：/* Demos */

= Getting Started =

* [https://github.com/bouffalolab/bouffalo_sdk 如何获取SDK]
* [[如何在Ubuntu上搭建编译环境]]
* [[如何在Windows上搭建编译环境]]
* [[如何获取开发板]]
* [[烧录固件到开发板]]

= Bouffalo SDK =
'''BouffaloSDK''' 是 Bouffalo Lab 提供的 IOT 和 MCU 软件开发包，支持博流智能所有系列芯片，也是 '''bl_mcu_sdk''' 和 '''bl_iot_sdk''' 的结合体。

[[文件:BouffaloSDK.png|无框|600x600像素]]

= Peripherals =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[I2S]]
*[[I2C]]
*[[CVBS]]
*[[Watchdog]]
*[[GSM/GPRS]]
*[[Codec]]
*[[PCIe]]
*[[GPIO]]
*[[eMMC]]
|width="32%" valign="top" align="left"|
*[[WiFi]]
*[[LED]]
*[[Serial port]]
*[[PWM]]
*[[SPI]]
*[[USB OTG]]
*[[LCD]]
*[[CPU]]
*[[Network]]
|width="32%" valign="top" align="left"|
*[[Bluetooth]]
*[[HDMI]]
*[[Camera]]
*[[Memory]]
*[[RTC]]
*[[EEPROM]]
*[[MIPI-DSI]]
*[[NPU]]
*[[VPU]]
|}

= Products =
{| border="0" cellpadding="10" width="100%"
|-
|width="50%" valign="top" align="left"|
* [[BL602]]
* [[BL702]]
* [[BL618]]
* [[BL606P]]
|width="50%" valign="top" align="left"|
* [[BL702L]]
* [[BL616]]
|}

= Develop Boards =
* BL602EVB

= Application Notes =
* [[SDIOWIFI架构和开发手册]]
* [[BL616低功耗开发手册]]
* [[USB Wi-Fi用户手册]]

= Demos =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[Demo:FreeRTOS]]
* [[Demo:wifi sta]]
* [[Demo:boot2_isp]]
* [[Demo:helloworld]]
|width="32%" valign="top" align="left"|
*[[Demo:DMA]]
* [[Demo:Btble]]
* [[Demo:coremark]]
|width="32%" valign="top" align="left"|
*[[Demo:Flash]]
* [[Demo:bflog]]
* [[Demo:dsp]]
|}

Demo:helloworld

2025-08-04T09:09:25Z

武楷轩：创建页面，内容为“=== Demo介绍： === 该demo测试基本日志等级输出，该Demo是对bflog加了一层封装，比如控制日志输出等级，控制是否使用严重等级颜色输出。保存路径： bouffalo_sdk/examples/helloworld 在当前默认情况下的输出如下：<syntaxhighlight lang="bash" line="1"> =========================== uart sig1:ffffffff, sig2:0000f32f clock gen1:9ffffffd, gen2:0fff0c11 xtal:40000000Hz(crystal) board init done ==============…”

=== Demo介绍： ===
该demo测试基本日志等级输出，该Demo是对bflog加了一层封装，比如控制日志输出等级，控制是否使用严重等级颜色输出。

保存路径： bouffalo_sdk/examples/helloworld

在当前默认情况下的输出如下：<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
[F][MAIN] hello world fatal
[E][MAIN] hello world error
[W][MAIN] hello world warning
[I][MAIN] hello world information
hello world fatal raw
hello world error raw
hello world warning raw
hello world information raw

</syntaxhighlight>通过代码对应可以看到部分代码没有输出，部分代码有颜色而部分代码没有颜色。

没有输出的部分是因为 LOG_LEVEL 的定义级别导致没有输出：<syntaxhighlight lang="c" line="1">
#if (CONFIG_LOG_LEVEL >= 4)
#define LOG_D(...) BFLOG_D((void *)&__bflog_recorder, __VA_ARGS__)
#define LOG_RD(...) BFLOG_RD((void *)&__bflog_recorder, __VA_ARGS__)
#else
#define LOG_D(...) ((void)0)
#define LOG_RD(...) ((void)0)
#endif

#if (CONFIG_LOG_LEVEL >= 5)
#define LOG_T(...) BFLOG_T((void *)&__bflog_recorder, __VA_ARGS__)
#define LOG_RT(...) BFLOG_RT((void *)&__bflog_recorder, __VA_ARGS__)
#else
#define LOG_T(...) ((void)0)
#define LOG_RT(...) ((void)0)
#endif
</syntaxhighlight>是否有颜色则取决于是否带有R,在引用文件中可以看到：<syntaxhighlight lang="c" line="1">
#define BFLOG_RF(_log, ...) BFLOG_X(_log, BFLOG_LEVEL_RAW | BFLOG_LEVEL_FATAL, (BFLOG_TAG), ##__VA_ARGS__)
</syntaxhighlight>以上配置可以在同级目录下的 proj.conf 中。

首页

2025-08-04T08:36:16Z

武楷轩：/* Demos */

= Getting Started =

* [https://github.com/bouffalolab/bouffalo_sdk 如何获取SDK]
* [[如何在Ubuntu上搭建编译环境]]
* [[如何在Windows上搭建编译环境]]
* [[如何获取开发板]]
* [[烧录固件到开发板]]

= Bouffalo SDK =
'''BouffaloSDK''' 是 Bouffalo Lab 提供的 IOT 和 MCU 软件开发包，支持博流智能所有系列芯片，也是 '''bl_mcu_sdk''' 和 '''bl_iot_sdk''' 的结合体。

[[文件:BouffaloSDK.png|无框|600x600像素]]

= Peripherals =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[I2S]]
*[[I2C]]
*[[CVBS]]
*[[Watchdog]]
*[[GSM/GPRS]]
*[[Codec]]
*[[PCIe]]
*[[GPIO]]
*[[eMMC]]
|width="32%" valign="top" align="left"|
*[[WiFi]]
*[[LED]]
*[[Serial port]]
*[[PWM]]
*[[SPI]]
*[[USB OTG]]
*[[LCD]]
*[[CPU]]
*[[Network]]
|width="32%" valign="top" align="left"|
*[[Bluetooth]]
*[[HDMI]]
*[[Camera]]
*[[Memory]]
*[[RTC]]
*[[EEPROM]]
*[[MIPI-DSI]]
*[[NPU]]
*[[VPU]]
|}

= Products =
{| border="0" cellpadding="10" width="100%"
|-
|width="50%" valign="top" align="left"|
* [[BL602]]
* [[BL702]]
* [[BL618]]
* [[BL606P]]
|width="50%" valign="top" align="left"|
* [[BL702L]]
* [[BL616]]
|}

= Develop Boards =
* BL602EVB

= Application Notes =
* [[SDIOWIFI架构和开发手册]]
* [[BL616低功耗开发手册]]
* [[USB Wi-Fi用户手册]]

= Demos =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[Demo:FreeRTOS]]
* [[Demo:wifi sta]]
* [[Demo:boot2_isp]]
|width="32%" valign="top" align="left"|
*[[Demo:DMA]]
* [[Demo:Btble]]
* [[Demo:coremark]]
|width="32%" valign="top" align="left"|
*[[Demo:Flash]]
* [[Demo:bflog]]
* [[Demo:dsp]]
|}

Demo:dsp

2025-08-04T08:35:53Z

武楷轩：dsp

该Demo主要从角度测试DSP功能是否正常，保存在SDK下的：bouffalo_sdk/examples/dsp 中。

=== 测试目的 ===

# '''验证 DSP 算法的正确性'''：
#* 通过运行多个 DSP 算法模块，检查其输出是否符合预期。
# '''集成测试'''：
#* 确保多个 DSP 算法模块可以在同一程序中顺利运行，验证其集成性。
# '''性能测试'''：
#* 测试这些算法在嵌入式平台上的运行效率和资源占用情况。

----

=== 测试的具体功能 ===
<code>main</code> 函数依次调用了以下 DSP 算法模块，功能如下：

# '''<code>riscv_dsp2_fir_q15</code>'''：
#* 测试FIR滤波器的实现。
#* 使用 Q15 格式处理输入信号，验证滤波器的输出是否与参考结果一致。
# '''<code>riscv_dsp2_matrix_q31</code>'''：
#* 测试矩阵运算功能。
#* 使用 Q31 格式进行矩阵计算，例如矩阵乘法或矩阵变换。
# '''<code>riscv_dsp2_rfft_q15</code>'''：
#* 测试快速傅里叶变换（FFT）的实现。
#* 使用 Q15 格式对输入信号进行频域变换，验证频域结果。
# '''<code>riscv_dsp2_sin_q31</code>'''：
#* 测试正弦波生成功能。
#* 使用 Q31 格式生成正弦波信号，验证其幅值和周期是否正确。
# '''<code>riscv_dsp2_variance_q15</code>'''：
#* 测试方差计算功能。
#* 使用 Q15 格式计算输入信号的方差，验证统计计算的准确性。

==== 示例输出： ====
<syntaxhighlight lang="bash" line="1">
Example run riscv_dsp2_fir_q15!
Example run successfully!
Example run riscv_dsp2_matrix_q31!
Example run successfully!
Example run riscv_dsp2_rfft_q15!
Example run successfully!
Example run riscv_dsp2_fir_q15!
Example run successfully!
Example run riscv_dsp2_variance_q15!
Example run successfully!
Example all successfully!

</syntaxhighlight>

首页

2025-08-04T08:23:46Z

武楷轩：/* Demos */

= Getting Started =

* [https://github.com/bouffalolab/bouffalo_sdk 如何获取SDK]
* [[如何在Ubuntu上搭建编译环境]]
* [[如何在Windows上搭建编译环境]]
* [[如何获取开发板]]
* [[烧录固件到开发板]]

= Bouffalo SDK =
'''BouffaloSDK''' 是 Bouffalo Lab 提供的 IOT 和 MCU 软件开发包，支持博流智能所有系列芯片，也是 '''bl_mcu_sdk''' 和 '''bl_iot_sdk''' 的结合体。

[[文件:BouffaloSDK.png|无框|600x600像素]]

= Peripherals =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[I2S]]
*[[I2C]]
*[[CVBS]]
*[[Watchdog]]
*[[GSM/GPRS]]
*[[Codec]]
*[[PCIe]]
*[[GPIO]]
*[[eMMC]]
|width="32%" valign="top" align="left"|
*[[WiFi]]
*[[LED]]
*[[Serial port]]
*[[PWM]]
*[[SPI]]
*[[USB OTG]]
*[[LCD]]
*[[CPU]]
*[[Network]]
|width="32%" valign="top" align="left"|
*[[Bluetooth]]
*[[HDMI]]
*[[Camera]]
*[[Memory]]
*[[RTC]]
*[[EEPROM]]
*[[MIPI-DSI]]
*[[NPU]]
*[[VPU]]
|}

= Products =
{| border="0" cellpadding="10" width="100%"
|-
|width="50%" valign="top" align="left"|
* [[BL602]]
* [[BL702]]
* [[BL618]]
* [[BL606P]]
|width="50%" valign="top" align="left"|
* [[BL702L]]
* [[BL616]]
|}

= Develop Boards =
* BL602EVB

= Application Notes =
* [[SDIOWIFI架构和开发手册]]
* [[BL616低功耗开发手册]]
* [[USB Wi-Fi用户手册]]

= Demos =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[Demo:FreeRTOS]]
* [[Demo:wifi sta]]
* [[Demo:boot2_isp]]
|width="32%" valign="top" align="left"|
*[[Demo:DMA]]
* [[Demo:Btble]]
* [[Demo:coremark]]
|width="32%" valign="top" align="left"|
*[[Demo:Flash]]
* [[Demo:bflog]]
|}

Demo:coremark

2025-08-04T08:22:48Z

武楷轩：coremark

=== Demo简介 (Introduction) ===
CoreMark 的主要目标是提供一个简单的方法来测试处理器核心功能,该Demo存放在SDK的 bouffalo_sdk/examples/coremark_v1.01 下。

关于处理器，更多信息请访问 www.eembc.org。
----

==== 构建与运行 ====

* 使用 <code>make</code> 命令构建和运行基准测试。
* 运行结果会输出到 <code>run1.log</code> 和 <code>run2.log</code> 文件中，性能结果在 <code>run1.log</code> 中。

==== 交叉编译 ====

* 对于交叉编译平台，需要调整 <code>core_portme.mak</code>、<code>core_portme.h</code> 和可能的 <code>core_portme.c</code> 文件。
* 示例：创建一个新平台目录并复制默认配置文件，然后运行： make PORT_DIR=<platform>

----

==== Makefile 目标 ====

* <code>run</code>：默认目标，生成 <code>run1.log</code> 和 <code>run2.log</code>。
* <code>run1.log</code>：性能参数运行结果。
* <code>run2.log</code>：验证参数运行结果。
* <code>run3.log</code>：生成配置文件的运行结果。
* <code>compile</code>：编译基准测试可执行文件。
* <code>link</code>：链接基准测试可执行文件。
* <code>check</code>：验证源文件的 MD5 值。
* <code>clean</code>：清理临时文件。

----

==== Make 标志 ====

# '''<code>ITERATIONS</code>'''：设置运行迭代次数，默认运行 10-100 秒。例如： make ITERATIONS=10 适用于模拟器、功耗测量等场景。
# '''<code>XCFLAGS</code>'''：添加编译器标志。例如： make XCFLAGS="-g -DMULTITHREAD=4 -DUSE_FORK=1"
# '''<code>CORE_DEBUG</code>'''：调试运行时使用。例如： make XCFLAGS="-DCORE_DEBUG=1"
# '''<code>REBUILD</code>'''：强制重新构建可执行文件。

==== 无 <code>make</code> 系统 (Systems Without <code>make</code>) ====

* 手动编译所需文件并运行。例如：
<syntaxhighlight lang="bash" line="1">gcc -O2 -o coremark.exe core_list_join.c core_main.c core_matrix.c core_state.c core_util.c simple/core_portme.c -DPERFORMANCE_RUN=1 -DITERATIONS=1000

./coremark.exe > run1.log</syntaxhighlight>

----

=== 并行执行 ===

* 使用 <code>XCFLAGS=-DMULTITHREAD=N</code> 设置并行线程数。例如： make XCFLAGS="-DMULTITHREAD=4 -DUSE_PTHREAD"

----

=== 可执行文件运行参数 (Run Parameters) ===

* CoreMark 可执行文件支持多个参数（如果 <code>main()</code> 支持参数）。
* 参数包括种子值、迭代次数、数据缓冲区大小等。

----

=== 运行规则 ===

* '''必须'''：
*# 基准测试运行时间至少为 10 秒。
*# 验证必须成功，种子值为 <code>0,0,0x66</code> 和 <code>0x3415,0x3415,0x66</code>。
*# 如果使用配置文件优化，必须使用种子值 <code>8,8,8</code> 生成配置文件。
*# 所有源文件必须使用相同的编译标志。
* '''允许'''：
** 修改迭代次数、工具链、内存分配方法等。
* '''不允许'''：
** 修改除 <code>core_portme*</code> 外的源文件。

'''示例输出：'''<syntaxhighlight lang="bash" line="1">
Benchmark started, please make sure it runs for at least 10s.

Now PC=a0006152
2K performance run parameters for coremark.
CoreMark Size : 666
Total ticks : 11807
Total time (secs): 11
Iterations/Sec : 1000
Iterations : 11000
Compiler version : GCC10.2.0
Compiler flags : -O2
Memory location : STACK
seedcrc : 0xe9f5
[0]crclist : 0xe714
[0]crcmatrix : 0x1fd7
[0]crcstate : 0x8e3a
[0]crcfinal : 0x33ff
Correct operation validated. See readme.txt for run and reporting rules.
CoreMark 1.0 : 1000 / GCC10.2.0 -O2 / STACK

</syntaxhighlight>

Demo:boot2 isp

2025-07-30T07:00:48Z

武楷轩：boot2

这部分代码是一个bootloader程序，具备 '''安全启动'''、'''双分区更新'''、'''压缩支持'''、'''多核管理''' 等工业级特性。

该demo存放在 SDK 下的：/home/user/FromGit/bouffalo_sdk/examples/boot2_isp 路径下。

=== 主要功能 ===

# '''分区表'''：
#* 读取并验证分区表（<code>pt_table_stuff</code>），确定活动分区（<code>active_id</code>）
#* 支持 A/B 双分区设计，实现无缝固件更新和回滚
#* 处理分区条目，包括固件位置、大小、版本号
# '''固件加载与启动'''：
#* 该程序会根据分区表加载固件到内存
#* 支持压缩固件：XZ 格式的解压<code>blsp_boot2_check_xz_fw</code>
#* 多核支持： <code>BLSP_BOOT2_CPU_GROUP_MAX</code> 定义 CPU 数量
# '''固件更新'''：
#* OTA 更新：将新固件从临时分区复制到主分区
#* 防回滚（Anti-Rollback）：防止降级到不安全版本
#* 支持 USB/UART 烧录模式，对应代码：<code>bflb_eflash_loader_main</code>
# '''安全'''：
#* SHA-256 校验
#* 具有固件完整性检查

您可以在开发板存在其他 App 的同时烧录该 bin ,'''这并不会覆盖掉你的程序，而是只为开发板更换 bootloader'''.
----

首页

2025-07-30T06:51:41Z

武楷轩：/* Demos */

= Getting Started =

* [https://github.com/bouffalolab/bouffalo_sdk 如何获取SDK]
* [[如何在Ubuntu上搭建编译环境]]
* [[如何在Windows上搭建编译环境]]
* [[如何获取开发板]]
* [[烧录固件到开发板]]

= Bouffalo SDK =
'''BouffaloSDK''' 是 Bouffalo Lab 提供的 IOT 和 MCU 软件开发包，支持博流智能所有系列芯片，也是 '''bl_mcu_sdk''' 和 '''bl_iot_sdk''' 的结合体。

[[文件:BouffaloSDK.png|无框|600x600像素]]

= Peripherals =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[I2S]]
*[[I2C]]
*[[CVBS]]
*[[Watchdog]]
*[[GSM/GPRS]]
*[[Codec]]
*[[PCIe]]
*[[GPIO]]
*[[eMMC]]
|width="32%" valign="top" align="left"|
*[[WiFi]]
*[[LED]]
*[[Serial port]]
*[[PWM]]
*[[SPI]]
*[[USB OTG]]
*[[LCD]]
*[[CPU]]
*[[Network]]
|width="32%" valign="top" align="left"|
*[[Bluetooth]]
*[[HDMI]]
*[[Camera]]
*[[Memory]]
*[[RTC]]
*[[EEPROM]]
*[[MIPI-DSI]]
*[[NPU]]
*[[VPU]]
|}

= Products =
{| border="0" cellpadding="10" width="100%"
|-
|width="50%" valign="top" align="left"|
* [[BL602]]
* [[BL702]]
* [[BL618]]
* [[BL606P]]
|width="50%" valign="top" align="left"|
* [[BL702L]]
* [[BL616]]
|}

= Develop Boards =
* BL602EVB

= Application Notes =
* [[SDIOWIFI架构和开发手册]]
* [[BL616低功耗开发手册]]
* [[USB Wi-Fi用户手册]]

= Demos =

{| border="0" cellpadding="10" width="100%"
|-
|width="32%" valign="top" align="left"|
*[[Demo:FreeRTOS]]
* [[Demo:wifi sta]]
* [[Demo:boot2_isp]]
|width="32%" valign="top" align="left"|
*[[Demo:DMA]]
* [[Demo:Btble]]
|width="32%" valign="top" align="left"|
*[[Demo:Flash]]
* [[Demo:bflog]]
|}

Demo:Btble

2025-07-29T09:12:28Z

武楷轩：

== Demo介绍： ==
'''这部分Demo主要是蓝牙通讯相关功能的实例代码，这些demo保存在SDK的 example/btble路径下。'''

== blemesh_cli: ==

=== 基本介绍： ===
该demo创建了一个 Bluetooth mesh 网络，通过向串口发送指令进行初始化后，就可以通过手机APP在mesh网络中进行添加并连接。

DEMO命令和输出：<syntaxhighlight lang="bash" line="1">
bouffalolab />blemesh_init #初始化bluemesh网络
#输出：
Init successfully
Env[LOCAL_NAME] Data len[10], setting_env_cb
Use pb-adv or pb-gatt to enable advertising

bouffalolab />blemesh_pb 2 1
#输出：
PB-GATT enabled

</syntaxhighlight>执行完上述命令后，就可以使用手机APP进行NODE的添加和连接。

添加的步骤如下：<gallery>
文件:APPopen.png|step1
文件:Meshnode2.png|step2
文件:Meshnode3.png|step3
文件:Meshnode4.png|step4
文件:Meshnode5.png|step5
文件:Meshnode6.png|ste6
文件:Meshnode7.png|step7
文件:Meshnode8.png|step8
文件:Meshnode9.png|step9
文件:Meshnode10.png|step10
文件:Meshnode11.png|step11
文件:Meshnode12.png|step12
文件:Meshnode13.png|step13
</gallery>

=== 如何使用配网器 Provisioner 将新设备添加进网络中： ===
大概流程如下：

'''1.打开未配网设备 ---- 2.启动配网器Provisioner ---- 3.监听设备广播 ---- 4.添加设备到网络 ---- 5.获取设备信息 ---- 6.分配密钥'''

provisioner设备编译时，必须更改一个编译选项：

CONFIG_BT_MESH_PROVISIONER=1

==== 执行步骤1：打开未配网设备并且输入以下命令： ====
<syntaxhighlight lang="bash" line="1">
blemesh_init # 初始化Mesh协议栈
blemesh_pb 1 1 # 开启PB-ADV和PB-GATT配网承载
</syntaxhighlight>

==== 执行步骤2：打开配网器设备输入以下命令： ====
<syntaxhighlight lang="bash" line="1">
bouffalolab />blemesh_pvnr_init #初始化Provisioner
#得到输出：
.........
Local node provisioned, net_idx 0x0000 address 0x0001

Network key:8fe7deea92943001567251dc1f9b0f03

Dev key:89c2f18f9f286661c6bbb1430d7aadb7

Provisioning completed
</syntaxhighlight>

* <code>net_idx 0x0000</code>：网络索引
* <code>address 0x0001</code>：Provisioner自身地址
* <code>Network key</code>：网络层加密密钥
* <code>Dev key</code>：设备专属配置密钥

==== 执行步骤3：打开广播 ====
执行以下命令：
blemesh_beacon_listen 0x01 # 开启广播监听

* 扫描周围广播Mesh信标的设备
* 捕获并显示未配网设备的UUID（如：<code>07af000011112222333318b905de96c2</code>）
* UUID包含设备身份信息（厂商ID、产品ID等）

==== 执行步骤4：在配网器设备上执行添加设备到网络命令 ====
<syntaxhighlight lang="bash" line="1">
bouffalolab />blemesh_provision_adv 07af000011112222333318b905de96c2 0 3 0
#输出
P1：“07af000011112222333318b905de96c2" is UUID information.
P2：0：net_idx
P3：3： assign node unicast address。
P4：0：attention_duration
</syntaxhighlight>

* <code>UUID</code>：目标设备的唯一标识
* <code>net_idx 0</code>：使用的网络索引
* <code>address 3</code>：分配给设备的单播地址(0x0003)
* <code>attention_duration 0</code>：配网指示时长（0=无提示）

==== 执行步骤5：获取设备信息 ====
执行的命令与输出内容：<syntaxhighlight lang="bash" line="1">
bouffalolab /> blemesh_get_comp 0x0000 0x0003 0x00
#输出：
P1：net index.

P2：dst address.

P3：page number.
</syntaxhighlight>

* <code>net_idx 0x0000</code>：网络索引
* <code>dst 0x0003</code>：目标设备地址
* <code>page 0x00</code>：组成数据页码

==== 执行步骤6：分配密钥key ====
<syntaxhighlight lang="bash" line="1">
bouffalolab /> blemesh_app_key_add 0x0000 0x0003 0x0000 0x0000
#输出
P1：net index.

P2：dst address.

P3：Network key index。

P4：Application key index.
</syntaxhighlight>

== blemesh_simple ==
该demo的功能与上述的一致，但是该demo不需要前置的命令操作，在板子上电后会自动启动 blue mesh 网络，你可以参考blemesh_cli中的连接步骤直接进行节点连接。

如果你需要发送指令来控制，你可以发送以下指令：

"gen_cli_send dstaddress"将控制数据发送到指定的设备地址或这组地址。

== btble_cli ==
该demo会启动一个基本的BLE设备。你需要使用命令去进行操控该设备。

如果您不熟悉BLE的通信流程，请参考以下基本流程。<syntaxhighlight lang="bash" line="1">
#服务端执行
ble_init
ble_start_adv 0 0 0x80 0x80

#客户端设备执行
ble_start_scan 0 1 0x80 0x50

#scan后会获取到对应的地址进行连接这里是示例地址
#连接成功后服务端的终端会显示 connected
ble_connect 0 B40ECF2E90FC

#查询GATT服务这里是通用服务码
ble_discover 0 0x1800 0x1 0xffff 或者 ble_discover 0 0x1801 0x1 0xffff

#如果要查询特殊码（这里可以省略这一步）
ble_discover 3 0x1800 0x1 0xffff

#查询到服务后，可以选择直接读写：
ble_read 0x7 0
ble_write 0x7 0 2 0102

#也可以通过CCC进行订阅操作
ble_subscribe 0x4 0x3 0x1
#取消订阅：
ble_unsubscribe

</syntaxhighlight>''<big>上述的函数相关具体说明，全部保存在SDK的路径下： docs/en/api_reference/ble.rst</big>''

=== BLE基本通信流程 GATT服务框架： ===
[[文件:BLE.png|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:BLE.png|左|450x450像素]]
[[文件:GATT.png|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:GATT.png|居中|450x450像素]]

CCC则是一个订阅开关，本质上是一个数值，服务端会监控这个数值，假设该数值变化了，那么服务端则认为连接设备需要订阅消息。

== btble_controller_test ==
BLE控制器测试demo,终端返回 pwr_mod is bf 则表示正常。

== btble_central ==
该demo上电后会直接自动扫描周围的BLE设备，当设备存在并且名称匹配时，会直接进行连接并扫描对应的GATT服务然后进行订阅。

设备名称，GATT服务等都是程序提前设定好的，这部分设定在同级目录下的 config.h 文件中。

这里展示一部分：<syntaxhighlight lang="bash" line="1">
#endif

/**
* CONFIG_BT_DEVICE_NAME:Bluetooth device name. Name can be up
* to 248 bytes long (excluding NULL termination). Can be empty string
*/
#ifndef CONFIG_BT_DEVICE_NAME
#if defined(CONFIG_AUTO_PTS)
#define CONFIG_BT_DEVICE_NAME "AUTO_PTS_TEST0123456789012345"
#else
#if defined(BL602)
#define CONFIG_BT_DEVICE_NAME "BL602-BLE-DEV"
#elif defined(BL702)
#define CONFIG_BT_DEVICE_NAME "BL702-BLE-DEV"
#elif defined(BL702L)
#define CONFIG_BT_DEVICE_NAME "BL702L-BLE-DEV"
#else
#define CONFIG_BT_DEVICE_NAME "BTBLE-DEV"
#endif
#endif
#endif
/**
</syntaxhighlight>

== btble_periphral ==
该demo测试了BLE的OAD服务，上电后会直接执行GATT的OAD服务注册，然后进行广播，所有了连接上该服务端的设备订阅OAD服务都可以进行OAD远程升级。

注意这部分代码需要分区表，所以在烧录时必须进行 make whole 将分区表信息烧录进去。

OAD烧录的固件需要手动生成：<syntaxhighlight lang="bash" line="1">
#其中FW.bin 是你要进行升级的bin
python3 components/wireless/bluetooth/tools/GenerateOAD.py FW.bin FW.bin.sha256

</syntaxhighlight>

Demo:Btble

2025-07-29T09:10:14Z

武楷轩：/* BLE基本通信流程： GATT服务是什么： */

== Demo介绍： ==
'''这部分Demo主要是蓝牙通讯相关功能的实例代码，这些demo保存在SDK的 example/btble路径下。'''

== blemesh_cli: ==

=== 基本介绍： ===
该demo创建了一个 Bluetooth mesh 网络，通过向串口发送指令进行初始化后，就可以通过手机APP在mesh网络中进行添加并连接。

DEMO命令和输出：<syntaxhighlight lang="bash" line="1">
bouffalolab />blemesh_init #初始化bluemesh网络
#输出：
Init successfully
Env[LOCAL_NAME] Data len[10], setting_env_cb
Use pb-adv or pb-gatt to enable advertising

bouffalolab />blemesh_pb 2 1
#输出：
PB-GATT enabled

</syntaxhighlight>执行完上述命令后，就可以使用手机APP进行NODE的添加和连接。

添加的步骤如下：<gallery>
文件:APPopen.png|step1
文件:Meshnode2.png|step2
文件:Meshnode3.png|step3
文件:Meshnode4.png|step4
文件:Meshnode5.png|step5
文件:Meshnode6.png|ste6
文件:Meshnode7.png|step7
文件:Meshnode8.png|step8
文件:Meshnode9.png|step9
文件:Meshnode10.png|step10
文件:Meshnode11.png|step11
文件:Meshnode12.png|step12
文件:Meshnode13.png|step13
</gallery>

=== 如何使用配网器 Provisioner 将新设备添加进网络中： ===
大概流程如下：

'''1.打开未配网设备 ---- 2.启动配网器Provisioner ---- 3.监听设备广播 ---- 4.添加设备到网络 ---- 5.获取设备信息 ---- 6.分配密钥'''

provisioner设备编译时，必须更改一个编译选项：

CONFIG_BT_MESH_PROVISIONER=1

==== 执行步骤1：打开未配网设备并且输入以下命令： ====
<syntaxhighlight lang="bash" line="1">
blemesh_init # 初始化Mesh协议栈
blemesh_pb 1 1 # 开启PB-ADV和PB-GATT配网承载
</syntaxhighlight>

==== 执行步骤2：打开配网器设备输入以下命令： ====
<syntaxhighlight lang="bash" line="1">
bouffalolab />blemesh_pvnr_init #初始化Provisioner
#得到输出：
.........
Local node provisioned, net_idx 0x0000 address 0x0001

Network key:8fe7deea92943001567251dc1f9b0f03

Dev key:89c2f18f9f286661c6bbb1430d7aadb7

Provisioning completed
</syntaxhighlight>

* <code>net_idx 0x0000</code>：网络索引
* <code>address 0x0001</code>：Provisioner自身地址
* <code>Network key</code>：网络层加密密钥
* <code>Dev key</code>：设备专属配置密钥

==== 执行步骤3：打开广播 ====
执行以下命令：
blemesh_beacon_listen 0x01 # 开启广播监听

* 扫描周围广播Mesh信标的设备
* 捕获并显示未配网设备的UUID（如：<code>07af000011112222333318b905de96c2</code>）
* UUID包含设备身份信息（厂商ID、产品ID等）

==== 执行步骤4：在配网器设备上执行添加设备到网络命令 ====
<syntaxhighlight lang="bash" line="1">
bouffalolab />blemesh_provision_adv 07af000011112222333318b905de96c2 0 3 0
#输出
P1：“07af000011112222333318b905de96c2" is UUID information.
P2：0：net_idx
P3：3： assign node unicast address。
P4：0：attention_duration
</syntaxhighlight>

* <code>UUID</code>：目标设备的唯一标识
* <code>net_idx 0</code>：使用的网络索引
* <code>address 3</code>：分配给设备的单播地址(0x0003)
* <code>attention_duration 0</code>：配网指示时长（0=无提示）

==== 执行步骤5：获取设备信息 ====
执行的命令与输出内容：<syntaxhighlight lang="bash" line="1">
bouffalolab /> blemesh_get_comp 0x0000 0x0003 0x00
#输出：
P1：net index.

P2：dst address.

P3：page number.
</syntaxhighlight>

* <code>net_idx 0x0000</code>：网络索引
* <code>dst 0x0003</code>：目标设备地址
* <code>page 0x00</code>：组成数据页码

==== 执行步骤6：分配密钥key ====
<syntaxhighlight lang="bash" line="1">
bouffalolab /> blemesh_app_key_add 0x0000 0x0003 0x0000 0x0000
#输出
P1：net index.

P2：dst address.

P3：Network key index。

P4：Application key index.
</syntaxhighlight>

== blemesh_simple ==
该demo的功能与上述的一致，但是该demo不需要前置的命令操作，在板子上电后会自动启动 blue mesh 网络，你可以参考blemesh_cli中的连接步骤直接进行节点连接。

如果你需要发送指令来控制，你可以发送以下指令：

"gen_cli_send dstaddress"将控制数据发送到指定的设备地址或这组地址。

== btble_cli ==
该demo会启动一个基本的BLE设备。你需要使用命令去进行操控该设备。

如果您不熟悉BLE的通信流程，请参考以下基本流程。<syntaxhighlight lang="bash" line="1">
#服务端执行
ble_init
ble_start_adv 0 0 0x80 0x80

#客户端设备执行
ble_start_scan 0 1 0x80 0x50

#scan后会获取到对应的地址进行连接这里是示例地址
#连接成功后服务端的终端会显示 connected
ble_connect 0 B40ECF2E90FC

#查询GATT服务这里是通用服务码
ble_discover 0 0x1800 0x1 0xffff 或者 ble_discover 0 0x1801 0x1 0xffff

#如果要查询特殊码（这里可以省略这一步）
ble_discover 3 0x1800 0x1 0xffff

#查询到服务后，可以选择直接读写：
ble_read 0x7 0
ble_write 0x7 0 2 0102

#也可以通过CCC进行订阅操作
ble_subscribe 0x4 0x3 0x1
#取消订阅：
ble_unsubscribe

</syntaxhighlight>''<big>上述的函数相关具体说明，全部保存在SDK的路径下： docs/en/api_reference/ble.rst</big>''

=== BLE基本通信流程： GATT服务是什么： ===
[[文件:BLE.png|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:BLE.png|左|450x450像素]]
[[文件:GATT.png|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:GATT.png|居中|450x450像素]]

CCC则是一个订阅开关，本质上是一个数值，服务端会监控这个数值，假设该数值变化了，那么服务端则认为连接设备需要订阅消息。

== btble_controller_test ==
BLE控制器测试demo,终端返回 pwr_mod is bf 则表示正常。

== btble_central ==
该demo上电后会直接自动扫描周围的BLE设备，当设备存在并且名称匹配时，会直接进行连接并扫描对应的GATT服务然后进行订阅。

设备名称，GATT服务等都是程序提前设定好的，这部分设定在同级目录下的 config.h 文件中。

这里展示一部分：<syntaxhighlight lang="bash" line="1">
#endif

/**
* CONFIG_BT_DEVICE_NAME:Bluetooth device name. Name can be up
* to 248 bytes long (excluding NULL termination). Can be empty string
*/
#ifndef CONFIG_BT_DEVICE_NAME
#if defined(CONFIG_AUTO_PTS)
#define CONFIG_BT_DEVICE_NAME "AUTO_PTS_TEST0123456789012345"
#else
#if defined(BL602)
#define CONFIG_BT_DEVICE_NAME "BL602-BLE-DEV"
#elif defined(BL702)
#define CONFIG_BT_DEVICE_NAME "BL702-BLE-DEV"
#elif defined(BL702L)
#define CONFIG_BT_DEVICE_NAME "BL702L-BLE-DEV"
#else
#define CONFIG_BT_DEVICE_NAME "BTBLE-DEV"
#endif
#endif
#endif
/**
</syntaxhighlight>

== btble_periphral ==
该demo测试了BLE的OAD服务，上电后会直接执行GATT的OAD服务注册，然后进行广播，所有了连接上该服务端的设备订阅OAD服务都可以进行OAD远程升级。

注意这部分代码需要分区表，所以在烧录时必须进行 make whole 将分区表信息烧录进去。

OAD烧录的固件需要手动生成：<syntaxhighlight lang="bash" line="1">
#其中FW.bin 是你要进行升级的bin
python3 components/wireless/bluetooth/tools/GenerateOAD.py FW.bin FW.bin.sha256

</syntaxhighlight>

Demo:Btble

2025-07-29T09:08:59Z

武楷轩：

== Demo介绍： ==
'''这部分Demo主要是蓝牙通讯相关功能的实例代码，这些demo保存在SDK的 example/btble路径下。'''

== blemesh_cli: ==

=== 基本介绍： ===
该demo创建了一个 Bluetooth mesh 网络，通过向串口发送指令进行初始化后，就可以通过手机APP在mesh网络中进行添加并连接。

DEMO命令和输出：<syntaxhighlight lang="bash" line="1">
bouffalolab />blemesh_init #初始化bluemesh网络
#输出：
Init successfully
Env[LOCAL_NAME] Data len[10], setting_env_cb
Use pb-adv or pb-gatt to enable advertising

bouffalolab />blemesh_pb 2 1
#输出：
PB-GATT enabled

</syntaxhighlight>执行完上述命令后，就可以使用手机APP进行NODE的添加和连接。

添加的步骤如下：<gallery>
文件:APPopen.png|step1
文件:Meshnode2.png|step2
文件:Meshnode3.png|step3
文件:Meshnode4.png|step4
文件:Meshnode5.png|step5
文件:Meshnode6.png|ste6
文件:Meshnode7.png|step7
文件:Meshnode8.png|step8
文件:Meshnode9.png|step9
文件:Meshnode10.png|step10
文件:Meshnode11.png|step11
文件:Meshnode12.png|step12
文件:Meshnode13.png|step13
</gallery>

=== 如何使用配网器 Provisioner 将新设备添加进网络中： ===
大概流程如下：

'''1.打开未配网设备 ---- 2.启动配网器Provisioner ---- 3.监听设备广播 ---- 4.添加设备到网络 ---- 5.获取设备信息 ---- 6.分配密钥'''

provisioner设备编译时，必须更改一个编译选项：

CONFIG_BT_MESH_PROVISIONER=1

==== 执行步骤1：打开未配网设备并且输入以下命令： ====
<syntaxhighlight lang="bash" line="1">
blemesh_init # 初始化Mesh协议栈
blemesh_pb 1 1 # 开启PB-ADV和PB-GATT配网承载
</syntaxhighlight>

==== 执行步骤2：打开配网器设备输入以下命令： ====
<syntaxhighlight lang="bash" line="1">
bouffalolab />blemesh_pvnr_init #初始化Provisioner
#得到输出：
.........
Local node provisioned, net_idx 0x0000 address 0x0001

Network key:8fe7deea92943001567251dc1f9b0f03

Dev key:89c2f18f9f286661c6bbb1430d7aadb7

Provisioning completed
</syntaxhighlight>

* <code>net_idx 0x0000</code>：网络索引
* <code>address 0x0001</code>：Provisioner自身地址
* <code>Network key</code>：网络层加密密钥
* <code>Dev key</code>：设备专属配置密钥

==== 执行步骤3：打开广播 ====
执行以下命令：
blemesh_beacon_listen 0x01 # 开启广播监听

* 扫描周围广播Mesh信标的设备
* 捕获并显示未配网设备的UUID（如：<code>07af000011112222333318b905de96c2</code>）
* UUID包含设备身份信息（厂商ID、产品ID等）

==== 执行步骤4：在配网器设备上执行添加设备到网络命令 ====
<syntaxhighlight lang="bash" line="1">
bouffalolab />blemesh_provision_adv 07af000011112222333318b905de96c2 0 3 0
#输出
P1：“07af000011112222333318b905de96c2" is UUID information.
P2：0：net_idx
P3：3： assign node unicast address。
P4：0：attention_duration
</syntaxhighlight>

* <code>UUID</code>：目标设备的唯一标识
* <code>net_idx 0</code>：使用的网络索引
* <code>address 3</code>：分配给设备的单播地址(0x0003)
* <code>attention_duration 0</code>：配网指示时长（0=无提示）

==== 执行步骤5：获取设备信息 ====
执行的命令与输出内容：<syntaxhighlight lang="bash" line="1">
bouffalolab /> blemesh_get_comp 0x0000 0x0003 0x00
#输出：
P1：net index.

P2：dst address.

P3：page number.
</syntaxhighlight>

* <code>net_idx 0x0000</code>：网络索引
* <code>dst 0x0003</code>：目标设备地址
* <code>page 0x00</code>：组成数据页码

==== 执行步骤6：分配密钥key ====
<syntaxhighlight lang="bash" line="1">
bouffalolab /> blemesh_app_key_add 0x0000 0x0003 0x0000 0x0000
#输出
P1：net index.

P2：dst address.

P3：Network key index。

P4：Application key index.
</syntaxhighlight>

== blemesh_simple ==
该demo的功能与上述的一致，但是该demo不需要前置的命令操作，在板子上电后会自动启动 blue mesh 网络，你可以参考blemesh_cli中的连接步骤直接进行节点连接。

如果你需要发送指令来控制，你可以发送以下指令：

"gen_cli_send dstaddress"将控制数据发送到指定的设备地址或这组地址。

== btble_cli ==
该demo会启动一个基本的BLE设备。你需要使用命令去进行操控该设备。

如果您不熟悉BLE的通信流程，请参考以下基本流程。<syntaxhighlight lang="bash" line="1">
#服务端执行
ble_init
ble_start_adv 0 0 0x80 0x80

#客户端设备执行
ble_start_scan 0 1 0x80 0x50

#scan后会获取到对应的地址进行连接这里是示例地址
#连接成功后服务端的终端会显示 connected
ble_connect 0 B40ECF2E90FC

#查询GATT服务这里是通用服务码
ble_discover 0 0x1800 0x1 0xffff 或者 ble_discover 0 0x1801 0x1 0xffff

#如果要查询特殊码（这里可以省略这一步）
ble_discover 3 0x1800 0x1 0xffff

#查询到服务后，可以选择直接读写：
ble_read 0x7 0
ble_write 0x7 0 2 0102

#也可以通过CCC进行订阅操作
ble_subscribe 0x4 0x3 0x1
#取消订阅：
ble_unsubscribe

</syntaxhighlight>''<big>上述的函数相关具体说明，全部保存在SDK的路径下： docs/en/api_reference/ble.rst</big>''

=== '''BLE基本通信流程：''' '''GATT服务是什么：''' ===
[[文件:BLE.png|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:BLE.png|左|450x450像素]]
[[文件:GATT.png|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:GATT.png|居中|450x450像素]]
CCC则是一个订阅开关，本质上是一个数值，服务端会监控这个数值，假设该数值变化了，那么服务端则认为连接设备需要订阅消息。

== btble_controller_test ==
BLE控制器测试demo,终端返回 pwr_mod is bf 则表示正常。

== btble_central ==
该demo上电后会直接自动扫描周围的BLE设备，当设备存在并且名称匹配时，会直接进行连接并扫描对应的GATT服务然后进行订阅。

设备名称，GATT服务等都是程序提前设定好的，这部分设定在同级目录下的 config.h 文件中。

这里展示一部分：<syntaxhighlight lang="bash" line="1">
#endif

/**
* CONFIG_BT_DEVICE_NAME:Bluetooth device name. Name can be up
* to 248 bytes long (excluding NULL termination). Can be empty string
*/
#ifndef CONFIG_BT_DEVICE_NAME
#if defined(CONFIG_AUTO_PTS)
#define CONFIG_BT_DEVICE_NAME "AUTO_PTS_TEST0123456789012345"
#else
#if defined(BL602)
#define CONFIG_BT_DEVICE_NAME "BL602-BLE-DEV"
#elif defined(BL702)
#define CONFIG_BT_DEVICE_NAME "BL702-BLE-DEV"
#elif defined(BL702L)
#define CONFIG_BT_DEVICE_NAME "BL702L-BLE-DEV"
#else
#define CONFIG_BT_DEVICE_NAME "BTBLE-DEV"
#endif
#endif
#endif
/**
</syntaxhighlight>

== btble_periphral ==
该demo测试了BLE的OAD服务，上电后会直接执行GATT的OAD服务注册，然后进行广播，所有了连接上该服务端的设备订阅OAD服务都可以进行OAD远程升级。

注意这部分代码需要分区表，所以在烧录时必须进行 make whole 将分区表信息烧录进去。

OAD烧录的固件需要手动生成：<syntaxhighlight lang="bash" line="1">
#其中FW.bin 是你要进行升级的bin
python3 components/wireless/bluetooth/tools/GenerateOAD.py FW.bin FW.bin.sha256

</syntaxhighlight>

Demo:Btble

2025-07-29T09:07:15Z

武楷轩：

== Demo介绍： ==
'''这部分Demo主要是蓝牙通讯相关功能的实例代码，这些demo保存在SDK的 example/btble路径下。'''

== blemesh_cli: ==

=== 基本介绍： ===
该demo创建了一个 Bluetooth mesh 网络，通过向串口发送指令进行初始化后，就可以通过手机APP在mesh网络中进行添加并连接。

DEMO命令和输出：<syntaxhighlight lang="bash" line="1">
bouffalolab />blemesh_init #初始化bluemesh网络
#输出：
Init successfully
Env[LOCAL_NAME] Data len[10], setting_env_cb
Use pb-adv or pb-gatt to enable advertising

bouffalolab />blemesh_pb 2 1
#输出：
PB-GATT enabled

</syntaxhighlight>执行完上述命令后，就可以使用手机APP进行NODE的添加和连接。

添加的步骤如下：<gallery>
文件:APPopen.png|step1
文件:Meshnode2.png|step2
文件:Meshnode3.png|step3
文件:Meshnode4.png|step4
文件:Meshnode5.png|step5
文件:Meshnode6.png|ste6
文件:Meshnode7.png|step7
文件:Meshnode8.png|step8
文件:Meshnode9.png|step9
文件:Meshnode10.png|step10
文件:Meshnode11.png|step11
文件:Meshnode12.png|step12
文件:Meshnode13.png|step13
</gallery>

=== 如何使用配网器 Provisioner 将新设备添加进网络中： ===
大概流程如下：

'''1.打开未配网设备 ---- 2.启动配网器Provisioner ---- 3.监听设备广播 ---- 4.添加设备到网络 ---- 5.获取设备信息 ---- 6.分配密钥'''

provisioner设备编译时，必须更改一个编译选项：

CONFIG_BT_MESH_PROVISIONER=1

==== 执行步骤1：打开未配网设备并且输入以下命令： ====
<syntaxhighlight lang="bash" line="1">
blemesh_init # 初始化Mesh协议栈
blemesh_pb 1 1 # 开启PB-ADV和PB-GATT配网承载
</syntaxhighlight>

==== 执行步骤2：打开配网器设备输入以下命令： ====
<syntaxhighlight lang="bash" line="1">
bouffalolab />blemesh_pvnr_init #初始化Provisioner
#得到输出：
.........
Local node provisioned, net_idx 0x0000 address 0x0001

Network key:8fe7deea92943001567251dc1f9b0f03

Dev key:89c2f18f9f286661c6bbb1430d7aadb7

Provisioning completed
</syntaxhighlight>

* <code>net_idx 0x0000</code>：网络索引
* <code>address 0x0001</code>：Provisioner自身地址
* <code>Network key</code>：网络层加密密钥
* <code>Dev key</code>：设备专属配置密钥

==== 执行步骤3：打开广播 ====
执行以下命令：
blemesh_beacon_listen 0x01 # 开启广播监听

* 扫描周围广播Mesh信标的设备
* 捕获并显示未配网设备的UUID（如：<code>07af000011112222333318b905de96c2</code>）
* UUID包含设备身份信息（厂商ID、产品ID等）

==== 执行步骤4：在配网器设备上执行添加设备到网络命令 ====
<syntaxhighlight lang="bash" line="1">
bouffalolab />blemesh_provision_adv 07af000011112222333318b905de96c2 0 3 0
#输出
P1：“07af000011112222333318b905de96c2" is UUID information.
P2：0：net_idx
P3：3： assign node unicast address。
P4：0：attention_duration
</syntaxhighlight>

* <code>UUID</code>：目标设备的唯一标识
* <code>net_idx 0</code>：使用的网络索引
* <code>address 3</code>：分配给设备的单播地址(0x0003)
* <code>attention_duration 0</code>：配网指示时长（0=无提示）

==== 执行步骤5：获取设备信息 ====
执行的命令与输出内容：<syntaxhighlight lang="bash" line="1">
bouffalolab /> blemesh_get_comp 0x0000 0x0003 0x00
#输出：
P1：net index.

P2：dst address.

P3：page number.
</syntaxhighlight>

* <code>net_idx 0x0000</code>：网络索引
* <code>dst 0x0003</code>：目标设备地址
* <code>page 0x00</code>：组成数据页码

==== 执行步骤6：分配密钥key ====
<syntaxhighlight lang="bash" line="1">
bouffalolab /> blemesh_app_key_add 0x0000 0x0003 0x0000 0x0000
#输出
P1：net index.

P2：dst address.

P3：Network key index。

P4：Application key index.
</syntaxhighlight>

== blemesh_simple ==
该demo的功能与上述的一致，但是该demo不需要前置的命令操作，在板子上电后会自动启动 blue mesh 网络，你可以参考blemesh_cli中的连接步骤直接进行节点连接。

如果你需要发送指令来控制，你可以发送以下指令：

"gen_cli_send dstaddress"将控制数据发送到指定的设备地址或这组地址。

== btble_cli ==
该demo会启动一个基本的BLE设备。你需要使用命令去进行操控该设备。

如果您不熟悉BLE的通信流程，请参考以下基本流程。<syntaxhighlight lang="bash" line="1">
#服务端执行
ble_init
ble_start_adv 0 0 0x80 0x80

#客户端设备执行
ble_start_scan 0 1 0x80 0x50

#scan后会获取到对应的地址进行连接这里是示例地址
#连接成功后服务端的终端会显示 connected
ble_connect 0 B40ECF2E90FC

#查询GATT服务这里是通用服务码
ble_discover 0 0x1800 0x1 0xffff 或者 ble_discover 0 0x1801 0x1 0xffff

#如果要查询特殊码（这里可以省略这一步）
ble_discover 3 0x1800 0x1 0xffff

#查询到服务后，可以选择直接读写：
ble_read 0x7 0
ble_write 0x7 0 2 0102

#也可以通过CCC进行订阅操作
ble_subscribe 0x4 0x3 0x1
#取消订阅：
ble_unsubscribe

</syntaxhighlight>''<big>上述的函数相关具体说明，全部保存在SDK的路径下： docs/en/api_reference/ble.rst</big>''

'''BLE基本通信流程：''' '''GATT服务是什么：'''
[[文件:BLE.png|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:BLE.png|左|450x450像素]]
[[文件:GATT.png|链接=https://docs.bouffalolab.com/%E6%96%87%E4%BB%B6:GATT.png|居中|450x450像素]]
CCC则是一个订阅开关，本质上是一个数值，服务端会监控这个数值，假设该数值变化了，那么服务端则认为连接设备需要订阅消息。

== btble_controller_test ==
BLE控制器测试demo,终端返回 pwr_mod is bf 则表示正常。

== btble_central ==
该demo上电后会直接自动扫描周围的BLE设备，当设备存在并且名称匹配时，会直接进行连接并扫描对应的GATT服务然后进行订阅。

设备名称，GATT服务等都是程序提前设定好的，这部分设定在同级目录下的 config.h 文件中。

这里展示一部分：<syntaxhighlight lang="bash" line="1">
#endif

/**
* CONFIG_BT_DEVICE_NAME:Bluetooth device name. Name can be up
* to 248 bytes long (excluding NULL termination). Can be empty string
*/
#ifndef CONFIG_BT_DEVICE_NAME
#if defined(CONFIG_AUTO_PTS)
#define CONFIG_BT_DEVICE_NAME "AUTO_PTS_TEST0123456789012345"
#else
#if defined(BL602)
#define CONFIG_BT_DEVICE_NAME "BL602-BLE-DEV"
#elif defined(BL702)
#define CONFIG_BT_DEVICE_NAME "BL702-BLE-DEV"
#elif defined(BL702L)
#define CONFIG_BT_DEVICE_NAME "BL702L-BLE-DEV"
#else
#define CONFIG_BT_DEVICE_NAME "BTBLE-DEV"
#endif
#endif
#endif
/**
</syntaxhighlight>

== btble_periphral ==
该demo测试了BLE的OAD服务，上电后会直接执行GATT的OAD服务注册，然后进行广播，所有了连接上该服务端的设备订阅OAD服务都可以进行OAD远程升级。

注意这部分代码需要分区表，所以在烧录时必须进行 make whole 将分区表信息烧录进去。

OAD烧录的固件需要手动生成：<syntaxhighlight lang="bash" line="1">
#其中FW.bin 是你要进行升级的bin
python3 components/wireless/bluetooth/tools/GenerateOAD.py FW.bin FW.bin.sha256

</syntaxhighlight>

文件:GATT.png

2025-07-29T07:00:25Z

武楷轩：

。

文件:BLE.png

2025-07-29T06:57:46Z

武楷轩：

通信大致宏观流程

用户:武楷轩

2025-07-28T07:39:55Z

武楷轩：

This is kxwu.

用户:武楷轩

2025-07-28T07:39:20Z

武楷轩：创建页面，内容为“this is kxwu”

this is kxwu

Demo:wifi sta

2025-07-23T07:37:22Z

武楷轩：

=== 基本介绍： ===
该系列demo存放在SDK 的路径为：bouffalo_sdk/examples/wifi/sta 。

该系列代码需要将开发板作为STA节点连接到WiFi或者路由器后进行一些基本的通讯数据功能性测试。

以下该系列demo的基本功能说明。

=== MQTT相关Demo说明： ===

==== wifi_mqtt_pub： ====
该demo将开发板作为mqtt中的publisher,向节点内发布主题信息。

要测试该节点需要以下前置：

1.建立一个mqtt服务器

2.使用mqttbox或者其他相关工具从服务器上订阅对应的主题。

3.可以向串口发送指令。

建议本地下载mosquito,在本地搭建一个mqtt服务器，或者使用emqX公用服务器。该案例的defult server是：`test.mosquitto.org:1883`

向串口发送指令连接WIFI并订阅：<syntaxhighlight lang="bash" line="1">
wifi_sta_connect your_wifi_id your_passwd

mqtts_pub $local_ip 8883 #mqtt_pub 如果不带参数会默认发送到上述的公有服务器

#会得到以下输出：

bouffalolab />mqtt_pub is ready to begin publishing the time.
Press ENTER to publish the current time.
Press CTRL-C to exit.
mqtt_pub published : "{"hello mqtt by bl616/8 !"}
Now time is 2023-06-16 00:00:00"
mqtt_pub published : "{"hello mqtt by bl616/8 !"}
Now time is 2023-06-16 00:00:03"
mqtt_pub stop publish to test.mosquitto.org
</syntaxhighlight>订阅方会受到当前时间的字符串。

==== wifi_mqtt_sub: ====
和上述一样，但是该案例是submiter ，也就是消息订阅方。

前置条件：同上。

同样向串口发送指令来验证：<syntaxhighlight lang="bash" line="1">
bouffalolab />wifi_sta_connect your_wifi_id your_pwd
bouffalolab />mqtt_sub your_server <port>

#得到输出

bouffalolab />mqtt_sub listening for '<theme>' messages.
Press CTRL-C to exit.
Received publish('<theme>'): {"hello mqtt"}
Received publish('<theme>'): {"hello mqtt"}
mqtt_sub disconnecting from xxx.your_server
</syntaxhighlight>

==== MQTTS功能： ====
'''上述的两个Demo现已支持TLS加密功能'''，该加密使用'''TLS1.2'''加密套件，未验证 CN name。

开启MQTT的选项在对应文件夹中的CmakeList中：<syntaxhighlight lang="makefile" line="1">
cmake_minimum_required(VERSION 3.15)

include(proj.conf)

find_package(bouffalo_sdk REQUIRED HINTS $ENV{BL_SDK_BASE})

# User
sdk_add_compile_definitions(-DCONFIG_CLI_CMD_ENABLE)
# sdk_add_compile_options(-DMQTT_USE_CUSTOM_SOCKET_HANDLE)
# sdk_add_compile_definitions(-DMBEDTLS_PK_PARSE_C)

sdk_add_compile_options(-DMQTT_USE_MBEDTLS) #注释该行则不启用TLS加密，否则加密。

target_sources(app PRIVATE
wifi_mqtt_pub.c)

sdk_add_include_directories(.)

sdk_set_main_file(main.c)

project(wifi_mqtt_publisher)

</syntaxhighlight>

==== 其中的CA证书，密钥等具体为： ====
<syntaxhighlight lang="bash" line="1">
#ca.crt：
-----BEGIN CERTIFICATE-----
MIIDwzCCAqugAwIBAgIUT2Cy6wsGGycw6WvNoHot5I+GlTQwDQYJKoZIhvcNAQEL
BQAwcTELMAkGA1UEBhMCQ04xEDAOBgNVBAgMB0JlaWppbmcxEDAOBgNVBAcMB0Jl
aWppbmcxDzANBgNVBAoMBk15IE9yZzEWMBQGA1UECwwNQ0EgRGVwYXJ0bWVudDEV
MBMGA1UEAwwMTVFUVCBSb290IENBMB4XDTI1MDcxNzEwMzU1MVoXDTM1MDcxNTEw
MzU1MVowcTELMAkGA1UEBhMCQ04xEDAOBgNVBAgMB0JlaWppbmcxEDAOBgNVBAcM
B0JlaWppbmcxDzANBgNVBAoMBk15IE9yZzEWMBQGA1UECwwNQ0EgRGVwYXJ0bWVu
dDEVMBMGA1UEAwwMTVFUVCBSb290IENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A
MIIBCgKCAQEAzMguxj26xEFb1N5u6slSgEp62eak+dqkmq6BoxVW48V2GO62caCt
n7MZywknnKm1sFM9kOv/mdr4fjHF3ZhvZ4MCqu0EPy2crjROoV8ofsjMDoIp2PSh
VZ7wmDC5zu7ndCMX85C/vv3Ikows5sMr/r6Ieh7lgoLeXTFDbGixLM3u1vB2I/OQ
gepYnPVkUHmEWsRFtzwwBgbAkSlmf3UreCT/lDbcOsKGl3YY4PZtJjk3wwtJqLAE
M/dNJdleU9ENwwelotScu4CGex+OaPNfn1EwLgwBrX2FByYyfpw+DUTnhdXsPbGM
jly24NUcg7CavTJxow5ltuWLahN5oQZZ4wIDAQABo1MwUTAdBgNVHQ4EFgQUGIBW
MZwM5z40nEZde/GSQxszsDEwHwYDVR0jBBgwFoAUGIBWMZwM5z40nEZde/GSQxsz
sDEwDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAAOCAQEALp0qj9qWnc9l
9GWivdOHVSfIHWWuTUN7+2QXGEHZ7vyC6dPoMNvr0Wg35Wj3VLbmZm6vlIubQ0JW
3nt5Kru9Keh/BALAxFa6onRVdYahXWRzD1fjTMUfIpDjaRtFWE6luA3ztfj2ZtiL
q665MZulKQLFhIQeAXNfR7hpxaiR+qu5YVYvWQN7gigjB787Y+JUk+h3rnlZ5vPX
j/yf9BP2u9tK1VkF2Ir1c+Y0xcp0qomd25QOm0H/qwgEh5wnO3du8GrTS5WMlYq1
LJSLM7dmBKgvTPngAgewFiwNPyhtywM6Vdc/mrcNwqAcfmyV0U8oU/DReKbX4ed2
+zlke05LKA==
-----END CERTIFICATE-----

#ca.key：
-----BEGIN PRIVATE KEY-----
MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDMyC7GPbrEQVvU
3m7qyVKASnrZ5qT52qSaroGjFVbjxXYY7rZxoK2fsxnLCSecqbWwUz2Q6/+Z2vh+
McXdmG9ngwKq7QQ/LZyuNE6hXyh+yMwOginY9KFVnvCYMLnO7ud0IxfzkL++/ciS
jCzmwyv+voh6HuWCgt5dMUNsaLEsze7W8HYj85CB6lic9WRQeYRaxEW3PDAGBsCR
KWZ/dSt4JP+UNtw6woaXdhjg9m0mOTfDC0mosAQz900l2V5T0Q3DB6Wi1Jy7gIZ7
H45o81+fUTAuDAGtfYUHJjJ+nD4NROeF1ew9sYyOXLbg1RyDsJq9MnGjDmW25Ytq
E3mhBlnjAgMBAAECggEAJTvQpWLb7osjs1SuPipUwdbI942kOXmzrBxGnexnXAqv
KmFc8tQQPZVG/0+u0CFbU7AO5abDVqolvGw4Wc45k0yS05k8yG/2qQYBtf2jU0oX
MBwil7wDCZpYjJNvdVyi4M7wr+yFsKhcK6kpENwzx6HFFs8/U7ePzsoCRFfUvxxu
26rKP0rF5168DCTn8UMyYqEdPQ9MOD2xI6hPsJVelqu7eWRXAWrFgVH5L+xgd0mH
MhtidnvayrUKt5eE+FifZN9QK2rgJ9lppGw9bPANSOQ+K1O7F+HIOwSCXCD2hM2t
bHaQfeLfOeu32MlOMcGQIcQGqwWpI9XHWQBJO9OcgQKBgQD5azAYDJL/jRxaN4o+
1QXOBRuimKNT4XDDyoPA0j6uwcXQa6LbhxPAack2ocyXm4O+g/wySiO/tnPoaNUH
WGppGdnGuqX+JAK/35GsNb30BCXb0Gkz/bijTSm3fNKg63ZTREZlJ/KTH8/4bM+p
B6FIO2g+oREjvVI6pRlBiLF70wKBgQDSL3nGHRzo6FSUjGmZBJ9f7koylYT7QuE8
mLoHG4fMoYaVDZk8eY10Xc9gL79aO4Uf98N004qbfL5QcbCgi5DBwrrIE1eInq0Y
CNKtfySzg2sdCG8Ex3fhtZZyOljlc4bckTj4gmGgCuNUDhPo+k2roskSoXo0G3T/
gFLFHJwvsQKBgG3UqIH+j4Ce59xGVsciUQMOtsObyVg3jst40xnGuzmDNJN5wmY/
DhCNxMAc8ZXVMmdjgVu30BQsyM+P0jcA1SLg8kgTiuLlgpxxW5lktPfOF8m69Yii
cnrekL8u5SVdamZySzliJOxqds8jQzJgnMHM/zONA5okVSBj8UItalJnAoGBAM8F
8hSfwkTp6b0zHCOauPv9MlnmicgOVNmhuMGdbUGx62ROs5ssQpbWe5bLENfofjRB
juQ4JHMICFAl2woWzar7iYvd+T7Yw7dDoXdAHz8td0hucSMs8TiA6kFylPLTuobw
B0RG7696afT1tMiqGeyvdwuBv2MplDDBDUWW64PRAoGAXmCqgu4AgKDrg/BsKCH3
070IxOXc+7tVdESmWyexDyNUfBCF+6Kowl1Kw3IgIcywA19sKK2msykyIy0Om+rM
EaZfHaspt9srWNlzDsPy6nV5dkXZcSezKVXxJgriDk46sPlEBNKGrYPbNmSYpvrY
NKgGQaYrJ5ixe1aEARcF2CE=
-----END PRIVATE KEY-----

#server.crt：
-----BEGIN CERTIFICATE-----
MIID6zCCAtOgAwIBAgIUYSb6OOUA1AaPPfdB/QhCrJFxYfIwDQYJKoZIhvcNAQEL
BQAwcTELMAkGA1UEBhMCQ04xEDAOBgNVBAgMB0JlaWppbmcxEDAOBgNVBAcMB0Jl
aWppbmcxDzANBgNVBAoMBk15IE9yZzEWMBQGA1UECwwNQ0EgRGVwYXJ0bWVudDEV
MBMGA1UEAwwMTVFUVCBSb290IENBMB4XDTI1MDcyMjA2MDk0MVoXDTI2MDcyMjA2
MDk0MVowazELMAkGA1UEBhMCQ04xEDAOBgNVBAgMB0JlaWppbmcxEDAOBgNVBAcM
B0JlaWppbmcxDzANBgNVBAoMBk15IE9yZzENMAsGA1UECwwETVFUVDEYMBYGA1UE
AwwPMTkyLjE2OC4xNTMuMTE0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
AQEAm1NDiGRlGbUKX938s9HFrTyprJ4fhjHgmVZuqy0Hj5jX5Wvq7iPDXQHUuStN
9rIMB31K8h8gBfTbWTALQnL/p5urvBACvLI8J3BEz8pweq61sUeqBNGFO8YnxRou
vRPUeel9zg4GbLIf4T6BfwKtgMoqX/ROnnUiuE8sdo/KCreB5we+ZriP+jS1gVSQ
NMiJFXbo08aEV8WefuQnTegjgooEbFpeq7dtHXKiDiHW5LUCj6TUGh1DcKVvlSTa
ur7SMCvADT0W4Mp8Q9VXFCGwJugwy6pmtOqnPHEEBxs+1EGX22XeGS6ccP5HH2bm
yJ1gSLI+yt0r+T0cMTsoeBR2EQIDAQABo4GAMH4wCQYDVR0TBAIwADALBgNVHQ8E
BAMCBaAwEwYDVR0lBAwwCgYIKwYBBQUHAwEwDwYDVR0RBAgwBocEwKiZcjAdBgNV
HQ4EFgQUW7r5PWIFPiDa1RcxhUUcMwMID3wwHwYDVR0jBBgwFoAUGIBWMZwM5z40
nEZde/GSQxszsDEwDQYJKoZIhvcNAQELBQADggEBAKWlIJWaDzhhbBy9ftUkGIis
EDjMvmLnkFchFFNAOWZq1yBujf3K0KqcmdgKfSearMQrK/YTHR1a39P21BSqnRpk
dfNZfiVvRkJAcdY9SgderklUmPoY9huxumtGEPDtrkxkyuhgpk7/9YyavgyMCMdd
cFIwdeBUEHPhHLw8TlhVT1UotClKbhjyRHOMrpfWXVnsa+U/UrPeqGn8uL49XPH4
9DqzKZPSZaPxNoAj0iHvo+7RvEl5jy+ixwRgnvdOsDteRwFFW0Kxd4Ccn4QKEgTY
chx6XC0/a2Lg8KwxZbmDGoj4sqJ3PltuG8GZB6Vdv0FJnjAK6cZAQE0Hyclhhbs=
-----END CERTIFICATE-----

#server.key：
-----BEGIN PRIVATE KEY-----
MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCbU0OIZGUZtQpf
3fyz0cWtPKmsnh+GMeCZVm6rLQePmNfla+ruI8NdAdS5K032sgwHfUryHyAF9NtZ
MAtCcv+nm6u8EAK8sjwncETPynB6rrWxR6oE0YU7xifFGi69E9R56X3ODgZssh/h
PoF/Aq2Ayipf9E6edSK4Tyx2j8oKt4HnB75muI/6NLWBVJA0yIkVdujTxoRXxZ5+
5CdN6COCigRsWl6rt20dcqIOIdbktQKPpNQaHUNwpW+VJNq6vtIwK8ANPRbgynxD
1VcUIbAm6DDLqma06qc8cQQHGz7UQZfbZd4ZLpxw/kcfZubInWBIsj7K3Sv5PRwx
Oyh4FHYRAgMBAAECgf8CjFso4a/6ImSix5sqi0Z/xEvRIsb7OW/cR1uJc2bfjdWW
h5Uf7Kl7EFltFq8ww1SiZGvWWd+TBj4sntBdRrjrBwkwpkXLn4ddHkc17k+Ds8B6
jn87lQE0LQwTlicuJiUjDhgCSWvRj+dcZEO7noLTzUoX4oPOFbd8G2oFuyL71s0l
4jO2poU42qsOxgBd2XIxePUc320/2a7Y0rABZJMLVx24oRzHqCLhyhRneqoqar0P
1hmS2tMeEr66db8U6Fr7J+P1SVt0KFSdrvEYCDHTCVf0TAZ25vYT69VznZGSok4U
YQkBQiFFuyGXLgiRfrX/aL7rYxj2KBRAbce/lUECgYEAyx1coRA+FyptMZLWh7ny
QSSq25/J7K+TPUMefIKFtKCmBRHg6gWu9YbTimXIOoq7l51xI+YT02VnEqjn9ToR
vkUlNRyHBzsDt2VQTH+00Slo0tn4NS9Sb8uMezHiUgKGjiQWPQqwzUG4ToG2cYkj
8+vcxyHK5CWkWEVjh/1sRRkCgYEAw8R9Zqic+nv+9wRV219bmqyeSw2SkDXIyQSM
tUBjqZHB1wh3Z+Tc0KdYSM9tymEwBJ5mx/nYxxF3gWXW0K4kuS1jtMFZscNaA2/1
VRweVXWBUlC/oZY1IEdLchtcQt3CfLIwQIKyikPwax0EU9YfQiTAiDNCAdBNJPF0
J/bMn7kCgYEAiBWbCxp7zz+Qu0cbTwJpafXsN4ueWWLlLoV6tocol/WOZhUtcP3v
0/bKYo6BEaADwbgtppSvMdJdtaXPC4ElhCqFnEkJuvFyMvzBSQ/DEORCpAp//vo+
rEJfU+b/MF0a078f2zP/cvYWSxsjJnxwxyt+1zgv3J3Pt4h+AA3t7XkCgYEAnCJh
VXgTQx+T2RUHGOBz4efck8VuaD/NNK3BP2nsUriiXcst2JnKl0tweRme2fMrZfOj
y8hz4UkIBBbh/it1tI8D34z56XIBn44yn7++XbBLBQjL3ac8FdNm08oIinftfqBr
JXhXxziqTfOlmOvEoG9JcxdWhLXKYTWFy73ls1kCgYEAsrPcSpF8Ce3r+izDW2TM
2M4arK3T7hcMItLAQQoLO7RCYIivgQQE0WV9BmbC0fVTkptDMfks5s7QcU/6vzqC
zPx0NowGnabNWS1vsXD4QyoOyV3gqfVhM46cWbRhxtRmMo/LGuJ8rXnHY3bgF5va
VJlSyLW96jWK9neR0QOTKM4=
-----END PRIVATE KEY-----

</syntaxhighlight>将对应的证书和密钥保存到文件中，放在mosquitto的路径下。'''注意要将这些文件的所属组归给mosquitto.'''

然后修改mosquito的配置文件，该文件储存在 /etc/mosquitto/mosquitto.conf 中，配置如下：<syntaxhighlight lang="bash" line="1">
# Place your local configuration in /etc/mosquitto/conf.d/
#
# A full description of the configuration file is at

log_dest file /var/log/mosquitto/mosquitto.log

listener 8883
tls_version tlsv1.2
cafile /etc/mosquitto/certs/ca.crt
certfile /etc/mosquitto/certs/server.crt
keyfile /etc/mosquitto/certs/server.key

listener 1883
allow_anonymous true
</syntaxhighlight>'''mosquitto的测试命令：'''<syntaxhighlight lang="bash" line="1">
#测试sub是否能收到信息
mosquitto_pub -h localhost -p 8883 -t bl618 -m "aaa" --cafile ca.crt --insecure

#测试pub是否能推送信息
mosquitto_sub -h localhost -p 8883 -t bl618 --cafile ca.crt --insecure
</syntaxhighlight>

=== HTTP与HTTPS相关demo说明： ===

==== wifi_http: ====
该demo会向网络服务器发送请求，根据返回结果判断http请求功能是否正常。

前置条件为：一个可共上网的wifi,可以向串口发送指令。<syntaxhighlight lang="bash" line="1">
bouffalolab />wifi_sta_connect your_wifi your_pwd
bouffalolab />wifi_http_test www.xxx.com

#以下为输出

bouffalolab />Http client task start ...
Host:www.xxx.com, Server ip Address : the ip of websit server
Http client connect server success!
Press CTRL-C to exit.
HTTP/1.1 200 OK
</syntaxhighlight>

==== wifi_https: ====
该demo会自动发加密数据到www.baidu.com，根据结果判断加密功能是否正常

前置条件：同上<syntaxhighlight lang="bash" line="1">
bouffalolab />wifi_https_test
bouffalolab />dst_addr is 842C9824

#以下为输出
[I: 124359488][bl_https.c:126] HTTP/S> bouffalo connect fd = 0x62fd0dc0
[I: 124377783][bl_https.c:136] HTTP/S> ret = -28
[I: 124598639][bl_https.c:156] HTTP/S> ret = 0
[I: 124598987][bl_https.c:160] HTTP/S> total time:471 ms
[I: 124679688][bl_https.c:168] HTTP/S> rcv_ret = 1179
[I: 124680077][bl_https.c:172] HTTP/S> proc_head_r 0, status_code 200, body_start_off 400
[I: 124680533][bl_https.c:180] HTTP/S> Copy to resp @off 0, len 779, 1st char 3C
bl_TcpSslDisconnect end
[I: 124683390][bl_https.c:264] HTTP/S> total time:555 ms
[I: 124683715][bl_https.c:265] HTTP/S> test_1: status_code 200, resp_len 779
[I: 124684395][bl_https.c:267] HTTP/S> resp body: <!DOCTYPE html>
<html> <head><meta http-equiv=content-type content=text/html;charset=utf-8><meta http-equiv=X-UA-Compatible content=IE=Edge><meta content=always name=referrer><link rel=stylesheet type=text/css href=https://ss1.

</syntaxhighlight>如果你想要更改测试服务器目标，可以在https.c源码中添加test,或者直接更改这部分代码：<syntaxhighlight lang="c" line="1">
static void test_1(void)
{
const char *host = "www.baidu.com";
const uint8_t send_buf[] = "GET / HTTP/1.1\r\n"
"Host: www.baidu.com\r\n"
"User-Agent: curl/7.58.0\r\n"
"accept: application/json\r\n"
"\r\n";
uint8_t *buf;
int resp_len;
int status_code;

buf = malloc(16 * 1024);
if (NULL == buf) {
LOG_E("malloc\r\n");
return;
}

resp_len = 16 * 1024;

uint32_t start_time = 0, stop_time = 0;
start_time = xTaskGetTickCount();
status_code = https_request(host, 443, send_buf, sizeof(send_buf) - 1, buf, &resp_len);
stop_time = xTaskGetTickCount();

LOG_I("total time:%d ms\r\n", (stop_time - start_time));
LOG_I("test_1: status_code %d, resp_len %d\r\n", status_code, resp_len);
buf[resp_len] = '\0';
LOG_I("resp body: %s\r\n", buf);

free(buf);
}
</syntaxhighlight>上述函数被调用用来执行测试，更改该部分代码可以实现更改测试目标的目的。

=== TCP的Demo说明： ===

==== wifi_tcp: ====
该部分代码编写了一个server.c和一个client.c,分别用于测试TCP服务端测试和客户端测试。

前置条件：PC端和开发板共同在一个局域网内，可以向串口发送指令。

使用picocom工具在串口中执行指令。

server测试：<syntaxhighlight lang="bash" line="1">
bouffalolab />wifi_sta_connect your_wifi_id your_wifi_pwd
bouffalolab />wifi_tcp_echo_test 3365

#服务器建立成功

bouffalolab />tcp server task start ...
Server ip Address : 0.0.0.0:3365

# 执行 nc -v ipaddr port 连接板子的tcp服务器

new client connected from (192.168.1.2, 57480)
Press CTRL-C to exit.
recv 7 len data
</syntaxhighlight>client测试：<syntaxhighlight lang="bash" line="1">

#首先执行 nc -l -p 3365 在本地架起一个服务器

bouffalolab />wifi_sta_connect BL_TEST 12345678
bouffalolab />wifi_tcp_test localip 3365

#输出

bouffalolab />tcp client task start ...
Server ip Address : 192.168.1.2:3365
TCP client connect server success!
Press CTRL-C to exit.
</syntaxhighlight>

=== UDP的demo说明： ===
该部分代码将使用开发板作为sta节点连接wifi并且架起一个udp服务器。

前置条件：PC端和开发板在同一个局域网内，可以向串口发送指令。

测试过程：<syntaxhighlight lang="bash" line="1">
#连接开发板终端并发送指令

bouffalolab />wifi_sta_connect your_wifi_id 12345678
bouffalolab />wifi_udp_echo 3365
bouffalolab />udp server task start ...

#服务其成功架起输出
ip Address : ip:3365
udp bind port success!
Press CTRL-C to exit.

#在PC端执行 nc -u server_ip server_port
#直接发送 1234567890

#成功接受到数据
recv from 192.168.1.2
recv:X
recv from 192.168.1.2
recv:X
recv from 192.168.1.2
recv:X
recv from 192.168.1.2
recv:X
recv from 192.168.1.2
recv:1234567890
</syntaxhighlight>

=== OTA的demo说明： ===

==== wifi_ota： ====
该部分代码测试了基本tcp升级固件，使用pc端作为服务器，在同一局域网下，通过命令使得开发板连接ota服务器，接收固件包。

用于测试的固件包被放在了编译出的 build/build_out 目录下。

前置条件：PC端和开发板在同一个局域网内，可以向串口发送指令。

测试过程：<syntaxhighlight lang="bash" line="1">
#该程序需要分区表，所以在编译之后需要执行make whole来烧录whole bin
make whole
cd build/build_out
cat wifi_ota_bl616.bin.ota | nc -nvl 3365 #在pc端架服务器并发送固件

#向串口发送指令连接WiFi并连接服务器开始测试
bouffalolab />wifi_sta_connect your_ssid your_passwd
bouffalolab />wifi_ota_test PC_ip_addr 3365

#收到以下回复则表示测试成功
[STA CONSOLE] Calculated SHA256 Checksum:9F5EA3181316DA72589CD4CB0702AA25ED3094F7BED2B5898187044A0A01A077
[STA CONSOLE] Header SET SHA256 Checksum:9F5EA3181316DA72589CD4CB0702AA25ED3094F7BED2B5898187044A0A01A077
[STA CONSOLE] [OTA] [TCP] prepare OTA partition info
[STA CONSOLE] [OTA] [TCP] Update PARTITION, partition len is 804560
reboot
[STA CONSOLE] [OTA] [TCP] Rebooting
[STA CONSOLE] dynamic memory init success, ocram heap size = 263 Kbyte
</syntaxhighlight>该源码可以支持配置自动连接WIFI,可以修改源码中的该部分内容：<syntaxhighlight lang="c" line="1">#define AUTO_CONNECT_WIFI (0)

/****************************************************************************
* Private Types
****************************************************************************/

/****************************************************************************
* Private Data
****************************************************************************/

struct bflb_device_s *gpio;
static struct bflb_device_s *uart0;

static TaskHandle_t wifi_fw_task;
#if AUTO_CONNECT_WIFI
struct bflb_device_s *wdg;
static TaskHandle_t ota_task_handle;
#endif
static wifi_conf_t conf = {
.country_code = "CN",
};

#if AUTO_CONNECT_WIFI
// clang-format off
/* config your wifi ssid and password */
static const uint8_t wifi_sta_connet[] = "wifi_sta_connect H3C_21A0AD\r";
/* config your ota server and port */
static const uint8_t wifi_ota_test[] = "wifi_ota_test 192.168.123.120 3365\r";
/* reboot command */
// static const uint8_t send_buf1[] = "reboot\r";
// clang-format on

extern Ring_Buffer_Type shell_rb;
extern void shell_release_sem(void);

SemaphoreHandle_t sem_wifi_init_done;
SemaphoreHandle_t sem_wifi_connect_done;
SemaphoreHandle_t sem_wifi_disconnect;
#endif</syntaxhighlight>将宏定义 AUTO_CONNECT_WIFI 设定为1,并修改 wifi_sta_connect[] wifi_ota_test[] 字符串为你的对应命令即可。

Demo:wifi sta

2025-07-23T07:25:04Z

武楷轩：添加MQTTS

=== 基本介绍： ===
该系列demo存放在SDK 的路径为：bouffalo_sdk/examples/wifi/sta 。

该系列代码需要将开发板作为STA节点连接到WiFi或者路由器后进行一些基本的通讯数据功能性测试。

以下该系列demo的基本功能说明。

=== MQTT相关Demo说明： ===

==== wifi_mqtt_pub： ====
该demo将开发板作为mqtt中的publisher,向节点内发布主题信息。

要测试该节点需要以下前置：

1.建立一个mqtt服务器

2.使用mqttbox或者其他相关工具从服务器上订阅对应的主题。

3.可以向串口发送指令。

建议本地下载mosquito,在本地搭建一个mqtt服务器，或者使用emqX公用服务器。该案例的defult server是：`test.mosquitto.org:1883`

向串口发送指令连接WIFI并订阅：<syntaxhighlight lang="bash" line="1">
wifi_sta_connect your_wifi_id your_passwd

mqtts_pub $local_ip 8883 #mqtt_pub 如果不带参数会默认发送到上述的公有服务器

#会得到以下输出：

bouffalolab />mqtt_pub is ready to begin publishing the time.
Press ENTER to publish the current time.
Press CTRL-C to exit.
mqtt_pub published : "{"hello mqtt by bl616/8 !"}
Now time is 2023-06-16 00:00:00"
mqtt_pub published : "{"hello mqtt by bl616/8 !"}
Now time is 2023-06-16 00:00:03"
mqtt_pub stop publish to test.mosquitto.org
</syntaxhighlight>订阅方会受到当前时间的字符串。

==== wifi_mqtt_sub: ====
和上述一样，但是该案例是submiter ，也就是消息订阅方。

前置条件：同上。

同样向串口发送指令来验证：<syntaxhighlight lang="bash" line="1">
bouffalolab />wifi_sta_connect your_wifi_id your_pwd
bouffalolab />mqtt_sub your_server <port>

#得到输出

bouffalolab />mqtt_sub listening for '<theme>' messages.
Press CTRL-C to exit.
Received publish('<theme>'): {"hello mqtt"}
Received publish('<theme>'): {"hello mqtt"}
mqtt_sub disconnecting from xxx.your_server
</syntaxhighlight>

==== MQTTS功能： ====
'''上述的两个Demo现已支持TLS加密功能'''，该加密使用'''TLS1.2'''加密套件，未验证 CN name。

开启MQTT的选项在对应文件夹中的CmakeList中：<syntaxhighlight lang="makefile" line="1">
cmake_minimum_required(VERSION 3.15)

include(proj.conf)

find_package(bouffalo_sdk REQUIRED HINTS $ENV{BL_SDK_BASE})

# User
sdk_add_compile_definitions(-DCONFIG_CLI_CMD_ENABLE)
# sdk_add_compile_options(-DMQTT_USE_CUSTOM_SOCKET_HANDLE)
# sdk_add_compile_definitions(-DMBEDTLS_PK_PARSE_C)

sdk_add_compile_options(-DMQTT_USE_MBEDTLS) #注释该行则不启用TLS加密，否则加密。

target_sources(app PRIVATE
wifi_mqtt_pub.c)

sdk_add_include_directories(.)

sdk_set_main_file(main.c)

project(wifi_mqtt_publisher)

</syntaxhighlight>

==== 其中的CA证书，密钥等具体为： ====
<syntaxhighlight lang="bash" line="1">
#ca.crt：
-----BEGIN CERTIFICATE-----
MIIDwzCCAqugAwIBAgIUT2Cy6wsGGycw6WvNoHot5I+GlTQwDQYJKoZIhvcNAQEL
BQAwcTELMAkGA1UEBhMCQ04xEDAOBgNVBAgMB0JlaWppbmcxEDAOBgNVBAcMB0Jl
aWppbmcxDzANBgNVBAoMBk15IE9yZzEWMBQGA1UECwwNQ0EgRGVwYXJ0bWVudDEV
MBMGA1UEAwwMTVFUVCBSb290IENBMB4XDTI1MDcxNzEwMzU1MVoXDTM1MDcxNTEw
MzU1MVowcTELMAkGA1UEBhMCQ04xEDAOBgNVBAgMB0JlaWppbmcxEDAOBgNVBAcM
B0JlaWppbmcxDzANBgNVBAoMBk15IE9yZzEWMBQGA1UECwwNQ0EgRGVwYXJ0bWVu
dDEVMBMGA1UEAwwMTVFUVCBSb290IENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A
MIIBCgKCAQEAzMguxj26xEFb1N5u6slSgEp62eak+dqkmq6BoxVW48V2GO62caCt
n7MZywknnKm1sFM9kOv/mdr4fjHF3ZhvZ4MCqu0EPy2crjROoV8ofsjMDoIp2PSh
VZ7wmDC5zu7ndCMX85C/vv3Ikows5sMr/r6Ieh7lgoLeXTFDbGixLM3u1vB2I/OQ
gepYnPVkUHmEWsRFtzwwBgbAkSlmf3UreCT/lDbcOsKGl3YY4PZtJjk3wwtJqLAE
M/dNJdleU9ENwwelotScu4CGex+OaPNfn1EwLgwBrX2FByYyfpw+DUTnhdXsPbGM
jly24NUcg7CavTJxow5ltuWLahN5oQZZ4wIDAQABo1MwUTAdBgNVHQ4EFgQUGIBW
MZwM5z40nEZde/GSQxszsDEwHwYDVR0jBBgwFoAUGIBWMZwM5z40nEZde/GSQxsz
sDEwDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0BAQsFAAOCAQEALp0qj9qWnc9l
9GWivdOHVSfIHWWuTUN7+2QXGEHZ7vyC6dPoMNvr0Wg35Wj3VLbmZm6vlIubQ0JW
3nt5Kru9Keh/BALAxFa6onRVdYahXWRzD1fjTMUfIpDjaRtFWE6luA3ztfj2ZtiL
q665MZulKQLFhIQeAXNfR7hpxaiR+qu5YVYvWQN7gigjB787Y+JUk+h3rnlZ5vPX
j/yf9BP2u9tK1VkF2Ir1c+Y0xcp0qomd25QOm0H/qwgEh5wnO3du8GrTS5WMlYq1
LJSLM7dmBKgvTPngAgewFiwNPyhtywM6Vdc/mrcNwqAcfmyV0U8oU/DReKbX4ed2
+zlke05LKA==
-----END CERTIFICATE-----

#ca.key：
-----BEGIN PRIVATE KEY-----
MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDMyC7GPbrEQVvU
3m7qyVKASnrZ5qT52qSaroGjFVbjxXYY7rZxoK2fsxnLCSecqbWwUz2Q6/+Z2vh+
McXdmG9ngwKq7QQ/LZyuNE6hXyh+yMwOginY9KFVnvCYMLnO7ud0IxfzkL++/ciS
jCzmwyv+voh6HuWCgt5dMUNsaLEsze7W8HYj85CB6lic9WRQeYRaxEW3PDAGBsCR
KWZ/dSt4JP+UNtw6woaXdhjg9m0mOTfDC0mosAQz900l2V5T0Q3DB6Wi1Jy7gIZ7
H45o81+fUTAuDAGtfYUHJjJ+nD4NROeF1ew9sYyOXLbg1RyDsJq9MnGjDmW25Ytq
E3mhBlnjAgMBAAECggEAJTvQpWLb7osjs1SuPipUwdbI942kOXmzrBxGnexnXAqv
KmFc8tQQPZVG/0+u0CFbU7AO5abDVqolvGw4Wc45k0yS05k8yG/2qQYBtf2jU0oX
MBwil7wDCZpYjJNvdVyi4M7wr+yFsKhcK6kpENwzx6HFFs8/U7ePzsoCRFfUvxxu
26rKP0rF5168DCTn8UMyYqEdPQ9MOD2xI6hPsJVelqu7eWRXAWrFgVH5L+xgd0mH
MhtidnvayrUKt5eE+FifZN9QK2rgJ9lppGw9bPANSOQ+K1O7F+HIOwSCXCD2hM2t
bHaQfeLfOeu32MlOMcGQIcQGqwWpI9XHWQBJO9OcgQKBgQD5azAYDJL/jRxaN4o+
1QXOBRuimKNT4XDDyoPA0j6uwcXQa6LbhxPAack2ocyXm4O+g/wySiO/tnPoaNUH
WGppGdnGuqX+JAK/35GsNb30BCXb0Gkz/bijTSm3fNKg63ZTREZlJ/KTH8/4bM+p
B6FIO2g+oREjvVI6pRlBiLF70wKBgQDSL3nGHRzo6FSUjGmZBJ9f7koylYT7QuE8
mLoHG4fMoYaVDZk8eY10Xc9gL79aO4Uf98N004qbfL5QcbCgi5DBwrrIE1eInq0Y
CNKtfySzg2sdCG8Ex3fhtZZyOljlc4bckTj4gmGgCuNUDhPo+k2roskSoXo0G3T/
gFLFHJwvsQKBgG3UqIH+j4Ce59xGVsciUQMOtsObyVg3jst40xnGuzmDNJN5wmY/
DhCNxMAc8ZXVMmdjgVu30BQsyM+P0jcA1SLg8kgTiuLlgpxxW5lktPfOF8m69Yii
cnrekL8u5SVdamZySzliJOxqds8jQzJgnMHM/zONA5okVSBj8UItalJnAoGBAM8F
8hSfwkTp6b0zHCOauPv9MlnmicgOVNmhuMGdbUGx62ROs5ssQpbWe5bLENfofjRB
juQ4JHMICFAl2woWzar7iYvd+T7Yw7dDoXdAHz8td0hucSMs8TiA6kFylPLTuobw
B0RG7696afT1tMiqGeyvdwuBv2MplDDBDUWW64PRAoGAXmCqgu4AgKDrg/BsKCH3
070IxOXc+7tVdESmWyexDyNUfBCF+6Kowl1Kw3IgIcywA19sKK2msykyIy0Om+rM
EaZfHaspt9srWNlzDsPy6nV5dkXZcSezKVXxJgriDk46sPlEBNKGrYPbNmSYpvrY
NKgGQaYrJ5ixe1aEARcF2CE=
-----END PRIVATE KEY-----

#server.crt：
-----BEGIN CERTIFICATE-----
MIID6zCCAtOgAwIBAgIUYSb6OOUA1AaPPfdB/QhCrJFxYfIwDQYJKoZIhvcNAQEL
BQAwcTELMAkGA1UEBhMCQ04xEDAOBgNVBAgMB0JlaWppbmcxEDAOBgNVBAcMB0Jl
aWppbmcxDzANBgNVBAoMBk15IE9yZzEWMBQGA1UECwwNQ0EgRGVwYXJ0bWVudDEV
MBMGA1UEAwwMTVFUVCBSb290IENBMB4XDTI1MDcyMjA2MDk0MVoXDTI2MDcyMjA2
MDk0MVowazELMAkGA1UEBhMCQ04xEDAOBgNVBAgMB0JlaWppbmcxEDAOBgNVBAcM
B0JlaWppbmcxDzANBgNVBAoMBk15IE9yZzENMAsGA1UECwwETVFUVDEYMBYGA1UE
AwwPMTkyLjE2OC4xNTMuMTE0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
AQEAm1NDiGRlGbUKX938s9HFrTyprJ4fhjHgmVZuqy0Hj5jX5Wvq7iPDXQHUuStN
9rIMB31K8h8gBfTbWTALQnL/p5urvBACvLI8J3BEz8pweq61sUeqBNGFO8YnxRou
vRPUeel9zg4GbLIf4T6BfwKtgMoqX/ROnnUiuE8sdo/KCreB5we+ZriP+jS1gVSQ
NMiJFXbo08aEV8WefuQnTegjgooEbFpeq7dtHXKiDiHW5LUCj6TUGh1DcKVvlSTa
ur7SMCvADT0W4Mp8Q9VXFCGwJugwy6pmtOqnPHEEBxs+1EGX22XeGS6ccP5HH2bm
yJ1gSLI+yt0r+T0cMTsoeBR2EQIDAQABo4GAMH4wCQYDVR0TBAIwADALBgNVHQ8E
BAMCBaAwEwYDVR0lBAwwCgYIKwYBBQUHAwEwDwYDVR0RBAgwBocEwKiZcjAdBgNV
HQ4EFgQUW7r5PWIFPiDa1RcxhUUcMwMID3wwHwYDVR0jBBgwFoAUGIBWMZwM5z40
nEZde/GSQxszsDEwDQYJKoZIhvcNAQELBQADggEBAKWlIJWaDzhhbBy9ftUkGIis
EDjMvmLnkFchFFNAOWZq1yBujf3K0KqcmdgKfSearMQrK/YTHR1a39P21BSqnRpk
dfNZfiVvRkJAcdY9SgderklUmPoY9huxumtGEPDtrkxkyuhgpk7/9YyavgyMCMdd
cFIwdeBUEHPhHLw8TlhVT1UotClKbhjyRHOMrpfWXVnsa+U/UrPeqGn8uL49XPH4
9DqzKZPSZaPxNoAj0iHvo+7RvEl5jy+ixwRgnvdOsDteRwFFW0Kxd4Ccn4QKEgTY
chx6XC0/a2Lg8KwxZbmDGoj4sqJ3PltuG8GZB6Vdv0FJnjAK6cZAQE0Hyclhhbs=
-----END CERTIFICATE-----

#server.key：
-----BEGIN PRIVATE KEY-----
MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCbU0OIZGUZtQpf
3fyz0cWtPKmsnh+GMeCZVm6rLQePmNfla+ruI8NdAdS5K032sgwHfUryHyAF9NtZ
MAtCcv+nm6u8EAK8sjwncETPynB6rrWxR6oE0YU7xifFGi69E9R56X3ODgZssh/h
PoF/Aq2Ayipf9E6edSK4Tyx2j8oKt4HnB75muI/6NLWBVJA0yIkVdujTxoRXxZ5+
5CdN6COCigRsWl6rt20dcqIOIdbktQKPpNQaHUNwpW+VJNq6vtIwK8ANPRbgynxD
1VcUIbAm6DDLqma06qc8cQQHGz7UQZfbZd4ZLpxw/kcfZubInWBIsj7K3Sv5PRwx
Oyh4FHYRAgMBAAECgf8CjFso4a/6ImSix5sqi0Z/xEvRIsb7OW/cR1uJc2bfjdWW
h5Uf7Kl7EFltFq8ww1SiZGvWWd+TBj4sntBdRrjrBwkwpkXLn4ddHkc17k+Ds8B6
jn87lQE0LQwTlicuJiUjDhgCSWvRj+dcZEO7noLTzUoX4oPOFbd8G2oFuyL71s0l
4jO2poU42qsOxgBd2XIxePUc320/2a7Y0rABZJMLVx24oRzHqCLhyhRneqoqar0P
1hmS2tMeEr66db8U6Fr7J+P1SVt0KFSdrvEYCDHTCVf0TAZ25vYT69VznZGSok4U
YQkBQiFFuyGXLgiRfrX/aL7rYxj2KBRAbce/lUECgYEAyx1coRA+FyptMZLWh7ny
QSSq25/J7K+TPUMefIKFtKCmBRHg6gWu9YbTimXIOoq7l51xI+YT02VnEqjn9ToR
vkUlNRyHBzsDt2VQTH+00Slo0tn4NS9Sb8uMezHiUgKGjiQWPQqwzUG4ToG2cYkj
8+vcxyHK5CWkWEVjh/1sRRkCgYEAw8R9Zqic+nv+9wRV219bmqyeSw2SkDXIyQSM
tUBjqZHB1wh3Z+Tc0KdYSM9tymEwBJ5mx/nYxxF3gWXW0K4kuS1jtMFZscNaA2/1
VRweVXWBUlC/oZY1IEdLchtcQt3CfLIwQIKyikPwax0EU9YfQiTAiDNCAdBNJPF0
J/bMn7kCgYEAiBWbCxp7zz+Qu0cbTwJpafXsN4ueWWLlLoV6tocol/WOZhUtcP3v
0/bKYo6BEaADwbgtppSvMdJdtaXPC4ElhCqFnEkJuvFyMvzBSQ/DEORCpAp//vo+
rEJfU+b/MF0a078f2zP/cvYWSxsjJnxwxyt+1zgv3J3Pt4h+AA3t7XkCgYEAnCJh
VXgTQx+T2RUHGOBz4efck8VuaD/NNK3BP2nsUriiXcst2JnKl0tweRme2fMrZfOj
y8hz4UkIBBbh/it1tI8D34z56XIBn44yn7++XbBLBQjL3ac8FdNm08oIinftfqBr
JXhXxziqTfOlmOvEoG9JcxdWhLXKYTWFy73ls1kCgYEAsrPcSpF8Ce3r+izDW2TM
2M4arK3T7hcMItLAQQoLO7RCYIivgQQE0WV9BmbC0fVTkptDMfks5s7QcU/6vzqC
zPx0NowGnabNWS1vsXD4QyoOyV3gqfVhM46cWbRhxtRmMo/LGuJ8rXnHY3bgF5va
VJlSyLW96jWK9neR0QOTKM4=
-----END PRIVATE KEY-----

</syntaxhighlight>将对应的证书和密钥保存到文件中，放在mosquitto的路径下。'''注意要将这些文件的所属组归给mosquitto.'''

然后修改mosquito的配置文件，该文件储存在 /etc/mosquitto/mosquitto.conf 中，配置如下：<syntaxhighlight lang="bash" line="1">
# Place your local configuration in /etc/mosquitto/conf.d/
#
# A full description of the configuration file is at

log_dest file /var/log/mosquitto/mosquitto.log

listener 8883
tls_version tlsv1.2
cafile /etc/mosquitto/certs/ca.crt
certfile /etc/mosquitto/certs/server.crt
keyfile /etc/mosquitto/certs/server.key

listener 1883
allow_anonymous true
</syntaxhighlight>

=== HTTP与HTTPS相关demo说明： ===

==== wifi_http: ====
该demo会向网络服务器发送请求，根据返回结果判断http请求功能是否正常。

前置条件为：一个可共上网的wifi,可以向串口发送指令。<syntaxhighlight lang="bash" line="1">
bouffalolab />wifi_sta_connect your_wifi your_pwd
bouffalolab />wifi_http_test www.xxx.com

#以下为输出

bouffalolab />Http client task start ...
Host:www.xxx.com, Server ip Address : the ip of websit server
Http client connect server success!
Press CTRL-C to exit.
HTTP/1.1 200 OK
</syntaxhighlight>

==== wifi_https: ====
该demo会自动发加密数据到www.baidu.com，根据结果判断加密功能是否正常

前置条件：同上<syntaxhighlight lang="bash" line="1">
bouffalolab />wifi_https_test
bouffalolab />dst_addr is 842C9824

#以下为输出
[I: 124359488][bl_https.c:126] HTTP/S> bouffalo connect fd = 0x62fd0dc0
[I: 124377783][bl_https.c:136] HTTP/S> ret = -28
[I: 124598639][bl_https.c:156] HTTP/S> ret = 0
[I: 124598987][bl_https.c:160] HTTP/S> total time:471 ms
[I: 124679688][bl_https.c:168] HTTP/S> rcv_ret = 1179
[I: 124680077][bl_https.c:172] HTTP/S> proc_head_r 0, status_code 200, body_start_off 400
[I: 124680533][bl_https.c:180] HTTP/S> Copy to resp @off 0, len 779, 1st char 3C
bl_TcpSslDisconnect end
[I: 124683390][bl_https.c:264] HTTP/S> total time:555 ms
[I: 124683715][bl_https.c:265] HTTP/S> test_1: status_code 200, resp_len 779
[I: 124684395][bl_https.c:267] HTTP/S> resp body: <!DOCTYPE html>
<html> <head><meta http-equiv=content-type content=text/html;charset=utf-8><meta http-equiv=X-UA-Compatible content=IE=Edge><meta content=always name=referrer><link rel=stylesheet type=text/css href=https://ss1.

</syntaxhighlight>如果你想要更改测试服务器目标，可以在https.c源码中添加test,或者直接更改这部分代码：<syntaxhighlight lang="c" line="1">
static void test_1(void)
{
const char *host = "www.baidu.com";
const uint8_t send_buf[] = "GET / HTTP/1.1\r\n"
"Host: www.baidu.com\r\n"
"User-Agent: curl/7.58.0\r\n"
"accept: application/json\r\n"
"\r\n";
uint8_t *buf;
int resp_len;
int status_code;

buf = malloc(16 * 1024);
if (NULL == buf) {
LOG_E("malloc\r\n");
return;
}

resp_len = 16 * 1024;

uint32_t start_time = 0, stop_time = 0;
start_time = xTaskGetTickCount();
status_code = https_request(host, 443, send_buf, sizeof(send_buf) - 1, buf, &resp_len);
stop_time = xTaskGetTickCount();

LOG_I("total time:%d ms\r\n", (stop_time - start_time));
LOG_I("test_1: status_code %d, resp_len %d\r\n", status_code, resp_len);
buf[resp_len] = '\0';
LOG_I("resp body: %s\r\n", buf);

free(buf);
}
</syntaxhighlight>上述函数被调用用来执行测试，更改该部分代码可以实现更改测试目标的目的。

=== TCP的Demo说明： ===

==== wifi_tcp: ====
该部分代码编写了一个server.c和一个client.c,分别用于测试TCP服务端测试和客户端测试。

前置条件：PC端和开发板共同在一个局域网内，可以向串口发送指令。

使用picocom工具在串口中执行指令。

server测试：<syntaxhighlight lang="bash" line="1">
bouffalolab />wifi_sta_connect your_wifi_id your_wifi_pwd
bouffalolab />wifi_tcp_echo_test 3365

#服务器建立成功

bouffalolab />tcp server task start ...
Server ip Address : 0.0.0.0:3365

# 执行 nc -v ipaddr port 连接板子的tcp服务器

new client connected from (192.168.1.2, 57480)
Press CTRL-C to exit.
recv 7 len data
</syntaxhighlight>client测试：<syntaxhighlight lang="bash" line="1">

#首先执行 nc -l -p 3365 在本地架起一个服务器

bouffalolab />wifi_sta_connect BL_TEST 12345678
bouffalolab />wifi_tcp_test localip 3365

#输出

bouffalolab />tcp client task start ...
Server ip Address : 192.168.1.2:3365
TCP client connect server success!
Press CTRL-C to exit.
</syntaxhighlight>

=== UDP的demo说明： ===
该部分代码将使用开发板作为sta节点连接wifi并且架起一个udp服务器。

前置条件：PC端和开发板在同一个局域网内，可以向串口发送指令。

测试过程：<syntaxhighlight lang="bash" line="1">
#连接开发板终端并发送指令

bouffalolab />wifi_sta_connect your_wifi_id 12345678
bouffalolab />wifi_udp_echo 3365
bouffalolab />udp server task start ...

#服务其成功架起输出
ip Address : ip:3365
udp bind port success!
Press CTRL-C to exit.

#在PC端执行 nc -u server_ip server_port
#直接发送 1234567890

#成功接受到数据
recv from 192.168.1.2
recv:X
recv from 192.168.1.2
recv:X
recv from 192.168.1.2
recv:X
recv from 192.168.1.2
recv:X
recv from 192.168.1.2
recv:1234567890
</syntaxhighlight>

=== OTA的demo说明： ===

==== wifi_ota： ====
该部分代码测试了基本tcp升级固件，使用pc端作为服务器，在同一局域网下，通过命令使得开发板连接ota服务器，接收固件包。

用于测试的固件包被放在了编译出的 build/build_out 目录下。

前置条件：PC端和开发板在同一个局域网内，可以向串口发送指令。

测试过程：<syntaxhighlight lang="bash" line="1">
#该程序需要分区表，所以在编译之后需要执行make whole来烧录whole bin
make whole
cd build/build_out
cat wifi_ota_bl616.bin.ota | nc -nvl 3365 #在pc端架服务器并发送固件

#向串口发送指令连接WiFi并连接服务器开始测试
bouffalolab />wifi_sta_connect your_ssid your_passwd
bouffalolab />wifi_ota_test PC_ip_addr 3365

#收到以下回复则表示测试成功
[STA CONSOLE] Calculated SHA256 Checksum:9F5EA3181316DA72589CD4CB0702AA25ED3094F7BED2B5898187044A0A01A077
[STA CONSOLE] Header SET SHA256 Checksum:9F5EA3181316DA72589CD4CB0702AA25ED3094F7BED2B5898187044A0A01A077
[STA CONSOLE] [OTA] [TCP] prepare OTA partition info
[STA CONSOLE] [OTA] [TCP] Update PARTITION, partition len is 804560
reboot
[STA CONSOLE] [OTA] [TCP] Rebooting
[STA CONSOLE] dynamic memory init success, ocram heap size = 263 Kbyte
</syntaxhighlight>该源码可以支持配置自动连接WIFI,可以修改源码中的该部分内容：<syntaxhighlight lang="c" line="1">#define AUTO_CONNECT_WIFI (0)

/****************************************************************************
* Private Types
****************************************************************************/

/****************************************************************************
* Private Data
****************************************************************************/

struct bflb_device_s *gpio;
static struct bflb_device_s *uart0;

static TaskHandle_t wifi_fw_task;
#if AUTO_CONNECT_WIFI
struct bflb_device_s *wdg;
static TaskHandle_t ota_task_handle;
#endif
static wifi_conf_t conf = {
.country_code = "CN",
};

#if AUTO_CONNECT_WIFI
// clang-format off
/* config your wifi ssid and password */
static const uint8_t wifi_sta_connet[] = "wifi_sta_connect H3C_21A0AD\r";
/* config your ota server and port */
static const uint8_t wifi_ota_test[] = "wifi_ota_test 192.168.123.120 3365\r";
/* reboot command */
// static const uint8_t send_buf1[] = "reboot\r";
// clang-format on

extern Ring_Buffer_Type shell_rb;
extern void shell_release_sem(void);

SemaphoreHandle_t sem_wifi_init_done;
SemaphoreHandle_t sem_wifi_connect_done;
SemaphoreHandle_t sem_wifi_disconnect;
#endif</syntaxhighlight>将宏定义 AUTO_CONNECT_WIFI 设定为1,并修改 wifi_sta_connect[] wifi_ota_test[] 字符串为你的对应命令即可。

Demo:DMA

2025-07-17T01:35:15Z

武楷轩：

=== Demo介绍： ===
这部分代码保存在SDK下的：/examples/peripherals/dma/ 中。展示了不同模式下的dma运行情况，测试dma外设的功能完整性。

在该SDK中，dma的搬运行为被构建成一个LLI，系统根据LLI不断向下搬运直到最终节点。

=== dma_normal: ===
该部分代码测试了内存到内存的基本dma运送。共搬运数据三组，字节对齐为32位。搬运模式为一次性搬运。

'''数据字节对齐式初始化：'''

这里这里以32位对齐是为了配合后面DMA读取。<syntaxhighlight lang="c" line="1">
static __attribute((aligned(32))) uint8_t src1_buffer[DMA_BUFFER_LENGTH];
static __attribute((aligned(32))) uint8_t src2_buffer[DMA_BUFFER_LENGTH];
static __attribute((aligned(32))) uint8_t src3_buffer[DMA_BUFFER_LENGTH];

static __attribute((aligned(32))) uint8_t dst1_buffer[DMA_BUFFER_LENGTH];
static __attribute((aligned(32))) uint8_t dst2_buffer[DMA_BUFFER_LENGTH];
static __attribute((aligned(32))) uint8_t dst3_buffer[DMA_BUFFER_LENGTH];
</syntaxhighlight>'''DMA配置解析：'''

方向配置为：内存到内存；

优先级都配置为： 0，是最高优先级；

目标和源数据指针都为递增；

突发传输次数配置都为 1；

数据宽度都为 32位置。<syntaxhighlight lang="c" line="1">
config.direction = DMA_MEMORY_TO_MEMORY;
config.src_req = 0;
config.dst_req = 0;
config.src_addr_inc = DMA_ADDR_INCREMENT_ENABLE;
config.dst_addr_inc = DMA_ADDR_INCREMENT_ENABLE;
config.src_burst_count = DMA_BURST_INCR1;
config.dst_burst_count = DMA_BURST_INCR1;
config.src_width = DMA_DATA_WIDTH_32BIT;
config.dst_width = DMA_DATA_WIDTH_32BIT;
</syntaxhighlight>

==== '''突发次数：''' ====
突发次数就是突发传输，是指在DMA占用总线时，一个周期里读或者写的次数。注意，虽然双方都配置了突发次数，但是'''并不是同时进行而是先读后写'''。

比如，源数据的突发传输次数设定为4,目标写的突发次数为2,则是先读取四次，然后再写入两次。'''''这里的突发读/写每次都会出发指针的递增'''''。

==== '''部分输出：''' ====
<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
dma memory case:
tc done
tc done
tc done
copy finished with time=353us
case end

</syntaxhighlight>

=== dma_normal_cycle: ===
该部分代码和上述代码的配置一致，但是该代码为循环搬运。

不同的地方在于：<syntaxhighlight lang="c" line="1">
int used_count = bflb_dma_channel_lli_reload(dma0_ch0, lli, 20, transfers, 3);
bflb_dma_channel_lli_link_head(dma0_ch0, lli, used_count); //该函数将链表进行了头尾相接
bflb_dma_channel_start(dma0_ch0);
</syntaxhighlight>'''链表头尾相接变成了环'''，所以程序将会重复循环搬运构建的链表内的所有item。

==== '''部分输出：''' ====
<syntaxhighlight lang="bash" line="1">
tc done
tc done
tc done
tc done
tc done
tc done
tc done
tc done
tc done
tc done
tc done
tc done
tc done
tc done
tc done
tc done
tc done
tc done
end

</syntaxhighlight>按照demo,应该触发一百次中断函数，所以应该有100次 tc done

=== dma_reduce_or_add: ===
这部分代码主要展示了两个模式在不同的情况下的应用，并且展示了普通模式下当目标数据和源数据宽度不同时应该怎么传输数据和当应该使用模式但没有使用时会产生什么样的负面效果。

==== '''Add与Reduce模式说明：''' ====
Add和Reduce模式从狭义来判断是当目标数据宽度和源数据宽度不匹配时使用。

但事实并不仅仅如此，'''本demo在第一段代码的配置中就展示了即使数据宽度不匹配也可以在normal模式下通过设置配置来运行'''：<syntaxhighlight lang="c" line="1">
config.direction = DMA_MEMORY_TO_MEMORY;
config.src_req = 0;
config.dst_req = 0;
config.src_addr_inc = DMA_ADDR_INCREMENT_ENABLE;
config.dst_addr_inc = DMA_ADDR_INCREMENT_ENABLE;
config.src_burst_count = DMA_BURST_INCR1;
config.dst_burst_count = DMA_BURST_INCR4;
config.src_width = DMA_DATA_WIDTH_32BIT;
config.dst_width = DMA_DATA_WIDTH_8BIT;
</syntaxhighlight>通过设定 burst 突发次数来配合宽度，最终使得：'''源宽度*突发次数 = 目标宽度*突发次数''' <big>则可以完整的将数据正确的传输过去</big>。

<big>那什么情况下使用Add和Reduce？</big>

答案是要'''参考数据总量'''，比如：<syntaxhighlight lang="c">
/* Disable reduce mode and enable add mode, src_width = 8bit, dst_width = 32bit, nbytes = 65, transfer length = nbytes + 3 = 68 byte, multiple of dst_width */
bflb_dma_feature_control(dma0_ch0, DMA_CMD_SET_REDUCE_MODE, 0);
bflb_dma_feature_control(dma0_ch0, DMA_CMD_SET_ADD_MODE, 1);

config.src_burst_count = DMA_BURST_INCR4;
config.dst_burst_count = DMA_BURST_INCR1;
config.src_width = DMA_DATA_WIDTH_8BIT;
config.dst_width = DMA_DATA_WIDTH_32BIT;
bflb_dma_channel_init(dma0_ch0, &config);

bflb_dma_channel_tcint_mask(dma0_ch0, false);

transfers[0].nbytes = DMA_TRANSFER_LENGTH + 1; //这里更改设置总传输量为65字节
bflb_dma_channel_lli_reload(dma0_ch0, lli, 20, transfers, 1);

bflb_dma_channel_start(dma0_ch0);
</syntaxhighlight>当目标数据宽度是32位4字节，而源数据的宽度是8位一字节，'''拿65/4 = 16 余下 1,也就是说最后一次传输会仅仅传输一字节数据向一个宽度为四字节的变量'''。假设这里不是变量而是寄存器，那么就有可能写不进去（可能识别错误）。那么<big>'''Add在这里的作用就是：字节对齐'''</big>。它会自动补全后面的数据，也就是补出来3字节的数据，''这就是什么注释中说最后的实际传输数据是65 + 3= 68 byte。''

而Reduce模式，在本demo中仅仅是测试，没有给出实际的需求场景。

在实际场景中的应用一般是在如下情况：假设当目标宽度为32位，数据源宽度为8位,读取总量设定为61字节。 61 / 4 = 15 余下 1。此时必须再次读取，但是读取的四字节中只有一字节要使用，假设寄存器读取后就会复位，那么这里就会错误操作。所以reduce模式就可以在这种情况下使用，它会规定用户设定的传输总量为最大读取字节数，<big>'''reduce的作用就是：防止过量读取。'''</big>

在配置上可以参考这个：
{| class="wikitable"
!模式
!适用场景
!配置公式
!效果
|-
|Reduce
|<nowiki>源宽度 > 目标宽度 || 不希望过度读取</nowiki>
|nbytes = 期望 + 目标宽度
|实际传输 = 期望
|-
|Add
|<nowiki>目标宽度 > 源宽度 || 需要字节对齐写入数据</nowiki>
|nbytes = 期望
|实际传输 = 对齐(期望)
|}

==== 部分输出： ====
<syntaxhighlight lang="bash" line="1">
===========================
uart sig1:ffffffff, sig2:0000f32f
clock gen1:9ffffffd, gen2:0fff0c11
xtal:40000000Hz(crystal)
board init done
===========================
dma memory case:
tc done
Check over

tc done
Check over

tc done
Correct, meaningless data. index: 65, src: 0x41, dst: 0x31
Correct, meaningless data. index: 66, src: 0x42, dst: 0x32
Correct, meaningless data. index: 67, src: 0x43, dst: 0x33
Check over

tc done
Check over

end

</syntaxhighlight>可以看到在最终的没有添加add模式的情况下，出现了无意义数据。

Demo:Btble

2025-07-16T08:30:29Z

武楷轩：添加blemesh_cli