1. 课程导论：为什么需要可移植性架构？

各位同学，大家好。我是这门课的主讲。

做嵌入式开发十几年，我见过太多因为硬件换型、OS升级导致整个项目重写的惨案。说实话，每次看到团队加班加点只为把代码从一个MCU移植到另一个MCU，我心里都挺不是滋味的。

今天这第一讲，咱们就来聊聊最根本的问题：为什么非要搞可移植性架构？

1.1 嵌入式软件的“碎片化”困局

嵌入式开发不像PC或手机，就那么几个平台。你想想看，光是ARM Cortex-M系列，就有ST、NXP、TI、Microchip等十几家厂商。每家都有自己的HAL库、寄存器定义、时钟配置方式。

这还没完。同一个芯片，你可能跑FreeRTOS，也可能跑RT-Thread、uC/OS、ThreadX，甚至裸机。OS的调度方式、IPC机制、内存管理，天差地别。

我在一个车载项目中遇到过这种情况：产品初期用STM32F4 + FreeRTOS，开发了一年。中期因为成本压力，换成了GD32 + RT-Thread。结果呢？底层驱动重写，OS接口全换，业务逻辑里到处是OS相关的代码，改得人想哭。

1.2 硬件碎片化：不只是换个芯片那么简单

很多人觉得，移植嘛，不就是改改寄存器地址？太天真了。

硬件差异体现在多个层面：

差异维度	典型问题	影响范围
外设寄存器布局	UART、SPI、I2C的寄存器地址和位定义完全不同	驱动层全部重写
中断控制器	NVIC vs VIC，中断优先级分组方式不同	中断管理代码
时钟树	PLL配置、时钟源选择、分频系数差异大	系统初始化
DMA控制器	通道数量、传输模式、描述符格式不同	数据搬运逻辑
GPIO	推挽/开漏配置、上下拉、复用功能映射	几乎所有外设

你看，这还只是MCU层面的差异。如果换成MPU，跑Linux，那又是另一套玩法了。

1.3 OS多样性：API接口的“巴别塔”

操作系统抽象层（OSAL）为什么重要？我直接给你看个例子。

同样是创建一个任务：

// FreeRTOS
xTaskCreate(vTaskFunction, "Task1", 256, NULL, 2, &xTaskHandle);

// RT-Thread
rt_thread_t tid = rt_thread_create("task1", vTaskFunction, NULL, 256, 2, 10);

// uC/OS-III
OSTaskCreate((OS_TCB *)&Task1TCB,
             (CPU_CHAR *)"Task1",
             (OS_TASK_PTR)vTaskFunction,
             (void *)NULL,
             (OS_PRIO)2,
             (CPU_STK *)&Task1Stk[0],
             (CPU_STK_SIZE)256 / sizeof(CPU_STK),
             (OS_MSG_QTY)0,
             (OS_TICK)10,
             (void *)NULL,
             (OS_OPT)OS_OPT_TASK_NONE,
             (OS_ERR *)&err);

参数顺序不同、类型不同、返回值不同。如果你的业务代码里直接调用了这些API，换OS就是一场噩梦。

1.4 可移植性架构到底解决什么问题？

说白了，就是隔离变化。

我们把代码分成三层：

• 业务逻辑层：只关心“做什么”，不关心“怎么做”。比如：读取传感器数据、执行控制算法、上报状态。
• 硬件抽象层（HAL）：封装MCU外设差异。提供统一的接口，比如 HAL_UART_Transmit()、HAL_GPIO_WritePin()。
• 操作系统抽象层（OSAL）：封装OS差异。提供统一的接口，比如 OSAL_TaskCreate()、OSAL_SemaphoreTake()。

这样，当硬件或OS变化时，只需要修改HAL或OSAL的实现，业务代码纹丝不动。

1.5 本章知识体系

下面这张图，概括了嵌入式软件可移植性架构的核心逻辑：

1.6 这门课能带给你什么？

30章的内容，我会带着你从零搭建一套完整的可移植性架构。不是纸上谈兵，每一章都有代码、有案例、有我在项目中踩过的坑。

• HAL设计：如何定义统一的GPIO、UART、SPI、I2C接口？如何做到不改一行业务代码就换MCU？
• OSAL设计：如何封装任务、信号量、消息队列、事件标志组？如何兼容FreeRTOS、RT-Thread、uC/OS？
• 实战案例：一个完整的传感器数据采集系统，从STM32移植到GD32，从FreeRTOS移植到RT-Thread，全程演示。
• 测试与验证：如何保证抽象层接口的正确性？如何做单元测试和集成测试？