From 15111eaec3aba78b6e33ac5faef040d7fcd6cde4 Mon Sep 17 00:00:00 2001 From: Wanderingss <1624155937@qq.com> Date: Wed, 28 Oct 2026 09:11:07 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E7=A1=AC=E4=BB=B6):=20=E5=A4=96=E8=AE=BE?= =?UTF-8?q?=E5=BC=95=E8=84=9A=E5=8F=A3=E5=BE=84=E7=94=B1=20V0.0=20?= =?UTF-8?q?=E6=9B=B4=E6=AD=A3=E4=B8=BA=20V0.1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit README 外设接口表与部署环境要求 3.2 节长期停留在 V0.0 引脚， 与 Inc/main.h（CubeMX 已迁 V0.1）不符。按 main.h 与 V0.1 网表 报告 §4.1 更正三处： - TPAFE 控制组 7 线：PD3/PD4/PD7 + PF13/14/15 改为 PC6 FRSTDATA / PC7 BUSY(EXTI) / PC8 RD / PC9 CONVST / PA8 OS2 / PA11 OS1 / PA12 OS0（原表漏 FRSTDATA 且 OS 顺序反） - RS-485：UART5（PC12/PD2/PD0）改为 UART4（PC10/PC11/PA15）， 依据 app_main.c 的 rs485_init(&g_rs485, &huart4, ...) - LED1/LED2 驱动脚：PC4/PC5 改为 PC5/PB0（PC4 让位给 ADC17）， 并补网名与丝印 LED(n+4) 倒序提示 产品需求设计文档 4.2 节随之删除该「文档遗留」标注（已闭环）。 README 补 RTC/SWD 两行，两处均加「口径 = V0.1」与权威来源。 --- README.md | 11 ++++++++--- docs/产品需求/产品需求设计文档.md | 3 --- docs/环境与部署/项目部署环境要求.md | 12 +++++++++--- 3 files changed, 17 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 5d723469..d4e899fc 100644 --- a/README.md +++ b/README.md @@ -8,16 +8,21 @@ - **封装**: LQFP144 - **RTOS**: FreeRTOS V10.3.1 (CMSIS-RTOS V2) -### 外设接口 +### 外设接口（V0.1 硬件） + +> 引脚口径 = `Inc/main.h`（CubeMX 生成，已迁 V0.1）+ `docs/硬件平台/V0.1_网表详细分析报告.md`。 +> V0.0 与本表的差异：TPAFE 控制组 7 线、LED1/LED2 驱动脚、RS-485 所在串口实例。 | 外设 | 接口 | 引脚 | 说明 | |------|------|------|------| | CH395F 以太网 | SPI2 | PB12 CS, PB13 SCK, PB14 MISO, PB15 MOSI | 10/100M 以太网控制器 | | GD5F2GQ5UE NAND | SPI1 | PE0 CS, PB3 SCK, PB4 MISO, PB5 MOSI, PB8 WP, PE1 HOLD | 256MB SPI NAND Flash | -| TPAFE5160 ADC | 并行16位 | PG0-PG15 数据, PC8 RD, PC9 CONVST, PC7 BUSY, PA8/PA11/PA12 OS0~2 | 高精度 ADC | +| TPAFE5160 ADC | 并行16位 | PG0-PG15 数据, PC6 FRSTDATA, PC7 BUSY(EXTI), PC8 RD, PC9 CONVST, PA8 OS2 / PA11 OS1 / PA12 OS0 | 高精度 ADC | | USART1 | 串口 | PA9 TX, PA10 RX | 115200bps 调试串口 | -| 6x LED | GPIO | PC4, PC5, PB1, PB2, PF11, PF12 | 低电平点亮 | +| SD2506 RTC | I2C1 | PB6 SCL, PB7 SDA | 墙钟基准与日志时间戳 | +| 6x LED | GPIO | PC5, PB0, PB1, PB2, PF11, PF12 | 低电平点亮 | | RS-485 | UART4 | PC10 TX, PC11 RX, PA15 DE | 半双工通信（B2 暂缓，见 `docs/任务规划/暂缓-RS485.md`） | +| SWD | — | PA13 SWDIO, PA14 SWCLK | 调试口 CN2（XH-3A） | ## 项目架构 diff --git a/docs/产品需求/产品需求设计文档.md b/docs/产品需求/产品需求设计文档.md index cf6e2a23..6bcc3ed7 100644 --- a/docs/产品需求/产品需求设计文档.md +++ b/docs/产品需求/产品需求设计文档.md @@ -501,9 +501,6 @@ sequenceDiagram > ⚠️ **V0.0 / V0.1 差异**：V0.1 相比 V0.0 做了**接口裁剪（删 8080 LCD 与 8 键）+ U17 大面积引脚重排 + > ADC 前端通道置换（17 路中 13 路变化）+ 调试口改型**。固件 BSP 与 ADC 通道映射表**必须按 V0.1 重映射**； > 详见 `docs/硬件平台/V0.1_网表详细分析报告.md`。 -> -> ⚠️ **文档遗留**：根 `README.md` 的"外设接口"表与 `docs/环境与部署/项目部署环境要求.md` §3.2 仍为 -> **V0.0 口径**（TPAFE 控制组、RS-485 实例、LED 序号），与 V0.1 不符——**本文以 V0.1 为准**。 ### 4.3 存储器件 diff --git a/docs/环境与部署/项目部署环境要求.md b/docs/环境与部署/项目部署环境要求.md index 90d88598..4c42fe42 100644 --- a/docs/环境与部署/项目部署环境要求.md +++ b/docs/环境与部署/项目部署环境要求.md @@ -487,14 +487,19 @@ $env:DTU_KEIL_UV4 = 'D:\NotExist\UV4.exe' # 仅当前会话，不动用户级 ### 3.2 外设硬件要求（引脚级） +> **口径 = V0.1 硬件**：引脚以 `Inc/main.h`（CubeMX 生成）与 +> [`docs/硬件平台/V0.1_网表详细分析报告.md`](../硬件平台/V0.1_网表详细分析报告.md) §4.1 为准。 +> V0.0 与本表的差异集中在三处：TPAFE 控制组 7 线（`PD1/PD3/PD4/PD7` + `PF13/14/15` → `PC6/PC8/PC9/PC7` + `PA12/11/8`）、 +> RS-485 所在串口实例（UART5 → **UART4**）、LED1/LED2 驱动脚（`PC4/PC5` → `PC5/PB0`）。 + | 外设 | 接口 | 引脚 | 备注 | |---|---|---|---| | CH395F 以太网 | SPI2 | PB12 CS / PB13 SCK / PB14 SDO / PB15 SDI | PHY 强制 100M 全双工；SPI 分频系数必须为 8（PCB 设计约束，速度受限） | | GD5F2GQ5UE NAND（2 Gbit） | SPI1 | PE0 CS / PB3 SCK / PB4 MISO / PB5 MOSI / PB8 WP / PE1 HOLD | FatFS（FAT32）+ dhara FTL；上电无卷自动 `f_mkfs` | -| TPAFE5160 ADC | 并行 16 位 | PG0~PG15 数据 / PD3 RD / PD4 CONVST / PD7 BUSY | **编译期常驻**（无裁剪开关；原 `APP_ADC_ENABLE` 未接线占位宏已于 2026-10-22 删除） | +| TPAFE5160 ADC | 并行 16 位 | PG0~PG15 数据 / **PC6 FRSTDATA** / **PC7 BUSY（EXTI9_5）** / **PC8 RD** / **PC9 CONVST** / **PA8 OS2 · PA11 OS1 · PA12 OS0** | **编译期常驻**（无裁剪开关；原 `APP_ADC_ENABLE` 未接线占位宏已于 2026-10-22 删除） | | USART1（调试串口） | UART | PA9 TX / PA10 RX | 115200 8N1；printf 日志 + `@test` 采集通道 | -| UART5（RS-485） | UART | PC12 TX / PD2 RX / PD0 DE | 半双工；**编译期常驻**（无裁剪开关；原 `APP_RS485_ENABLE` 占位宏已删） | -| 状态 LED ×6 | GPIO | PC4 / PC5 / PB1 / PB2 / PF11 / PF12 | **低电平点亮** | +| UART4（RS-485） | UART | **PC10 TX / PC11 RX / PA15 DE** | 半双工 115200；`app_main.c` 以 `rs485_init(&g_rs485, &huart4, ST_DIR4_GPIO_Port, ST_DIR4_Pin)` 绑定；**编译期常驻**（无裁剪开关；原 `APP_RS485_ENABLE` 占位宏已删） | +| 状态 LED ×6 | GPIO | **PC5 / PB0 / PB1 / PB2 / PF11 / PF12**（LED1~LED6） | **低电平点亮**；网名↔实板丝印为 `LED(n+4)` 倒序（V0.1 网表关注点 V3），固件 LED 序表须按丝印对齐 | ### 3.3 资源预算（部署红线） @@ -648,6 +653,7 @@ $env:DTU_KEIL_UV4 = 'D:\NotExist\UV4.exe' # 仅当前会话，不动用户级 | 日期 | 变更 | |---|---| +| 2026-10-28 | **§3.2 外设引脚口径由 V0.0 更正为 V0.1**：① TPAFE5160 控制组由 `PD3 RD / PD4 CONVST / PD7 BUSY` 改为 **`PC6 FRSTDATA / PC7 BUSY(EXTI9_5) / PC8 RD / PC9 CONVST / PA8 OS2 · PA11 OS1 · PA12 OS0`**（V0.1 把 7 线整组从 PD/PF 迁到 PC/PA）；② RS-485 由 **UART5**（`PC12 TX / PD2 RX / PD0 DE`）改为 **UART4**（`PC10 TX / PC11 RX / PA15 DE`）——依据 `App/app/app_main.c` 的 `rs485_init(&g_rs485, &huart4, ST_DIR4_GPIO_Port, ST_DIR4_Pin)`；③ LED1/LED2 驱动脚由 `PC4/PC5` 改为 **`PC5/PB0`**（PC4 让位给 ADC17），并补网名↔丝印 `LED(n+4)` 倒序提示（V0.1 网表关注点 V3）。引脚口径改以 `Inc/main.h` 与 `V0.1_网表详细分析报告.md` §4.1 为准 | | 2026-10-22 | **§3.2 / §3.3 与 §2.2 内存事实纠偏**：① §3.3 资源预算表由 2026-09-11 快照刷新为 2026-10-22 实测——Flash 231,768 B / 22.1%，主 SRAM1 由"125,104 B / 95.4% / 极度紧张"更正为 **75,264 B / 57.4%（余 55,808 B）**，并**补上 CCM 行**（57,376 B / 87.9%，余 7,904 B）——当前红线在 CCM 而非 SRAM1；② 删除 §3.3 的任务栈副本表（无门禁、已缺 `adcTask`/`iec104Task`/`protectTask`），改指针到 `README.md`/`AGENTS.md` 受管表与 `RAM使用分析与优化方案.md` §2.3/§0.6；③ §2.2 链接布局补 `RW_CCM 0x10000000` 段（2026-10-11 已启用、**不可 DMA**），§3.1 MCU 行更正为**单精度 FPU、无 TrustZone**（原写"双精度 FPU / TrustZone"是芯片事实错误，也正是报告 F-6 双精度软浮点被长期误判的土壤） | | 2026-10-12 | **远程 CI 文档迁出本目录**：`CI配置指南.md` 与 `Gitea_Runner部署指南.md` 合并为 **`docs/CI/远程CI完整指南.md`**（入口 `docs/CI/README.md`），本文三处引用改指新路径与新章节号（§4.1.3 机器级变量、§7 相关文档登记）。原因：远程 CI 只涉及本机一台 runner，不应与"任何机器都要过"的部署核对清单混在一起 | | 2026-10-10 | **删除旧档 NCFG 迁移**（升级/迁移口径变更）：旧固件遗留的 `/cfg/netcfg.bin` 不再"首启自动迁移"——旧档若存在则被忽略（不读、不删、不迁移），配置直接回落工厂默认（`/config.ini` `[network]` 段模板）。`net_cfg_legacy.c/h` 与 `cfg_store_legacy_path()` 已移除；携带旧档的设备升级后需经 UI 或 FTP 重新配置网口。§五 现场部署 IP 行同步 |