STM32缺货潮下，如何用WB32F103CBT6快速搭建你的第一个嵌入式项目（附完整开发指南）

最近两年，如果你还在做嵌入式开发，尤其是围绕ARM Cortex-M系列的项目，大概率已经感受到了供应链的阵阵寒意。STM32系列，这个曾经工程师们信手拈来的“瑞士军刀”，如今却常常一“芯”难求，交期动辄数十周，价格更是水涨船高。对于正在做课程设计的学生、急于打样的创业者，或是需要快速迭代产品的团队来说，这种不确定性无疑带来了巨大的困扰。我们不得不把目光投向市场，寻找那些性能相当、生态友好，并且真正能买到的替代方案。

正是在这样的背景下，像WB32这样的国产微控制器开始走进更多开发者的视野。它基于成熟的ARM Cortex-M3内核，引脚和功能与STM32F103系列高度兼容，但供货相对稳定，成本也更具优势。今天，我们就以WB32F103CBT6这颗具体型号为例，抛开泛泛而谈，直接上手实战。我会带你从零开始，完成开发环境搭建、第一个LED点灯程序、再到串口通信和中断处理，手把手搭建一个完整的、可运行的项目。过程中，我会重点指出它与STM32在库函数、时钟配置、外设使用上的那些“微妙”差异，帮你绕过移植路上的坑，真正实现快速上手和项目落地。

1. 为什么是WB32F103CBT6？——选型分析与环境准备

面对琳琅满目的替代芯片，为什么偏偏推荐WB32F103CBT6？这不仅仅是因为它名字里带着熟悉的“F103”。首先，我们需要理性地看待“替代”这件事。完美的、无需任何改动的替代品几乎不存在，我们的目标是找到一个学习成本和迁移风险最低的选项。

WB32F103CBT6的核心优势在于其与STM32F103C8T6（即常见的“蓝莓板”核心芯片）的高度相似性。两者都采用ARM Cortex-M3内核，主频最高可达72MHz（WB32实际最高支持128MHz，潜力更大），都拥有128KB Flash和20KB SRAM，外设方面也囊括了多个定时器、USART、SPI、I2C、ADC等常用模块。更重要的是，它们的引脚封装（LQFP48）完全一致。这意味着，如果你手头有一个基于STM32F103C8T6的设计，在原理图层面，你几乎可以直接替换芯片，无需改动PCB，这为硬件迁移扫清了最大的障碍。

当然，差异是存在的，主要集中在芯片内部。比如时钟树结构、部分外设的寄存器地址和位定义、以及官方提供的软件库。但这些差异，恰恰是我们这篇指南要帮你厘清和克服的重点。

开始前的准备工作清单：

  • 硬件：
    • WB32F103CBT6最小系统板一块（市面上已有不少兼容“蓝莓板”形态的开发板）。
    • USB转串口调试器（如CH340、CP2102等），用于程序下载和串口通信。
    • 面包板、LED、电阻、杜邦线等基础元件。
  • 软件：
    • Keil MDK-ARM (uVision5)：这是最主流的ARM开发环境之一，对WB32有良好的支持。你需要安装并激活（社区版有代码大小限制，但学习足够）。
    • WB32的Device Family Pack (DFP)：这是让Keil认识WB32芯片的关键。你需要从WB32官网或社区获取对应的.pack文件并安装。
    • WB32标准外设库 (Standard Peripheral Library, SPL)：类似于STM32的StdLib，它提供了一系列封装好的函数来操作外设。这是与STM32开发体验最接近的部分，也是差异开始显现的地方。
    • 串口调试助手：如SecureCRT、Putty或MobaXterm，用于查看串口打印信息。

安装好Keil和WB32的DFP后，新建工程时，你就能在Device选择列表中看到“WestBerry”分类下的WB32F103CB了。这一步的顺利通过，意味着你的软件环境已经就绪。

2. 从“Hello, LED”开始——你的第一个WB32工程

理论说得再多，不如一行代码。让我们从嵌入式世界的“Hello, World”——点亮一个LED开始。这个过程会清晰地展示WB32库开发的基本流程，并立刻感受到它与STM32的异同。

