Bouffalo Lab Docs - 最近更改 [zh-cn]

DebuggingBouffaloLabChipsWithGDB

张良 — Fri, 10 Apr 2026 01:05:38 GMT

←上一版本		2026年4月10日 (五) 01:05的版本
第11行：		第11行：
	==== 进行GDB调试 ====		==== 进行GDB调试 ====

	~~这里以Ubuntu为例，此时应该可以看到 <code>/dev/ttyACM0</code> 设备（以实际为准）~~		这里以Ubuntu为例，分别运行如下两条命令

	~~分别运行如下两条命令~~

首页

张良 — Thu, 09 Apr 2026 07:06:24 GMT

←上一版本		2026年4月9日 (四) 07:06的版本
第6行：		第6行：
	* [[如何获取开发板]]		* [[如何获取开发板]]
	* [[烧录固件到开发板]]		* [[烧录固件到开发板]]
			* [[DebuggingBouffaloLabChipsWithGDB\|如何调试博流开发板]]

	= Bouffalo SDK =		= Bouffalo SDK =

使用GDB调试

张良 — Thu, 09 Apr 2026 07:05:28 GMT

张良移动页面使用GDB调试至DebuggingBouffaloLabChipsWithGDB

←上一版本		2026年4月9日 (四) 07:05的版本
（未显示同一用户的2个中间版本）
第6行：		第6行：
	==== 通过USB连接到PC ====		==== 通过USB连接到PC ====

	[[文件:BL616DVK ~~Light_CKLinkLite~~.jpg \| ~~BL616DVK Light_CKLinkLite~~]]		[[文件:BL616DVK Light CKLinkLite.jpg\| 600像素 \| BL616DVKLight_CKLinkLite]]


第12行：		第12行：

	这里以Ubuntu为例，此时应该可以看到 <code>/dev/ttyACM0</code> 设备（以实际为准）		这里以Ubuntu为例，此时应该可以看到 <code>/dev/ttyACM0</code> 设备（以实际为准）

	分别运行如下两条命令		分别运行如下两条命令


	<code>DebugServerConsole</code>		<code>DebugServerConsole</code>

	<code>riscv64-unknown-elf-gdb *.elf</code>		<code>riscv64-unknown-elf-gdb *.elf</code>


	[[文件:BL616DVKLight_CKLinkLite.gif\| BL616DVKLight_CKLinkLite]]		[[文件:BL616DVKLight_CKLinkLite.gif\| BL616DVKLight_CKLinkLite]]

文件:BL616DVK Light CKLinkLite.jpg

张良 — Thu, 09 Apr 2026 07:00:05 GMT

张良上传文件:BL616DVK Light CKLinkLite.jpg BL616DVKLight_CKLinkLite.jpg

新页面

== 摘要 ==
BL616DVKLight_CKLinkLite.jpg

使用GDB调试

张良 — Thu, 09 Apr 2026 06:58:21 GMT

←上一版本		2026年4月9日 (四) 06:58的版本
第16行：		第16行：
	<code>riscv64-unknown-elf-gdb *.elf</code>		<code>riscv64-unknown-elf-gdb *.elf</code>

	[[文件:~~BL616DVK Light_CKLinkLite~~.gif \| ~~BL616DVK Light_CKLinkLite~~]]		[[文件:BL616DVKLight_CKLinkLite.gif\| BL616DVKLight_CKLinkLite]]

文件:BL616DVKLight CKLinkLite.gif

张良 — Thu, 09 Apr 2026 06:57:24 GMT

张良上传文件:BL616DVKLight CKLinkLite.gif BL616DVKLight_CKLinkLite.gif

新页面

== 摘要 ==
BL616DVKLight_CKLinkLite.gif

使用GDB调试

张良 — Thu, 09 Apr 2026 06:55:42 GMT

