/******************************************************************************
 * @file    app_linkage.c
 * @brief   CBR1 联动引擎骨架（P0：BOARD_LINKAGE_ENABLE=0）
 * @author  cyWu <1917507415@qq.com>
 * @date    2026.09.04
 * @version V1.0.0，P2 填充实现（规格书第 10 章）
 ******************************************************************************/

#include "system/includes.h"
#include "app_linkage.h"
#include "app_relay.h"
#include "board_pin.h"

#define LOG_TAG_CONST APP
#define LOG_TAG       "[LINK]"
#define LOG_INFO_ENABLE
#include "debug.h"

static void linkage_disabled_once(void)
{
    static uint8_t s_logged;

    if (!s_logged) {
        s_logged = 1;
        log_info("app_linkage disabled (P2)\n");
    }
}

/**
 * @brief  初始化联动
 * @return 无
 */
void app_linkage_init(void)
{
#if BOARD_LINKAGE_ENABLE
    /* P2: 清作废标志（配置由 app_nvm_load 灌） */
#else
    linkage_disabled_once();
#endif
}

/**
 * @brief  500ms 任务上下文跑联动
 * @param  dt 距上次调用的毫秒数
 * @return 无
 */
void app_linkage_run(uint16_t dt)
{
#if BOARD_LINKAGE_ENABLE
    (void)dt;
    /* P2: 有效配置 + 未作废 + 有温度 → 按 10.3 请求开/关 */
#else
    (void)dt;
#endif
}

/**
 * @brief  立刻重判（APP 重写 DP8 / 定时收口）
 * @return 无
 */
void app_linkage_reeval(void)
{
#if !BOARD_LINKAGE_ENABLE
    linkage_disabled_once();
#endif
}

/**
 * @brief  DP7 联动删除（脉冲）
 * @return 无
 */
void app_linkage_delete(void)
{
#if !BOARD_LINKAGE_ENABLE
    linkage_disabled_once();
#endif
}

/**
 * @brief  APP 重写 DP8
 * @return 无
 */
void app_linkage_set_config(void)
{
#if !BOARD_LINKAGE_ENABLE
    linkage_disabled_once();
#endif
}

/**
 * @brief  手动作废本轮联动（仲裁器转调；P0 无联动，空操作）
 * @return 无
 */
void app_linkage_void(void)
{
#if !BOARD_LINKAGE_ENABLE
    /* P0：无联动引擎，无事可做 */
#endif
}

/**
 * @brief  配置是否有效
 * @return 1=有效
 */
uint8_t app_linkage_is_valid(void)
{
    return 0; /* P0：无有效配置 */
}

/**
 * @brief  缸体编号
 * @return tank_id
 */
uint16_t app_linkage_get_tank_id(void)
{
    return 0;
}

/**
 * @brief  配置版本
 * @return 版本号
 */
uint8_t app_linkage_get_cfg_ver(void)
{
    return 0;
}