STM32 標準外設庫使用全攻略：初始化、數據操作、狀態檢查與統一風格總結

庫函數設計哲學

ST 官方標準外設庫 (StdPeriph_Lib) 採用 結構體配置 + 統一 API 風格，將寄存器操作封裝為高層函數，降低開發門檻、提高代碼可移植性。

三大核心使用模式

1. 初始化結構體模式 (配置外設)

// 步驟 a: 定義結構體變量
GPIO_InitTypeDef GPIO_InitStructure;

// 步驟 b: 填充配置參數
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_13;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;

// 步驟 c: 調用初始化函數寫入寄存器
GPIO_Init(GPIOC, &GPIO_InitStructure);

2. 數據輸入輸出模式 (運行時控制)

// 寫入操作：指定外設 + 引腳 + 數據
GPIO_WriteBit(GPIOA, GPIO_Pin_5, Bit_SET);   // PA5 輸出高電平
GPIO_WriteBit(GPIOA, GPIO_Pin_5, Bit_RESET); // PA5 輸出低電平

// 讀取操作：指定外設 + 引腳 → 返回數據
uint8_t state = GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0); // 讀取 PA0 輸入狀態

// 批量操作
GPIO_Write(GPIOA, 0xFFFF);           // 整個端口寫入
uint16_t data = GPIO_ReadInputData(GPIOA); // 整個端口讀取

3. 狀態位/標誌位檢查模式 (事件驅動)

統一 API 命名規範總結表

典型開發流程範例：UART 串口通訊

// 1. 時鐘使能
RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE);

// 2. GPIO 配置 (TX=PA9, RX=PA10)
GPIO_InitTypeDef GPIO_InitStructure;
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;  // 復用推挽輸出
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(GPIOA, &GPIO_InitStructure);

GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; // 浮空輸入
GPIO_Init(GPIOA, &GPIO_InitStructure);

// 3. UART 參數配置
USART_InitTypeDef USART_InitStructure;
USART_InitStructure.USART_BaudRate = 115200;
USART_InitStructure.USART_WordLength = USART_WordLength_8b;
USART_InitStructure.USART_StopBits = USART_StopBits_1;
USART_InitStructure.USART_Parity = USART_Parity_No;
USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None;
USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx;
USART_Init(USART1, &USART_InitStructure);

// 4. 中斷配置 (可選)
USART_ITConfig(USART1, USART_IT_RXNE, ENABLE);
NVIC_InitTypeDef NVIC_InitStructure;
NVIC_InitStructure.NVIC_IRQChannel = USART1_IRQn;
NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1;
NVIC_InitStructure.NVIC_IRQChannelSubPriority = 1;
NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;
NVIC_Init(&NVIC_InitStructure);

// 5. 使能外設
USART_Cmd(USART1, ENABLE);

// 6. 發送數據
USART_SendData(USART1, 'A');
while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) == RESET); // 等待發送完成

最佳實踐建議

1. 善用 XXX_StructInit()：先填充預設值，再修改需變更參數，避免未初始化成員
2. 時鐘先行：任何外設使用前必須開啟對應 RCC 時鐘
3. 中斷配置分層：外設級 (XXX_ITConfig) + 核心級 (NVIC_Init) 兩級配置
4. 標誌位清除時機：進入中斷服務程序 (ISR) 開頭立即清除對應掛起位
5. 查閱 .h 文件：所有配置宏定義、結構體成員、函數原型均在外設對應頭文件中

從 StdPeriph 到 HAL/LL 的演進

「掌握 StdPeriph 統一風格，遷移 HAL/LL 只是語法轉換，核心邏輯通用。」