←上一版本		2026年4月9日 (四) 06:55的版本
第1行：		第1行：


	通过CKLink调试DVK light开发板
			= 通过CKLink调试DVK light开发板 =

			==== 通过USB连接到PC ====

			[[文件:BL616DVK Light_CKLinkLite.jpg \| BL616DVK Light_CKLinkLite]]


			==== 进行GDB调试 ====

			这里以Ubuntu为例，此时应该可以看到 <code>/dev/ttyACM0</code> 设备（以实际为准）
			分别运行如下两条命令
			<code>DebugServerConsole</code>
			<code>riscv64-unknown-elf-gdb *.elf</code>

			[[文件:BL616DVK Light_CKLinkLite.gif \| BL616DVK Light_CKLinkLite]]

文件:BL616DVK Light CKLinkLite.jpg.jpg

张良 — Thu, 09 Apr 2026 06:54:55 GMT

张良上传文件:BL616DVK Light CKLinkLite.jpg.jpg

新页面

BL616DVK Light_CKLinkLite.jpg

使用GDB调试

张良 — Thu, 09 Apr 2026 06:49:53 GMT

创建页面，内容为“ 通过CKLink调试DVK light开发板”

新页面

通过CKLink调试DVK light开发板

Windows wsl bringup

张良 — Thu, 09 Apr 2026 02:22:22 GMT

←上一版本		2026年4月9日 (四) 02:22的版本
（未显示同一用户的3个中间版本）
第1行：		第1行：


	~~git clone git@code.bouffalolab.com:liangzhang/bouffalo_sdk_rel.git~~

	~~git clone git~~@~~code.bouffalolab~~.com:~~bouffalo_sw~~/~~toolchain_riscv_thead_linux64.git~~		== 1. Build and Flash the Device Firmware ==




			ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

			cd examples/wifi/nethub

			''# BL616''
			make CHIP=bl616 BOARD=bl616dk

			''# BL616CL''
			make CHIP=bl616cl BOARD=bl616cldk

			''# BL618DG''
			make CHIP=bl618dg BOARD=bl618dgdk CPU_ID=ap
			Flash example:
			cd examples/wifi/nethub
			make flash CHIP=bl618dg COMX=/dev/ttyUSB0

			make flash CHIP=bl616cl COMX=/dev/ttyUSB0

			make flash CHIP=bl616cl COMX=COM5





	export PATH=$HOME/work/toolchain_riscv_thead_linux64/bin:$PATH		export PATH=$HOME/work/toolchain_riscv_thead_linux64/bin:$PATH

Windows wsl bringup

张良 — Wed, 08 Apr 2026 03:30:36 GMT

创建页面，内容为“ git clone git@code.bouffalolab.com:liangzhang/bouffalo_sdk_rel.git git clone git@code.bouffalolab.com:bouffalo_sw/toolchain_riscv_thead_linux64.git export PATH=$HOME/work/toolchain_riscv_thead_linux64/bin:$PATH”

新页面

git clone git@code.bouffalolab.com:liangzhang/bouffalo_sdk_rel.git

git clone git@code.bouffalolab.com:bouffalo_sw/toolchain_riscv_thead_linux64.git

export PATH=$HOME/work/toolchain_riscv_thead_linux64/bin:$PATH

烧录固件到开发板

张良 — Wed, 01 Apr 2026 11:00:28 GMT

查看运行log

←上一版本		2026年4月1日 (三) 11:00的版本
（未显示同一用户的2个中间版本）
第2行：		第2行：

	==== 通过USB连接到PC ====		==== 通过USB连接到PC ====

			[[文件:BL616DVK Light.jpg \| BL616DVK_light \| 400px]]

	这里以Ubuntu为例，此时应该可以看到 <code>/dev/ttyACM0</code> 设备（以实际为准）		这里以Ubuntu为例，此时应该可以看到 <code>/dev/ttyACM0</code> 设备（以实际为准）

第13行：		第16行：
	make flash CHIP=bl616 COMX=/dev/ttyACM0		make flash CHIP=bl616 COMX=/dev/ttyACM0
	</pre>		</pre>

			==== 查看运行log ====
			通过串口终端查看运行的log即可，默认波特率2M（刚烧录完需要手动按一下Reset按键）

文件:BL616DVK Light.jpg

张良 — Wed, 01 Apr 2026 10:54:17 GMT

张良上传文件:BL616DVK Light.jpg

