From ece1d9982a5837095d04ce169570e7ad9f4c29d1 Mon Sep 17 00:00:00 2001 From: Admin Date: Mon, 14 Sep 2026 12:20:52 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BB=BB=E5=8A=A1=E4=B9=A6=E4=B8=AD?= =?UTF-8?q?=E9=99=84=E5=BD=95=E5=BC=95=E7=94=A8=E6=B7=BB=E5=8A=A0=E8=B7=B3?= =?UTF-8?q?=E8=BD=AC=E9=93=BE=E6=8E=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 新人项目训练任务书.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/新人项目训练任务书.md b/新人项目训练任务书.md index 12c065f..db304f7 100644 --- a/新人项目训练任务书.md +++ b/新人项目训练任务书.md @@ -95,7 +95,7 @@ - ESP32-S3 技术参考手册、Arduino-ESP32 / ESP-IDF 官方文档； - FreeRTOS 官方文档； - 蓝牙 GATT 规范及 ESP32 蓝牙例程； -- 本任务书**附录 A：雷达串口通信协议**与**附录 B：蓝牙通信协议**（学员须严格按协议实现）。 +- 本任务书 [**附录 A：雷达串口通信协议**](#附录-a雷达串口通信协议) 与 [**附录 B：蓝牙通信协议**](#附录-b蓝牙通信协议)（学员须严格按协议实现）。 ## 三、通用要求 @@ -112,10 +112,10 @@ ### 4.2 功能需求 1. 正确初始化调试串口与雷达串口，串口参数依据雷达数据手册设置。 -2. 从雷达串口接收字节流，依据**附录 A 雷达串口通信协议**对字节流进行**组帧**。 +2. 从雷达串口接收字节流，依据 [**附录 A 雷达串口通信协议**](#附录-a雷达串口通信协议) 对字节流进行**组帧**。 3. 对每个完整帧进行**校验**，校验失败的帧必须丢弃并给出提示。 -4. 通过串口 0 打印**人类可读的关键信息**：解析帧内容后，按字段输出人体存在、运动状态、距离、坐标、心率、呼吸、睡眠等信息（字段定义见附录 A），要求信息清晰、易于查看。 -5. 雷达模组上电后不会主动上报，需按附录 A 发送使能命令后才输出数据；需实现命令帧的构造与发送（含校验和计算）。 +4. 通过串口 0 打印**人类可读的关键信息**：解析帧内容后，按字段输出人体存在、运动状态、距离、坐标、心率、呼吸、睡眠等信息（字段定义见 [附录 A](#附录-a雷达串口通信协议)），要求信息清晰、易于查看。 +5. 雷达模组上电后不会主动上报，需按 [附录 A](#附录-a雷达串口通信协议) 发送使能命令后才输出数据；需实现命令帧的构造与发送（含校验和计算）。 6. 程序运行稳定，接收过程不阻塞、不丢帧，缓冲区溢出时能自动恢复。 ### 4.3 完成标准 @@ -123,13 +123,13 @@ - [ ] 串口 0 能稳定输出人类可读的解析结果，字段含义正确、无乱码。 - [ ] 人体靠近/远离时，能观察到数据实时变化。 - [ ] 人为构造校验错误的帧，程序能识别并丢弃。 -- [ ] 能清晰说明附录 A 的帧格式、校验算法与字段布局。 +- [ ] 能清晰说明 [附录 A](#附录-a雷达串口通信协议) 的帧格式、校验算法与字段布局。 ## 五、任务二：引入实时操作系统并新增蓝牙数据传输任务 ### 5.1 任务目标 -将任务一改造成基于实时操作系统（FreeRTOS）的多任务架构，并新增一个蓝牙数据传输任务，把采集到的雷达数据按**附录 B 蓝牙通信协议**发送给手机端。 +将任务一改造成基于实时操作系统（FreeRTOS）的多任务架构，并新增一个蓝牙数据传输任务，把采集到的雷达数据按 [**附录 B 蓝牙通信协议**](#附录-b蓝牙通信协议) 发送给手机端。 ### 5.2 功能需求 @@ -140,7 +140,7 @@ - **数据通知通道**：周期性或在数据变化时向手机推送雷达数据； - **命令通道**：接收手机写入的命令，并按命令返回对应响应。 5. **命令功能**：至少支持"启动连续推送""停止连续推送""查询一次数据"，并对未知命令返回错误响应。 -6. **按附录 B 实现蓝牙传输协议**：严格按协议规定的 GATT 服务/特征、帧格式、TLV 编码、命令码、错误码实现；要求： +6. **按 [附录 B](#附录-b蓝牙通信协议) 实现蓝牙传输协议**：严格按协议规定的 GATT 服务/特征、帧格式、TLV 编码、命令码、错误码实现；要求： - 发送端支持**分包**，接收端支持**重组**； - 命令响应与请求通过序列号**一一对应**； - 接收端校验 CRC 并丢弃非法帧。 @@ -152,13 +152,13 @@ - [ ] 手机端写入查询命令，能收到匹配的响应（序列号一致、校验正确）。 - [ ] 启动 / 停止连续推送命令均生效；未知命令返回错误响应。 - [ ] 多任务运行稳定，无明显阻塞与看门狗复位。 -- [ ] 能说明任务划分、队列/互斥设计，以及附录 B 协议的实现要点。 +- [ ] 能说明任务划分、队列/互斥设计，以及 [附录 B](#附录-b蓝牙通信协议) 协议的实现要点。 ## 六、任务三：新增蓝牙配网任务 ### 6.1 任务目标 -在任务二基础上，新增一个蓝牙配网任务，按**附录 B 蓝牙通信协议**的配网命令，实现通过手机蓝牙下发 WiFi 信息，使设备完成联网。 +在任务二基础上，新增一个蓝牙配网任务，按 [**附录 B 蓝牙通信协议**](#附录-b蓝牙通信协议) 的配网命令，实现通过手机蓝牙下发 WiFi 信息，使设备完成联网。 ### 6.2 功能需求 @@ -194,7 +194,7 @@ 2. **多网络保存**：支持保存多个 WiFi 配置，并能查询、删除已保存的网络（按训练方要求）。 3. **开机自动重连**：设备复位或上电后，读取 Flash 中已保存的 WiFi 配置，自动扫描并连接可用网络，无需重新配网。 4. **选择与重试**：存在多个已保存网络时，按信号强度或保存顺序选择合适的网络连接；连接失败按一定间隔自动重试。 -5. **状态反馈**：自动重连过程中，通过附录 B 的状态推送通道向手机反馈 WiFi 状态变化。 +5. **状态反馈**：自动重连过程中，通过 [附录 B](#附录-b蓝牙通信协议) 的状态推送通道向手机反馈 WiFi 状态变化。 6. **容错**：Flash 无配置或全部连接失败时，保持可被蓝牙配网的状态，且不阻塞其它功能。 ### 7.3 完成标准