从Makefile到CMake：NumWorks计算器移植ESP-IDF实战

1. 项目背景与目标

作为一名长期从事嵌入式系统开发的工程师，我最近接手了一个有趣的项目：将NumWorks图形计算器的软件从原有的Makefile构建系统迁移到基于CMake的ESP-IDF框架。这个移植工作看似简单，实则暗藏玄机，特别是当我们需要处理复杂的模块依赖关系时。

NumWorks是一款基于STM32微控制器的开源图形计算器，其软件架构设计精良，但构建系统相对传统。而ESP-IDF是乐鑫为ESP32系列芯片提供的官方开发框架，采用现代化的CMake构建系统。将两者结合，不仅能让NumWorks运行在更强大的ESP32-S3硬件平台上，还能享受ESP-IDF丰富的组件生态系统。

2. 理解NumWorks的Makefile结构

2.1 Makefile体系解析

NumWorks的构建系统采用典型的分布式Makefile架构。顶层Makefile位于项目根目录，负责协调整个构建过程。通过深入研究，我发现它主要包含以下几个关键部分：

• 平台配置：位于build/platform.mak，定义了目标硬件平台（如n0110）相关的设置
• 全局配置：位于build/config.mak，包含编译器选项、优化级别等通用设置
• 模块规则：位于build/module.mak，定义了如何构建各个模块的通用规则

每个功能模块（如ion、kandinsky等）都有自己的子makefile，定义了模块特定的源文件、头文件路径和依赖关系。这种设计使得模块可以独立开发，同时又能被顶层Makefile统一管理。

2.2 典型模块makefile示例

以Ion模块为例，其makefile通常包含以下关键内容：

makefile复制ION_ROOT = $(ROOT)/ion
ION_SRC = \
  $(ION_ROOT)/src/display.cpp \
  $(ION_ROOT)/src/keyboard.cpp \
  $(ION_ROOT)/src/timing.cpp \
  $(ION_ROOT)/src/device/shared/crc32.cpp \
  $(ION_ROOT)/src/device/n0110/display.cpp

ION_CCFLAGS = -I$