新页面

BL616DVK_Light

烧录固件到开发板

张良 — Wed, 01 Apr 2026 10:52:50 GMT

如何烧录到DVK light开发板

←上一版本		2026年4月1日 (三) 10:52的版本
第1行：		第1行：
	= 如何烧录到DVK light开发板 =		= 如何烧录到DVK light开发板 =

	# 通过USB连接到PC		==== 通过USB连接到PC ====

	这里以Ubuntu为例，此时应该可以看到 <code>/dev/ttyACM0</code> 设备（以实际为准）		这里以Ubuntu为例，此时应该可以看到 <code>/dev/ttyACM0</code> 设备（以实际为准）

	# 设备进入烧录模式		==== 设备进入烧录模式 ====

	按住 <code>BOOT</code> 键，trigger 一下 <code>reset</code> 按键，设备即进入烧录模式		按住 <code>BOOT</code> 键，trigger 一下 <code>reset</code> 按键，设备即进入烧录模式

	# 编译并烧录		==== 编译并烧录 ====

	<pre>		<pre>
	cd examples/wifi/sta/wifi_tcp		cd examples/wifi/sta/wifi_tcp

烧录固件到开发板

张良 — Wed, 01 Apr 2026 10:52:06 GMT

创建页面，内容为“= 如何烧录到DVK light开发板 = # 通过USB连接到PC 这里以Ubuntu为例，此时应该可以看到 <code>/dev/ttyACM0</code> 设备（以实际为准） # 设备进入烧录模式按住 <code>BOOT</code> 键，trigger 一下 <code>reset</code> 按键，设备即进入烧录模式 # 编译并烧录 <pre> cd examples/wifi/sta/wifi_tcp make CHIP=bl616 BOARD=bl616dk make flash CHIP=bl616 COMX=/dev/ttyACM0 </pre>”

新页面

= 如何烧录到DVK light开发板 =

# 通过USB连接到PC

这里以Ubuntu为例，此时应该可以看到 <code>/dev/ttyACM0</code> 设备（以实际为准）

# 设备进入烧录模式

按住 <code>BOOT</code> 键，trigger 一下 <code>reset</code> 按键，设备即进入烧录模式

# 编译并烧录

<pre>
cd examples/wifi/sta/wifi_tcp
make CHIP=bl616 BOARD=bl616dk
make flash CHIP=bl616 COMX=/dev/ttyACM0
</pre>

NetHubQuickBringup

张良 — Tue, 31 Mar 2026 00:14:42 GMT

Sync NetHub docs from local Markdown

←上一版本		2026年3月31日 (二) 00:14的版本
第334行：		第334行：
	* whether <code>bflbwifid</code> is still running		* whether <code>bflbwifid</code> is still running
	* whether <code>nethub_vchan_app</code> is still running		* whether <code>nethub_vchan_app</code> is still running

			=== 8.4 How Do I Change the Host-Side Virtual Interface Name <code>mr_eth0</code>? ===

			The default host-side virtual network interface name comes from <code>bsp/common/msg_router/linux_host/kernel/netdev/mr_netdev.c</code>:

			<syntaxhighlight lang="c">
			#define ETH_DRV_NAME "mr_eth%d"
			</syntaxhighlight>

			The first created interface therefore appears as <code>mr_eth0</code>.

			To change the interface name, update <code>ETH_DRV_NAME</code> to the pattern you want. For example:

			<syntaxhighlight lang="c">
			#define ETH_DRV_NAME "nethub%d"
			</syntaxhighlight>

			Notes:

			* Keep <code>%d</code> if you want Linux to allocate names such as <code>nethub0</code>, <code>nethub1</code>, and so on
			* Rebuild the host software after the change and reload the host-side kernel module
			* If any local scripts or service configuration still refer to <code>mr_eth0</code>, update them accordingly

TestApi

张良 — Tue, 17 Mar 2026 11:05:57 GMT

张良移动页面TestApi至TestApi1 重命名测试页面，统一命名规范

新页面

== 测试页面 ==

这是一个使用 MediaWiki Action API 创建的测试页面。

