/*
 * 模块名称：ADC Sampling Task
 * 模块功能：TPAFE5160 8 通道同步采样，数据缓存与通知
 * 状态说明：**预留桩（未启用）**——采集链路尚未实现，产品定义未定
 *          （见 docs/待处理内容.md 阶段 B0/B1）。当前 init/func 为空实现，
 *          不触发 CONVST、不消费数据。
 *          2026-10-10 起本文件已挂进 MDK-ARM 工程（此前两边都不注册 = 永不编译，
 *          改它不生效），但仍未在 Src/freertos.c 创建任务。
 * 接入前必读：取数只用 tpafe5160_snapshot()（临界区原子快照，仅任务上下文；
 *          旧的 get_buf/data_ready/clear_ready 已删除）；接消费者前的强制门禁
 *          见根 AGENTS.md「接 ADC / RS-485 消费者前的强制门禁」+ 建任务前后各跑
 *          scripts/stack_report.py 做栈预算。
 * 适用平台：STM32F407ZGTx + TPAFE5160
 * 作者：王建锋
 * 创建日期：2026-07-19
 * 修改记录：
 *   v1.0  2026-07-19  王建锋  创建初始版本
 *   v1.1  2026-10-05  王建锋  P3-11：注明"预留桩（未启用）"，避免误认为已实现
 */

#include "adc_task.h"
#include "cmsis_os.h"
#include "tpafe5160.h"

#define DBG_TAG "[ADC_TASK]"
#include "dbg_log.h"

/*
 * 函数功能：ADC 任务初始化
 * 入口参数：无
 * 返 回 值：0 - 成功，-1 - 失败
 * 限定条件：TPAFE5160 硬件已上电
 * 函数说明：配置采样参数，准备数据缓冲区
 */
int adc_task_init(void) {
    DBG_INFO("adc_task_init");
    return 0;
}

/*
 * 函数功能：ADC 任务主函数
 * 入口参数：arg - FreeRTOS 传入参数（未使用）
 * 返 回 值：无
 * 限定条件：adc_task_init() 已成功调用
 * 函数说明：定时触发 TPAFE5160 同步采样并处理数据
 */
void adc_task_func(void const *arg) {
    (void)arg;

    for (;;) {
        osDelay(1000);
    }
}