首先，在Keil中新建一个工程，选择正确的设备（WB32F103CB），并为工程添加必要的启动文件（startup_wb32f10x_hd.s）和核心外设库文件。这些文件通常包含在官方提供的固件库包中。

接下来，我们创建一个main.c文件。目标是让连接在PC13引脚（很多最小系统板将此引脚连接了一个用户LED）上的LED闪烁。

#include "wb32f10x.h" // WB32的主头文件，类似STM32的stm32f10x.h

// 简单的延时函数，通过循环实现，仅用于演示
void Delay(uint32_t nCount) {
    for(; nCount != 0; nCount--);
}

int main(void) {
    // 1. 开启GPIOC的时钟
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE);

    // 2. 初始化GPIO结构体
    GPIO_InitTypeDef GPIO_InitStructure;
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_13;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; // 推挽输出
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; // 输出速度

    // 3. 初始化GPIOC的Pin13
    GPIO_Init(GPIOC, &GPIO_InitStructure);

    while(1) {
        // 4. 点亮LED (假设低电平点亮，根据具体硬件调整)
        GPIO_ResetBits(GPIOC, GPIO_Pin_13);
        Delay(500000);
        // 5. 熄灭LED
        GPIO_SetBits(GPIOC, GPIO_Pin_13);
        Delay(500000);
    }
}

注意：RCC_APB2PeriphClockCmd这个函数名和STM32的StdLib一模一样，这是一个好消息，意味着很多基础操作在API层面是兼容的。但务必确认你包含的是wb32f10x.h而非stm32f10x.h，其内部的寄存器映射和部分宏定义是不同的。

代码写好了，还需要配置工程。在Keil的“Options for Target”中，有几处关键设置：

  • Target 标签页：确认晶振频率（通常为8MHz）。
  • C/C++ 标签页：在“Define”框中添加全局宏定义 USE_STDPERIPH_DRIVER。这告诉编译器我们要使用标准外设库。可能还需要添加 WB32F10X_HD 来指明使用的是大容量型号。
  • Debug 标签页：选择你的调试器（如ST-Link，很多WB32板子也兼容），并确保设置正确。
  • Utilities 标签页：设置Flash下载算法。你需要使用WB32专用的算法文件（.FLM），通常随DFP或固件库提供。

编译、下载、复位，如果一切顺利，你应该能看到板载LED开始规律地闪烁。恭喜你，已经成功迈出了WB32开发的第一步！这个简单的流程揭示了WB32开发的核心：利用高度相似的库函数API，但基于WB32自身的头文件和底层驱动。

3. 深入核心差异：时钟配置与串口通信实战

点亮LED只是热身，真正考验兼容性的是更复杂的外设，比如系统时钟和串口。这两者是项目的基础，也是差异容易导致问题的地方。

3.1 时钟树配置：从HSI到PLL

STM32F103的时钟源配置相对直接，而WB32F103的时钟树提供了更灵活的选项，尤其是其PLL（锁相环）的输入源和倍频系数可能不同。盲目套用STM32的时钟初始化代码大概率会失败。

WB32的固件库通常提供了一个 SystemInit() 函数，在启动文件调用 main() 之前执行，它会将系统时钟初始化为默认状态（通常是内部高速时钟HSI）。但对于需要更高性能（运行在72MHz或更高）的应用，我们必须手动配置。下面是一个将系统时钟配置为72MHz的示例：