创建时间: 2026-03-17

== 功能测试 ==

* Action API 编辑 ✅
* Bot 认证 ✅

== 更新测试 ==

这是追加的内容，测试编辑功能是否正常工作。

更新时间: 刚刚

TestApi2

张良 — Tue, 17 Mar 2026 11:03:15 GMT

通过 MCP 工具创建 TestApi2 页面，与 TestApi 形成对比测试

新页面

== 高级测试页面 ==

这是通过 MediaWiki API 创建的**第二个**测试页面，与 TestApi 有显著差异。

创建时间: 2026-03-17
页面版本: v2.0

=== API 功能验证 ===

此页面用于验证以下 MediaWiki MCP 功能：

; 页面读取
: 使用 <code>action=query</code> 获取页面内容 ✅

; 页面创建
: 使用 <code>action=edit</code> 创建新页面 ✅

; 格式支持
: Wikitext 格式化测试 ✅

== 数据对比表 ==

{| class="wikitable"
! 特性 !! TestApi !! TestApi2
|-
| 创建方式 || API 编辑 || MCP 工具
|-
| 版本号 || v1.0 || v2.0
|-
| 标题级别 || 二级 || 三级（部分）
|-
| 表格 || 无 || 有
|}

== 额外功能测试 ===

=== 代码块测试 ===

<source lang="python">
def hello_mediawiki():
print("Hello from MediaWiki MCP!")
return True
</source>

=== 列表样式差异 ===

; 有序列表项 1
: 子项描述 A
: 子项描述 B

; 有序列表项 2
: 子项描述 C

== 总结 ==

此页面与 TestApi 的主要差异：

# 使用了更复杂的 wikitext 语法
# 添加了表格展示
# 包含代码高亮示例
# 使用了不同的列表格式
# 页面结构更加层次化

---
''最后更新：通过 MCP 工具自动生成''

TestApi

张良 — Tue, 17 Mar 2026 08:49:50 GMT

创建 API 测试页面

←上一版本	2026年3月17日 (二) 08:49的版本
（没有差异）

NetHub

张良 — Tue, 17 Mar 2026 05:54:34 GMT

Sync NetHub docs from local Markdown

