# STM32固件端文档

## 1. 端侧职责
- 从 K210 串口接收识别结果。
- 在本地执行签到逻辑（时间段判断、重复判定、缓存与重传）。
- 通过 ESP8266 将签到数据以 AES-128-CBC 加密后上传服务端。
- 维护 RTC（DS1302）与网络时间同步。

对应入口文件：`User/main.c`

## 2. 关键模块
- 主流程：`User/main.c`
- 考勤逻辑：`Hardware/Attendance.c`
- WiFi/HTTP：`Hardware/esp8266.c`
- 加密：`Hardware/Crypto.c`
- RTC：`Hardware/DS1302.c`
- 光照补光：`Hardware/LightSensor.c`
- K210串口解析：`Hardware/K210_USART.c`

## 3. 当前默认配置（代码内）
文件：`User/main.c`
- `WIFI_SSID`: `yzfh`
- `WIFI_PASSWORD`: `yzfhroot`
- `HTTP_SERVER_IP`: `27.106.113.205`
- `HTTP_SERVER_PORT`: `8082`
- `CLASS_ID`: `1`

建议将上述配置改为部署环境参数后再编译烧录。

## 4. 通信与接口
STM32 通过 `ESP8266_HttpGet` / `ESP8266_SendEncryptedData` 访问服务端：
- `POST /api/checkin`：上传加密签到数据（必带 `X-Encrypted: AES128-CBC`）。
- `GET /api/time`：获取服务器时间戳。
- `GET /api/timeslots`：下载时间段配置。
- `GET /api/check_duplicate`：按时段查重。
- `GET /api/today_records`：下载今日已签到学号列表。

## 5. 主流程说明
1. 系统初始化（OLED、串口、考勤模块、加密模块、RTC、传感器）。
2. 初始化并连接 ESP8266 到 WiFi 与 HTTP 服务器。
3. 可用时同步网络时间到 DS1302。
4. 定时拉取时间段配置。
5. 处理 K210 上报的人脸识别结果：
- 置信度通过阈值后进入签到逻辑。
- 本地去重 + 服务器时段去重。
- 记录加入本地队列并尝试上传。
6. 网络异常时离线缓存，恢复后批量补传。

## 6. 调试建议
- 优先看串口调试输出（`DEBUG_PRINT` 系列）。
- 检查 `g_wifi_connected`、`g_server_connected` 变化。
- 若频繁重连，先确认 AP 稳定性、服务器可达性与 8082 端口。

## 7. 构建与烧录
工程为 Keil 工程：
- `Project.uvprojx`
- `Project.uvoptx`

按当前板卡配置在 Keil 中编译并烧录。

## 8. 依赖与注意事项
- 与服务端 AES Key/IV 必须一致（否则 `/api/checkin` 解密失败）。
- DS1302 可用时优先作为本地时钟；不可用则回退网络时间。
- `Attendance.c` 的默认时间段仅为兜底，实际以服务器下发为准。