65 lines
2.3 KiB
Markdown
65 lines
2.3 KiB
Markdown
# 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` 的默认时间段仅为兜底，实际以服务器下发为准。
|