BSP与启动

文档版本：V1.0 | 适用系统：RT-Thread | 适用硬件：C-3576BQ V10 核心板 + M4-R2（ShimetaPi）底板 | 更新日期：2026-10-23

1. 概述

1.1 功能简介

BSP（Board Support Package）是 RT-Thread 在 M4-R2（RK3576）硬件平台上运行的基础支撑层，负责将 RT-Thread 内核与具体硬件（时钟、引脚、中断、外设控制器）对接。在 RK3576 平台上，BSP 的核心任务包括：

• 硬件初始化：完成 SoC 时钟树、IOMUX、内存控制器的配置
• 外设驱动注册：将 UART、GPIO、I2C 等外设接入 RT-Thread 设备框架
• 控制台建立：初始化调试串口，使 RT-Thread shell（finsh/msh）可用
• 启动引导：从 U-Boot 加载 RT-Thread 镜像并跳转执行

1.2 应用场景

场景	说明
调试串口通信	通过底板 DEBUG 串口连接 RT-Thread shell，进行交互式调试
裸机外设驱动开发	基于 BSP 框架编写 UART/I2C/SPI 等外设驱动
AMP 多核异构	RT-Thread 运行在 RK3576 的 Cortex-A53 核心（32 位模式），与 Linux 协同
实时控制	利用 RT-Thread 实时性处理电机控制、传感器采集等任务

1.3 工作原理

RT-Thread BSP 的启动流程分为五个阶段：

1. U-Boot 引导：U-Boot 将 RT-Thread 镜像从存储介质加载到 DDR 内存
2. 镜像跳转：U-Boot 跳转到 RT-Thread 镜像入口点（entry point）
3. 板级初始化：执行 rt_hw_board_init()，完成时钟、引脚、内存映射
4. 内核初始化：RT-Thread 内核启动，调度器、定时器、设备框架就绪
5. 控制台就绪：UART 驱动初始化完成，finsh/msh shell 可交互

---

2. 硬件准备

2.1 开发板

组件	型号	验证状态
核心板	C-3576BQ V10	已验证
底板	M4-R2（ShimetaPi）	已验证
SoC	RK3576（4×Cortex-A72 + 4×Cortex-A53）	已验证

2.2 调试串口连接

M4-R2 调试串口为底板 DEBUG 串口（4pin/1.0mm，3.3V 电平，波特率 1500000）。底板原理图（S-04）中调试串口网络标注为 UART0_TX_M0_DEBUG（GPIO0_D4_D）和 UART0_RX_M0_DEBUG（GPIO0_D5_D），PMUIO1 域。通过 USB 转 TTL 模块连接底板调试串口座。

信号	底板引脚	USB 转 TTL 引脚
TX	UART0_TX_M0_DEBUG（DEBUG 串口）	RXD
RX	UART0_RX_M0_DEBUG（DEBUG 串口）	TXD
GND	GND	GND

来源：S-04 底板原理图 / S-06 IO Domains（已验证） 一致性说明：规格书（S-01）将调试串口标为 UART2（RX2/TX2），底板原理图（S-04）标注为 UART0_TX_M0_DEBUG/UART0_RX_M0_DEBUG，两者命名不一致，具体以实际物料与 SDK 配置为准（待板上验证）。波特率 1500000bps，3.3V 电平。

2.3 必要工具

工具	用途
USB 转 TTL 模块	连接调试串口（3.3V 电平）
Type-C 数据线	供电及数据传输
串口终端软件	PuTTY / minicom / MobaXterm

---

3. 软件准备

3.1 RT-Thread 源码

RT-Thread 官方 BSP 仓库中包含 Rockchip 系列的 BSP 支持。获取方式：

# 方式一：通过 RT-Thread Env 工具拉取
# 先安装 env 工具，再通过 menuconfig 选择 RK3576 BSP

# 方式二：直接克隆 RT-Thread 官方仓库
git clone https://github.com/RT-Thread/rt-thread.git

