wandering1
f5902bcc21
两篇规划期文档改成对当前系统的描述，档名统一去掉"设计说明"的"说明"。 运行与自检记录： - 旧档重写为现状版（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 通过。
63 lines
1.9 KiB
C
63 lines
1.9 KiB
C
/* USER CODE BEGIN Header */
|
||
/**
|
||
******************************************************************************
|
||
* @file adc.h
|
||
* @brief This file contains all the function prototypes for
|
||
* the adc.c file
|
||
******************************************************************************
|
||
* @attention
|
||
*
|
||
* Copyright (c) 2026 STMicroelectronics.
|
||
* All rights reserved.
|
||
*
|
||
* This software is licensed under terms that can be found in the LICENSE file
|
||
* in the root directory of this software component.
|
||
* If no LICENSE file comes with this software, it is provided AS-IS.
|
||
*
|
||
******************************************************************************
|
||
*/
|
||
/* USER CODE END Header */
|
||
/* Define to prevent recursive inclusion -------------------------------------*/
|
||
#ifndef __ADC_H__
|
||
#define __ADC_H__
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/* Includes ------------------------------------------------------------------*/
|
||
#include "main.h"
|
||
|
||
/* USER CODE BEGIN Includes */
|
||
|
||
/* USER CODE END Includes */
|
||
|
||
extern ADC_HandleTypeDef hadc1;
|
||
|
||
/* USER CODE BEGIN Private defines */
|
||
|
||
/* USER CODE END Private defines */
|
||
|
||
void MX_ADC1_Init(void);
|
||
|
||
/* USER CODE BEGIN Prototypes */
|
||
|
||
/* ADC1 上电自校准（RM0090 §13.3.6；本仓库 HAL 无 HAL_ADCEx_Calibration_Start，
|
||
* 实现见 Src/adc.c 的 USER CODE BEGIN 1）。返回 0 = 完成，-1 = 等待超时 */
|
||
int adc1_calibrate(void);
|
||
|
||
/* ADC1 关闭（清 ADON 并等其生效）。实现见 Src/adc.c 的 USER CODE BEGIN 1。
|
||
* **必须在挂 DMA 之前调用**：把"使能 ADC"推迟到 HAL_ADC_Start_DMA 内部完成，
|
||
* 使能与搬运之间不留可观测间隔。返回 0 = 已关闭，-1 = 等待超时。
|
||
* 动机与台架证据见 docs/子系统设计/ADC采样节拍设计.md §4.5（DMA 缓冲 +2 格旋转）。 */
|
||
int adc1_disable(void);
|
||
|
||
/* USER CODE END Prototypes */
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* __ADC_H__ */
|
||
|