前置介绍为什么要手动建立工程模板?CubeMX 是一个开发工具, 并不是开发本身, 学会借助它的便利, 而不依赖它的结构, 这是我们迈向高级开发者的关键的一步新建工程简要步骤手动建立工程1. 新建工程文件夹2. 拷贝文件2.1. 参考目录, 文件结构对于 Inc 和 Src 等文件夹直接 copy 文件夹即可, 不需要一个个 copy 里面的具体文件手动创建HAL库模板/ ├── Doc/ # 文档目录 │ └── readme.txt # 项目说明文档 │ ├── Libraries/ # 库文件目录 │ ├── CMSIS/ # ARM Cortex-M 软件接口标准 │ │ ├── Device/ │ │ │ └── ST/ │ │ │ └── STM32F1xx/ # STM32F1 系列设备文件 │ │ │ ├── Include/ # 头文件 │ │ │ │ ├── stm32f1xx.h # STM32F1xx 主头文件 │ │ │ │ ├── system_stm32f1xx.h # 系统配置文件 │ │ │ │ └── stm32f103xb.h # 具体型号头文件 (F103C8T6) │ │ │ └── Source/ │ │ │ └── Templates/ # 启动模板 │ │ │ ├── arm/ # ARM 编译器启动文件 │ │ │ ├── gcc/ # GCC 启动文件 链接脚本 │ │ │ ├── iar/ # IAR 启动文件 链接脚本 │ │ │ └── system_stm32f1xx.c # 系统初始化文件 │ │ └── Include/ # CMSIS 核心头文件 │ │ ├── core_cm3.h # Cortex-M3 核心定义 │ │ ├── cmsis_compiler.h # 编译器抽象层 │ │ ├── cmsis_gcc.h # GCC 编译器支持 │ │ └── ... # 其他核心头文件 │ │ │ └── STM32F1xx_HAL_Driver/ # STM32 HAL 驱动库 │ ├── Inc/ # HAL 库头文件 │ │ ├── stm32f1xx_hal.h # HAL 库主头文件 │ │ ├── stm32f1xx_hal_conf_template.h # 配置文件模板 │ │ ├── stm32f1xx_hal_gpio.h # GPIO 驱动 │ │ ├── stm32f1xx_hal_rcc.h # RCC 时钟驱动 │ │ ├── stm32f1xx_hal_tim.h # 定时器驱动 │ │ ├── stm32f1xx_hal_uart.h # UART 驱动 │ │ ├── stm32f1xx_hal_spi.h # SPI 驱动 │ │ ├── stm32f1xx_hal_i2c.h # I2C 驱动 │ │ ├── stm32f1xx_hal_adc.h # ADC 驱动 │ │ ├── stm32f1xx_hal_dma.h # DMA 驱动 │ │ ├── stm32f1xx_hal_flash.h # Flash 驱动 │ │ ├── stm32f1xx_hal_pwr.h # 电源管理 │ │ ├── stm32f1xx_hal_cortex.h # Cortex 内核驱动 │ │ ├── Legacy/ # 传统 API 兼容头文件 │ │ └── stm32f1xx_ll_*.h # LL 库头文件 (底层驱动) │ │ │ └── Src/ # HAL 库源文件 │ ├── stm32f1xx_hal.c # HAL 核心 │ ├── stm32f1xx_hal_cortex.c # Cortex 驱动 │ ├── stm32f1xx_hal_rcc.c # RCC 驱动 │ ├── stm32f1xx_hal_gpio.c # GPIO 驱动 │ ├── stm32f1xx_hal_tim.c # 定时器驱动 │ ├── stm32f1xx_hal_uart.c # UART 驱动 │ ├── stm32f1xx_hal_spi.c # SPI 驱动 │ ├── stm32f1xx_hal_i2c.c # I2C 驱动 │ ├── stm32f1xx_hal_adc.c # ADC 驱动 │ ├── stm32f1xx_hal_dma.c # DMA 驱动 │ ├── stm32f1xx_hal_flash.c # Flash 驱动 │ ├── stm32f1xx_hal_pwr.c # 电源管理 │ ├── stm32f1xx_it.c # 中断服务函数 │ ├── system_stm32f1xx.c # 系统初始化 │ ├── Legacy/ # 传统 API 源文件 │ └── stm32f1xx_ll_*.c # LL 库源文件 │ ├── Project/ # Keil 项目文件目录 │ ├── DebugConfig/ # 调试配置 │ │ └── Target_1_STM32F103C8_1.0.0.dbgconf # 调试目标配置 │ ├── Listings/ # 编译列表文件 │ │ └── Fire_F103.map # 链接映射文件 │ ├── Objects/ # 编译输出文件 │ │ ├── Fire_F103.axf # 可执行文件 │ │ ├── Fire_F103.hex # HEX 烧录文件 │ │ ├── Fire_F103.build_log.htm # 编译日志 │ │ ├── *.o # 目标文件 │ │ ├── *.d # 依赖文件 │ │ └── *.crf # 交叉引用文件 │ ├── Fire_F103.uvprojx # Keil 项目文件 │ ├── Fire_F103.uvoptx # Keil 项目选项 │ └── Fire_F103.uvguix.HeartacheBoy # Keil 用户界面配置 │ └── User/ # 用户应用代码 ├── main.c # 主程序入口 ├── main.h # 主程序头文件 ├── stm32f1xx_hal_conf.h # HAL 库配置文件 ├── stm32f1xx_it.c # 中断服务函数实现 ├── stm32f1xx_it.h # 中断服务函数声明 └── system_stm32f1xx.c # 系统时钟配置3. 新建工程框架4. 添加分组及文件5. 魔术棒设置5.1.1. Target5.1.2. Output5.1.3. Listing5.1.4. C/C5.1.5. Debug工程代码部分/** * brief 模板 */ #include main.h /* Private typedef -----------------------------------------------------------*/ /* Private define ------------------------------------------------------------*/ /* Private macro -------------------------------------------------------------*/ /* Private variables ---------------------------------------------------------*/ /* Private function prototypes -----------------------------------------------*/ void SystemClock_Config(void); /* Private functions ---------------------------------------------------------*/ int main(void) { HAL_Init(); // 初始化 HAL 库 SystemClock_Config(); // 配置系统时钟, 设置为 72MHz while (1) { } } /** * brief System Clock Configuration * The system Clock is configured as follow : * System Clock source PLL (HSE) * SYSCLK(Hz) 72000000 * HCLK(Hz) 72000000 * AHB Prescaler 1 * APB1 Prescaler 2 * APB2 Prescaler 1 * HSE Frequency(Hz) 8000000 * HSE PREDIV1 1 * PLLMUL 9 * Flash Latency(WS) 2 * param None * retval None */ void SystemClock_Config(void) { RCC_ClkInitTypeDef clkinitstruct {0}; RCC_OscInitTypeDef oscinitstruct {0}; /* Enable HSE Oscillator and activate PLL with HSE as source */ oscinitstruct.OscillatorType RCC_OSCILLATORTYPE_HSE; oscinitstruct.HSEState RCC_HSE_ON; oscinitstruct.HSEPredivValue RCC_HSE_PREDIV_DIV1; oscinitstruct.PLL.PLLState RCC_PLL_ON; oscinitstruct.PLL.PLLSource RCC_PLLSOURCE_HSE; oscinitstruct.PLL.PLLMUL RCC_PLL_MUL9; if (HAL_RCC_OscConfig(oscinitstruct)! HAL_OK) { /* Initialization Error */ while(1); } /* Select PLL as system clock source and configure the HCLK, PCLK1 and PCLK2 clocks dividers */ clkinitstruct.ClockType (RCC_CLOCKTYPE_SYSCLK | RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_PCLK1 | RCC_CLOCKTYPE_PCLK2); clkinitstruct.SYSCLKSource RCC_SYSCLKSOURCE_PLLCLK; clkinitstruct.AHBCLKDivider RCC_SYSCLK_DIV1; clkinitstruct.APB2CLKDivider RCC_HCLK_DIV1; clkinitstruct.APB1CLKDivider RCC_HCLK_DIV2; if (HAL_RCC_ClockConfig(clkinitstruct, FLASH_LATENCY_2)! HAL_OK) { /* Initialization Error */ while(1); } }修改完之后, 编译, 下载.如果下载成功, 说明配置成功.点灯测试写个简单的点灯程序测试能否正常运行./** * brief 模板 */ #include main.h /* Private typedef -----------------------------------------------------------*/ /* Private define ------------------------------------------------------------*/ /* Private macro -------------------------------------------------------------*/ /* Private variables ---------------------------------------------------------*/ /* Private function prototypes -----------------------------------------------*/ void SystemClock_Config(void); /* Private functions ---------------------------------------------------------*/ int main(void) { HAL_Init(); // 初始化 HAL 库 SystemClock_Config(); // 配置系统时钟, 设置为 72MHz __HAL_RCC_GPIOA_CLK_ENABLE(); GPIO_InitTypeDef GPIO_PIN_LED_G; GPIO_PIN_LED_G.Mode GPIO_MODE_OUTPUT_PP; GPIO_PIN_LED_G.Pin GPIO_PIN_2; GPIO_PIN_LED_G.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOA, GPIO_PIN_LED_G); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_2, GPIO_PIN_SET); while (1) { HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_2); HAL_Delay(500); } } /** * brief System Clock Configuration * The system Clock is configured as follow : * System Clock source PLL (HSE) * SYSCLK(Hz) 72000000 * HCLK(Hz) 72000000 * AHB Prescaler 1 * APB1 Prescaler 2 * APB2 Prescaler 1 * HSE Frequency(Hz) 8000000 * HSE PREDIV1 1 * PLLMUL 9 * Flash Latency(WS) 2 * param None * retval None */ void SystemClock_Config(void) { RCC_ClkInitTypeDef clkinitstruct {0}; RCC_OscInitTypeDef oscinitstruct {0}; /* Enable HSE Oscillator and activate PLL with HSE as source */ oscinitstruct.OscillatorType RCC_OSCILLATORTYPE_HSE; oscinitstruct.HSEState RCC_HSE_ON; oscinitstruct.HSEPredivValue RCC_HSE_PREDIV_DIV1; oscinitstruct.PLL.PLLState RCC_PLL_ON; oscinitstruct.PLL.PLLSource RCC_PLLSOURCE_HSE; oscinitstruct.PLL.PLLMUL RCC_PLL_MUL9; if (HAL_RCC_OscConfig(oscinitstruct)! HAL_OK) { /* Initialization Error */ while(1); } /* Select PLL as system clock source and configure the HCLK, PCLK1 and PCLK2 clocks dividers */ clkinitstruct.ClockType (RCC_CLOCKTYPE_SYSCLK | RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_PCLK1 | RCC_CLOCKTYPE_PCLK2); clkinitstruct.SYSCLKSource RCC_SYSCLKSOURCE_PLLCLK; clkinitstruct.AHBCLKDivider RCC_SYSCLK_DIV1; clkinitstruct.APB2CLKDivider RCC_HCLK_DIV1; clkinitstruct.APB1CLKDivider RCC_HCLK_DIV2; if (HAL_RCC_ClockConfig(clkinitstruct, FLASH_LATENCY_2)! HAL_OK) { /* Initialization Error */ while(1); } }这里有个注意点:在STM32中为了降低功耗所有外设包括GPIO端口的时钟在默认情况下都是关闭的。必须先手动开启对应端口的时钟才能对其进行配置和操作。例如: 使用 GPIOA , 那么就要使用 __HAL_RCC_GPIOA_CLK_ENABLE();测试程序现象