1. 项目背景与工程架构设计在嵌入式系统开发中，一个看似简单的万年历功能背后，实则是一次完整的软件工程实践。它不仅涉及RTC（实时时钟）的时间管理、OLED显示驱动、旋转编码器人机交互等硬件外设协同，更关键的是如何将这些分散的模块组织成可维护、可扩展、职责清晰的代码结构。本项目以STM32F103C8T6（Cortex-M3内核）为平台，采用HAL库进行底层驱动，不依赖任何RTOS，完全基于裸机循环调度构建。其核心目标并非仅实现时间显示，而是建立一套符合工业级嵌入式开发范式的模块化架构。该架构摒弃了传统“所有代码堆砌在main.c”的教学式写法，转而采用分层模块化设计。整个工程被明确划分为三个逻辑层级：应用层（Application Layer）、模块库层（Library Layer）和硬件抽象层（HAL Layer）。应用层（位于/APP/SRC）承载全部业务逻辑，即万年历的状态机、模式切换、时间设置流程；模块库层（位于/LIB/SRC）封装了OLED、RTC、旋钮（Knob）等独立功能单元，每个模块对外提供清晰的初始化、配置、操作接口，并通过回调函数机制与上层解耦；硬件抽象层则由STM32CubeMX生成的HAL代码构成，负责最底层的寄存器操作与中断处理。这种划分严格遵循了“高内聚、低耦合”原则——OLED库无需知晓RTC如何工作，旋钮模块也不关心时间数据如何被解析显示。当未来需要更换OLED屏幕型号时，只需重写/LIB/SRC/oled.c中的底层通信函数，应用层代码一行不需改动；同理，若