从点灯到多任务：在STM32F103上，手把手教你用CubeMX和FreeRTOS构建一个环境监测项目
从点灯到多任务：在STM32F103上构建环境监测系统的全流程实战
项目概述与环境搭建
在嵌入式开发领域，将理论知识转化为实际项目能力是每个工程师成长的必经之路。本教程将以STM32F103C8T6开发板为核心，通过CubeMX和FreeRTOS构建一个完整的环境监测系统。这个项目不仅涵盖了基础的GPIO控制，还涉及ADC采样、串口通信以及RTOS多任务管理等关键技术点。
选择STM32F103系列作为开发平台有几个明显优势：首先，它基于Cortex-M3内核，性能足够应对大多数嵌入式场景；其次，丰富的片上外设资源让我们能够在一个芯片上实现多种功能；最重要的是，ST提供的HAL库和CubeMX工具极大地简化了开发流程。
开发环境准备步骤如下：
硬件准备清单：
- STM32F103C8T6最小系统板（蓝色药丸开发板）
- USB转TTL串口模块（如CH340G）
- LM35温度传感器或NTC热敏电阻模块
- 面包板及杜邦线若干
- 按键开关和LED指示灯
软件工具链：
- STM32CubeMX 6.x
- Keil MDK-ARM或STM32CubeIDE
- 串口调试助手（如Putty或Tera Term）
提示：建议使用最新版本的CubeMX，因为它包含了对FreeRTOS最新版本的支持和更多外设驱动模板。
CubeMX工程配置详解
启动CubeMX后，首先选择正确的芯片型号STM32F103C8T6。这个步骤至关重要，因为不同型号的引脚定义和外设资源可能有差异。在Pinout视图中，我们可以直观地看到芯片的所有引脚及其复用功能。
时钟树配置是CubeMX中最关键也最容易出错的环节。对于STM32F103C8T6，我们通常采用8MHz外部晶振作为时钟源，通过PLL倍频到72MHz系统时钟。具体配置路径为：
HSE (8MHz) → PLLMUL ×9 → PLLCLK (72MHz) → SYSCLK APB1 Prescaler /2 → 36MHz APB2 Prescaler /1 → 72MHz外设配置按照项目需求逐步添加：
GPIO配置：
- 配置PC13为输出模式（LED控制）
- 配置PA0为输入模式，启用上拉电阻（按键检测）
ADC配置：
- 启用ADC1，选择通道0（PA0）
- 设置12位分辨率，独立模式
- 采样时间设置为239.5周期（提高精度）
USART配置：
- 启用USART1，异步模式
- 波特率115200，8数据位，无校验，1停止位
- 启用发送和接收功能
FreeRTOS配置：
- 在Middleware选项卡中选择FreeRTOS
- 设置
USE_PREEMPTION为Enabled（抢占式调度） - 配置
TICK_RATE_HZ为1000（1ms系统节拍） - 设置合适的总堆栈大小（建议不少于4KB）
完成配置后，点击"Generate Code"生成工程文件。CubeMX会自动生成外设初始化代码和FreeRTOS配置文件，为我们节省大量底层配置时间。
FreeRTOS任务设计与实现
在基于RTOS的系统中，合理的任务划分是项目成功的关键。对于环境监测系统，我们设计三个主要任务：
| 任务名称 | 优先级 | 功能描述 | 执行周期 |
|---|---|---|---|
| DataAcquisition | 3 | 采集温度数据并通过队列发送 | 500ms |
| Communication | 2 | 从队列获取数据并通过串口发送 | 事件触发 |
| KeyProcess | 1 | 检测按键并控制LED状态 | 100ms |
在main.c中创建任务前，需要先初始化必要的RTOS资源：
/* 创建消息队列，用于任务间通信 */ QueueHandle_t xTempQueue = xQueueCreate(5, sizeof(uint16_t)); /* 创建二进制信号量，用于串口发送同步 */ SemaphoreHandle_t xUARTSemaphore = xSemaphoreCreateBinary(); xSemaphoreGive(xUARTSemaphore); // 初始化为可用状态任务函数原型示例：
void DataAcquisitionTask(void const * argument) { uint16_t adcValue; char tempStr[20]; for(;;) { // 启动ADC转换并获取结果 HAL_ADC_Start(&hadc1); if(HAL_ADC_PollForConversion(&hadc1, 10) == HAL_OK) { adcValue = HAL_ADC_GetValue(&hadc1); // 将原始ADC值转换为温度（假设使用LM35，10mV/℃） float temperature = (adcValue * 3.3 / 4095) * 100; // 发送到消息队列 if(xQueueSend(xTempQueue, &adcValue, portMAX_DELAY) != pdPASS) { // 错误处理 } } vTaskDelay(pdMS_TO_TICKS(500)); // 500ms周期 } }通信任务的关键点在于正确处理队列接收和串口发送的同步：
void CommunicationTask(void const * argument) { uint16_t receivedValue; for(;;) { if(xQueueReceive(xTempQueue, &receivedValue, portMAX_DELAY) == pdPASS) { // 获取串口信号量，避免多任务同时访问 if(xSemaphoreTake(xUARTSemaphore, pdMS_TO_TICKS(100)) == pdTRUE) { char msg[50]; float temp = (receivedValue * 3.3 / 4095) * 100; int len = sprintf(msg, "Temperature: %.2fC\r\n", temp); HAL_UART_Transmit(&huart1, (uint8_t*)msg, len, HAL_MAX_DELAY); xSemaphoreGive(xUARTSemaphore); // 释放信号量 } } } }系统调试与性能优化
当所有任务都创建并运行后，我们需要验证系统的实时性和稳定性。FreeRTOS提供了一些实用的API可以帮助我们监控系统状态：
- 任务栈使用检查：
void CheckTaskStacks(void) { TaskStatus_t *pxTaskStatusArray; volatile UBaseType_t uxArraySize, x; uxArraySize = uxTaskGetNumberOfTasks(); pxTaskStatusArray = pvPortMalloc(uxArraySize * sizeof(TaskStatus_t)); if(pxTaskStatusArray != NULL) { uxArraySize = uxTaskGetSystemState(pxTaskStatusArray, uxArraySize, NULL); for(x = 0; x < uxArraySize; x++) { printf("Task: %s, Stack HighWaterMark: %u\r\n", pxTaskStatusArray[x].pcTaskName, pxTaskStatusArray[x].usStackHighWaterMark); } vPortFree(pxTaskStatusArray); } }- CPU利用率统计： 在
FreeRTOSConfig.h中启用以下配置：
#define configUSE_TRACE_FACILITY 1 #define configGENERATE_RUN_TIME_STATS 1 #define portCONFIGURE_TIMER_FOR_RUN_TIME_STATS() ConfigureTimerForRuntimeStats() #define portGET_RUN_TIME_COUNTER_VALUE() GetRuntimeCounterValue()然后实现相应的定时器函数，并通过vTaskGetRunTimeStatistics()获取统计信息。
常见问题排查表：
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 系统卡死 | 任务栈溢出 | 增加栈大小，检查HighWaterMark |
| 数据丢失 | 队列满 | 增大队列长度或提高消费者任务优先级 |
| 串口乱码 | 波特率不匹配 | 检查两端波特率设置 |
| ADC值不稳定 | 采样时间不足 | 增加采样周期或添加硬件滤波 |
对于性能敏感的应用，可以考虑以下优化措施：
- 将ADC采样改为DMA方式，减少CPU干预
- 使用RTOS的通知机制代替信号量，降低延迟
- 对时间关键任务设置更高的优先级
- 合理调整系统节拍频率，平衡响应速度和开销
项目扩展与进阶思路
基础功能实现后，可以考虑为系统添加更多实用功能：
- 多传感器支持：
typedef struct { float temperature; float humidity; uint16_t light; } SensorData_t; // 扩展消息队列以传输结构体数据 QueueHandle_t xSensorQueue = xQueueCreate(5, sizeof(SensorData_t));- 低功耗模式：
void EnterStopMode(void) { // 配置唤醒源（如EXTI中断） HAL_PWR_EnableWakeUpPin(PWR_WAKEUP_PIN1); // 暂停RTOS调度器 vTaskSuspendAll(); // 进入停止模式 HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI); // 唤醒后恢复系统时钟 SystemClock_Config(); // 恢复调度器 xTaskResumeAll(); }无线通信模块集成： 通过SPI或UART接口连接ESP8266/ESP32模块，将传感器数据上传到云平台。可以创建一个专用的"NetworkTask"来处理无线通信。
命令行接口(CLI)： 基于串口实现简单的命令解析功能，方便调试和参数配置：
void CLITask(void *pvParameters) { char cmdBuffer[64]; uint8_t index = 0; for(;;) { if(HAL_UART_Receive(&huart1, (uint8_t*)&cmdBuffer[index], 1, 10) == HAL_OK) { if(cmdBuffer[index] == '\r') { cmdBuffer[index] = '\0'; ProcessCommand(cmdBuffer); index = 0; } else { index = (index + 1) % sizeof(cmdBuffer); } } } }在实际项目中，我发现合理使用FreeRTOS的任务通知机制可以显著简化任务间通信。相比传统的队列和信号量，通知机制更加轻量级，特别适合简单的状态同步场景。例如，当按键任务检测到用户输入时，可以直接使用xTaskNotify()唤醒通信任务立即发送当前数据，而不必维护额外的同步对象。