add README.md
This commit is contained in:
@@ -0,0 +1,58 @@
|
||||
# 基于Cmake编译的STM32标准库项目模板
|
||||
|
||||
## 项目概述
|
||||
本项目提供了一个基于 CMake 和 `gcc-arm-none-eabi` 编译器的模板,用于开发 STM32 微控制器的应用程序。它配置了必要的编译选项和链接脚本,使得开发者可以轻松地开始编写针对 STM32F103 系列微控制器的代码,并可在此基础上修改以支持其他控制器。
|
||||
|
||||
## 主要特性
|
||||
- **CMake 构建系统**:使用 CMake 来管理项目的构建过程,支持跨平台编译。
|
||||
- **GCC ARM Embedded 工具链**:利用 `gcc-arm-none-eabi` 编译器为 ARM 架构生成可执行文件。
|
||||
- **STM32 标准外设库**:集成了 STM32 标准外设库,简化硬件抽象层的开发。
|
||||
- **灵活的编译选项**:支持 Debug 和 Release 两种编译模式,并且可以通过 CMake 配置进行自定义调整。
|
||||
- **预设的链接脚本**:包含一个默认的链接脚本 `STM32F103C8TX_FLASH.ld`,适用于 STM32F103C8T6 微控制器。
|
||||
|
||||
## 项目结构
|
||||
```
|
||||
STM32-CMake-Demo
|
||||
├── build/ # 构建输出目录
|
||||
├── cmake/ # CMake 相关文件
|
||||
│ ├── stm32base/ # STM32 基础库配置
|
||||
│ └── gcc-arm-none-eabi.cmake # GCC ARM Embedded 工具链配置
|
||||
├── Libraries/ # 外部库(如 STM32 标准外设库)
|
||||
├── USER/ # 用户源码及头文件
|
||||
├── .gitignore # Git 忽略文件列表
|
||||
├── CMakeLists.txt # 顶层 CMake 配置文件
|
||||
├── CMakePresets.json # CMake 预设配置
|
||||
└── STM32F103C8TX_FLASH.ld # 链接脚本
|
||||
```
|
||||
|
||||
|
||||
### 关键文件说明
|
||||
- **CMakeLists.txt**: 顶层 CMake 脚本,定义了整个项目的编译设置、源文件以及链接库等信息。
|
||||
- **cmake/gcc-arm-none-eabi.cmake**: 定义了 GCC ARM Embedded 工具链的具体配置,包括编译器路径、标志等。
|
||||
- **USER/src/main.c**: 示例主函数入口点,演示了如何初始化 LED 并实现简单的闪烁功能。
|
||||
- **Libraries/**: 包含了 STM32F10x 标准外设库及其相关文件。
|
||||
- **STM32F103C8TX_FLASH.ld**: 针对特定型号 STM32 微控制器的内存映射链接脚本。
|
||||
|
||||
## 开始使用
|
||||
1. 确保已安装以下工具:
|
||||
- CMake (版本 >= 3.22)
|
||||
- `gcc-arm-none-eabi` 编译器套件
|
||||
2. 克隆此仓库到本地。
|
||||
3. 在项目根目录下创建一个构建目录并进入该目录:
|
||||
```shell script
|
||||
mkdir build && cd build
|
||||
```
|
||||
|
||||
4. 运行 CMake 配置命令:
|
||||
```shell script
|
||||
cmake ..
|
||||
```
|
||||
|
||||
5. 编译项目:
|
||||
```shell script
|
||||
make
|
||||
```
|
||||
|
||||
|
||||
## 示例代码
|
||||
示例代码位于 `USER/src/main.c` 中,展示了如何通过 GPIO 控制板载 LED 的亮灭。更多详细信息请参阅源代码。
|
||||
Reference in New Issue
Block a user