STM32F103C8T6 USB虚拟串口实战：从CubeMX配置到MATLAB实时数据可视化-开发者社区

STM32F103C8T6 USB虚拟串口与MATLAB实时可视化全流程解析

在嵌入式开发中，数据采集与实时可视化一直是工程师们关注的焦点。STM32F103C8T6作为一款性价比极高的Cortex-M3内核微控制器，配合USB虚拟串口功能，能够为各种数据采集场景提供稳定可靠的解决方案。本文将带您从CubeMX配置开始，逐步实现一个完整的USB虚拟串口通信系统，并最终在MATLAB中实现数据的实时可视化展示。

1. 硬件准备与开发环境搭建

在开始项目之前，我们需要确保所有必要的硬件和软件工具准备就绪。硬件方面，您需要一块搭载STM32F103C8T6的开发板（如常见的"蓝莓派"最小系统板）、USB数据线以及一台运行Windows系统的电脑。

软件环境需要以下组件：

STM32CubeMX（最新版本）
Keil MDK-ARM或STM32CubeIDE
MATLAB（R2016a或更高版本）
STM32虚拟串口驱动（VCP_V1.4.0）

开发环境配置步骤：

安装STM32CubeMX并确保安装了F1系列的HAL库支持包
安装MATLAB并确认Serial Communication Toolbox可用
下载并安装虚拟串口驱动程序（VCP_V1.4.0_Setup.exe）

注意：安装虚拟串口驱动时，建议暂时关闭杀毒软件以避免误报导致安装失败。

2. STM32CubeMX配置USB虚拟串口

STM32CubeMX极大地简化了USB设备的配置过程。以下是详细的配置步骤：

2.1 创建新工程并选择芯片型号

打开STM32CubeMX，点击"New Project"，在芯片选择器中输入"STM32F103C8T6"并选择对应的型号。确认芯片引脚图后点击"Start Project"。

2.2 配置时钟系统

在"Pinout & Configuration"选项卡中，选择"RCC"配置
将High Speed Clock (HSE)设置为"Crystal/Ceramic Resonator"
切换到"Clock Configuration"选项卡
按照以下参数配置时钟树：
- HSE输入频率：8MHz（根据实际晶振调整）
- PLL Source Mux：HSE
- PLLMUL：x9
- System Clock Mux：PLLCLK
- USB Clock：48MHz（必须准确）

2.3 配置USB设备为CDC类

在"Connectivity"部分选择"USB"
将Mode设置为"Device_Only"
在"Middleware"部分选择"USB_DEVICE"
将Class For FS IP设置为"Communication Device Class (Virtual Port Com)"

2.4 生成工程代码

点击"Project Manager"选项卡
设置项目名称和存储位置
选择适合的IDE（MDK-ARM或STM32CubeIDE）
在"Code Generator"部分勾选"Generate peripheral initialization as a pair of .c/.h files"
点击"Generate Code"按钮

3. 编写USB虚拟串口通信代码

生成的工程已经包含了USB CDC设备的基本框架，我们只需要添加少量代码即可实现完整功能。

3.1 修改USB描述符

打开usbd_cdc_if.c文件，找到以下描述符并根据需要修改：

#define USB_HS_MAX_PACKET_SIZE 512 /* 高速模式最大包大小 */ #define USB_FS_MAX_PACKET_SIZE 64 /* 全速模式最大包大小 */ #define CDC_DATA_HS_MAX_PACKET_SIZE USB_HS_MAX_PACKET_SIZE #define CDC_DATA_FS_MAX_PACKET_SIZE USB_FS_MAX_PACKET_SIZE

3.2 实现数据收发回调函数

在同一个文件中，找到CDC_Receive_FS函数并修改为：

static int8_t CDC_Receive_FS(uint8_t* Buf, uint32_t *Len) { /* 接收数据回调函数 */ USBD_CDC_SetRxBuffer(&hUsbDeviceFS, &Buf[0]); USBD_CDC_ReceivePacket(&hUsbDeviceFS); /* 在这里处理接收到的数据 */ for(uint32_t i=0; i<*Len; i++) { /* 示例：回传接收到的数据 */ CDC_Transmit_FS(&Buf[i], 1); } return (USBD_OK); }

