终版

Hardware/esp8266.h

@@ -25,6 +25,7 @@ typedef struct {
   * @brief  对ESP8266模块进行基础设置
   * @retval 1 表示成功, 0 表示失败
   */
+// 函数作用：初始化 ESP8266 模块并配置基础 AT 工作模式。
 uint8_t ESP8266_Setup(void);
 
 /**
@@ -33,6 +34,7 @@ uint8_t ESP8266_Setup(void);
   * @param  password WiFi的密码
   * @retval 1 表示成功, 0 表示失败
   */
+// 函数作用：控制 ESP8266 连接指定 WiFi 网络。
 uint8_t ESP8266_ConnectWiFi(const char* ssid, const char* password);
 
 /**
@@ -41,6 +43,7 @@ uint8_t ESP8266_ConnectWiFi(const char* ssid, const char* password);
   * @param  port 服务器的端口号
   * @retval 1 表示成功, 0 表示失败
   */
+// 函数作用：控制 ESP8266 与指定 HTTP 服务器建立 TCP 连接。
 uint8_t ESP8266_ConnectHTTPServer(const char* ip, const char* port);
 
 /**
@@ -48,12 +51,14 @@ uint8_t ESP8266_ConnectHTTPServer(const char* ip, const char* port);
   * @param  encrypted_data 加密后的Base64数据
   * @retval 1 表示成功, 0 表示失败
   */
+// 函数作用：通过 ESP8266 发送加密后的考勤 HTTP POST 数据。
 uint8_t ESP8266_SendEncryptedData(const char* encrypted_data);
 
 /**
   * @brief  检查TCP连接是否正常
   * @retval 1 表示已连接, 0 表示未连接
   */
+// 函数作用：检查 ESP8266 当前 TCP/网络连接是否仍然可用。
 uint8_t ESP8266_CheckConnection(void);
 
 /**
@@ -61,6 +66,7 @@ uint8_t ESP8266_CheckConnection(void);
   * @param  datetime 时间结构体指针，用于存储获取的时间
   * @retval 1 表示成功, 0 表示失败
   */
+// 函数作用：从网络时间服务或服务端接口获取当前日期时间。
 uint8_t ESP8266_GetNetworkTime(ESP8266_DateTime* datetime);
 
 /**
@@ -70,6 +76,7 @@ uint8_t ESP8266_GetNetworkTime(ESP8266_DateTime* datetime);
   * @param  buffer_size 缓冲区大小
   * @retval 1 表示成功, 0 表示失败
   */
+// 函数作用：通过 ESP8266 发起 HTTP GET 请求并把响应写入缓冲区。
 uint8_t ESP8266_HttpGet(const char* path, char* response_buffer, uint16_t buffer_size);
 
 /**
@@ -79,6 +86,7 @@ uint8_t ESP8266_HttpGet(const char* path, char* response_buffer, uint16_t buffer
   * @param  slot_end 时段结束时间（格式"HH:MM"）
   * @retval 1 表示已签到（重复）, 0 表示未签到
   */
+// 函数作用：调用服务端查重接口，判断学生在指定时段是否已签到。
 uint8_t ESP8266_CheckDuplicate(const char* student_id, const char* slot_start, const char* slot_end);
 
 /**
@@ -89,6 +97,7 @@ uint8_t ESP8266_CheckDuplicate(const char* student_id, const char* slot_start, c
   * @param  buffer_size 缓冲区大小
   * @retval 成功下载的学号数量
   */
+// 函数作用：下载指定时段内今日已签到学生列表，用于本地去重缓存恢复。
 uint8_t ESP8266_DownloadTodayRecords(const char* slot_start, const char* slot_end, char* student_ids, uint16_t buffer_size);
 
 #endif