3.2 RK3576 BSP 目录结构

RT-Thread 对 Rockchip 系列的 BSP 支持位于 bsp/rockchip/ 目录下（RK3576 具体板级子目录名称待 RK3576 AMP SDK 实际目录确认，待板上验证）：

bsp/rockchip/
├── SConscript              # SCons 构建脚本
├── SConstruct              # 顶层构建脚本
├── Kconfig                 # menuconfig 菜单定义
├── rk3576_xxx/             # RK3576 具体板级 BSP（名称以实际 SDK 为准）
│   ├── board/
│   │   ├── board.c         # 板级初始化入口
│   │   ├── Kconfig         # 板级配置选项
│   │   └── link.lds        # 链接脚本
│   ├── applications/       # 用户应用代码
│   └── packages/           # 软件包目录
└── common/
    └── hal/                # Rockchip HAL 硬件抽象层

3.3 RT-Thread Env 工具

用于配置、编译 RT-Thread 工程：

# 安装 Python 依赖
pip install rt-thread

# 或通过 SCons 编译（需先配置）
cd bsp/rockchip/<rk3576 板级目录>/
scons --menuconfig

3.4 defconfig 配置文件

RT-Thread 的默认配置通过 defconfig 文件管理。RK3576 BSP 的 defconfig 位于 BSP 根目录或 rtos/rt-thread/ 目录下（具体路径待板上验证）。

关键配置项（调试串口对应的 UART 序号以实际 BSP 与 SDK 配置为准）：

# 启用串口设备框架
CONFIG_RT_USING_SERIAL=y

# 启用调试串口作为控制台（M4-R2 调试串口为 UART0_M0_DEBUG，规格书标 UART2，以实际 SDK 为准）
CONFIG_RT_USING_UARTx=y
CONFIG_USING_SERIAL_DRIVER=y

# 启用 finsh/msh shell
CONFIG_RT_USING_FINSH=y
CONFIG_FINSH_USING_MSH=y
CONFIG_FINSH_THREAD_STACK_SIZE=4096

---

4. 操作步骤

4.1 获取并配置 BSP

步骤 1：获取 RT-Thread 源码

git clone https://github.com/RT-Thread/rt-thread.git
cd rt-thread

步骤 2：进入 RK3576 BSP 目录

cd bsp/rockchip/<rk3576 板级目录>

路径待板上验证，以实际 RT-Thread 版本中 RK3576 BSP 位置和 RK3576 AMP SDK 为准。

步骤 3：执行 menuconfig 配置

scons --menuconfig

在 menuconfig 中依次确认以下配置：

RT-Thread Common Setup --->
    [*] Using C++ language    # 如需 C++ 支持

RT-Thread Components --->
    [*] Device framework      # 设备框架
        [*] Using serial device drivers  # 串口驱动
        [*] Using device I/O carriers    # I/O 框架

RT-Thread Components --->
    Finsh Shell --->
        [*] Using finsh shell
        [*] Using MSH shell
        (finsh) The stack size of finsh thread

步骤 4：配置 UART 控制台

在 Kconfig 中确保调试串口对应的 UART 被选为控制台设备：

Board Type (RK3576) --->
    Select Console UART --->
        (X) UARTx   # 以实际 BSP Kconfig 为准（M4-R2 调试串口，待板上确认）

UART 控制台选择待板上验证，具体选项名称以 BSP Kconfig 为准。

4.2 编译

scons -j$(nproc)

编译成功后会在当前目录生成 rtthread.bin 或 rtthread.elf 文件。

4.3 烧录与启动

通过 U-Boot 加载 RT-Thread 镜像（待板上验证，以下为参考方法）：

方式一：通过 TFTP 加载

# 在 U-Boot 命令行中执行
setenv ipaddr 192.168.1.100
setenv serverip 192.168.1.100
tftp 0x02000000 rtthread.bin
go 0x02000000

