RT-Thread-博流RISC-V系列AIoT芯片RT-Thread上手指南RT-Thread问答社区

博流RISC-V系列AIoT芯片RT-Thread上手指南

发布于 2023-05-07 15:06:56 浏览：2385 订阅该版

[tocm]

rt-thread下bouffalo_lab bsp是针对博流智能[https://www.bouffalolab.com/](https://www.bouffalolab.com/) 的系列AIoT芯片，位于rt-thread/bsp/bouffalo_lab，目前有4个子目录包括，

|      | 芯片型号                 | 内核                                     |
| ---- | :----------------------- | ---------------------------------------- |
| 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) |

以上系列芯片都是RISC-V内核，内核有一些差别，最新的芯片如支持Wi-Fi6的bl616/bl618,三核异构的多媒体芯片bl808,都采用是平头哥的RISC-V核。
芯片相关资料可在[https://github.com/bouffalolab/bl_docs](https://github.com/bouffalolab/bl_docs) 下载，资料非常详细，有所有寄存器级说明。

# 1. rt-thread驱动适配
当前bsp采用bouffalo_lab最新LHAL 驱动库，驱动库与[https://github.com/bouffalolab/bouffalo_sdk](https://github.com/bouffalolab/bouffalo_sdk) (原bl_mcu_sdk)代码同步，当前commitid为:`e6e8da79a50aeb4fcb67ac380c3bd8885cd56faf`。
**LHAL** 是博流为统一通用外设接口而设计的驱动库，代码精炼并且支持博流所有系列芯片。
在众多小伙伴的一起支持下，目前已完成基本外设驱动适配，包括uart/gpio/i2c/spi/pwm/rtc/adc/wdt/hwtimer/flash，rt-thread驱动也是一套代码支持以上所有芯片。其他驱动也在适配中，有兴趣的小伙伴也可以一起参与提交PR，也可以直接与我（微信：flyingcys）联系。

| 驱动 | 支持情况 | 备注              |
| :--- | :------- | :---------------- |
| UART | 支持     | 默认波特率2000000 |
| GPIO | 支持     |                   |
| I2C  | 支持     |                   |
| SPI  | 支持     | 支持DMA           |
| PWM  | 支持     |                   |
| ADC  | 支持     |                   |
| RTC  | 支持     |                   |
| WDT  | 支持     |                   |
| HWTIMER  | 支持 |                   |
| FLASH  | 支持 |                   |

关注开源之夏活动的小伙伴也可以关注一下博流bsp，开源之夏 rt-thread社区的高阶项目之一"rt-thread上使用BL602/BL702芯片上支持WiFi、BLE、thread功能"，需要完成"BL60X/BL70X的IoT通讯能力，完成BL602的WiFi、ble能力，BL702的BLE、thread通讯能力"，可以点击以下链接。
[https://summer-ospp.ac.cn/org/prodetail/238bc0129?list=org&navpage=org](https://summer-ospp.ac.cn/org/prodetail/238bc0129?list=org&navpage=org)

# 2. 编译
 ## 2.1. 交叉编译器下载
 不同的芯片需下载对应的toolchain，请至对应下载链接下载芯片的工具链：

| 芯片型号  | 下载地址   |
| ------------ | ------------ |
| bl60x/bl70x  | [Linux](https://gitee.com/bouffalolab/toolchain_gcc_sifive_linux)/[windows](https://gitee.com/bouffalolab/toolchain_gcc_sifive_windows)  |
| bl61x/bl808  | [T-Head官网](https://occ.t-head.cn/community/download?id=4073475960903634944)或[Linux](https://gitee.com/bouffalolab/linuxtoolchain_gcc_t-head)/[windows](https://gitee.com/bouffalolab/toolchain_gcc_t-head_windows)  |

## 2.2. 设置
Windows下请使用使用[env工具][1]，使用命令 `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工具][1]，在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](https://raw.githubusercontent.com/bouffalolab/bl_mcu_sdk/master/tools/bflb_tools/bflb_fw_post_proc/bflb_fw_post_proc.exe)/[Linux](https://raw.githubusercontent.com/bouffalolab/bl_mcu_sdk/master/tools/bflb_tools/bflb_fw_post_proc/bflb_fw_post_proc-ubuntu)/[macos](https://raw.githubusercontent.com/bouffalolab/bl_mcu_sdk/master/tools/bflb_tools/bflb_fw_post_proc/bflb_fw_post_proc-macos) |
| --------- | ------------------------------------------------------------ |
| 下载地址2 | [bflb_fw_post_proc-win.tar.gz](https://gitee.com/flyingcys/bflb_tools/releases/download/v1.0.4/bflb_fw_post_proc-win.tar.gz)/[bflb_fw_post_proc-linux.tar.gz](https://gitee.com/flyingcys/bflb_tools/releases/download/v1.0.4/bflb_fw_post_proc-linux.tar.gz)/[bflb_fw_post_proc-macos.tar.gz](https://gitee.com/flyingcys/bflb_tools/releases/download/v1.0.4/bflb_fw_post_proc-macos.tar.gz) |
| 下载地址3 | [bflb_fw_post_proc-win.tar.gz](https://github.com/flyingcys/bflb_tools/releases/download/v1.0.4/bflb_fw_post_proc-win.tar.gz)/[bflb_fw_post_proc-linux.tar.gz](https://github.com/flyingcys/bflb_tools/releases/download/v1.0.4/bflb_fw_post_proc-linux.tar.gz)/[bflb_fw_post_proc-macos.tar.gz](https://github.com/flyingcys/bflb_tools/releases/download/v1.0.4/bflb_fw_post_proc-macos.tar.gz) |

# 3. 下载烧录
 ## 3.1. 烧录工具下载

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

- 烧录工具下载地址1：[百度网盘](https://pan.baidu.com/s/1eG9pkxf3riAqQAu9aXiOjw?pwd=miv1)

- 烧录工具下载地址2：

[bouffalo_flash_cube-win.zip](https://gitee.com/flyingcys/bflb_tools/releases/download/v1.0.4/bouffalo_flash_cube-win.zip)/[bouffalo_flash_cube-win.tar.gz](https://gitee.com/flyingcys/bflb_tools/releases/download/v1.0.4/bouffalo_flash_cube-win.tar.gz)

[bouffalo_flash_cube-linux.zip](https://gitee.com/flyingcys/bflb_tools/releases/download/v1.0.4/bouffalo_flash_cube-linux.zip)/[bouffalo_flash_cube-linux.tar.gz](https://gitee.com/flyingcys/bflb_tools/releases/download/v1.0.4/bouffalo_flash_cube-linux.tar.gz)

[bouffalo_flash_cube-macos.zip](https://gitee.com/flyingcys/bflb_tools/releases/download/v1.0.4/bouffalo_flash_cube-macos.zip)/[bouffalo_flash_cube-macos.tar.gz](https://gitee.com/flyingcys/bflb_tools/releases/download/v1.0.4/bouffalo_flash_cube-macos.tar.gz)

- 烧录工具下载地址3：

[bouffalo_flash_cube-win.zip](https://github.com/flyingcys/bflb_tools/releases/download/v1.0.4/bouffalo_flash_cube-win.zip)/[bouffalo_flash_cube-win.tar.gz](https://github.com/flyingcys/bflb_tools/releases/download/v1.0.4/bouffalo_flash_cube-win.tar.gz)

[bouffalo_flash_cube-linux.zip](https://github.com/flyingcys/bflb_tools/releases/download/v1.0.4/bouffalo_flash_cube-linux.zip)/[bouffalo_flash_cube-linux.tar.gz](https://github.com/flyingcys/bflb_tools/releases/download/v1.0.4/bouffalo_flash_cube-linux.tar.gz)

[bouffalo_flash_cube-macos.zip](https://github.com/flyingcys/bflb_tools/releases/download/v1.0.4/bouffalo_flash_cube-macos.zip)/[bouffalo_flash_cube-macos.tar.gz](https://github.com/flyingcys/bflb_tools/releases/download/v1.0.4/bouffalo_flash_cube-macos.tar.gz)

## 3.2. GUI方式下载

1. 连接好串口并在工具上选择对应的串口号
2. 打开对应芯片文件夹下的flash_prog_cfg.ini文件
3. 按住开发板上的boot按钮后重新上电，进入下载状态
4. 点击"Download"开始下载

![bouffalo_flash_cube.jpg](https://oss-club.rt-thread.org/uploads/20230507/695cdc78d9d7a4b2c646492d605324c3.jpg.webp)

## 3.3. 命令行下载

命令行下载可使用`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：芯片名称
- /dev/ttyUSB1：下载串口号，linux下为/dev/ttyUSBx或/dev/ttyACMx，windows下为COMx

# 4.  运行

如果编译 & 烧写无误，当复位设备后，会在串口上看到RT-Thread的启动logo信息：
![rt-thread.jpg](https://oss-club.rt-thread.org/uploads/20230507/99322796e6c661da182f209c0b5dbb70.jpg)

# 5. 支持开发板列表

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

# 6. 后续推进计划
包括：
- WiFi驱动适配
- SD卡驱动适配
- USB驱动适配
- I2S驱动适配
- 显示驱动适配
- BLE驱动适配
- 异构核间通信
等；

希望有更多小伙伴一起参与，一起学习RISC-V，一起学习IoT；
有对 **risc-v**、**rt-smart**、 **博流bsp**感兴趣的都可以加我微信(flyingcys)