终版

Hardware/K210_USART.c

@@ -11,6 +11,7 @@ extern volatile uint8_t  g_k210_rx_flag;
 // 全局变量：存储解析后的人脸识别结果
 FaceRecognitionResult K210_FaceResult;
 
+/* 函数作用：初始化与 K210 通信的 USART3 串口和接收中断。 */
 void K210_USART_Init(void)
 {
     // 根据连接图.md: K210使用USART3 (PB10/PB11)
@@ -60,6 +61,7 @@ void K210_USART_Init(void)
   * K210数据格式示例: "ID:2021001,NAME:Zhang_San,CONF:0.95"
   * 或者: "UNKNOWN" (未识别到人脸)
   */
+/* 函数作用：解析 K210 串口发送的人脸识别字符串并填充结果结构体。 */
 uint8_t K210_ParseFaceData(const char* buffer, FaceRecognitionResult* result)
 {
     DEBUG_PRINT("[K210] Raw data: %s\r\n", buffer);
@@ -109,6 +111,7 @@ uint8_t K210_ParseFaceData(const char* buffer, FaceRecognitionResult* result)
     return 0; // 解析失败
 }
 
+/* 函数作用：检查 K210 接收完成标志，并在有新数据时解析识别结果。 */
 uint8_t K210_GetRxFlag(void)
 {
     if (g_k210_rx_flag)
@@ -129,6 +132,7 @@ uint8_t K210_GetRxFlag(void)
     return 0;
 }
 
+/* 函数作用：清除 K210 串口接收完成标志和计数器。 */
 void K210_ClearRxFlag(void)
 {
     g_k210_rx_flag = 0;