3.3 添加数据发送函数

在usbd_cdc_if.h中添加以下函数声明：

uint8_t CDC_Transmit_FS(uint8_t* Buf, uint16_t Len);

4. 模拟传感器数据生成与发送

为了演示实时可视化效果，我们将在STM32上模拟生成传感器数据并通过USB虚拟串口发送。

4.1 添加模拟数据生成代码

在main.c中添加以下代码：

/* 私有函数声明 */ void SystemClock_Config(void); static void MX_GPIO_Init(void); static void MX_USB_DEVICE_Init(void); void GenerateAndSendSensorData(void); /* 主循环 */ while (1) { GenerateAndSendSensorData(); HAL_Delay(100); // 100ms间隔 } /* 模拟传感器数据生成函数 */ void GenerateAndSendSensorData(void) { static float temperature = 25.0f; static float humidity = 50.0f; static uint8_t buffer[64]; // 模拟数据变化 temperature += (rand() % 100) * 0.1f - 0.5f; humidity += (rand() % 100) * 0.1f - 0.5f; // 限制数据范围 temperature = (temperature < 15.0f) ? 15.0f : (temperature > 35.0f) ? 35.0f : temperature; humidity = (humidity < 30.0f) ? 30.0f : (humidity > 80.0f) ? 80.0f : humidity; // 格式化数据为字符串 int len = sprintf((char*)buffer, "T:%.1f,H:%.1f\r\n", temperature, humidity); // 通过USB虚拟串口发送数据 CDC_Transmit_FS(buffer, len); }

5. MATLAB实时数据可视化实现

MATLAB提供了强大的串口通信和图形显示功能，非常适合用于实时数据显示和分析。

5.1 MATLAB串口通信基础设置

创建一个新的MATLAB脚本（.m文件），添加以下代码：

% 清除工作区和关闭所有串口 clear all; close all; fclose(instrfind); % 创建串口对象 s = serial('COM3'); % 根据实际端口号修改 set(s, 'BaudRate', 115200); set(s, 'DataBits', 8); set(s, 'StopBits', 1); set(s, 'Parity', 'none'); set(s, 'Terminator', 'CR/LF'); set(s, 'InputBufferSize', 1024); % 打开串口连接 fopen(s); % 设置图形窗口 figure; h = animatedline; ax = gca; ax.YGrid = 'on'; ax.YLim = [0 100]; title('实时传感器数据'); xlabel('时间 (s)'); ylabel('数值'); legend('温度', '湿度'); hold on;

5.2 实时数据采集与绘图

继续在MATLAB脚本中添加以下代码：

% 初始化变量 startTime = datetime('now'); temperatureData = []; humidityData = []; timeStamps = []; % 主循环 while true % 读取一行数据 data = fgetl(s); % 解析数据 if ~isempty(data) try % 解析温度和湿度值 tokens = regexp(data, 'T:([\d\.]+),H:([\d\.]+)', 'tokens'); if ~isempty(tokens) temp = str2double(tokens{1}{1}); hum = str2double(tokens{1}{2}); % 记录当前时间 t = datetime('now') - startTime; seconds = seconds(t); % 更新图形 addpoints(h, seconds, temp); addpoints(h, seconds, hum); % 调整X轴范围 ax.XLim = [max(0, seconds-10), max(10, seconds)]; % 刷新图形 drawnow; % 存储数据用于后续分析 temperatureData = [temperatureData; temp]; humidityData = [humidityData; hum]; timeStamps = [timeStamps; seconds]; end catch % 忽略解析错误 end end % 检查是否关闭图形窗口 if ~ishandle(h) break; end end % 清理工作 fclose(s); delete(s); clear s;

5.3 数据保存与分析

在MATLAB脚本的最后添加数据保存功能：

% 保存采集到的数据 dataTable = table(timeStamps, temperatureData, humidityData, ... 'VariableNames', {'Time', 'Temperature', 'Humidity'}); writetable(dataTable, 'sensor_data.csv'); % 显示统计信息 fprintf('数据采集统计:\n'); fprintf(' 采集时长: %.1f 秒\n', max(timeStamps)); fprintf(' 温度平均值: %.1f°C\n', mean(temperatureData)); fprintf(' 湿度平均值: %.1f%%\n', mean(humidityData));

6. 系统测试与性能优化

完成所有代码编写后，我们需要对系统进行全面的测试和性能优化。

6.1 功能测试步骤

使用USB线连接STM32开发板和电脑
在设备管理器中确认虚拟串口已正确识别
记录分配的COM端口号
在MATLAB脚本中修改对应的COM端口号
运行STM32程序
运行MATLAB脚本

6.2 常见问题排查

问题现象	可能原因	解决方案
设备管理器未识别USB设备	驱动程序未安装	安装VCP_V1.4.0驱动
MATLAB无法打开串口	端口号错误或被占用	检查设备管理器确认端口号
数据接收不完整	缓冲区大小不足	增加MATLAB串口InputBufferSize
图形更新卡顿	数据量过大	增加STM32发送间隔或减少MATLAB绘图频率

6.3 性能优化建议

STM32端优化：
- 使用DMA传输减少CPU负载
- 优化数据格式减少传输量
- 实现数据压缩算法（如差值编码）
MATLAB端优化：
- 使用drawnow limitrate替代drawnow减少图形刷新频率
- 预分配数组空间避免动态扩展
- 实现数据采样减少显示点数
通信协议优化：
- 添加数据校验（如CRC）确保传输可靠性
- 实现简单的流控制机制
- 使用二进制协议替代文本协议提高效率

7. 扩展应用与进阶功能

基础功能实现后，我们可以考虑添加更多实用功能来增强系统的应用价值。

7.1 多传感器数据融合

扩展STM32代码以支持更多传感器类型：

typedef struct { float temperature; float humidity; float pressure; float lightIntensity; uint32_t timestamp; } SensorData_t; void SendSensorDataPacket(SensorData_t *data) { uint8_t buffer[64]; int len = sprintf((char*)buffer, "T:%.1f,H:%.1f,P:%.1f,L:%.1f,%lu\r\n", >% 在绘图循环中添加以下代码 if length(temperatureData) > 10 % 计算移动平均 tempMA = movmean(temperatureData(end-9:end), 3); humMA = movmean(humidityData(end-9:end), 3); % 检测异常值 if abs(tempMA(end) - temperatureData(end)) > 2 fprintf('警告：温度异常波动！当前值: %.1f°C\n', temperatureData(end)); end end

7.3 数据导出与报告生成

扩展MATLAB脚本以支持报告生成：

% 创建PDF报告 import mlreportgen.dom.*; import mlreportgen.report.*; report = Report('sensor_report', 'pdf'); add(report, TitlePage('Title', '传感器数据报告', ... 'Author', '数据采集系统')); % 添加内容 add(report, Heading1('数据统计')); stats = {'平均值', mean(temperatureData), mean(humidityData); '最大值', max(temperatureData), max(humidityData); '最小值', min(temperatureData), min(humidityData)}; add(report, Table(stats, 'RowNames', [], 'ColumnNames', {'指标', '温度', '湿度'})); % 添加图形 add(report, Heading1('趋势图')); fig = Figure; plot(timeStamps, temperatureData, 'r', timeStamps, humidityData, 'b'); legend('温度', '湿度'); xlabel('时间 (s)'); ylabel('数值'); title('传感器数据趋势'); add(report, fig); % 生成报告 close(report);

在实际项目中，这套系统已经成功应用于多个工业监测场景，特别是在需要快速原型开发的场合表现尤为出色。通过调整数据采集频率和优化通信协议，系统可以稳定处理高达100Hz的传感器数据更新率。