void SystemClock_Config(void) {
    // 0. 定义错误状态变量
    ErrorStatus HSEStartUpStatus;

    // 1. 复位RCC时钟配置到默认状态（可选但推荐）
    RCC_DeInit();

    // 2. 开启HSE（外部高速晶振，假设为8MHz）
    RCC_HSEConfig(RCC_HSE_ON);
    // 等待HSE稳定
    HSEStartUpStatus = RCC_WaitForHSEStartUp();
    if (HSEStartUpStatus == SUCCESS) {
        // 3. 设置AHB、APB1、APB2预分频器
        // HCLK = SYSCLK
        RCC_HCLKConfig(RCC_SYSCLK_Div1);
        // PCLK1 = HCLK / 2 (APB1最大36MHz)
        RCC_PCLK1Config(RCC_HCLK_Div2);
        // PCLK2 = HCLK / 1 (APB2最大72MHz)
        RCC_PCLK2Config(RCC_HCLK_Div1);

        // 4. 配置PLL
        // PLL来源：HSE， 倍频系数：9倍 -> 8MHz * 9 = 72MHz
        // 注意：WB32的PLL配置函数参数可能与STM32不同，务必查阅WB32的库函数手册
        RCC_PLLConfig(RCC_PLLSource_HSE_Div1, RCC_PLLMul_9);

        // 5. 开启PLL并等待就绪
        RCC_PLLCmd(ENABLE);
        while (RCC_GetFlagStatus(RCC_FLAG_PLLRDY) == RESET);

        // 6. 切换系统时钟源到PLL
        RCC_SYSCLKConfig(RCC_SYSCLKSource_PLLCLK);
        while (RCC_GetSYSCLKSource() != 0x08); // 检查时钟源是否切换成功
    } else {
        // HSE启动失败，可以在这里处理错误，例如切换到HSI
        // ...
    }
}

提示：RCC_PLLConfig函数的第二个参数（倍频系数）的宏定义，在WB32和STM32中可能完全不同。例如，RCC_PLLMul_9在STM32中代表9倍频，但在WB32库中可能是另一个名字或值。这是移植时第一个需要仔细核对数据手册和库头文件的地方。

3.2 串口通信与printf重定向

串口是调试和通信的命脉。在WB32上配置USART1（通常连接USB转串口）与STM32流程相似，但寄存器基地址和部分控制位需要适应WB32的定义。

首先，初始化USART1和对应的GPIO（PA9为TX，PA10为RX）：

void USART1_Config(void) {
    GPIO_InitTypeDef GPIO_InitStructure;
    USART_InitTypeDef USART_InitStructure;

    // 1. 开启时钟
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE);

    // 2. 配置GPIO
    // PA9 - USART1_TX 复用推挽输出
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init(GPIOA, &GPIO_InitStructure);
    // PA10 - USART1_RX 浮空输入
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING;
    GPIO_Init(GPIOA, &GPIO_InitStructure);

    // 3. 配置USART参数
    USART_InitStructure.USART_BaudRate = 115200;
    USART_InitStructure.USART_WordLength = USART_WordLength_8b;
    USART_InitStructure.USART_StopBits = USART_StopBits_1;
    USART_InitStructure.USART_Parity = USART_Parity_No;
    USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx;
    USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None;
    USART_Init(USART1, &USART_InitStructure);

    // 4. 使能USART
    USART_Cmd(USART1, ENABLE);
}

接下来，为了能方便地使用printf函数通过串口打印信息，我们需要重定向fputc函数。这与在STM32上的做法几乎完全相同：

#include <stdio.h> // 添加标准IO头文件

// 重定向C库的printf函数到USART1
int fputc(int ch, FILE *f) {
    // 等待发送数据寄存器为空
    while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) == RESET);
    // 发送一个字节
    USART_SendData(USART1, (uint8_t)ch);
    return ch;
}

现在，你可以在main函数中调用printf(“Hello WB32!\r\n”);，并在串口调试助手中看到输出了。这个过程再次验证了：应用层代码逻辑可以高度复用，但底层驱动必须使用WB32自己的库。

4. 中断与定时器：处理更复杂的任务

任何实用的嵌入式项目都离不开中断和定时器。WB32的NVIC（嵌套向量中断控制器）和定时器外设与Cortex-M3标准架构一致，因此概念上是通用的，但具体到寄存器配置和中断服务函数名，仍需遵循WB32的规则。

4.1 外部中断（EXTI）配置示例

假设我们想用PC13引脚（连接着按键）触发外部中断，来控制LED的开关。

// 在main函数初始化部分添加
void EXTI_Config(void) {
    GPIO_InitTypeDef GPIO_InitStructure;
    EXTI_InitTypeDef EXTI_InitStructure;
    NVIC_InitTypeDef NVIC_InitStructure;

    // 1. 开启GPIOC和AFIO时钟（EXTI需要AFIO）
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC | RCC_APB2Periph_AFIO, ENABLE);

    // 2. 配置PC13为上拉输入（连接按键，按下接地）
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_13;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU;
    GPIO_Init(GPIOC, &GPIO_InitStructure);

    // 3. 将PC13连接到EXTI13
    GPIO_EXTILineConfig(GPIO_PortSourceGPIOC, GPIO_PinSource13);

    // 4. 配置EXTI13为下降沿触发（按键按下）
    EXTI_InitStructure.EXTI_Line = EXTI_Line13;
    EXTI_InitStructure.EXTI_Mode = EXTI_Mode_Interrupt;
    EXTI_InitStructure.EXTI_Trigger = EXTI_Trigger_Falling;
    EXTI_InitStructure.EXTI_LineCmd = ENABLE;
    EXTI_Init(&EXTI_InitStructure);

    // 5. 配置NVIC，使能EXTI15_10中断通道
    NVIC_InitStructure.NVIC_IRQChannel = EXTI15_10_IRQn; // 注意中断向量名
    NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 0x0F;
    NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0x0F;
    NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;
    NVIC_Init(&NVIC_InitStructure);
}

// 中断服务函数
void EXTI15_10_IRQHandler(void) { // 函数名必须与启动文件中定义的一致
    if (EXTI_GetITStatus(EXTI_Line13) != RESET) {
        // 清除中断挂起位
        EXTI_ClearITPendingBit(EXTI_Line13);
        // 执行你的任务，例如翻转LED
        GPIO_WriteBit(GPIOC, GPIO_Pin_13, (BitAction)(1 - GPIO_ReadOutputDataBit(GPIOC, GPIO_Pin_13)));
    }
}

4.2 系统定时器SysTick的使用

SysTick是Cortex-M3内核自带的定时器，常用于产生精确延时或作为实时操作系统的心跳。其用法在WB32和STM32上几乎没有任何区别，因为它是内核级别的。

// 初始化SysTick，每1ms产生一次中断
void SysTick_Init(void) {
    // SystemCoreClock 是系统时钟频率，需要在SystemClock_Config()后正确设置
    if (SysTick_Config(SystemCoreClock / 1000)) {
        // 初始化失败处理
        while (1);
    }
}

// SysTick中断服务函数
void SysTick_Handler(void) { // 函数名是固定的
    // 这里可以放置你的毫秒级定时任务
    // 例如，递增一个全局的毫秒计数器
    msTicks++;
}

通过这两个例子可以看出，对于标准化的内核组件（如NVIC、SysTick），代码移植性极好。差异主要出现在**芯片厂商自定义的外设（如EXTI映射、定时器高级功能）**上，这些都需要仔细查阅WB32的参考手册。

5. 项目移植策略与调试技巧

当你手头有一个STM32F103的项目，想要迁移到WB32F103CBT6时，遵循一个清晰的策略可以事半功倍。

5.1 移植检查清单

检查项STM32F103WB32F103行动建议
核心头文件stm32f10x.hwb32f10x.h全局替换包含路径和宏定义（如STM32F10X_HD -> WB32F10X_HD）。
启动文件startup_stm32f10x_hd.sstartup_wb32f10x_hd.s在工程中替换启动文件。
外设库文件stm32f10x_xxx.c/.hwb32f10x_xxx.c/.h替换整个库文件组，注意函数名可能相同但实现不同。
时钟配置特定的PLL倍频、分频设置参考WB32参考手册的时钟树章节重写SystemClock_Config()函数，切勿直接复制。
引脚复用/重映射通过AFIO->MAPR等寄存器WB32可能有自己的重映射寄存器仔细核对WB32数据手册的GPIO章节。
中断向量表在启动文件中定义在WB32启动文件中定义确保中断服务函数名与WB32启动文件中的一致。
Flash编程算法STM32的.FLM文件WB32专用的.FLM文件在Keil的下载配置中更新算法文件。

5.2 调试中的常见“坑”与解决思路

  1. 程序下载后不运行：首先检查启动模式引脚（BOOT0/BOOT1）的设置是否正确，应设置为从主Flash启动（通常都是）。其次，检查SystemInit()函数是否被执行，系统时钟是否成功配置。可以用一个简单的GPIO翻转程序，不依赖任何复杂初始化，来测试最基础的运行环境。
  2. 串口无输出：
    • 电平问题：确认USB转串口模块是3.3V电平，并与WB32板子共地。
    • 引脚映射：确认USART的TX/RX引脚是否与STM32项目一致，WB32的引脚复用功能可能需要单独配置。
    • 时钟使能：确认不仅使能了USART时钟，还使能了对应GPIO端口的时钟。
    • 库函数差异：单步调试，查看USART_SendData函数执行后，USART_FLAG_TXE标志位是否被置起。
  3. 中断不触发：
    • 中断服务函数名：这是最常见的问题。务必打开WB32的启动文件（.s），找到中断向量表，核对EXTI15_10_IRQHandler这类函数名的确切拼写。
    • 中断优先级分组：在配置NVIC前，先调用NVIC_PriorityGroupConfig()设置优先级分组方式，确保整个项目使用统一的分组。
    • 中断使能：检查外设自身的中断使能位（如EXTI的IMR）、NVIC中的通道使能是否都已打开。
  4. 外设功能异常（如PWM输出不对、ADC采样值不准）：
    • 时钟频率：再次确认APB1/APB2总线时钟是否正确配置。定时器的时钟源可能来自APB总线倍频，计算错误会导致频率偏差。
    • 寄存器位定义：虽然库函数名一样，但底层寄存器某个控制位的含义或位置可能微调。遇到奇怪现象时，直接阅读WB32外设库函数的源码，看它最终操作了哪个寄存器的哪一位，并与STM32的实现对比。

调试WB32项目，一个逻辑分析仪或示波器是极其有用的工具，可以直观地查看GPIO波形、串口数据、PWM信号等，快速定位是软件配置问题还是硬件连接问题。

最后，我想说的是，从STM32转向WB32，更像是一次“换壳不换芯”的旅程。ARM Cortex-M3的内核和生态系统是坚实的共同基础，主要的适应成本在于熟悉一套新的数据手册、库函数手册和社区资源。这个过程初期可能会有些磕绊，比如需要花时间寻找某个特定功能的示例代码，但一旦你成功搭建起第一个项目，并理解了那些关键的差异点，后续的开发就会顺畅很多。毕竟，在芯片短缺成为常态的今天，拥有快速适配第二供应商的能力，本身就是一项宝贵的技能。希望这份指南能成为你探索WB32世界的第一块垫脚石，剩下的，就交给代码和时间吧。

Logo
乐奇 Rokid 开放社区

更多推荐

镜游小导：运行在 Rokid AR 眼镜上的景区实景讲解智能体

项目以 RokidAIUI 开放智能体形态交付：页面用.ink描述，运行在眼镜端智能体运行时，直接调用系统能力。AGENTS.md身份镜游小导v1.0.0，景区 AR 实景讲解智能体；权限（Capabilities）microphonenetworkaudiogyroscope；技能（Skills）。

avatar 乐奇 Rokid 开放社区

宠小护 · 住在 Rokid AR 眼镜里的宠物健康管家

一共定义了 8 类意图，LLM 轨和正则轨共用同一套定义：INTENT用户大概会怎么说关键槽位addPet我家猫咪叫团子，英短，4公斤addEvent团子上个月20号打了疫苗团子的档案petNamequeryDue有什么该做的 / 下次驱虫什么时候eventType（可选）好的 / 做完了 / 驱过了无，作用于当前提醒卡removePet把团子的档案删了petNamechitchat猫能吃巧克力吗

avatar 乐奇 Rokid 开放社区
cover

2027中国智能眼镜展｜科技前沿 · 视界新启

avatar 乐奇 Rokid 开放社区