IOT_API/Model/Entity/Config/GatewayEntity.cs

using SqlSugar;

namespace Model.Entity.Config
{
    /// <summary>
    /// 网关（通讯通道）：TCP 类存 IP+端口，串口类存 COM+波特率，S7 类额外存 CPU/Rack/Slot。
    /// 同一网关下多设备用从站号（SlaveId）区分。
    /// </summary>
    public class GatewayEntity : BaseEntity
    {
        /// <summary>
        /// 网关编码（唯一，如 GW-ENV-01）
        /// </summary>
        [SugarColumn(ColumnDescription = "网关编码", Length = 64)]
        public string Code { get; set; }

        /// <summary>
        /// 网关名称
        /// </summary>
        [SugarColumn(ColumnDescription = "网关名称", Length = 100)]
        public string Name { get; set; }

        /// <summary>
        /// 通讯协议类型（决定连接参数组：TCP/Serial/S7）
        /// </summary>
        [SugarColumn(ColumnDescription = "通讯协议类型")]
        public IotDeviceProtocolEnum ProtocolType { get; set; } = IotDeviceProtocolEnum.ModbusTcp;

        #region TCP 参数（ModbusTcp / Tcp / S7 协议使用）
        /// <summary>
        /// IP 地址
        /// </summary>
        [SugarColumn(ColumnDescription = "IP地址", Length = 50, IsNullable = true)]
        public string? Host { get; set; }

        /// <summary>
        /// 端口号（ModbusTcp 默认 502，S7 默认 102）
        /// </summary>
        [SugarColumn(ColumnDescription = "端口号", IsNullable = true)]
        public int? Port { get; set; }
        #endregion

        #region 串口参数（ModbusRtu / Serial 协议使用）
        /// <summary>
        /// 串口号（如 COM3）
        /// </summary>
        [SugarColumn(ColumnDescription = "串口号", Length = 20, IsNullable = true)]
        public string? ComPort { get; set; }

        /// <summary>
        /// 波特率（默认 9600）
        /// </summary>
        [SugarColumn(ColumnDescription = "波特率", IsNullable = true)]
        public int? BaudRate { get; set; }

        /// <summary>
        /// 数据位（默认 8）
        /// </summary>
        [SugarColumn(ColumnDescription = "数据位", IsNullable = true)]
        public byte? DataBits { get; set; }

        /// <summary>
        /// 停止位（1/2，默认 1）
        /// </summary>
        [SugarColumn(ColumnDescription = "停止位", IsNullable = true)]
        public byte? StopBits { get; set; }

        /// <summary>
        /// 校验位（0=None 1=Odd 2=Even，默认 0）
        /// </summary>
        [SugarColumn(ColumnDescription = "校验位", IsNullable = true)]
        public byte? Parity { get; set; }
        #endregion

        #region S7 参数（S7 协议专用）
        /// <summary>
        /// S7 CPU 型号（如 S71200、S71500）
        /// </summary>
        [SugarColumn(ColumnDescription = "S7 CPU型号", Length = 20, IsNullable = true)]
        public string? CpuType { get; set; }

        /// <summary>
        /// S7 Rack（默认 0）
        /// </summary>
        [SugarColumn(ColumnDescription = "S7 Rack", IsNullable = true)]
        public byte? Rack { get; set; }

        /// <summary>
        /// S7 Slot（默认 1）
        /// </summary>
        [SugarColumn(ColumnDescription = "S7 Slot", IsNullable = true)]
        public byte? Slot { get; set; }
        #endregion

        #region 状态
        /// <summary>
        /// 是否启用
        /// </summary>
        [SugarColumn(ColumnDescription = "是否启用")]
        public bool IsEnabled { get; set; } = true;

        /// <summary>
        /// 在线状态（0=离线 1=在线 3=异常，由测试连接更新）
        /// </summary>
        [SugarColumn(ColumnDescription = "在线状态")]
        public byte OnlineStatus { get; set; }

        /// <summary>
        /// 最后连接成功时间
        /// </summary>
        [SugarColumn(ColumnDescription = "最后连接时间", IsNullable = true)]
        public DateTime? LastConnectedTime { get; set; }

        /// <summary>
        /// 最近错误
        /// </summary>
        [SugarColumn(ColumnDescription = "最近错误", Length = 500, IsNullable = true)]
        public string? LastError { get; set; }
        #endregion

        /// <summary>
        /// 备注
        /// </summary>
        [SugarColumn(ColumnDescription = "备注", Length = 500, IsNullable = true)]
        public string? Remark { get; set; }
    }
}