告别状态机！在STM32单片机上用Protothread协程库实现异步LED闪烁（附完整代码）

告别状态机！在STM32单片机上用Protothread协程库实现异步LED闪烁（附完整代码）

在嵌入式开发中，如何优雅地处理多个异步任务一直是开发者面临的挑战。想象一下这样的场景：你的STM32需要同时处理LED闪烁、按键检测和串口通信，而传统的延时循环或状态机实现往往让代码变得难以维护。今天，我将带你用Protothread这个轻量级协程库，以更自然的方式编写异步代码。

1. 为什么选择Protothread？

在资源受限的单片机环境中，开发者通常面临两种选择：使用复杂的状态机，或者引入实时操作系统(RTOS)。前者代码难以维护，后者则可能带来不必要的开销。

Protothread提供了第三种方案——协程。它具备以下优势：

• 极低的内存占用：每个协程仅需2字节存储状态
• 无堆栈切换：相比传统线程更轻量
• 线性代码结构：消除状态机的跳转逻辑
• 可移植性强：纯C实现，不依赖特定硬件

// 传统状态机实现LED闪烁 typedef enum { LED_OFF, LED_ON, DELAY } led_state_t; void led_task() { static led_state_t state = LED_OFF; static uint32_t timer = 0; switch(state) { case LED_OFF: GPIO_ResetBits(LED_PORT, LED_PIN); timer = HAL_GetTick(); state = DELAY; break; case LED_ON: GPIO_SetBits(LED_PORT, LED_PIN); timer = HAL_GetTick(); state = DELAY; break; case DELAY: if(HAL_GetTick() - timer >= 500) { state = (state == LED_OFF) ? LED_ON : LED_OFF; } break; } }

对比上面的状态机实现，Protothread让代码更接近我们自然的思维方式。

2. Protothread核心机制解析

Protothread的实现基于C语言的局部continuation概念，通过宏技巧实现了协程的挂起和恢复。关键要理解这几个核心机制：

2.1 协程控制块

每个协程需要一个struct pt控制块，保存协程的执行状态：

struct pt { lc_t lc; // 行号或标签指针 };

2.2 协程生命周期管理

Protothread提供了一套宏来管理协程：

注意：Protothread默认使用switch实现，因此在协程函数内避免使用switch语句，否则会导致冲突。

3. 在STM32上集成Protothread

让我们一步步将Protothread集成到STM32工程中：

3.1 获取并添加库文件

从官网下载Protothread库，只需要将以下文件添加到工程：

• pt.h
• lc.h
• lc-switch.h(或lc-addrlabels.h)

# 推荐的文件结构 YourProject/ ├── Inc/ │ ├── pt.h │ ├── lc.h │ └── lc-switch.h ├── Src/ │ ├── main.c │ └── protothread_demo.c

3.2 基础配置

在main.h中添加包含路径：

#include "pt.h"

初始化协程控制块：

static struct pt led_pt, button_pt, uart_pt; int main(void) { HAL_Init(); SystemClock_Config(); PT_INIT(&led_pt); PT_INIT(&button_pt); PT_INIT(&uart_pt); while (1) { led_task(&led_pt); button_task(&button_pt); uart_task(&uart_pt); } }

4. 实现异步LED闪烁

现在我们来实现核心功能——非阻塞的LED闪烁：

4.1 基本闪烁实现

static PT_THREAD(led_task(struct pt *pt)) { static uint32_t last_tick; PT_BEGIN(pt); while(1) { // LED亮 HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_SET); last_tick = HAL_GetTick(); PT_WAIT_UNTIL(pt, HAL_GetTick() - last_tick >= 200); // LED灭 HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET); last_tick = HAL_GetTick(); PT_WAIT_UNTIL(pt, HAL_GetTick() - last_tick >= 800); } PT_END(pt); }

4.2 添加可调参数

通过信号量实现频率调节：

#include "pt-sem.h" static struct pt_sem led_sem; static uint16_t blink_interval = 500; static PT_THREAD(led_task(struct pt *pt)) { static uint32_t last_tick; PT_BEGIN(pt); while(1) { PT_SEM_WAIT(pt, &led_sem); // 等待触发 HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); last_tick = HAL_GetTick(); PT_WAIT_UNTIL(pt, HAL_GetTick() - last_tick >= blink_interval); } PT_END(pt); } // 在定时器中断中触发 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim == &htim2) { PT_SEM_SIGNAL(&led_pt, &led_sem); } }

4.3 多任务协作示例

结合按键控制LED模式：

static PT_THREAD(button_task(struct pt *pt)) { static uint8_t mode = 0; PT_BEGIN(pt); while(1) { PT_WAIT_UNTIL(pt, HAL_GPIO_ReadPin(BUTTON_GPIO_Port, BUTTON_Pin) == GPIO_PIN_RESET); HAL_Delay(50); // 简单消抖 mode = (mode + 1) % 3; switch(mode) { case 0: blink_interval = 200; break; case 1: blink_interval = 500; break; case 2: blink_interval = 1000; break; } PT_WAIT_UNTIL(pt, HAL_GPIO_ReadPin(BUTTON_GPIO_Port, BUTTON_Pin) == GPIO_PIN_SET); } PT_END(pt); }

5. 高级技巧与常见问题

5.1 避免静态变量的陷阱

Protothread依赖静态变量保存状态，但不当使用会导致问题：

// 错误示例 - 多个实例共享状态 static PT_THREAD(bad_example(struct pt *pt)) { static int counter; // 所有实例共享 PT_BEGIN(pt); // ... PT_END(pt); } // 正确做法 - 使用结构体封装 struct led_ctx { uint32_t last_tick; uint16_t interval; }; static PT_THREAD(good_example(struct pt *pt, struct led_ctx *ctx)) { PT_BEGIN(pt); while(1) { HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); ctx->last_tick = HAL_GetTick(); PT_WAIT_UNTIL(pt, HAL_GetTick() - ctx->last_tick >= ctx->interval); } PT_END(pt); }

5.2 性能优化技巧

• 使用lc-addrlabels.h实现（需要GCC）
• 避免在协程中使用浮点运算
• 关键时序部分仍用硬件定时器

5.3 调试建议

添加调试输出宏：

#define PT_DEBUG(pt, fmt, ...) \ do { \ if((pt)->lc) \ printf("[PT %p] " fmt, pt, ##__VA_ARGS__); \ } while(0) static PT_THREAD(debug_demo(struct pt *pt)) { PT_BEGIN(pt); PT_DEBUG(pt, "协程启动\n"); // ... PT_END(pt); }

完整示例代码

以下是基于STM32CubeIDE的完整实现：

/* main.c */ #include "main.h" #include "pt.h" struct led_ctx { uint32_t last_tick; uint16_t interval; }; static struct pt led_pt; static struct led_ctx led_ctx = {.interval = 500}; static PT_THREAD(led_task(struct pt *pt, struct led_ctx *ctx)) { PT_BEGIN(pt); while(1) { HAL_GPIO_TogglePin(LD2_GPIO_Port, LD2_Pin); ctx->last_tick = HAL_GetTick(); PT_WAIT_UNTIL(pt, HAL_GetTick() - ctx->last_tick >= ctx->interval); } PT_END(pt); } int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); PT_INIT(&led_pt); while (1) { led_task(&led_pt, &led_ctx); } }

在实际项目中，我发现Protothread特别适合处理那些需要等待外部事件的任务，比如等待传感器数据、超时处理等。相比状态机，它的代码可读性明显提升，而资源消耗又远低于RTOS。