基于STM32F103的USB副屏实现：从HID协议到LVGL图形库全解析

你是否想过，用一块成本不到20元的STM32F103开发板，就能为你的电脑扩展出一块额外的屏幕？这听起来像是极客的玩具，但背后却是一个将USB协议栈、显示驱动和嵌入式图形库深度融合的硬核项目。市面上成熟的USB显示器方案往往基于专用芯片，成本较高且灵活性不足。而基于STM32F103的USB副屏方案，则为我们打开了一扇窗：它不仅是一个低成本的学习平台，更能让你深入理解从USB设备枚举到像素渲染的完整链路。

对于嵌入式开发者、电子爱好者或任何想深入硬件与PC交互细节的人来说，这个项目极具吸引力。它解决的远不止“多一块屏幕”的问题，而是“如何让一个资源受限的MCU，通过标准USB协议，高效、稳定地接收并显示来自主机的动态图像数据”。本文将带你从零开始，拆解“USB副屏STM32F103”项目的核心原理、实现步骤与关键陷阱。读完本文，你将能亲手搭建一套可工作的系统，并理解其中每一个技术决策背后的原因。

1. 项目核心：我们要解决的究竟是什么问题？

这个项目的本质，是让STM32F103微控制器扮演一个“USB显示设备”的角色。从PC（主机）的角度看，它希望连接的是一个即插即用的标准显示器。而从STM32F103（设备）的角度看，它需要完成三件大事：

1. USB通信：实现USB Human Interface Device (HID) 或更高效的USB Video Class (UVC) 协议，与PC建立稳定、高速的数据通道，接收屏幕帧数据。
2. 数据处理与缓冲：STM32F103的RAM通常只有20KB或64KB，而一帧QVGA（320x240）的RGB565图像就需要150KB。因此，必须设计巧妙的数据流和缓冲策略，例如使用“行缓冲”或“块传输+实时渲染”。
3. 图形显示：将接收到的像素数据，通过FSMC（可变静态存储控制器）或GPIO模拟8080/6800时序，驱动LCD屏幕（如ILI9341、ST7789等）进行显示。

真正的挑战在于资源与性能的平衡。STM32F103C8T6（蓝色药丸板）仅有64KB Flash和20KB RAM，主频72MHz。在这样的限制下，直接实现完整的UVC协议并缓存整帧图像几乎不可能。因此，大多数成功方案都采用了“自定义USB HID报告描述符 + 压缩/分块传输 + 实时行渲染”的架构。这要求开发者对USB协议、LCD驱动和实时系统有综合理解。

2. 核心概念与架构选型

在动手之前，必须理清几个关键概念和我们的技术选型。

2.1 USB设备类：HID vs UVC

• USB Video Class (UVC)：这是USB摄像头和显示器的标准协议。如果实现UVC，Windows/macOS/Linux无需安装驱动即可识别为显示器。但UVC协议栈复杂，对描述符、带宽、实时性要求高，在STM32F103上实现完整UVC并保证流畅度非常困难。
• USB Human Interface Device (HID)：最初为键盘、鼠标设计。其优势是协议栈相对简单，所有操作系统都有内置驱动。我们可以自定义HID报告描述符，定义一种用于传输“屏幕帧数据”的报告格式。缺点是带宽较低（全速USB下，中断传输每帧最大64字节，但可以通过多个报告描述符提升），且PC端需要配套的“显示器驱动”软件（通常是我们自己写的）将屏幕图像数据按自定义格式打包发送。

我们的选择：鉴于STM32F103的资源限制和项目首要目标（跑通并理解原理），采用自定义HID协议是更务实、更易成功的起点。PC端我们可以用Python或C++写一个简单的服务程序，捕获屏幕区域，压缩（如RLE）或分块，然后通过HID API发送给设备。

2.2 显示接口：FSMC vs GPIO模拟

• FSMC (Flexible Static Memory Controller)：这是STM32F103系列中高端型号（如ZET6）才有的外设。它可以将LCD的并口映射到内存地址空间，像读写内存一样操作LCD，速度极快，不占用CPU时间。这是驱动高速刷屏的理想选择。
• GPIO模拟8080/6800时序：通过软件控制GPIO电平变化来模拟LCD的读/写、使能、数据/命令信号。实现简单，所有型号都支持，但刷屏速度慢，CPU占用率高。

我们的选择：如果你的STM32F103是C8T6（无FSMC），则只能使用GPIO模拟。如果是ZET6或VET6，强烈建议使用FSMC以获得更好的体验。本文将以GPIO模拟为基础进行讲解，因为其适用性最广，理解了GPIO模拟，迁移到FSMC只需修改底层硬件抽象层。

2.3 图形库与缓冲策略

• 图形库：为了简化画点、画线、填充、显示文字等操作，我们需要一个轻量级图形库。LVGL (Light and Versatile Graphics Library) 是当前嵌入式领域的首选，它模块化设计，对资源要求可配置，且功能强大。另一个经典选择是u8g2，但更专注于单色屏。
• 缓冲策略：
  • 全帧缓冲 (Full Framebuffer)：在RAM中开辟一块与屏幕分辨率匹配的缓冲区。所有绘图操作先在内存中进行，最后一次性刷到屏幕。体验流畅，但极度消耗RAM（320x240x2=150KB > 20KB），在C8T6上不可行。
  • 行缓冲/部分缓冲 (Partial Framebuffer)：只开辟几行像素的缓冲区。LVGL支持这种模式，它只渲染当前需要更新的“区域”到这个小缓冲区，然后迅速刷屏。这是资源受限MCU的标配方案。
  • 无缓冲，直接渲染 (No Buffer, Direct Rendering)：每收到一个像素包或一个图形指令，直接计算并写入LCD。这对数据传输的实时性和稳定性要求极高，通常与自定义的简单图形指令集配合使用。

我们的选择：我们将采用 LVGL + 部分缓冲 的方案。LVGL负责图形对象的维护和渲染逻辑，我们则实现一个“刷屏回调函数”，将LVGL渲染好的小块区域数据通过GPIO写入LCD。

3. 硬件准备与软件环境搭建

3.1 所需硬件清单

1. 主控：STM32F103C8T6最小系统板（蓝色药丸板）或STM32F103ZET6核心板（带FSMC）。
2. 显示屏：支持8080或6800并行接口的TFT LCD，如ILI9341（320x240）或ST7789（240x240）。建议选择带触摸的型号以备后续扩展。
3. USB线：Micro-USB数据线，用于供电和通信。
4. 连接线：杜邦线若干，用于连接MCU与LCD。
5. 可选：ST-Link V2调试器，用于程序下载和调试。

3.2 软件环境准备