stm32f103c8t6库函数

针对 STM32F103C8T6（基于 Cortex-M3 内核）的库函数开发，ST 官方提供了两种主流的库：标准外设库（Standard Peripheral Library, SPL） 和 HAL/LL 库。以下是两种库的中文对比及使用示例：

一、标准外设库（SPL）

适用于直接操作寄存器的传统开发方式，代码效率高，但配置较繁琐。

1. 常用模块及函数

GPIO 配置

// 使能 GPIOB 时钟
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE);

// 配置 PB12 为推挽输出
GPIO_InitTypeDef GPIO_InitStruct;
GPIO_InitStruct.GPIO_Pin = GPIO_Pin_12;
GPIO_InitStruct.GPIO_Mode = GPIO_Mode_Out_PP;  // 推挽输出
GPIO_InitStruct.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(GPIOB, &GPIO_InitStruct);

USART 串口通信

// 使能 USART1 和 GPIOA 时钟
RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE);

// 配置 PA9 (TX) 为复用推挽输出
GPIO_InitStruct.GPIO_Pin = GPIO_Pin_9;
GPIO_InitStruct.GPIO_Mode = GPIO_Mode_AF_PP;
GPIO_Init(GPIOA, &GPIO_InitStruct);

// 初始化 USART1
USART_InitTypeDef USART_InitStruct;
USART_InitStruct.USART_BaudRate = 115200;
USART_InitStruct.USART_WordLength = USART_WordLength_8b;
USART_InitStruct.USART_StopBits = USART_StopBits_1;
USART_InitStruct.USART_Parity = USART_Parity_No;
USART_InitStruct.USART_Mode = USART_Mode_Tx | USART_Mode_Rx;
USART_Init(USART1, &USART_InitStruct);
USART_Cmd(USART1, ENABLE);

定时器（TIM）PWM 输出

// 使能 TIM3 时钟
RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE);

// 配置 TIM3 通道1 (PA6) 为 PWM 输出
TIM_OCInitTypeDef TIM_OCInitStruct;
TIM_OCInitStruct.TIM_OCMode = TIM_OCMode_PWM1;
TIM_OCInitStruct.TIM_OutputState = TIM_OutputState_Enable;
TIM_OCInitStruct.TIM_Pulse = 500;  // 占空比
TIM_OC1Init(TIM3, &TIM_OCInitStruct);

// 启动 TIM3
TIM_Cmd(TIM3, ENABLE);

二、HAL 库

ST 推荐的现代库，提供硬件抽象层，简化跨平台移植，但代码体积稍大。

1. 常用模块及函数

GPIO 配置

// 使能 GPIOB 时钟
__HAL_RCC_GPIOB_CLK_ENABLE();

// 配置 PB12 为输出
GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = GPIO_PIN_12;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

USART 通信

// 初始化 USART1
UART_HandleTypeDef huart1;
huart1.Instance = USART1;
huart1.Init.BaudRate = 115200;
huart1.Init.WordLength = UART_WORDLENGTH_8B;
huart1.Init.StopBits = UART_STOPBITS_1;
huart1.Init.Parity = UART_PARITY_NONE;
huart1.Init.Mode = UART_MODE_TX_RX;
HAL_UART_Init(&huart1);

// 发送数据
uint8_t data[] = "Hello World!";
HAL_UART_Transmit(&huart1, data, sizeof(data), 1000);

ADC 采样

// 初始化 ADC1
ADC_HandleTypeDef hadc;
hadc.Instance = ADC1;
hadc.Init.ScanConvMode = ADC_SCAN_DISABLE;
hadc.Init.ContinuousConvMode = ENABLE;
HAL_ADC_Init(&hadc);

// 启动 ADC 采样
HAL_ADC_Start(&hadc);
uint32_t adc_value = HAL_ADC_GetValue(&hadc);