方式二：通过 SD 卡 / TF 卡加载

# 将 rtthread.bin 拷贝到 TF 卡
cp rtthread.bin /media/sdcard/
# 在 U-Boot 中从 TF 卡加载
load mmc 0:1 0x02000000 rtthread.bin
go 0x02000000

说明：M4-R2 支持 TF 卡（SD 3.0，最高 128GB）启动，也可使用 USB OTG 烧录（详见系统烧录指南）。

4.4 验证启动

打开串口终端，波特率设置为 1500000（与底板调试串口一致），复位开发板后应看到 RT-Thread 启动日志和 finsh/msh 提示符。

---

5. 代码详解

5.1 RT-Thread UART 驱动架构

RT-Thread 串口驱动位于 components/drivers/serial/ 目录：

文件	功能
serial.c	串口设备框架，提供统一的 rt_device 接口
serial_core.c	串口核心层，管理串口设备注册与数据收发

RT-Thread 提供的串口设备 API：

API	功能
rt_device_find("uartx")	查找指定名称的串口设备
rt_device_open(device, RT_DEVICE_FLAG_RDWR)	打开串口设备
rt_device_read(device, offset, buffer, size)	从串口读取数据
rt_device_write(device, offset, buffer, size)	向串口写入数据
rt_device_control(device, cmd, arg)	控制串口参数（波特率等）

5.2 RK3576 UART 控制器特性

RK3576 的 UART 控制器（基于 Rockchip UART IP）具备以下特性（具体以实际发布的 RK3576 SDK/TRM 为准，待板上确认）：

• 兼容 16550A 标准
• 支持中断模式和 DMA 模式
• 核心板最多支持 7 路 UART（已验证，S-02）
• 调试串口：底板 DEBUG 串口（UART0_M0_DEBUG 网络，规格书标 UART2，待板上确认）

参考说明：UART 控制器具体特性（波特率上限、FIFO 深度等）以 RK3576 TRM 和实际 BSP 代码为准。

5.3 板级初始化代码

板级初始化入口位于 board.c 中的 rt_hw_board_init() 函数。该函数在 RT-Thread 内核启动前执行，完成硬件底层配置。

UART 初始化流程示意（参考代码）：

#include <rtthread.h>
#include <rtdevice.h>

/* UART IOMUX 配置 —— 基于 HAL 层接口 */
static void uart_debug_pinmux_init(void)
{
    /* 配置调试串口 TX/RX 引脚复用 */
    /* HAL_PINCTRL_SetIOMUX() 接口来自 Rockchip HAL 层 */
    /* M4-R2 调试串口网络：UART0_TX_M0_DEBUG（GPIO0_D4_D） */
    /*                     UART0_RX_M0_DEBUG（GPIO0_D5_D） */
    /* 具体引脚编号以 RK3576 数据手册和底板原理图为准 */

    /* 代码实现待板上验证 */
}

/* UART 时钟使能 */
static void uart_debug_clock_enable(void)
{
    /* 使能调试 UART 控制器时钟 */
    /* 具体寄存器地址和时钟源以 RK3576 TRM 为准 */
    /* 代码实现待板上验证 */
}

/* 板级初始化入口 */
void rt_hw_board_init(void)
{
    /* 1. 时钟初始化 */
    /* rt_hw_clock_init(); */  /* 待板上验证 */

    /* 2. 引脚复用配置 */
    uart_debug_pinmux_init();

    /* 3. UART 时钟使能 */
    uart_debug_clock_enable();

    /* 4. 中断注册（中断模式）或 DMA 通道分配（DMA 模式） */
    /* 代码实现待板上验证 */

    /* 5. 系统定时器初始化 */
    /* rt_system_timer_init(); */  /* 待板上验证 */

    /* 6. 堆内存初始化 */
    /* rt_system_heap_init(); */   /* 待板上验证 */
}

上述代码为流程示意，非可直接编译的完整实现。RK3576 HAL 层接口的具体调用方式以 Rockchip RT-Thread BSP 官方代码为准。

