注:以下教程已经安装好基于 vscode + wsl2 的开发环境，请先参照博流官方linux开发环境搭建教程 使用wsl2和 vscode 搭建
- 创建项目根文件夹并进入，执行以下git命令
- project 用于存放不同工程的源文件，如prj1，prj2...
- middleware 用于存放多个工程共用的中间件
- riscv64_elf 用于复制一份交叉编译工具链用于调试
git init
git submodule add [email protected]:bouffalolab/bl_mcu_sdk.git
mkdir project
cd project
mkdir prj1
cd ../
mkdir middleware
mkdir riscv64_elf
- 修改 bl_mcu_sdk/toos/tools.cmake 文件
file(MAKE_DIRECTORY ${OUTPUT_DIR})
set(HEX_FILE ${OUTPUT_DIR}/${target_name}.hex)
set(BIN_FILE ${OUTPUT_DIR}/${target_name}.bin)
set(MAP_FILE ${OUTPUT_DIR}/${target_name}.map)
set(ASM_FILE ${OUTPUT_DIR}/${target_name}.asm)
# 找到以上这段代码，添加以下一行
set(ELF_FILE ${OUTPUT_DIR}/${target_name}.elf)add_custom_command(TARGET ${target_name}.elf POST_BUILD
COMMAND ${CMAKE_OBJCOPY} -Obinary $<TARGET_FILE:${target_name}.elf> ${BIN_FILE}
COMMAND ${CMAKE_OBJDUMP} -d -S $<TARGET_FILE:${target_name}.elf> >${ASM_FILE}
# COMMAND ${CMAKE_OBJCOPY} -Oihex $<TARGET_FILE:${mainname}.elf> ${HEX_FILE}
COMMAND ${SIZE} $<TARGET_FILE:${target_name}.elf>
COMMAND ${CMAKE_COMMAND} -E copy ${BIN_FILE} ${CMAKE_SOURCE_DIR}/tools/bflb_flash_tool/img/project.bin
# 找到以上代码，添加下面 9 行，用于输出固定的文件以及输出 bin 文件
COMMAND ${CMAKE_COMMAND} -E rm -rf ${CMAKE_SOURCE_DIR}/../latest
COMMAND ${CMAKE_COMMAND} -E copy ${BIN_FILE} ${CMAKE_SOURCE_DIR}/../latest/latest.bin
COMMAND ${CMAKE_COMMAND} -E copy ${ELF_FILE} ${CMAKE_SOURCE_DIR}/../latest/latest.elf
COMMAND ${CMAKE_COMMAND} -E copy ${MAP_FILE} ${CMAKE_SOURCE_DIR}/../latest/latest.map
COMMAND ${CMAKE_COMMAND} -E copy ${ASM_FILE} ${CMAKE_SOURCE_DIR}/../latest/latest.asm
COMMAND ${CMAKE_COMMAND} -E copy ${BIN_FILE} ${CMAKE_SOURCE_DIR}/../output/${target_name}.bin
COMMAND ${CMAKE_COMMAND} -E copy ${ELF_FILE} ${CMAKE_SOURCE_DIR}/../output/${target_name}.elf
COMMAND ${CMAKE_COMMAND} -E copy ${MAP_FILE} ${CMAKE_SOURCE_DIR}/../output/${target_name}.map
COMMAND ${CMAKE_COMMAND} -E copy ${ASM_FILE} ${CMAKE_SOURCE_DIR}/../output/${target_name}.asm- 修改 bl_mcu_sdk/CMakeLists.txt 文件
cmake_minimum_required(VERSION 3.15)
set(CMAKE_TOOLCHAIN_FILE ${CMAKE_SOURCE_DIR}/tools/cmake/riscv64-unknown-elf-gcc.cmake)
include(${CMAKE_SOURCE_DIR}/drivers/${CHIP}_driver/cpu_flags.cmake)
include(${CMAKE_SOURCE_DIR}/tools/cmake/compiler_flags.cmake)
include(${CMAKE_SOURCE_DIR}/tools/cmake/tools.cmake)
PROJECT(${BOARD} C CXX ASM)
# set(CMAKE_VERBOSE_MAKEFILE ON)
ENABLE_LANGUAGE(ASM)
# 添加以下一行
set(MIDDLEWARE_DIR ${CMAKE_SOURCE_DIR}/../middleware)
include_directories(${CMAKE_SOURCE_DIR}/bsp/bsp_common/platform)
if(IS_DIRECTORY ${CMAKE_SOURCE_DIR}/bsp/board/${CHIP})
include_directories(${CMAKE_SOURCE_DIR}/bsp/board/${CHIP})
else()
message(FATAL_ERROR "${CMAKE_SOURCE_DIR}/bsp/board/${CHIP} is not exist")
endif()
# search_application(${CMAKE_SOURCE_DIR}/${APP_DIR})
# 注释上一行改为下一行
search_application(${CMAKE_SOURCE_DIR}/../${APP_DIR})- 修改 bl_mcu_sdk/Makefile 文件
#common config
BOARD?=bl706_iot
CHIP?=bl702
APP_DIR?=project #修改默认 APP_DIR 为外部的project文件夹
APP?=helloworld
CPU_ID?=none- 复制 bl_mcu_sdk/examples/gpio/gpio_blink 文件夹到 project 文件夹，wsl2 命令行进入bl_mcu_sdk 目录，执行以下命令，如果成功则修改完成，项目根文件夹会多出 output 文件夹以及 latest 文件夹
make APP=gpio_blink- 复制配置工具链时候的工具链文件夹内容到riscv-elf文件夹下，工具链文件夹一般名称为riscv64-unknown-elf-xxxxxx 或 riscv64-elf-xxxxxx 等字样
- 添加launch.json
{
{
// 使用 IntelliSense 了解相关属性。
// 悬停以查看现有属性的描述。
// 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"name": "Bouffalo",
"type": "cppdbg",
"request": "launch",
// 配置为你的 项目根目录/latest/latest.elf 文件路径
"program": "/mnt/x/vector_project/vector_bl706/latest/latest.elf",
"args": [],
"stopAtEntry": false,
"cwd": "${fileDirname}",
"environment": [],
"externalConsole": false,
"MIMode": "gdb",
// 配置为你的工具链
"miDebuggerPath": "riscv64-unknown-elf-gdb",
// 配置端口一般为2331，ip 地址为vEthernet(WSL) ipv4地址, 不行可以尝试localhost 或者本机ip地址 192.168.1.xxx之类的
"miDebuggerServerAddress": "172.17.240.1:2331",
"setupCommands": [
{
"description": "为 gdb 启用整齐打印",
"text": "-enable-pretty-printing",
"ignoreFailures": true
}
]
}
]
}- 打开dev cube下载编译成功的bin文件
- 启动jlinkGdbServer，Target device 设置为RISC-V，little endian， jtag 接口 Fixed 12000 kHz，勾选init registers，不勾选 Localhost only。
- vscode 打开对应的main文件，按F5 开始调试
注: 如果vscode 弹出连接超时，尝试更改ip地址
- 将 root/middleware/segger_rtt 文件夹复制到你的目录 middleware文件夹内
- 将 root/project/segger_rtt 文件夹复制到你的目录 project 文件夹内
- 修改bl_mcu_sdk/Makefile 文件
#option config to use
SUPPORT_FLOAT?=n
SUPPORT_ROMAPI?=y
SUPPORT_HALAPI?=y
SUPPORT_USB_HS?=n
SUPPORT_HW_SEC_ENG_DISABLE?=n
SUPPORT_BLECONTROLLER_LIB?=n
# 添加以下一行
SEGGER_RTT_VIEW?=y
#cmake definition config
cmake_definition+= -DCHIP=$(CHIP)
cmake_definition+= -DCPU_ID=$(CPU_ID)
cmake_definition+= -DBOARD=$(BOARD)
cmake_definition+= -DAPP_DIR=$(APP_DIR)
cmake_definition+= -DAPP=$(APP)
cmake_definition+= -DBOOTROM=$(BOOTROM)
cmake_definition+= -DCONFIG_ROMAPI=$(SUPPORT_ROMAPI)
cmake_definition+= -DCONFIG_HALAPI=$(SUPPORT_HALAPI)
cmake_definition+= -DCONFIG_PRINT_FLOAT=$(SUPPORT_FLOAT)
cmake_definition+= -DCONFIG_USB_HS=$(SUPPORT_USB_HS)
cmake_definition+= -DCONFIG_HW_SEC_ENG_DISABLE=$(SUPPORT_HW_SEC_ENG_DISABLE)
cmake_definition+= -DCONFIG_BLECONTROLLER_LIB=$(SUPPORT_BLECONTROLLER_LIB)
# 添加以下一行
cmake_definition+= -DSEGGER_RTT_VIEW=$(SEGGER_RTT_VIEW)- 修改bl_mcu_sdk/CMakeLists.txt 文件
cmake_minimum_required(VERSION 3.15)
set(CMAKE_TOOLCHAIN_FILE ${CMAKE_SOURCE_DIR}/tools/cmake/riscv64-unknown-elf-gcc.cmake)
include(${CMAKE_SOURCE_DIR}/drivers/${CHIP}_driver/cpu_flags.cmake)
include(${CMAKE_SOURCE_DIR}/tools/cmake/compiler_flags.cmake)
include(${CMAKE_SOURCE_DIR}/tools/cmake/tools.cmake)
PROJECT(${BOARD} C CXX ASM)
# set(CMAKE_VERBOSE_MAKEFILE ON)
ENABLE_LANGUAGE(ASM)
# 添加以下一行
set(MIDDLEWARE_DIR ${CMAKE_SOURCE_DIR}/../middleware)
# 添加以下四行
if(SEGGER_RTT_VIEW)
add_definitions(-DSEGGER_RTT_VIEW)
include_directories(${MIDDLEWARE_DIR}/segger_rtt)
endif()
include_directories(${CMAKE_SOURCE_DIR}/bsp/bsp_common/platform)
if(IS_DIRECTORY ${CMAKE_SOURCE_DIR}/bsp/board/${CHIP})
include_directories(${CMAKE_SOURCE_DIR}/bsp/board/${CHIP})
else()
message(FATAL_ERROR "${CMAKE_SOURCE_DIR}/bsp/board/${CHIP} is not exist")
endif()
# search_application(${CMAKE_SOURCE_DIR}/${APP_DIR})
search_application(${CMAKE_SOURCE_DIR}/../${APP_DIR})- 修改 bl_mcu_sdk/bsp/bsp_common/platform/bflb_platform.h 文件
/*!< 找到对应段修改为以下 */
#ifndef SEGGER_RTT_VIEW
#define MSG(a, ...) bflb_platform_printf(a, ##__VA_ARGS__)
#define MSG_DBG(a, ...) bflb_platform_printf(a, ##__VA_ARGS__)
#define MSG_ERR(a, ...) bflb_platform_printf(a, ##__VA_ARGS__)
#else
#include "segger_rtt_debug_log.h"
#define MSG LOG_INFO
#define MSG_DBG LOG_DEBUG
#define MSG_ERR LOG_ERROR
#endif/*!< 找到对应段修改为以下 */
#ifndef SEGGER_RTT_VIEW
#define LOG_D(fmt, ...) dbg_log_line("D", 0, fmt, ##__VA_ARGS__)
#define LOG_I(fmt, ...) dbg_log_line("I", 35, fmt, ##__VA_ARGS__)
#define LOG_W(fmt, ...) dbg_log_line("W", 33, fmt, ##__VA_ARGS__)
#define LOG_E(fmt, ...) dbg_log_line("E", 31, fmt, ##__VA_ARGS__)
#define LOG_RAW(...) bflb_platform_printf(__VA_ARGS__)
#else
#define LOG_D LOG_DEBUG
#define LOG_I LOG_INFO
#define LOG_W LOG_WARN
#define LOG_E LOG_ERROR
#define LOG_RAW(...) ((void)0)
#endif- 编译工程
make APP=segger_rtt- 打开jlink rtt viewer软件
- Target Device 为RISC-V (RV32)
- Target Interface 为 Jtag 12000 kHz
- scan chain 配置为Auto detection
- RTT Control Block 设置为 Search Range
- Search Range 值为 0x22010000 0x20000
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent