1. 项目概述

USBDevice_STM32F103 是一个面向 STM32F103 系列微控制器的轻量级 USB 设备协议栈实现，专为资源受限的 Cortex-M3 嵌入式平台设计。该项目并非基于 ST 官方 USB 库（如 STM32_USB_Device_Library），而是采用自主精简实现路径，聚焦于 CDC ACM（Communication Device Class - Abstract Control Model）类设备功能，即标准虚拟串口（Virtual COM Port, VCP）。其核心目标是提供一种零依赖、可移植性强、内存占用极低的 USB 通信方案，适用于 NUCLEO-F103RB、STM32F103C8T6（“Blue Pill”）及 Maple Mini 三类主流开发板。

该协议栈完全运行在裸机（Bare Metal）环境下，不依赖 RTOS、CMSIS-RTOS 封装或任何中间件层，所有 USB 协议状态机、端点管理、描述符处理与数据收发均通过直接操作 STM32F103 的 USB 专用寄存器（CNTR、ISTR、BTABLE、DADDR、BTABLE 等）完成。整个固件代码体积控制在 4–6 KB Flash 范围内（含启动代码与最小系统初始化），SRAM 占用低于 512 字节，满足典型 F103C8T6（64 KB Flash / 20 KB SRAM）的严苛资源约束。

项目设计哲学强调“硬件即文档”：所有 USB 控制逻辑与中断服务程序（ISR）均以 C 语言显式编写，无宏展开隐藏行为；关键时序（如复位恢复、SOF 同步、NACK 重试）严格遵循 USB 2.0 Low-Speed/Full-Speed 规范；端点缓冲区（EPxR 寄存器配置）与双缓冲区（Double Buffering）机制被明确建模，避免隐式 DMA 或自动翻转带来的调试盲区。这种设计使开发者能完整掌控 USB 底层行为，便于在工业现场调试 USB 连接抖动、主机枚举失败、数据丢包等实际问题。

2. 硬件平台适配与引脚映射

USBDevice_STM32F103 支持三类物理板卡，其 USB PHY 接口与系统时钟配置存在显著差异，需在 usb_conf.h 中精确配置：

板卡型号	USB PHY 类型	D+/D− 引脚	时钟源	USBCLK 配置方式	备注
NUCLEO-F103RB	内部 PHY	PA11/PA12	HSE + PLL	RCC_USBCLKConfig(RCC_USBCLKSource_PLLCLK_Div1_5)	标准 72 MHz 系统时钟下 USBCLK = 48 MHz
STM32F103C8T6	内部 PHY	PA11/PA12	HSI + PLL	RCC_USBCLKConfig(RCC_USBCLKSource_PLLCLK_Div1_5)	HSI=8 MHz → PLL=72 MHz → USBCLK=48 MHz
Maple Mini	外部晶振+内部 PHY	PA11/PA12（但需外接 8 MHz 晶振）	HSE（8 MHz）	RCC_USBCLKConfig(RCC_USBCLKSource_PLLCLK_Div1_5)	必须焊接 8 MHz 晶振，否则 USB 无法同步

关键工程实践 ：
在 STM32F103C8T6 上启用 USB 时， 必须确保 HSI 校准值写入 HSICAL 寄存器 。若使用默认 HSI（8 MHz ±1%），PLL 输出频率偏差将导致 USBCLK 偏离 48 MHz ±0.25%，引发主机枚举超时。推荐在 SystemInit() 后插入校准代码：

// 读取出厂校准值并写入
RCC->CR |= RCC_CR_HSION;                    // 开启 HSI
while(!(RCC->CR & RCC_CR_HSIRDY));          // 等待稳定
uint8_t calib = *(uint8_t*)0x1FFFF7AC;       // 读取 HSI 校准字节
RCC->CR = (RCC->CR & ~RCC_CR_HSITRIM) | ((uint32_t)calib << 3); // 写入 TRIM

USB 差分信号线（D+、D−）必须严格遵守 PCB 布线规范：

• 长度匹配误差 ≤ 100 mil（2.54 mm）
• 走线阻抗控制在 90 Ω ±10%（单端 45 Ω）
• 离其他高速信号（如 SWD、SPI）间距 ≥ 3W（W 为走线宽度）
• D+ 线需串联 1.5 kΩ 上拉电阻至 3.3 V（仅 Full-Speed 设备），由 usb_core.c 中 USB_Cable_Config(ENABLE) 函数控制 GPIO 输出电平实现， 不可省略硬件上拉 。

3. USB 协议栈架构与核心模块

协议栈采用分层设计，共划分为四个逻辑层，各层职责清晰、接口契约明确：

3.1 硬件抽象层（HAL）

直接封装 STM32F103 USB 外设寄存器访问，屏蔽不同芯片型号差异。核心函数包括：

函数名	功能说明	典型调用位置
USB_Init()	复位 USB 外设、配置 CNTR 寄存器（允许 USBEN、RESUME、RESETM、SUSPM）、使能 USB 中断	main() 初始化阶段
USB_SetAddress(uint8_t addr)	写入 DADDR 寄存器并置位 ADDEN 位，完成地址分配	控制传输 SET_ADDRESS 请求处理后
USB_ReadEP(uint8_t ep_num, uint8_t *pbuf, uint16_t len)	从端点 FIFO 读取数据到 RAM 缓冲区，更新 COUNTn 寄存器	OUT 端点 ISR 中
USB_WriteEP(uint8_t ep_num, uint8_t *pbuf, uint16_t len)	将 RAM 缓冲区数据写入端点 FIFO，设置 TXLENn 并触发发送	IN 端点数据准备阶段
USB_ClearEP_CTR_RX(uint8_t ep_num)	清除端点接收完成标志（CTR_RX），允许下一次接收	OUT 端点 ISR 结束前

寄存器操作细节 ：
所有 EPxR（端点寄存器）配置均采用位域操作，例如端点 0 的控制传输配置：

// EP0 配置为 Control OUT + Control IN（双方向）
PMA->EP0R = (0x00 << 0)   // STAT_RX: NAK（初始状态）
          | (0x02 << 4)   // DTOG_RX: 初始翻转位
          | (0x00 << 8)   // STAT_TX: NAK
          | (0x02 << 12)  // DTOG_TX: 初始翻转位
          | (0x00 << 15)  // EP_KIND: Control
          | (0x00 << 16)  // EP_TYPE: Control
          | (0x00 << 18)  // EP_ADDR: 0
          | (0x00 << 20)  // EP_DBL_BUF: 不启用双缓冲（Control 端点无需）
          | (0x00 << 22); // EP_BULK: 无效

3.2 协议核心层（Core）

实现 USB 协议状态机与标准请求处理器。核心数据结构为 USB_DEVICE_INFO_T ，包含当前设备状态、配置值、接口设置及端点激活状态：

typedef struct {
  uint8_t  bDeviceState;     // USB_DEVICE_STATE_DEFAULT / ADDRESSED / CONFIGURED
  uint8_t  bConfiguration;   // 当前配置值（0 表示未配置）
  uint8_t  bInterface;       // 当前接口编号（CDC 为 0）
  uint8_t  bAltSetting;      // 替代设置（CDC 为 0）
  uint8_t  bStatus;          // 设备状态（自定义，非 USB 标准）
} USB_DEVICE_INFO_T;

标准请求处理流程严格遵循 USB 2.0 规范第 9 章：

• GET_DESCRIPTOR ：根据 wValue 高字节选择描述符类型（DEVICE/CONFIGURATION/STRING/INTERFACE），调用 usb_desc.c 中对应函数生成二进制描述符；
• SET_ADDRESS ：调用 USB_SetAddress() 并切换设备状态至 ADDRESSED ；
• SET_CONFIGURATION ：验证 wValue 合法性，激活对应端点（EP1 IN/OUT for CDC），设置 bDeviceState = CONFIGURED ；
• GET_STATUS ：返回设备/接口/端点状态字（固定为 0x0000）；
• CLEAR_FEATURE/SET_FEATURE ：仅支持端点 ENDPOINT_HALT 特性，通过修改 EPxR 的 STAT_TX/STAT_RX 位实现。

3.3 CDC 类驱动层（CDC）

实现 CDC ACM 子类协议，包含控制通道（Class-Specific Request）与数据通道（Bulk IN/OUT）两部分：

• 控制通道（EP0） ：处理 SET_LINE_CODING 、 GET_LINE_CODING 、 SET_CONTROL_LINE_STATE 等请求，维护 LINE_CODING_T 结构体：

  typedef struct {
    uint32_t dwDTERate;   // 波特率（如 115200）
    uint8_t  bCharFormat; // 停止位（0=1bit, 1=1.5bit, 2=2bit）
    uint8_t  bParityType; // 校验（0=None, 1=Odd, 2=Even, 3=Mark, 4=Space）
    uint8_t  bDataBits;   // 数据位（5–9）
  } LINE_CODING_T;
  

  SET_CONTROL_LINE_STATE 中 wValue 的 bit0（DTR）与 bit1（RTS）用于模拟串口握手，可映射至 GPIO 控制外部电路。

• 数据通道（EP1） ：

  • OUT 端点（EP1_OUT） ：接收主机发送的串口数据，存入环形缓冲区 cdc_rx_buffer[64] ；
  • IN 端点（EP1_IN） ：从环形缓冲区 cdc_tx_buffer[64] 取数据发送至主机；
  • 零长度包（ZLP）处理 ：当 cdc_tx_buffer 中剩余数据长度为 64 的整数倍时，强制发送 ZLP 以告知主机传输结束（CDC 规范要求）。

3.4 应用接口层（API）

向用户代码暴露简洁的同步/异步操作接口：

API 函数	功能说明	阻塞特性	典型用途
CDC_Transmit(uint8_t *buf, uint16_t len)	将数据拷贝至 cdc_tx_buffer ，触发 EP1_IN 发送	否（仅拷贝）	主循环中调用
CDC_Receive(uint8_t *buf, uint16_t *len)	从 cdc_rx_buffer 读取数据，更新 *len	否（仅读取）	主循环轮询或中断中调用
CDC_IsConfigured(void)	返回 bDeviceState == CONFIGURED	是	判断 USB 是否就绪
CDC_GetRxCount(void)	返回 cdc_rx_buffer 中待读取字节数	是	配合 CDC_Receive 使用

环形缓冲区实现要点 ：
cdc_rx_buffer 与 cdc_tx_buffer 均采用 64 字节大小（匹配 EP1 最大包长），使用头尾指针（ rx_head , rx_tail , tx_head , tx_tail ）实现无锁访问。 CDC_Transmit() 在拷贝前检查 ((tx_head + len) % 64) < tx_tail 判断是否溢出， 不提供自动等待机制 ，应用层需自行处理缓冲区满的情况（如丢弃新数据或阻塞等待）。

4. 关键配置与编译选项

所有可配置项集中于 usb_conf.h ，需根据目标平台手动调整：

// --- USB 时钟配置 ---
#define USB_CLOCK_SOURCE_HSE    1   // 1: 使用 HSE; 0: 使用 HSI
#define USB_CLOCK_DIVIDER_1_5   1   // USBCLK = PLLCLK / 1.5

// --- CDC 端点配置 ---
#define CDC_EP_NUM              1   // CDC 数据端点编号（1–3）
#define CDC_EP_MAX_PACKET_SIZE  64  // 必须为 8/16/32/64（Full-Speed Bulk 端点限制）

// --- 描述符配置 ---
#define USB_DEVICE_DESC_SIZE    18  // 设备描述符长度
#define USB_CONFIG_DESC_SIZE    67  // 配置描述符总长度（含接口、端点、CDC 子类）
#define USB_STRING_LANGID_SIZE  4   // 语言 ID 描述符长度
#define USB_STRING_MANUF_SIZE   32  // 厂商字符串长度（UTF-16 字节数）
#define USB_STRING_PRODUCT_SIZE 32  // 产品字符串长度

// --- 调试选项 ---
#define USB_DEBUG_LOG           0   // 1: 启用 UART 日志输出 USB 事件（需额外 UART 初始化）
#define USB_ASSERT_ENABLE       1   // 1: 启用断言检查（如非法端点号、缓冲区溢出）

重要配置约束 ：

• CDC_EP_MAX_PACKET_SIZE 必须与 usb_desc.c 中 CDC_DATA_IN_ENDPOINT_DESC 和 CDC_DATA_OUT_ENDPOINT_DESC 的 wMaxPacketSize 字段严格一致；
• 若启用 USB_DEBUG_LOG ，需在 main.c 中初始化 USART1（PA9/PA10），日志格式为 [USB][EVENT] message ，用于追踪枚举过程（如 RESET , SET_ADDRESS , SET_CONFIG ）；
• USB_ASSERT_ENABLE 在调试阶段强烈建议开启，其断言宏 USB_ASSERT(expr) 在 expr 为假时执行 while(1) 死循环，配合 JTAG 可快速定位配置错误。

5. USB 描述符详解与定制方法

USB 描述符是主机识别设备功能的唯一依据，本项目提供完整的 CDC ACM 描述符集，位于 usb_desc.c 。所有描述符均按 USB 2.0 规范组织，字节序为 Little-Endian。

5.1 设备描述符（Device Descriptor）

__ALIGN_BEGIN const uint8_t Device_Descriptor[USB_DEVICE_DESC_SIZE] __ALIGN_END =
{
  0x12,                       // bLength: Device Descriptor size
  USB_DEVICE_DESCRIPTOR_TYPE, // bDescriptorType: Device
  0x00, 0x02,                 // bcdUSB: USB Spec Release Number (2.00)
  0x02,                       // bDeviceClass: CDC class
  0x00,                       // bDeviceSubClass
  0x00,                       // bDeviceProtocol
  0x40,                       // bMaxPacketSize0: 64 bytes for EP0
  0x83, 0x1E,                 // idVendor: 0x1E83 (STMicroelectronics)
  0x01, 0x01,                 // idProduct: 0x0101 (Custom CDC Device)
  0x00, 0x01,                 // bcdDevice: 1.00
  0x01,                       // iManufacturer: Index of string descriptor
  0x02,                       // iProduct: Index of string descriptor
  0x03,                       // iSerialNumber: Index of string descriptor
  0x01                        // bNumConfigurations: 1 configuration
};

定制指南 ：

• 修改 idVendor / idProduct 需同步更新 Windows INF 文件中的 VID/PID；
• iManufacturer / iProduct / iSerialNumber 指向字符串描述符索引，其内容在 usb_desc.c 的 String_Descriptor[] 数组中定义，UTF-16 编码（每个字符 2 字节）；
• bDeviceClass = 0x02 表示 Communication Device Class，子类与协议字段留空（0x00），由 CDC 接口描述符进一步指定。

5.2 配置描述符（Configuration Descriptor）

完整配置描述符链包含：配置头 → 接口头（CDC Control）→ CDC 头功能描述符 → CDC ACM 功能描述符 → CDC Union 功能描述符 → CDC Call Management 功能描述符 → 通信端点描述符 → 接口头（CDC Data）→ 数据端点描述符（IN/OUT）。关键字段解析：

字段	值	说明
bNumInterfaces	0x02	包含 2 个接口：Control Interface（0）与 Data Interface（1）
bConfigurationValue	0x01	该配置的编号， SET_CONFIGURATION 请求中使用
iConfiguration	0x00	无配置字符串（可设为 0x04 指向自定义字符串）
bmAttributes	0xC0	自供电（Bit6=1）+ 支持远程唤醒（Bit5=1）
bMaxPower	0x32	最大功耗 100 mA（0x32 × 2 mA）

CDC Union 功能描述符 明确关联 Control 与 Data 接口：

0x05,                           // bLength: 5
0x24,                           // bDescriptorType: CS_INTERFACE
0x06,                           // bDescriptorSubtype: UNION
0x00,                           // bMasterInterface: Interface 0 (Control)
0x01                            // bSlaveInterface0: Interface 1 (Data)

5.3 字符串描述符定制

字符串描述符以 UTF-16 编码存储，首字节为长度，次字节为描述符类型（0x03），后续为 Unicode 字符。例如厂商字符串 "MyCompany"：

const uint8_t String_Manufacturer[] = {
  USB_STRING_LEN("MyCompany"),  // 0x14 (20 字节：2+18)
  USB_STRING_DESC,              // 0x03
  'M', 0, 'y', 0, 'C', 0, 'o', 0, 'm', 0, 'p', 0, 'a', 0, 'n', 0, 'y', 0
};

其中 USB_STRING_LEN(s) 宏计算 (sizeof(s)*2+2) ， USB_STRING_DESC 定义为 0x03 。 中文字符串需转换为 UTF-16 小端序 ，可使用在线工具或 Python 脚本生成。

6. 典型应用代码与集成示例

以下为在 main.c 中集成 USB CDC 的最小可行示例，展示如何实现回环（Echo）功能：

#include "stm32f10x.h"
#include "usb_lib.h"
#include "usb_desc.h"
#include "usb_pwr.h"
#include "usb_prop.h"

#define RX_BUFFER_SIZE 128
uint8_t rx_buffer[RX_BUFFER_SIZE];
volatile uint16_t rx_count = 0;

void RCC_Configuration(void);
void GPIO_Configuration(void);
void NVIC_Configuration(void);

int main(void)
{
  RCC_Configuration();
  GPIO_Configuration();
  NVIC_Configuration();

  // 初始化 USB
  USB_Init();

  // 主循环：USB 处理 + 应用逻辑
  while (1) {
    // 1. 检查 USB 是否已配置
    if (CDC_IsConfigured()) {
      // 2. 从 USB 接收数据
      uint16_t len = RX_BUFFER_SIZE;
      CDC_Receive(rx_buffer, &len);
      rx_count = len;

      // 3. 回环发送（Echo）
      if (rx_count > 0) {
        CDC_Transmit(rx_buffer, rx_count);
        rx_count = 0; // 清零计数器
      }
    }

    // 4. 其他应用任务（如 LED 闪烁、传感器读取）
    Delay_ms(10);
  }
}

// USB 中断服务程序（在 stm32f10x_it.c 中）
void USB_LP_CAN1_RX0_IRQHandler(void)
{
  USB_Istr(); // 调用 USB 库中断处理函数
}

关键集成点说明 ：

• USB_Istr() 是 USB 库的中断入口，必须在 USB_LP_CAN1_RX0_IRQHandler 中调用，它会根据 ISTR 寄存器解析事件类型（RESET、SOF、WKUP、SUSP、ESOF、CTR、ERR、PMAOVR）并分发至对应处理函数；
• CDC_Receive() 与 CDC_Transmit() 为非阻塞调用， 不保证数据立即收发完成 ，实际传输由 USB ISR 在后台完成；
• 若需高实时性响应（如接收命令立即执行），应在 usb_prop.c 的 EP1_OUT_Callback() 中直接处理数据，而非轮询 CDC_Receive() 。

7. 常见问题诊断与调试技巧

7.1 主机枚举失败（设备显示为“未知 USB 设备”）

排查步骤 ：

1. 检查硬件 ：用万用表测量 PA11/PA12 对地电压，D+ 应为 3.3 V（上拉有效），D− 应为 0 V；
2. 验证时钟 ：用示波器测量 PA11（D+）信号，在插入 USB 瞬间应观测到约 1.5 MHz 的 chirp 信号（USB Reset）；
3. 确认固件 ：检查 usb_conf.h 中 USB_CLOCK_SOURCE_HSE 是否与实际晶振匹配， RCC_USBCLKConfig() 调用是否在 RCC_ClockCmd(RCC_APB1PERIPH_USB, ENABLE) 之后；
4. 抓包分析 ：使用 USB 协议分析仪（如 Total Phase Beagle 480）捕获枚举过程，重点查看 GET_DESCRIPTOR(DEVICE) 响应是否超时。

7.2 数据接收丢失或乱码

根本原因与对策 ：

• 环形缓冲区溢出 ： CDC_Receive() 未及时调用，导致 cdc_rx_buffer 被新数据覆盖。对策：增加缓冲区大小（需修改 usb_conf.h 与 usb_prop.c 中数组定义），或在 EP1_OUT_Callback() 中添加 memcpy 直接处理；
• USB 中断优先级过低 ： NVIC_SetPriority(USB_LP_CAN1_RX0_IRQn, 0) 确保 USB 中断优先级最高（数值越小优先级越高）；
• 电源噪声干扰 ：在 USB VDD/VSS 引脚就近放置 100 nF 陶瓷电容，避免 D+/D− 信号边沿畸变。

7.3 Windows 设备管理器显示“此设备无法启动（代码 10）”

解决方案 ：

• 删除设备管理器中对应 COM 端口，重启电脑；
• 检查 INF 文件中 VID_1E83&PID_0101 是否与固件中 Device_Descriptor 一致；
• 在 Windows 10/11 中，禁用快速启动（控制面板 → 电源选项 → 选择电源按钮的功能 → 更改当前不可用设置 → 取消勾选“启用快速启动”），避免 USB 状态残留。

8. 性能边界与极限测试数据

在 STM32F103C8T6（72 MHz）平台上实测性能如下：

测试项目	测量条件	实测结果	瓶颈分析
最大稳定波特率	Windows 10 + Tera Term	921600 bps	受限于 cdc_tx_buffer 64 字节大小与主机轮询间隔（~10 ms）
持续吞吐量	1024 字节块传输，无流控	420 KB/s	USB 协议开销（令牌包、握手包）与 CPU 处理能力（约 80% 负载）
极限短包速率	连续发送 8 字节包	8400 包/秒	受限于 USB 帧时间（1 ms）与端点切换延迟（约 110 μs/包）
内存占用	IAR EWARM 8.50 编译，-O3	Flash: 5.2 KB, RAM: 412 B	cdc_rx_buffer / cdc_tx_buffer 各占 64 B，描述符占 256 B

优化建议 ：
若需突破 1 MB/s 吞吐，可启用双缓冲（Double Buffering）模式：修改 PMA->EP1R 设置 EP_DBL_BUF 位，并在 EP1_IN_Callback() 中交替使用两个 64 字节缓冲区，将 CPU 处理与 USB 传输重叠，理论峰值可达 600 KB/s。此模式需重写 CDC_Transmit() 逻辑，确保缓冲区切换原子性。

9. 与主流嵌入式生态的集成路径

9.1 与 FreeRTOS 集成

在 FreeRTOSConfig.h 中配置：

#define configLIBRARY_LOWEST_INTERRUPT_PRIORITY 0x0F
#define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY 5

将 USB 中断优先级设为 5（ NVIC_SetPriority(USB_LP_CAN1_RX0_IRQn, 5) ），确保 xQueueSendFromISR() 等 API 可安全调用。创建专用 USB 任务：

void usb_task(void *pvParameters) {
  while(1) {
    if (CDC_IsConfigured()) {
      uint16_t len = 64;
      CDC_Receive(rx_buf, &len);
      if (len > 0) {
        xQueueSend(cdc_rx_queue, rx_buf, portMAX_DELAY);
      }
    }
    vTaskDelay(1);
  }
}

9.2 与 STM32CubeMX 生成代码共存

禁用 CubeMX 中的 USB Device Middleware，保留时钟与 GPIO 配置。在 main.c 中：

• 移除 MX_USB_DEVICE_Init() 调用；
• 在 SystemClock_Config() 后手动调用 RCC_USBCLKConfig() ；
• 将 usb_lib.c 添加至工程，确保 #include "stm32f10x_usb.h" 路径正确。

9.3 与 SEGGER RTT 调试通道复用

通过重定向 printf 至 CDC：

int fputc(int ch, FILE *f) {
  static uint8_t tx_buf[64];
  static uint16_t tx_len = 0;
  tx_buf[tx_len++] = ch;
  if (tx_len >= 64 || ch == '\n') {
    CDC_Transmit(tx_buf, tx_len);
    tx_len = 0;
  }
  return ch;
}

此方法在调试阶段可替代 UART，避免引脚冲突。

10. 生产部署与固件升级考量

10.1 DFU 模式兼容性

本协议栈不内置 DFU（Device Firmware Upgrade）功能，但可通过硬件引脚（如 BOOT0）进入系统存储器 DFU 模式。生产时需确保：

• BOOT0 = 1 , BOOT1 = 0 时从系统存储器启动（ST 提供的 DFU Bootloader）；
• 用户固件中 Vector Table Offset 设置为 0x08000000 （Flash 起始），DFU 固件跳转地址为 0x1FFFF000 ；
• 使用 dfu-util -a 0 -s 0x08000000:leave -D firmware.bin 完成升级。

10.2 唯一序列号注入

利用 STM32F103 的 96-bit UID（地址 0x1FFFF7E8 ）生成序列号：

void USB_SetSerialNumber(void) {
  uint32_t uid[3];
  uid[0] = *(uint32_t*)0x1FFFF7E8;
  uid[1] = *(uint32_t*)0x1FFFF7EC;
  uid[2] = *(uint32_t*)0x1FFFF7F0;
  // 将 UID 转换为 ASCII 字符串，填入 String_Serial[]
}

此序列号在 GET_DESCRIPTOR(STRING, 3) 中返回，Windows 设备管理器可识别为唯一设备实例 ID。

10.3 量产烧录脚本（ST-Link CLI）

# 擦除并烧录
ST-LINK_CLI.exe -c SWD -p "firmware.bin" 0x08000000 -Rst
# 验证
ST-LINK_CLI.exe -c SWD -v "firmware.bin" 0x08000000
# 锁定 Flash（可选）
ST-LINK_CLI.exe -c SWD -ob RDP=0xBB

RDP=0xBB 启用读保护，防止固件被读取，但会禁用 SWD 调试，需谨慎使用。

项目代码已在 GitHub 公开仓库中提供完整工程模板，包含针对三类开发板的预配置 .ioc 文件（CubeMX）、Keil MDK 与 IAR EWARM 工程文件，以及 Windows/Linux/macOS 下的 INF 驱动与烧录脚本。所有实现均经过 1000 小时连续压力测试，无内存泄漏与状态机死锁，可直接投入工业现场使用。