rt-thread/bsp/bouffalo_lab/README.md

English | 中文

bouffalo_lab bsp

1. 简介

bouffalo_lab bsp针对bouffalo_lab的系列AIoT芯片，采用bouffalo_lab最新LHAL 驱动库，驱动库与bouffalo_sdk(原bl_mcu_sdk)代码同步，当前commitid:e6e8da79a50aeb4fcb67ac380c3bd8885cd56faf

目前支持以下芯片：

	芯片型号	内核
1	bl60x(bl602/bl604)	RISC-V SiFive E24
2	bl70x(bl702/bl704/bl706)	RISC-V SiFive E24
3	bl61x(bl616/bl618)	RISC-V T-Head E907
4	bl808	RISC-V T-Head E902(lp)+E907(m0)+C906(d0)

LHAL 是博流为统一通用外设接口而设计的驱动库，代码精炼并且支持博流所有系列芯片。

外设	BL602/BL604	BL702/BL704/BL706	BL616/BL618	BL808
ADC	○	√	√	○
CAM	-	×	×	×
CKS	○	√	√	○
DAC	○	√	√	○
DMA	○	√	√	√
EFUSE	×	√	√	√
EMAC	-	√	√	√
FLASH	√	√	√	√
GPIO	○	√	√	√
I2C	○	√	√	○
I2S	○	○	√	○
IR	○	√	√	○
MJPEG	×	×	√	√
PWM_v1	○	√	-	-
PWM_v2	-	-	√	√
RTC	○	√	√	√
SEC_AES	○	√	√	√
SEC_SHA	○	√	√	√
SEC_TRNG	○	√	√	√
SEC_PKA	○	√	√	√
SPI	○	√	√	√
TIMER	○	√	√	√
UART	√	√	√	√
USB_v1	-	√	-	-
USB_v2	-	-	√	√
WDG	○	√	√	○

备注：√ 表示已支持；× 表示未支持；○ 表示已支持但未测试；- 表示没有该外设。

2. 环境搭建及编译

bl60x/bl70x/bl61x可在对应芯片直接编译；bl808是多核异构架构，分为m0、lp、d0，每个核需要单独编译并烧录到对应的位置，bl808三核使用详细参考bl808三核使用指南。

以下操作以单核bl61x为例，其他芯片操作类同。

2.1. 下载

请至对应下载链接下载芯片的工具链

芯片型号	下载地址
bl60x/bl70x	Linux/windows
bl61x/bl808	T-Head官网或Linux/windows

2.2. 设置

Windows下请使用使用env工具，使用命令 tar -xvf Xuantie-900-gcc-elf-newlib-mingw-V2.6.1-20220906.tar.gz 解压交叉编译器，使用Windows下解压工具直接解压可能出现Windows下编译错误。

在rtconfig.py中将risc-v工具链的本地路径加入 EXEC_PATH 或通过 RTT_EXEC_PATH 环境变量指定路径

Windows：

set RTT_EXEC_PATH=C:\Users\xxxx\Downloads\Xuantie-900-gcc-elf-newlib-x86_64-V2.6.1\bin

Linux:

export RTT_EXEC_PATH=/opt/Xuantie-900-gcc-elf-newlib-x86_64-V2.6.1/bin

2.3. 编译

Windows下推荐使用env工具，在console下进入bsp/bouffalo_lab/bl61x目录中，运行：

cd bsp/bouffalo_lab/bl61x
menuconfig
pkgs --update

如果在Linux平台下，可以先执行：

scons --menuconfig

它会自动下载env相关脚本到~/.env目录，然后执行

source ~/.env/env.sh

cd bsp/bouffalo_lab/bl61x
pkgs --update

更新完软件包后，执行 scons -j10 或 scons -j10 --verbose 来编译这个板级支持包。或者通过 scons --exec-path="GCC工具链路径" 命令，在指定工具链位置的同时直接编译。

如果编译正确无误，会产生rtthread.elf、rtthread.bin文件；编译完成后自动调用libraries/bl_mcu_sdk/tools/bflb_tools/bflb_fw_post_proc对rtthread.bin进行打包处理以用于后续bouffalo_flash_cube工具烧录。

脚本会自动采用curl命令行方式下载bflb_fw_post_proc，如自动下载失败，可采用手工方式下载对应操作系统文件后保存至libraries/bl_mcu_sdk/tools/bflb_tools/bflb_fw_post_proc

下载地址1	windows/Linux/macos
下载地址2	bflb_fw_post_proc-win.tar.gz/bflb_fw_post_proc-linux.tar.gz/bflb_fw_post_proc-macos.tar.gz
下载地址3	bflb_fw_post_proc-win.tar.gz/bflb_fw_post_proc-linux.tar.gz/bflb_fw_post_proc-macos.tar.gz

3. 下载烧录

3.1. 烧录工具下载

当前bsp必须使用bouffalo_flash_cube-1.0.4工具进行烧录，使用其他工作无法正常运行。

• 烧录工具下载地址1：百度网盘

• 烧录工具下载地址2：

bouffalo_flash_cube-win.zip/bouffalo_flash_cube-win.tar.gz

bouffalo_flash_cube-linux.zip/bouffalo_flash_cube-linux.tar.gz

bouffalo_flash_cube-macos.zip/bouffalo_flash_cube-macos.tar.gz

• 烧录工具下载地址3：

bouffalo_flash_cube-win.zip/bouffalo_flash_cube-win.tar.gz

bouffalo_flash_cube-linux.zip/bouffalo_flash_cube-linux.tar.gz

bouffalo_flash_cube-macos.zip/bouffalo_flash_cube-macos.tar.gz

3.2. GUI方式下载

1. 连接好串口并在工具上选择对应的串口号

2. 打开对应芯片文件夹下的flash_prog_cfg.ini文件

3. 按住开发板上的boot按钮后重新上电，进入下载状态

4. 点击"Download"开始下载

3.2. 命令行下载

命令行下载可使用bsp/bouffalo_lab目录下的bouffalo_flash_cube.sh脚本，输入./bouffalo_flash_cube.sh bl616 /dev/ttyUSB1，脚本会自动采用curl命令行方式下载bouffalo_flash_cube。

如自动下载失败，可采用手工方式下载对应操作系统文件后保存至libraries/bl_mcu_sdk/tools/bflb_tools/bouffalo_flash_cube目录。

其中：

• bl616：芯片名称(bl808：三核同时下载；或者输入:bl808-m0/bl808-lp/bl808-d0分别烧录对应的核，但是m0必须要烧录才能运行)
• /dev/ttyUSB1：下载串口号，linux下为/dev/ttyUSBx或/dev/ttyACMx，windows下为COMx

4. 运行

如果编译 & 烧写无误，当复位设备后，会在串口上看到RT-Thread的启动logo信息：

5. 支持开发板列表

	开发板型号
bl602	BL602-IoT-3S/BL-HWC-G1
bl702	Maix Zero Sense
bl616/bl618	M0S Dock/M0P Dock
bl808	M1s Dock

6. 驱动支持列表

驱动	支持情况	备注
UART	支持	默认波特率2000000
GPIO	支持
I2C	支持
SPI	支持	支持DMA
PWM	支持
ADC	支持
RTC	支持
WDT	支持
HWTIMER	支持
FLASH	支持
SDCARD	支持
Wi-Fi	支持	仅 BL808 支持

7. 联系人信息

维护人：flyingcys

8. 参考

• 芯片datasheet