From d252e8b178464a67281e6f474a82d343cc81a612 Mon Sep 17 00:00:00 2001 From: tux Date: Tue, 11 Nov 2025 15:16:06 +0800 Subject: [PATCH] add commit to cmake files --- cmake/Toolchain/gcc-arm-none-eabi.cmake | 37 +++++++++++++---- cmake/Toolchain/starm-clang.cmake | 53 +++++++++++++++++++------ 2 files changed, 70 insertions(+), 20 deletions(-) diff --git a/cmake/Toolchain/gcc-arm-none-eabi.cmake b/cmake/Toolchain/gcc-arm-none-eabi.cmake index 7d2065e..13ca6c0 100644 --- a/cmake/Toolchain/gcc-arm-none-eabi.cmake +++ b/cmake/Toolchain/gcc-arm-none-eabi.cmake @@ -1,55 +1,78 @@ +# 设置目标系统为通用系统(无操作系统) set(CMAKE_SYSTEM_NAME Generic) +# 设置目标处理器架构为ARM set(CMAKE_SYSTEM_PROCESSOR arm) +# 以下三行被注释掉的设置用于强制指定编译器信息 #set(CMAKE_C_COMPILER_FORCED TRUE) #set(CMAKE_CXX_COMPILER_FORCED TRUE) #set(CMAKE_C_COMPILER_ID GNU) #set(CMAKE_CXX_COMPILER_ID GNU) -# Some default GCC settings -# arm-none-eabi- must be part of path environment +# 设置工具链前缀(需要在系统PATH环境变量中包含arm-none-eabi-工具链) set(TOOLCHAIN_PREFIX arm-none-eabi-) +# 设置C编译器为arm-none-eabi-gcc set(CMAKE_C_COMPILER ${TOOLCHAIN_PREFIX}gcc) +# 设置汇编器使用C编译器(gcc也可以处理汇编文件) set(CMAKE_ASM_COMPILER ${CMAKE_C_COMPILER}) +# 设置C++编译器为arm-none-eabi-g++ set(CMAKE_CXX_COMPILER ${TOOLCHAIN_PREFIX}g++) +# 设置链接器为arm-none-eabi-g++(使用C++编译器进行链接) set(CMAKE_LINKER ${TOOLCHAIN_PREFIX}g++) +# 设置objcopy工具,用于生成二进制文件等 set(CMAKE_OBJCOPY ${TOOLCHAIN_PREFIX}objcopy) +# 设置size工具,用于查看程序内存占用 set(CMAKE_SIZE ${TOOLCHAIN_PREFIX}size) +# 设置各种源文件生成的可执行文件后缀为.elf set(CMAKE_EXECUTABLE_SUFFIX_ASM ".elf") set(CMAKE_EXECUTABLE_SUFFIX_C ".elf") set(CMAKE_EXECUTABLE_SUFFIX_CXX ".elf") +# 设置尝试编译的目标类型为静态库(用于工具链测试) set(CMAKE_TRY_COMPILE_TARGET_TYPE STATIC_LIBRARY) -# MCU specific flags +# 设置MCU特定的编译标志 set(TARGET_FLAGS "-mcpu=cortex-m7 -mfpu=fpv5-d16 -mfloat-abi=hard ") +# 将MCU标志添加到C编译标志中 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${TARGET_FLAGS}") +# 添加警告和优化相关标志 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -Wextra -Wpedantic -fdata-sections -ffunction-sections") + +# 根据构建类型设置不同的优化级别 if(CMAKE_BUILD_TYPE MATCHES "Debug") - set(CMAKE_C_FLAGS_DEBUG "-O0 -g") + set(CMAKE_C_FLAGS_DEBUG "-O0 -g") # 调试模式:无优化,包含调试信息 set(CMAKE_CXX_FLAGS_DEBUG "-O0 -g") elseif(CMAKE_BUILD_TYPE MATCHES "Release") - set(CMAKE_C_FLAGS_RELEASE "-O3") + set(CMAKE_C_FLAGS_RELEASE "-O3") # 发布模式:最高级别优化 set(CMAKE_CXX_FLAGS_RELEASE "-O3") elseif(CMAKE_BUILD_TYPE MATCHES "RelWithDebInfo") - set(CMAKE_C_FLAGS_RELWITHDEBINFO "-O2 -g") + set(CMAKE_C_FLAGS_RELWITHDEBINFO "-O2 -g") # 带调试信息的发布模式:中等优化,包含调试信息 set(CMAKE_CXX_FLAGS_RELWITHDEBINFO "-O2 -g") elseif(CMAKE_BUILD_TYPE MATCHES "MinSizeRel") - set(CMAKE_C_FLAGS_MINSIZEREL "-Os") + set(CMAKE_C_FLAGS_MINSIZEREL "-Os") # 最小体积模式:优化代码大小 set(CMAKE_CXX_FLAGS_MINSIZEREL "-Os") endif() +# 设置汇编器标志:包含C标志,并添加汇编特定选项 set(CMAKE_ASM_FLAGS "${CMAKE_C_FLAGS} -x assembler-with-cpp -MMD -MP") +# 设置C++标志:包含C标志,并禁用RTTI、异常和线程安全静态变量 set(CMAKE_CXX_FLAGS "${CMAKE_C_FLAGS} -fno-rtti -fno-exceptions -fno-threadsafe-statics") +# 设置C链接标志 set(CMAKE_C_LINK_FLAGS "${TARGET_FLAGS}") +# 添加链接脚本文件 set(CMAKE_C_LINK_FLAGS "${CMAKE_C_LINK_FLAGS} -T \"${CMAKE_SOURCE_DIR}/STM32H723XG_FLASH.ld\"") +# 使用nano规格(精简C库) set(CMAKE_C_LINK_FLAGS "${CMAKE_C_LINK_FLAGS} --specs=nano.specs") +# 生成map文件并启用垃圾回收 set(CMAKE_C_LINK_FLAGS "${CMAKE_C_LINK_FLAGS} -Wl,-Map=${CMAKE_PROJECT_NAME}.map -Wl,--gc-sections") +# 链接C库和数学库(使用组解决循环依赖) set(CMAKE_C_LINK_FLAGS "${CMAKE_C_LINK_FLAGS} -Wl,--start-group -lc -lm -Wl,--end-group") +# 打印内存使用情况 set(CMAKE_C_LINK_FLAGS "${CMAKE_C_LINK_FLAGS} -Wl,--print-memory-usage") +# 设置C++链接标志:在C链接标志基础上添加C++标准库支持 set(CMAKE_CXX_LINK_FLAGS "${CMAKE_C_LINK_FLAGS} -Wl,--start-group -lstdc++ -lsupc++ -Wl,--end-group") \ No newline at end of file diff --git a/cmake/Toolchain/starm-clang.cmake b/cmake/Toolchain/starm-clang.cmake index 7ae916f..c899a54 100644 --- a/cmake/Toolchain/starm-clang.cmake +++ b/cmake/Toolchain/starm-clang.cmake @@ -1,74 +1,101 @@ +# 设置目标系统为通用系统(无操作系统) set(CMAKE_SYSTEM_NAME Generic) +# 设置目标处理器架构为ARM set(CMAKE_SYSTEM_PROCESSOR arm) +# 明确指定编译器为Clang set(CMAKE_C_COMPILER_ID Clang) set(CMAKE_CXX_COMPILER_ID Clang) -# Some default llvm settings +# 设置工具链前缀为starm-(ST ARM工具链) set(TOOLCHAIN_PREFIX starm-) +# 设置C编译器为starm-clang set(CMAKE_C_COMPILER ${TOOLCHAIN_PREFIX}clang) +# 设置汇编器使用C编译器(clang也可以处理汇编文件) set(CMAKE_ASM_COMPILER ${CMAKE_C_COMPILER}) +# 设置C++编译器为starm-clang++ set(CMAKE_CXX_COMPILER ${TOOLCHAIN_PREFIX}clang++) +# 设置链接器为starm-clang set(CMAKE_LINKER ${TOOLCHAIN_PREFIX}clang) +# 设置objcopy工具,用于生成二进制文件等 set(CMAKE_OBJCOPY ${TOOLCHAIN_PREFIX}objcopy) +# 设置size工具,用于查看程序内存占用 set(CMAKE_SIZE ${TOOLCHAIN_PREFIX}size) +# 设置各种源文件生成的可执行文件后缀为.elf set(CMAKE_EXECUTABLE_SUFFIX_ASM ".elf") set(CMAKE_EXECUTABLE_SUFFIX_C ".elf") set(CMAKE_EXECUTABLE_SUFFIX_CXX ".elf") +# 设置尝试编译的目标类型为静态库(用于工具链测试) set(CMAKE_TRY_COMPILE_TARGET_TYPE STATIC_LIBRARY) -# STARM_TOOLCHAIN_CONFIG allows you to choose the toolchain configuration. -# Possible values are: -# "STARM_HYBRID" : Hybrid configuration using starm-clang Assemler and Compiler and GNU Linker -# "STARM_NEWLIB" : starm-clang toolchain with NEWLIB C library -# "STARM_PICOLIBC" : starm-clang toolchain with PICOLIBC C library +# STARM_TOOLCHAIN_CONFIG允许选择工具链配置,可能的取值有: +# "STARM_HYBRID" : 混合配置,使用starm-clang汇编器和编译器,但使用GNU链接器 +# "STARM_NEWLIB" : 使用NEWLIB C库的starm-clang工具链 +# "STARM_PICOLIBC" : 使用PICOLIBC C库的starm-clang工具链 set(STARM_TOOLCHAIN_CONFIG "STARM_HYBRID") +# 根据选择的工具链配置设置多库配置选项 if (STARM_TOOLCHAIN_CONFIG STREQUAL "STARM_HYBRID") + # 混合配置:使用GNU工具链的多库配置和GCC工具链路径 set(TOOLCHAIN_MULTILIBS "--multi-lib-config=\"$ENV{CLANG_GCC_CMSIS_COMPILER}/multilib.gnu_tools_for_stm32.yaml\" --gcc-toolchain=\"$ENV{GCC_TOOLCHAIN_ROOT}/..\"") elseif (STARM_TOOLCHAIN_CONFIG STREQUAL "STARM_NEWLIB") + # Newlib配置:使用newlib.cfg配置文件 set(TOOLCHAIN_MULTILIBS "--config=newlib.cfg") endif () -# MCU specific flags +# 设置MCU特定的编译标志 set(TARGET_FLAGS "-mcpu=cortex-m7 -mfpu=fpv5-d16 -mfloat-abi=hard ${TOOLCHAIN_MULTILIBS}") +# 将MCU标志添加到C编译标志中 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${TARGET_FLAGS}") +# 设置汇编器标志:包含C标志,并添加汇编特定选项 set(CMAKE_ASM_FLAGS "${CMAKE_C_FLAGS} -x assembler-with-cpp -MP") +# 添加警告和优化相关标志到C编译标志 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -fdata-sections -ffunction-sections") +# 根据构建类型设置不同的优化级别 if (CMAKE_BUILD_TYPE MATCHES "Debug") - set(CMAKE_C_FLAGS_DEBUG "-O0 -g") + set(CMAKE_C_FLAGS_DEBUG "-O0 -g") # 调试模式:无优化,包含调试信息 set(CMAKE_CXX_FLAGS_DEBUG "-O0 -g") elseif (CMAKE_BUILD_TYPE MATCHES "Release") - set(CMAKE_C_FLAGS_RELEASE "-O3") + set(CMAKE_C_FLAGS_RELEASE "-O3") # 发布模式:最高级别优化 set(CMAKE_CXX_FLAGS_RELEASE "-O3") elseif (CMAKE_BUILD_TYPE MATCHES "RelWithDebInfo") - set(CMAKE_C_FLAGS_RELWITHDEBINFO "-O2 -g") + set(CMAKE_C_FLAGS_RELWITHDEBINFO "-O2 -g") # 带调试信息的发布模式:中等优化,包含调试信息 set(CMAKE_CXX_FLAGS_RELWITHDEBINFO "-O2 -g") elseif (CMAKE_BUILD_TYPE MATCHES "MinSizeRel") - set(CMAKE_C_FLAGS_MINSIZEREL "-Os") + set(CMAKE_C_FLAGS_MINSIZEREL "-Os") # 最小体积模式:优化代码大小 set(CMAKE_CXX_FLAGS_MINSIZEREL "-Os") endif () +# 设置C++标志:包含C标志,并禁用RTTI、异常和线程安全静态变量 set(CMAKE_CXX_FLAGS "${CMAKE_C_FLAGS} -fno-rtti -fno-exceptions -fno-threadsafe-statics") +# 设置可执行文件链接标志 set(CMAKE_EXE_LINKER_FLAGS "${TARGET_FLAGS}") +# 根据工具链配置添加特定的链接选项 if (STARM_TOOLCHAIN_CONFIG STREQUAL "STARM_HYBRID") + # 混合配置:使用GCC的nano规格 set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} --gcc-specs=nano.specs") + # 链接数学库 set(TOOLCHAIN_LINK_LIBRARIES "m") elseif (STARM_TOOLCHAIN_CONFIG STREQUAL "STARM_NEWLIB") + # Newlib配置:使用无系统支持的C运行时 set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -lcrt0-nosys") elseif (STARM_TOOLCHAIN_CONFIG STREQUAL "STARM_PICOLIBC") + # Picolibc配置:使用托管环境的C运行时 set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -lcrt0-hosted") - endif () +# 添加链接脚本文件 set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -T \"${CMAKE_SOURCE_DIR}/STM32H723XG_FLASH.ld\"") +# 生成map文件并启用垃圾回收 set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -Wl,-Map=${CMAKE_PROJECT_NAME}.map -Wl,--gc-sections") +# 设置栈为不可执行(安全增强) set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -z noexecstack") -set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -Wl,--print-memory-usage ") +# 打印内存使用情况 +set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -Wl,--print-memory-usage ") \ No newline at end of file