终版

Hardware/Serial.c

@@ -7,6 +7,7 @@ char RxBuffer[RX_BUFFER_SIZE];
 uint16_t RxCounter = 0;
 
 // 初始化ESP8266所用的串口 (根据连接图.md: USART1 PA9/PA10)
+/* 函数作用：初始化与 ESP8266 通信的 USART1 串口和接收中断。 */
 void Serial_Init(void)
 {
     GPIO_InitTypeDef GPIO_InitStructure;
@@ -46,6 +47,7 @@ void Serial_Init(void)
 }
 
 // 发送字符串
+/* 函数作用：通过 USART1 向 ESP8266 发送字符串。 */
 void Serial_SendString(const char* String)
 {
     for (uint32_t i = 0; String[i] != '\0'; i++)
@@ -56,12 +58,14 @@ void Serial_SendString(const char* String)
 }
 
 // 获取接收缓冲区
+/* 函数作用：返回 USART1 接收缓冲区指针。 */
 char* Serial_GetRxBuffer(void)
 {
     return RxBuffer;
 }
 
 // 清空接收缓冲区
+/* 函数作用：清空 USART1 接收缓冲区和接收计数。 */
 void Serial_ClearRxBuffer(void)
 {
     memset(RxBuffer, 0, RX_BUFFER_SIZE);
@@ -69,6 +73,7 @@ void Serial_ClearRxBuffer(void)
 }
 
 // USART1中断服务函数 (ESP8266)
+/* 函数作用：接收 ESP8266 串口返回数据并写入环形缓冲区。 */
 void USART1_IRQHandler(void)
 {
     if (USART_GetITStatus(USART1, USART_IT_RXNE) == SET)