1. 环境准备与工具安装

在开始STM32F103VCT6的RT-Thread BSP定制之前，我们需要准备好开发环境。这里我推荐使用RT-Thread官方提供的env工具链，它集成了编译、配置、打包等全套功能，用起来特别顺手。

首先去RT-Thread官网下载env工具包，解压后直接运行env.exe。这个工具不需要复杂的安装过程，解压即用，特别适合新手。我习惯把它放在D盘的根目录下，这样路径简单不容易出错。第一次运行时可能会提示注册环境变量，选择"是"就可以了。

接下来我们需要获取RT-Thread源码。使用git命令克隆国内gitee镜像站的代码库，这样下载速度会快很多：

git clone https://gitee.com/rtthread/rt-thread.git

克隆完成后，进入rt-thread/bsp/stm32目录，这里包含了所有STM32系列的BSP支持包。我们需要基于现有的模板来创建自己的BSP，而不是从头开始写，这样可以节省大量时间。

2. 创建自定义BSP工程

找到bsp/stm32/libraries/templates目录，这里存放着BSP模板文件。我把整个templates文件夹复制到bsp/stm32目录下，然后改名为stm32f103-custom-vct6，这样就能清楚地知道这是为STM32F103VCT6定制的BSP。

进入新建的stm32f103-custom-vct6/board/CubeMX_Config目录，用STM32CubeMX打开CubeMX_Config.ioc文件。这里有个小技巧：如果你还没有安装STM32CubeMX，建议安装最新版本，因为新版本对RT-Thread的支持更好。

在CubeMX中，首先需要更改MCU型号。点击"MCU Selector"，搜索STM32F103VCT6，选择LQFP-100封装的型号。这一步很重要，因为不同封装的引脚定义可能不同，选错了会导致后续的引脚配置全部对不上。

接着配置时钟系统。使能外部高速时钟（HSE），选择外部晶振作为时钟源。STM32F103VCT6的最高主频是72MHz，我们需要通过PLL倍频来实现这个频率。具体配置是：HSE输入8MHz，PLL倍频9倍，得到72MHz系统时钟。APB1总线时钟设置为36MHz，APB2总线时钟设置为72MHz，这样配置能充分发挥芯片性能。

然后配置调试接口。我推荐使用SWD接口，只需要占用两个IO口（PA13和PA14），比JTAG节省引脚资源。在SYS配置中选择Serial Wire模式，这样就能用ST-Link等调试器进行程序下载和调试了。

最后配置所需的外设。根据需求使能UART1、UART4和SPI3。UART1通常用作调试串口，波特率设置为115200；UART4根据实际需要配置参数；SPI3配置为全双工主模式，时钟极性低电平，相位第一个边沿，8位数据帧。配置完成后点击"GENERATE CODE"生成代码。

3. 关键文件修改与配置

现在开始修改BSP的核心配置文件。首先是链接脚本link.sct，这个文件决定了代码和数据在内存中的布局。STM32F103VCT6有256KB Flash和48KB RAM，所以需要相应调整内存映射。

打开link.sct文件，修改Flash大小为0x40000（256KB），RAM大小为0xC000（48KB）。具体配置如下：

LR_IROM1 0x08000000 0x00040000 {
    ER_IROM1 0x08000000 0x00040000 {
        *.o (RESET, +First)
        *(InRoot$$Sections)
        .ANY (+RO)
    }
    RW_IRAM1 0x20000000 0x0000C000 {
        .ANY (+RW +ZI)
    }
}

接下来修改board.c文件。从CubeMX生成的main.c文件中复制SystemClock_Config函数，替换掉board.c中的同名函数。这个函数包含了完整的时钟树配置，确保系统时钟、总线时钟和外设时钟都正确设置。我建议在复制后仔细检查每个时钟配置参数，特别是PLL倍频数和分频系数，这些直接影响系统运行速度。

然后修改board.h文件，更新Flash和RAM的大小定义：

#define STM32_FLASH_SIZE (256 * 1024)
#define STM32_SRAM_SIZE 48

还需要修改堆栈相关的定义。HEAP_BEGIN指向BSS段结束地址，HEAP_END指向SRAM结束地址，这样RT-Thread的内存管理器就能正确管理可用内存空间。

Kconfig文件的修改很重要，它决定了menuconfig配置界面中可选的选项。我们需要使能GPIO、UART1、UART4和SPI3驱动，并根据实际需求配置DMA支持。特别是UART4，默认是不使能的，需要手动打开：

config BSP_USING_UART4
    bool "Enable UART4"
    default y

SConscript文件也需要调整，确保编译系统能正确找到源文件和头文件路径。由于不同版本的CubeMX生成的文件路径可能略有不同，需要根据实际情况调整stm32f1xx_hal_msp.c文件的路径：

