docs(design): 运行/自检记录与 ADC 节拍两篇改为现状设计并去掉档名"说明"
两篇规划期文档改成对当前系统的描述,档名统一去掉"设计说明"的"说明"。 运行与自检记录: - 旧档重写为现状版(10 节:概览 / 记录布局 / 写入路径 / 读取与呈现 / 事件分类 / 控制台日志 / 双端差异 / 内存 / 异常恢复 / 自测要点), 删掉需求表、调研摘要、模块清单动作列、实施步骤与开放问题。 - 按代码纠正:七类记录齐备(原文只写了两类)、自检描述串换成实际 落盘的 28 条、待机阈值以 ui_tokens.h 为准、记录页已走 ui_w_records 共享组件、容量满只删该文件而非整卷清空。 - 待机屏移出本篇:它不属于日志,归 UI 侧;内容页架构补"待机屏 (覆盖层)"一节,产品需求 FR-LOG-3 拆成单纯的上电/重启分类, 待机显示归口已有的 FR-UI-3。 ADC 采样节拍: - §4.5 从 45 行压到 24 行,只留规则 / 违反的代价 / 为什么 / 兜底与 档案指针;九路置换实测表、A/B 对照、探针计数等取证归 ADC_Trap_Records.md 的 TRAP-ADC-01(那里已有完整档案)。 - adc1_gap 字段去掉"2026-10-21 起、此前固件为次数"的修订记录式括号。 - app_main.c 的注释改为指向 TRAP-ADC-01 取证、§4.5 设计口径。 引用同步:两个旧档名全仓替换(含代码注释、角色档、归档 id 表), 旧名残留 0;对 ADC 篇的 § 引用逐条复核落在真实章节上。 验证:48 个提交期钩子全通过,check_doc_links --sections-strict 通过。
This commit is contained in:
@@ -329,7 +329,7 @@ int adc1_calibrate(void)
|
||||
* 调用本函数后 ADC 处于关闭态,HAL_ADC_Start_DMA 内部会自己
|
||||
* __HAL_ADC_ENABLE + 等 Tstab(~20 µs),然后紧接着开 CR2.DMA 并启流,
|
||||
* 使能与搬运之间不再有可观测的间隔 → 旋转消失(台架 4/4 次,差值 ≤4 码)。
|
||||
* 证据、复现方法与机制分析见 docs/子系统设计/ADC采样节拍设计说明.md §4.5。
|
||||
* 证据、复现方法与机制分析见 docs/子系统设计/ADC采样节拍设计.md §4.5。
|
||||
*/
|
||||
int adc1_disable(void)
|
||||
{
|
||||
|
||||
+1
-1
@@ -152,7 +152,7 @@ const osThreadAttr_t timeSyncTask_attributes = {
|
||||
* Normal 任务",唤醒延迟固定为 µs 级。
|
||||
* 代价:本任务单拍最坏 adcm≈2 ms 会在 AboveNormal 上挤占 net/ftp/default/timeSync;
|
||||
* 实测峰值来自每 10 s 心跳日志而非采集(STM32 侧已由 DMA 搬运,单拍取数 µs 量级)
|
||||
* → 耗时特征与代价见 docs/子系统设计/ADC采样节拍设计说明.md §9、§10。 */
|
||||
* → 耗时特征与代价见 docs/子系统设计/ADC采样节拍设计.md §9、§10。 */
|
||||
osThreadId_t adcTaskHandle;
|
||||
const osThreadAttr_t adcTask_attributes = {
|
||||
.name = "adcTask",
|
||||
|
||||
+2
-2
@@ -260,9 +260,9 @@ void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
|
||||
* → 两片转换器由同一硬件事件驱动,采样时刻对齐。
|
||||
* TIM3 与 BUSY EXTI(EXTI9_5_IRQn) 同为抢占优先级 6 → 互不抢占,
|
||||
* 读 RD 时序不会被下一次 CONVST 脉冲打断。详见
|
||||
* docs/子系统设计/ADC采样节拍设计说明.md §3.3。放 USER CODE 区(L2)。
|
||||
* docs/子系统设计/ADC采样节拍设计.md §3.3。放 USER CODE 区(L2)。
|
||||
* ⚠ 节拍源必须能触发 ADC1:F4 上 ADC1 的外部触发清单里没有 TIM6/TIM7 的 TRGO
|
||||
* (只接 DAC),判据见 docs/子系统设计/ADC采样节拍设计说明.md §3.2。
|
||||
* (只接 DAC),判据见 docs/子系统设计/ADC采样节拍设计.md §3.2。
|
||||
* ⚠ 唤醒必须走 adc_tick_irq_notify(),**不要**在这里直接 osThreadFlagsSet:
|
||||
* TIM3 在 app_main_init() 就启动,远早于建任务与 osKernelStart,
|
||||
* "消费者就绪"门在 adc_task.c 里(同本文件 TIM7 分支 2026-10-02 的实测坑)。 */
|
||||
|
||||
Reference in New Issue
Block a user