/*
 * 模块名称：SNTP 配置核心 (SNTP Configuration Core)
 * 模块功能：RAM 配置副本 + 工厂默认 + 读写出口（INI [sntp] 段：
 *           enable/server1/server2/poll_min）；加载/保存编排复用 [network]
 *           段的既有链路（net_cfg_load/save + UI 保存行请求链）。段描述符
 *           由 net_cfg.c 的 s_sntp_register() 组装注册——分层门禁 layer-deps
 *           要求本模块不 include 配置引擎头（App/cfg/cfg_file.h），只留
 *           数据本体与访问器
 * 适用平台：STM32F407ZGTx / PC 模拟器（两端共用）
 * 作者：王建锋
 * 创建日期：2026-11-04
 * 修改记录：
 *     v1.0  2026-11-04  王建锋  创建初始版本（SNTP 客户端接入，#57 调研结论：
 *                               出厂默认关闭、服务器 IPv4 字面量、周期 1~1440 分钟）
 *     v1.1  2026-11-04  王建锋  分层门禁口径改造：注册编排移出本模块（见 .h 同名注）
 */

/* 头文件包含区 */
#include <string.h>

#include "sntp_cfg.h"

/* 静态变量定义区 */

/* RAM 配置副本：以工厂默认值静态初始化（落 .data），自启动即有效——
 * 不依赖 cfg_file_load 是否成功（与 net_cfg s_cfg 同一口径）。
 * 命名带 s_sntp_ 前缀：net_cfg.c 与本文件会在同一 TU 里被主机单测并入
 * （test/host/net_cfg），裸 s_cfg/s_defaults 会同名重定义 */
static sntp_cfg_t s_sntp_cfg = {
    .enable     = SNTP_CFG_DEF_ENABLE,
    .server_pri = SNTP_CFG_DEF_SERVER,
    .server_bak = SNTP_CFG_DEF_SERVER,
    .poll_min   = SNTP_CFG_DEF_POLL_MIN,
};

/* 工厂默认（引擎注册 p_defaults 指向；与 s_sntp_cfg 初值共用宏单一来源） */
static const sntp_cfg_t s_sntp_defaults = {
    .enable     = SNTP_CFG_DEF_ENABLE,
    .server_pri = SNTP_CFG_DEF_SERVER,
    .server_bak = SNTP_CFG_DEF_SERVER,
    .poll_min   = SNTP_CFG_DEF_POLL_MIN,
};

/* 函数定义区 */

/*
 * 函数功能：取 [sntp] 段 RAM 副本（引擎注册专用写入口）
 * 入口参数：无
 * 返回值：RAM 配置副本指针（恒非空）  sntp_cfg_t *
 * 限定条件：仅 net_cfg.c 组段描述符用；业务读走 sntp_cfg_get()，
 *          UI 编辑走 sntp_cfg_set()
 */
sntp_cfg_t *sntp_cfg_data(void) {
    return &s_sntp_cfg;
}

/*
 * 函数功能：取工厂默认值（引擎注册 p_defaults 指向）
 * 入口参数：无
 * 返回值：工厂默认结构指针（只读，恒非空）  const sntp_cfg_t *
 * 限定条件：仅 net_cfg.c 组段描述符用
 */
const sntp_cfg_t *sntp_cfg_defaults(void) {
    return &s_sntp_defaults;
}

/*
 * 函数功能：取 [sntp] 段 RAM 副本（只读）
 * 入口参数：无
 * 返回值：RAM 配置副本指针（恒非空）  const sntp_cfg_t *
 * 限定条件：无
 */
const sntp_cfg_t *sntp_cfg_get(void) {
    return &s_sntp_cfg;
}

/*
 * 函数功能：更新 RAM 副本（不写盘）
 * 入口参数：p_new - 新配置（NULL 忽略）  const sntp_cfg_t *
 * 返回值：无
 * 限定条件：UI 编辑路径（net_cfg_set 同口径：整结构体一次拷贝，
 *          写盘走 net_cfg_save_request 整档链，属主 defaultTask）
 */
void sntp_cfg_set(const sntp_cfg_t *p_new) {
    if (p_new != NULL) {
        (void)memcpy(&s_sntp_cfg, p_new, sizeof(s_sntp_cfg));
    }
}

/*
 * 函数功能：取轮询周期（带外自愈读出口）
 * 入口参数：无
 * 返回值：合法范围内 = 存储值；0 或 >1440 = 工厂默认 60  uint16_t
 * 限定条件：无
 */
uint16_t sntp_cfg_poll_min(void) {
    uint16_t v = s_sntp_cfg.poll_min;

    if ((v < SNTP_CFG_POLL_MIN_MIN) || (v > SNTP_CFG_POLL_MIN_MAX)) {
        return SNTP_CFG_DEF_POLL_MIN;
    }
    return v;
}