环境文档小修：CMSIS pack 更正为非必装（keil.com 已下架）、串口配置源端口更正为 COM6
This commit is contained in:
@@ -106,7 +106,7 @@ Graphviz / Cppcheck 的安装位置差异一律用 `DTU_*` 环境变量表达（
|
||||
| 项 | 配置方法 | 说明 |
|
||||
|---|---|---|
|
||||
| License | 首次启动 UV4 自动生成 **90 天评估 license**；长期使用需购买正式 license | license 绑定机器、不在仓库；`Options for Target → License` 查看/输入 |
|
||||
| Device Pack | **Pack Installer** 安装 `Keil::CMSIS`、`Keil::STM32F4xx_DFP`（pack 源 https://www.keil.com/pack/ ） | 工程引用的 **Flash 算法 `STM32F4xx_1024.FLM` 就来自此 pack**（.uvoptx 的 `$$Device:STM32F407ZGTx$` 变量解析到 pack 目录 `<Keil安装目录>\PACK\Keil\STM32F4xx_DFP\<ver>\CMSIS\Flash\`，如 `C:\Keil_v5\...`）；**pack 缺失则下载失败** |
|
||||
| Device Pack | **Pack Installer** 安装 `Keil::STM32F4xx_DFP`（pack 源 https://www.keil.com/pack/ ） | 工程引用的 **Flash 算法 `STM32F4xx_1024.FLM` 就来自此 pack**（.uvoptx 的 `$$Device:STM32F407ZGTx$` 变量解析到 pack 目录 `<Keil安装目录>\PACK\Keil\STM32F4xx_DFP\<ver>\CMSIS\Flash\`，如 `C:\Keil_v5\...`）；**pack 缺失则下载失败**。`Keil::CMSIS` pack **不需要**：核心头文件由仓库 `Drivers/CMSIS/` 提供，`.uvprojx` 只引用 DFP pack（2026-10-02 本机实测：未装 CMSIS pack 构建 0/0 通过；且 keil.com 的 CMSIS pack 直链（5.7.0~6.1.0）均已下架 404，无从安装） |
|
||||
| 下载器驱动 | 工程已配 **UL2CM3** 调试驱动 + Flash 算法参数（.uvoptx 自带，调试时钟 10 MHz） | 物理下载器（ST-Link 等）需装 USB 驱动（见第 8 步）；现场换其他下载器在 Keil `Options for Target → Debug → Settings` 切换 |
|
||||
|
||||
> **项目自带、新机器无需重配**（随仓库同步）：编译器与目标选项（`.uvprojx`：ARMCC v5 / 设备 STM32F407ZGTx / Cortex-M4+FPU）、
|
||||
@@ -238,7 +238,7 @@ winget install Git.Git
|
||||
|
||||
- 下载页：<https://www.keil.com/arm/mdk.htm>（MDK-ARM v5.x；90 天评估 license 可先开发；必须含 **ARMCC v5** 编译器——工程锁 `uAC6=0`，armclang 不行）
|
||||
- **安装目录任意**（装完设置 `DTU_KEIL_UV4` = UV4.exe 完整路径，§2.1.1；默认安装位置即可）
|
||||
- 装完打开 **Pack Installer** → 安装 `Keil::CMSIS` 和 `Keil::STM32F4xx_DFP`（提供 STM32F407ZGTx 设备 + `STM32F4xx_1024.FLM` Flash 算法；pack 源 https://www.keil.com/pack/ ，Pack Installer 自动拉取）——**必装，否则烧录失败**（FLM 从 pack 目录解析，不在仓库）
|
||||
- 装完打开 **Pack Installer** → 安装 `Keil::STM32F4xx_DFP`（提供 STM32F407ZGTx 设备 + `STM32F4xx_1024.FLM` Flash 算法；pack 源 https://www.keil.com/pack/ ，Pack Installer 自动拉取）——**必装，否则烧录失败**（FLM 从 pack 目录解析，不在仓库）。`Keil::CMSIS` pack 不需要：核心头文件由仓库 `Drivers/CMSIS/` 提供（`.uvprojx` 只引用 DFP pack；CMSIS pack 已被 keil.com 下架，2026-10-02 实测各版本直链均 404）
|
||||
- **License**：首次启动 UV4 自动生成 90 天评估 license（长期使用需购买正式 license；license 绑定机器、不在仓库）
|
||||
- **STM32CubeMX 6.17.0**：下载页 https://www.st.com/en/tools/stm32cubemx.html （直链 https://www.st.com/resource/en/software_stm32cubemx/stm32cubemx_setup.exe ）
|
||||
- 用途：打开仓库 `STM32F407-Demo.ioc` → 改外设/引脚/时钟 → 生成代码（仅重写 CubeMX 区域，**USER CODE 区域保留**）
|
||||
@@ -366,7 +366,7 @@ pre-commit run --all-files
|
||||
**搭建清单汇总**（随步骤逐项打勾）：
|
||||
|
||||
- [ ] Windows 10/11 x64 + PowerShell 5.1+
|
||||
- [ ] Keil MDK-ARM v5.x 已装（任意目录，`DTU_KEIL_UV4` 已设 UV4.exe 完整路径，§2.1.1）+ CMSIS / STM32F4 DFP 包
|
||||
- [ ] Keil MDK-ARM v5.x 已装（任意目录，`DTU_KEIL_UV4` 已设 UV4.exe 完整路径，§2.1.1）+ STM32F4 DFP 包（CMSIS pack 不需要，见 §2.2）
|
||||
- [ ] STM32CubeMX 6.17.0 已装（与 .ioc 版本一致；含/可装 STM32Cube FW_F4 V1.28.3 固件包）
|
||||
- [ ] VS2019 / 2022 / 2026 任一（C++ x64 工作负载）+ Windows 10/11 SDK + CMake ≥3.15（模拟器构建脚本自动适配 VS 版本；**同一 VS 提供主机侧单测所需的 `cl.exe`**，见 §2.3 / §2.10）
|
||||
- [ ] `git clone` 仓库 → `pre-commit install`；cppcheck 入 PATH
|
||||
@@ -385,7 +385,7 @@ pre-commit run --all-files
|
||||
|---|---|---|
|
||||
| Git for Windows | https://git-scm.com/download/win | 最新稳定版 |
|
||||
| Keil MDK-ARM | https://www.keil.com/arm/mdk.htm | v5.x，须含 ARMCC v5；安装目录任意（`DTU_KEIL_UV4` 设 UV4.exe 完整路径） |
|
||||
| CMSIS / STM32F4xx DFP | https://www.keil.com/pack/ | 在 Keil Pack Installer 内装 `Keil::CMSIS`、`Keil::STM32F4xx_DFP` |
|
||||
| STM32F4xx DFP | https://www.keil.com/pack/ | 在 Keil Pack Installer 内装 `Keil::STM32F4xx_DFP`（CMSIS pack 不需要/已下架，见 §2.2） |
|
||||
| STM32CubeMX | https://www.st.com/en/tools/stm32cubemx.html | 6.17.0（与 .ioc 一致）；直链 https://www.st.com/resource/en/software_stm32cubemx/stm32cubemx_setup.exe |
|
||||
| STM32Cube FW_F4（固件包） | https://www.st.com/en/embedded-software/stm32cube-f4.html | V1.28.3（与仓库 HAL 驱动一致） |
|
||||
| Visual Studio 2019 | https://visualstudio.microsoft.com/zh-hans/vs/archives/ | 直链：https://aka.ms/vs/16/release/vs_community.exe |
|
||||
@@ -646,6 +646,7 @@ $env:DTU_KEIL_UV4 = 'D:\NotExist\UV4.exe' # 仅当前会话，不动用户级
|
||||
|
||||
| 日期 | 变更 |
|
||||
|---|---|
|
||||
| 2026-10-02 | 更正 Device Pack 必装范围：`Keil::CMSIS` pack 不再列为必装项——本工程不依赖它（核心头文件由仓库 `Drivers/CMSIS/` 提供，`.uvprojx` 只引用 DFP pack；2026-10-02 本机实测未装 CMSIS pack 构建 0/0 通过），且其 keil.com 直链（5.7.0~6.1.0）均已下架 404；必装的只有 `Keil::STM32F4xx_DFP`（3.1.1，与 `.uvprojx` PackID 一致）。§2.2 / 第 2 步 / 搭建清单 / §2.10 同步更正 |
|
||||
| 2026-10-02 | 新增 §2.12「跨机验证（第二台机器 / 换机验收清单）」：变量配置 + sanity check → 六步验证链（含期望结果与失败诊断，含模拟器既有 CMake 问题标注）→ 反向 fail-fast 测试 → 通过判定，作为方案跨机验收的标准操作 |
|
||||
| 2026-10-02 | **本地工具路径环境变量方案落地**（`本地工具路径环境变量方案.md`）：仓库脚本不再含本机绝对工具路径——10 处调用点（`build/download/reset.bat`、`_build.cmd` 退役、`ci_local.py`、`ci.yml`、`gen_refgraph.py`、`unit_test_harness.py`、`build_sim.ps1`、`make_font.py`）统一改为"`DTU_*` 变量优先 + 自动发现回退"（显式设置但无效 = 硬报错，不静默回退）；新增 §2.1.1 变量清单/设置方法/解析语义；Keil 安装路径、Graphviz、cppcheck、VS/SDK 自动探测、Python 重建示例与速查表同步改为变量口径；`requirements.txt` 增 `pre-commit`（重建 `.venv` 即可直接跑 L0 门禁）；本机已按 §2.1.1 配置用户级 `DTU_KEIL_UV4`/`DTU_STLINK_CLI` 并全链路验证（@build 0/0、ci_local L0+L0.5 全绿、refgraph 重生成、reset 探针识别） |
|
||||
| 2026-10-02 | 新增 **`Gitea_Runner部署指南.md`**：针对**本机 Gitea 原生部署**（`D:\Docker\Gitea\gitea.exe` + Windows 服务 + `127.0.0.1:3001`）定制的 Runner 端全流程——下载 / `register`（**`--instance` 用回环、`--labels "windows:host"` 必须精确匹配 `runs-on`**）/ `config.yaml` / `daemon install` 常驻 / 软件与 PATH 坑 / MSVC 路径约束 / 内网 action 零依赖改法 / 排障表 / `check_env.ps1` 自检脚本；§七相关文档登记 |
|
||||
|
||||
Reference in New Issue
Block a user