5.4 UART 驱动注册示例

#include <rtdevice.h>

/* 注册调试 UART 为 RT-Thread 设备 */
static int rt_hw_uart_debug_init(void)
{
    struct rt_serial_device *serial;

    /* 初始化 UART 控制器寄存器 */
    /* 配置波特率、数据位、停止位、校验位 */

    /* 注册到 RT-Thread 设备框架 */
    /* rt_hw_serial_register(serial, "uartx", RT_DEVICE_FLAG_RDWR, ...); */

    return RT_EOK;
}
INIT_BOARD_EXPORT(rt_hw_uart_debug_init);

INIT_BOARD_EXPORT 宏使该函数在板级初始化阶段自动执行。具体实现待板上验证。

5.5 UART 使用示例

用户应用中通过设备框架接口操作 UART：

#include <rtthread.h>
#include <rtdevice.h>

int uart_example(void)
{
    rt_device_t uart_dev;
    char tx_buf[] = "Hello from RK3576 RT-Thread!\r\n";
    char rx_buf[64];
    rt_size_t rx_len;

    /* 1. 查找 UART 设备（设备名以 BSP 注册名为准） */
    uart_dev = rt_device_find("uartx");
    if (uart_dev == RT_NULL) {
        rt_kprintf("UART device not found!\n");
        return -RT_ERROR;
    }

    /* 2. 打开设备 */
    if (rt_device_open(uart_dev, RT_DEVICE_FLAG_RDWR) != RT_EOK) {
        rt_kprintf("Failed to open UART!\n");
        return -RT_ERROR;
    }

    /* 3. 发送数据 */
    rt_device_write(uart_dev, 0, tx_buf, sizeof(tx_buf) - 1);

    /* 4. 接收数据（非阻塞） */
    rx_len = rt_device_read(uart_dev, 0, rx_buf, sizeof(rx_buf) - 1);
    if (rx_len > 0) {
        rx_buf[rx_len] = '\0';
        rt_kprintf("Received: %s\n", rx_buf);
    }

    /* 5. 关闭设备 */
    rt_device_close(uart_dev);

    return RT_EOK;
}

---

6. 常见问题

6.1 编译报错找不到 BSP 目录

现象：执行 scons --menuconfig 提示找不到 RK3576 BSP。

可能原因：当前 RT-Thread 版本未包含 RK3576 BSP，或 BSP 目录路径不同。

处理方法：确认使用的 RT-Thread 版本支持 RK3576；检查 bsp/rockchip/ 下是否存在对应的 RK3576 板级目录。如不存在，需使用支持 RK3576 的 RT-Thread 版本或参考 Rockchip 官方 RK3576 AMP SDK。

6.2 串口无输出

现象：编译烧录后串口终端无任何输出。

可能原因：

• 串口波特率设置不正确（底板调试串口波特率为 1500000）
• 调试串口未被选为控制台设备
• IOMUX 未正确配置

处理方法：

1. 确认串口终端波特率设置为 1500000
2. 检查 menuconfig 中调试串口对应的 UART 是否已选为 console
3. 确认 defconfig 中串口设备配置已启用

6.3 缺少 finsh/shell 提示符

现象：串口有启动日志但无交互式 shell。

可能原因：finsh/msh 组件未启用。

处理方法：在 menuconfig 中启用 RT_USING_FINSH 和 FINSH_USING_MSH。

---

7. 相关文档

文档	说明
RT-Thread环境与工程入口	AMP 架构、SDK 目录、构建流程入口
CAN-FD与UART	RT-Thread 外设驱动详解（CAN-FD、UART）
Linux与RTOS_AMP	Linux + RTOS AMP 多核异构方案
核心板参数	调试串口引脚、UART 网络标注等硬件事实
UART串口驱动	Linux 侧 UART 驱动（对照参考）
系统烧录指南	烧录工具与 LOADER 模式

---