using System.Collections.Generic;
using XP.Hardware.PLC.Models;

namespace XP.Hardware.PLC.Abstractions
{
    /// <summary>
    /// XML 信号地址定义解析器接口 | XML signal address definition parser interface
    /// 提供 PlcAddrDfn.xml 的加载和保存功能 | Provides loading and saving of PlcAddrDfn.xml
    /// </summary>
    public interface IXmlSignalParser
    {
        /// <summary>
        /// 从文件加载信号分组列表 | Load signal group list from file
        /// </summary>
        /// <param name="filePath">XML 文件路径 | XML file path</param>
        /// <returns>信号分组列表 | Signal group list</returns>
        List<SignalGroup> LoadFromFile(string filePath);

        /// <summary>
        /// 按 SignalGroup 结构保存信号配置到文件 | Save signal configuration to file by SignalGroup structure
        /// </summary>
        /// <param name="filePath">XML 文件路径 | XML file path</param>
        /// <param name="groups">信号分组列表 | Signal group list</param>
        void SaveToFile(string filePath, List<SignalGroup> groups);
    }
}