←上一版本		2026年3月17日 (二) 05:54的版本
第39行：		第39行：
	== Online Wiki ==		== Online Wiki ==

	* [https://docs.bouffalolab.com/index.php?title=NetHub]		* [https://docs.bouffalolab.com/index.php?title=NetHub NetHub]
	* [https://docs.bouffalolab.com/index.php?title=NetHubQuickBringup]		* [https://docs.bouffalolab.com/index.php?title=NetHubQuickBringup NetHubQuickBringup]
	* [https://docs.bouffalolab.com/index.php?title=NetHubArchitecture]		* [https://docs.bouffalolab.com/index.php?title=NetHubArchitecture NetHubArchitecture]
	* [https://docs.bouffalolab.com/index.php?title=NetHubVirtualChannel]		* [https://docs.bouffalolab.com/index.php?title=NetHubVirtualChannel NetHubVirtualChannel]

NetHubQuickBringup

张良 — Tue, 17 Mar 2026 05:42:10 GMT

Sync NetHub docs from local Markdown

←上一版本		2026年3月17日 (二) 05:42的版本
第3行：		第3行：
	This document is for customers who are using NetHub for the first time. The goal is to help you complete device and host bring-up as quickly as possible.		This document is for customers who are using NetHub for the first time. The goal is to help you complete device and host bring-up as quickly as possible.

	~~<img src="https~~:~~//docs.bouffalolab.com/images/d/d4/~~Nethub_sdio_quickstart_demo.gif~~" alt="~~NetHub SDIO Quick Start Demo~~" />~~		[[文件:Nethub_sdio_quickstart_demo.gif \| NetHub SDIO Quick Start Demo]]

	If you only care about the currently available solution, keep these points in mind:		If you only care about the currently available solution, keep these points in mind:

NetHubArchitecture

张良 — Tue, 17 Mar 2026 05:33:51 GMT

Sync NetHub docs from local Markdown

显示更改

NetHubVirtualChannel

张良 — Tue, 17 Mar 2026 05:33:51 GMT

Sync NetHub docs from local Markdown

显示更改

NetHub

张良 — Tue, 17 Mar 2026 05:33:43 GMT

Sync NetHub docs from local Markdown

←上一版本		2026年3月17日 (二) 05:33的版本
第1行：		第1行：
	= NetHub =		= NetHub =

	NetHub ~~用于把~~ device 侧的 Wi-Fi ~~能力桥接到 host。~~		NetHub bridges device-side Wi-Fi capabilities to the host.

	~~当前方案面向~~ <code>BL616 / BL618 / BL616CL / BL618DG</code> ~~这类 Wi~~-~~Fi SoC，当前推荐 bringup 路径为~~ <code>SDIO</code>。		The current solution targets Wi-Fi SoCs such as <code>BL616 / BL618 / BL616CL / BL618DG</code>, and the recommended bring-up path is currently <code>SDIO</code>.

	== ~~页面导航~~ ==		== Documentation Guide ==

	* [[NetHubQuickBringup\|~~NetHub 快速上手~~]]		* [[NetHubQuickBringup\|NetHubQuickBringup.md]]
	** ~~面向首次 bringup 的客户~~		** For customers doing first-time bring-up
	** 说明 device/host ~~的关键选择、编译、加载、连接~~ AP ~~和常见问题~~		** Covers key device/host choices, build steps, module loading, AP connection, and common issues
	* [[NetHubArchitecture\|~~NetHub 架构说明~~]]		* [[NetHubArchitecture\|NetHubArchitecture.md]]
	** ~~面向需要理解模块边界和 API 的开发者~~		** For developers who need to understand module boundaries and APIs
	** 说明 device/host ~~分层、公共接口和关键数据流~~		** Covers device/host layering, public interfaces, and key data flows
	* [[NetHubVirtualChannel\|~~NetHub USER Virtual Channel~~]]		* [[NetHubVirtualChannel\|NetHubVirtualChannel.md]]
	** ~~面向需要传输私有数据的客户或应用开发者~~		** For customers or application developers who need to transfer private data
	** 说明 USER ~~通道的前提、API 和典型使用方式~~		** Covers USER channel prerequisites, APIs, and typical usage

	== ~~当前结论~~ ==		== Current Conclusions ==

	* ~~当前主路径是~~ <code>SDIO</code>		* The current primary path is <code>SDIO</code>
	* device 侧 Wi-Fi backend 支持 <code>fhost / wl80211</code>		* The device-side Wi-Fi backend supports <code>fhost / wl80211</code>
	* host 控制 backend ~~运行时二选一：~~<code>tty</code> 或 <code>vchan</code>		* The host control backend is selected at runtime: <code>tty</code> or <code>vchan</code>
	* ~~控制通道和~~ <code>USER virtual channel</code> ~~都承载在同一条~~ host link 上		* The control channel and <code>USER virtual channel</code> both run on the same host link

	== ~~仓内参考目录~~ ==		== In-Repo Reference Directories ==

	* <code>examples/wifi/nethub</code>		* <code>examples/wifi/nethub</code>
	* <code>components/net/nethub</code>		* <code>components/net/nethub</code>
	* <code>bsp/common/msg_router/linux_host/userspace/nethub</code>		* <code>bsp/common/msg_router/linux_host/userspace/nethub</code>

			== Local Documentation Source ==

			* Markdown documents:
			** <code>examples/wifi/nethub/docs/</code>

			If you need to publish to the online wiki, use these four Markdown documents as the source.

			== Online Wiki ==

			* [https://docs.bouffalolab.com/index.php?title=NetHub]
			* [https://docs.bouffalolab.com/index.php?title=NetHubQuickBringup]
			* [https://docs.bouffalolab.com/index.php?title=NetHubArchitecture]
			* [https://docs.bouffalolab.com/index.php?title=NetHubVirtualChannel]

NetHubQuickBringup

张良 — Tue, 17 Mar 2026 05:33:43 GMT

Sync NetHub docs from local Markdown

显示更改