src = Split('''
board.c
CubeMX_Config/CubeMX_Config/Core/Src/stm32f1xx_hal_msp.c
''')

4. Keil工程配置与生成

现在修改MDK工程模板。打开template.uvprojx文件，首先修改芯片型号为STM32F103VC，然后配置Flash下载算法。由于STM32F103VCT6的Flash容量是256KB，需要选择正确的Flash算法，否则下载程序时可能会出错。

在配置Flash算法时，我建议选择"STM32F10x High-density Flash算法"，这个算法支持128KB到512KB的Flash容量。同时勾选"Reset and Run"选项，这样程序下载后会自动运行，不需要手动复位。

接下来生成最终的Keil工程。在env环境中右键打开ConEmu，输入menuconfig命令进入配置界面。在这里可以看到刚才在Kconfig中配置的选项，检查UART4和SPI3是否已经使能。如果发现某些选项没有出现，可能是Kconfig语法有错误，需要回头检查。

配置完成后保存退出，然后执行scons --target=mdk5命令生成Keil工程。这个命令会根据当前的配置生成完整的MDK5工程文件，包括源文件组、头文件路径和编译选项。

生成完成后用Keil打开project.uvprojx文件，编译整个工程。第一次编译可能会有些警告，主要是未使用的变量或参数，这些一般不影响运行。如果出现错误，需要根据错误信息检查相应的源文件或配置。

5. 调试与验证

工程编译通过后，就可以下载到开发板进行调试了。连接ST-Link调试器，选择SWD接口模式，设置下载后自动复位和运行。第一次下载建议先不要运行，而是暂停程序，检查PC指针是否指向Reset_Handler，这样可以确认程序是否正常启动。

如果程序能够正常运行，接下来验证各个外设是否工作正常。首先测试调试串口（通常是UART1），通过串口助手发送和接收数据，确认波特率和数据格式正确。然后测试UART4，方法类似。最后测试SPI3，可以通过连接SPI Flash或传感器来验证通信是否正常。

在调试过程中可能会遇到各种问题，比如时钟配置错误、引脚复用冲突、DMA配置不当等。这时候需要耐心排查，首先检查CubeMX中的配置，然后查看生成的代码，最后确认BSP中的驱动实现。我建议每次只测试一个功能，逐步验证，这样更容易定位问题。

6. 常见问题与解决方案

在实际移植过程中，我遇到过几个典型问题。首先是时钟配置错误，导致系统运行频率不对。解决方法是在SystemClock_Config函数中添加时钟频率验证代码，通过读取RCC相关寄存器确认实际时钟频率。

第二个常见问题是内存分配错误。由于STM32F103VCT6的RAM只有48KB，需要合理配置堆栈大小。在rtconfig.h中修改RT_HEAP_SIZE，建议设置为20-30KB，留出足够空间给系统和应用。

第三个问题是外设中断冲突。多个外设使用相同的中断优先级可能导致系统不稳定。建议在CubeMX中合理分配中断优先级，系统关键中断（如SysTick、PendSV）设置为最高优先级，外设中断根据实际需求分配。

还有一个容易忽略的问题是引脚复用冲突。同一个引脚可能被多个外设复用，需要在CubeMX中仔细检查引脚分配。特别是调试接口（SWD）使用的PA13和PA14，不要被其他外设占用。

最后是编译问题，可能由于文件路径错误或编译器选项不当导致。建议定期执行scons --clean清除中间文件，然后重新编译。如果使用AC6编译器，需要注意某些编译选项与AC5不同。

7. 优化与进阶配置

BSP基本功能调试通过后，可以考虑进行一些优化。首先是电源管理，启用RT-Thread的PM组件，配置低功耗模式。STM32F103支持睡眠、停机和待机模式，可以根据实际应用场景选择合适的低功耗策略。

其次是文件系统支持。如果应用需要存储数据，可以添加SPI Flash驱动和FATFS文件系统。RT-Thread提供了完整的软件包，只需要在menuconfig中使能相应选项即可。

网络功能也是常见的需求。虽然STM32F103没有以太网接口，但可以通过SPI接口连接W5500等硬件TCP/IP芯片实现网络功能。RT-Thread的wiznet软件包提供了完整支持。

最后考虑添加调试和日志功能。除了串口调试外，可以添加SEGGER_RTT或ULog组件，提供更多的调试手段。特别是在资源受限的环境中，轻量级的日志系统很有帮助。

在整个移植过程中，我建议保持代码的整洁和可维护性。及时添加注释，使用版本控制系统管理代码变更，定期备份重要文件。这样即使遇到问题，也能快速回退到之前的稳定版本。

移植完成后，建议编写详细的文档，记录配置步骤、注意事项和测试结果。这不仅有助于后续维护，也能帮助其他开发者快速上手。毕竟好的文档和好的代码同样重要。