1
hutongqing
2025-01-02 8c6fd742db249ad4cc819cf041eb98d880a3ef73
WIDESEAWCS_Server/WIDESEAWCS_Communicator/Modbus/ModbusTcpCommunicator.cs
@@ -39,10 +39,19 @@
        #endregion
        #region PublicMember
        /// <summary>
        /// 日志记录实例对象
        /// </summary>
        public override ILogNet LogNet => _logNet;
        /// <summary>
        /// 设备名称
        /// </summary>
        public override string Name => _name;
        /// <summary>
        /// 获取当前通讯器是否已连接到PLC。
        /// </summary>
        public override bool IsConnected => _connected;
        #endregion
@@ -312,6 +321,10 @@
        #endregion
        #region PublicMethod
        /// <summary>
        /// 连接到PLC。
        /// </summary>
        /// <returns>如果连接成功则返回true,否则返回false。</returns>
        public override bool Connect()
        {
            try
@@ -335,6 +348,10 @@
            }
        }
        /// <summary>
        /// 断开与工业设备的连接。
        /// </summary>
        /// <returns>如果成功断开连接则返回true,如果已经是断开状态则返回false。</returns>
        public override bool Disconnect()
        {
            try
@@ -356,6 +373,9 @@
            }
        }
        /// <summary>
        /// 释放对象资源的接口。
        /// </summary>
        public override void Dispose()
        {
            _isPing = false;
@@ -364,27 +384,60 @@
            GC.SuppressFinalize(this);
        }
        /// <summary>
        /// 从PLC读取数据。
        /// </summary>
        /// <param name="address">源地址,具体格式取决于使用的工业协议。</param>
        /// <param name="length">要读取的数据长度。</param>
        /// <returns>读取到的数据,如果读取失败则可能返回null或空数组。</returns>
        public override byte[] Read(string address, int length)
        {
            return (byte[])GetContent(plc.Read(address, (ushort)length), address);
        }
        /// <summary>
        /// 从PLC读取数据。
        /// </summary>
        /// <typeparam name="T">读取数据的类型泛型。</typeparam>
        /// <param name="address">源地址,具体格式取决于使用的工业协议。</param>
        /// <returns>读取到的数据,如果读取失败则可能返回null或抛出异常。</returns>
        public override T Read<T>(string address)
        {
            Type type = typeof(T);
            return (T)Read(address, Type.GetTypeCode(type));
        }
        /// <summary>
        /// 从PLC读取数据。
        /// </summary>
        /// <typeparam name="T">读取数据的类型泛型。</typeparam>
        /// <param name="address">源地址,具体格式取决于使用的工业协议。</param>
        /// <param name="length">读取的长度。</param>
        /// <returns>读取到的数据,如果读取失败则可能返回null或抛出异常。</returns>
        public override T[] Read<T>(string address, ushort length)
        {
            Type type = typeof(T);
            return (T[])Read(address, Type.GetTypeCode(type), length);
        }
        /// <summary>
        /// 从PLC读取数据。
        /// </summary>
        /// <param name="address">源地址,具体格式取决于使用的工业协议。</param>
        /// <param name="dataType">数据类型。</param>
        /// <returns>读取到的数据,如果读取失败则可能返回null或抛出异常。</returns>
        public override object ReadAsObj(string address, string dataType)
        {
            return Read(address, SiemensDBDataType.GetTypeCode(dataType));
        }
        /// <summary>
        /// 读取自定义的数据类型,需要继承自IDataTransfer接口,返回一个新的类型的实例对象。
        /// </summary>
        /// <typeparam name="T">自定义的数据类型泛型。</typeparam>
        /// <param name="address">源地址,具体格式取决于使用的工业协议。</param>
        /// <returns>成功返回自定义类型数据,失败抛出异常。</returns>
        public override T ReadCustomer<T>(string address)
        {
            throw new Exception("该方法暂不可用");
@@ -399,6 +452,15 @@
            //}
        }
        /// <summary>
        /// 等待指定地址的泛型类型值为指定的值
        /// </summary>
        /// <typeparam name="T">指定的值的类型泛型。</typeparam>
        /// <param name="address">源地址,具体格式取决于使用的工业协议。</param>
        /// <param name="readInterval">读取的频率。</param>
        /// <param name="waitTimeout">等待的超时时间,如果超时时间为-1的话,则是无期限等待。</param>
        /// <param name="value">等待检测的值</param>
        /// <returns>是否等待成功的结果对象,一旦通信失败,或是等待超时就返回失败。否则返回成功,并告知调用方等待了多久。</returns>
        public override OperateResult<TimeSpan> Wait<T>(string address, int readInterval, int waitTimeout, T value)
        {
            TypeCode typeCode = Type.GetTypeCode(typeof(T));
@@ -435,6 +497,12 @@
            }
        }
        /// <summary>
        /// 向PLC写入数据。
        /// </summary>
        /// <param name="address">源地址,具体格式取决于使用的工业协议。</param>
        /// <param name="data">要写入的数据。</param>
        /// <returns>如果写入成功则返回true,否则抛出异常。</returns>
        public override bool Write(string address, byte[] data)
        {
            try
@@ -457,15 +525,37 @@
            }
        }
        /// <summary>
        /// 向PLC写入数据。
        /// </summary>
        /// <typeparam name="T">写入数据的类型泛型。</typeparam>
        /// <param name="address">源地址,具体格式取决于使用的工业协议。</param>
        /// <param name="value">要写入的数据。</param>
        /// <returns>如果写入成功则返回true,否则抛出异常。</returns>
        public override bool Write<T>(string address, T value)
        {
            return GetResult(Write(address, value), address, value);
        }
        /// <summary>
        /// 向PLC写入数据。
        /// </summary>
        /// <typeparam name="T">写入数据的类型泛型。</typeparam>
        /// <param name="address">源地址,具体格式取决于使用的工业协议。</param>
        /// <param name="values">要写入的数据。</param>
        /// <returns>如果写入成功则返回true,否则抛出异常。</returns>
        public override bool Write<T>(string address, T[] values)
        {
            return GetResult(Write(address, values), address, values);
        }
        /// <summary>
        /// 写入自定义类型的数据,该类型必须继承自IDataTransfer接口。
        /// </summary>
        /// <typeparam name="T">自定义的数据类型泛型。</typeparam>
        /// <param name="address">源地址,具体格式取决于使用的工业协议。</param>
        /// <param name="value">要写入数据。</param>
        /// <returns>如果写入成功则返回true,失败则抛出异常。</returns>
        public override bool WriteCustomer<T>(string address, [NotNull] T value)
        {
            throw new Exception("该方法暂不可用");
@@ -520,6 +610,14 @@
            //}
        }
        /// <summary>
        /// 向PLC写入数据。
        /// </summary>
        /// <param name="address">源地址,具体格式取决于使用的工业协议。</param>
        /// <param name="dataType">要写入的数据类型。</param>
        /// <param name="value">要写入的数据。</param>
        /// <returns>如果写入成功则返回true,失败则抛出异常。</returns>
        /// <exception cref="CommunicationException"></exception>
        public override bool WriteObj(string address, string dataType, object value)
        {
            bool obj = false;