/*
 * 模块名称：net_cfg_legacy
 * 模块功能：旧版 NCFG 二进制配置一次性迁移到通用配置文件（net_cfg 旧磁盘格式
 *          的拥有者：magic 'NCFG' + ver + CRC-16/MODBUS + 18B 字段）
 * 适用平台：STM32F407ZGTx / PC 模拟器（两端共用；平台路径经 cfg_file_store 后端）
 * 作者：王建锋
 * 创建日期：2026-09-14
 * 修改记录：
 *     v1.0  2026-09-14  王建锋  创建初始版本（P3：net_cfg 引擎化，旧格式代码迁入）
 */

#ifndef NET_CFG_LEGACY_H
#define NET_CFG_LEGACY_H

#ifdef __cplusplus
extern "C" {
#endif

/*
 * 函数功能：旧 NCFG 二进制配置（28B）一次性迁移到通用配置文件
 * 入口参数：无
 * 返回值：0 - 迁移成功，或无旧文件/新文件已存在（正常）；
 *         -1 - 迁移失败（新文件未生成）  int
 * 限定条件：调用方须已注册 [network] 段（net_cfg_load 内部完成）
 * 函数说明：新文件已存在 → 跳过（已迁移过）；旧文件有效 → 填网络配置 RAM
 *          副本 → 经引擎生成新文件（带旧值）→ 删旧文件；旧文件缺失/无效 →
 *          不动旧文件（留人工检查），新文件按工厂默认生成
 */
int net_cfg_legacy_migrate(void);

#ifdef __cplusplus
}
#endif

#endif /* NET_CFG_LEGACY_H */