基础类库积累--SiemensS7NetClient类

前言

这个类是针对S7协议的类，如果你是做上位机，和下位机（PLC）交互，可能会给你带来帮助。

代码

使用NuGet引入第三方库（HslCommunication）

HslCommunication

HslCommunication的简介：

       HSL专注于解决工业网络间的复杂的数据通信问题，解决多个独立程序之间的数据通信，甚至是不同的操作系统，平台的网络通信问题， 可以用来构建各种各样的应用程序，下至通信小软件，上位机软件，CS架构的聊天系统，上至ERP系统，历史追述系统，生产管理系统，MES系统， 无论你的开发环境是Visual Studio, Visual Studio Code, IntelliJ IDEA, Eclipse, Labview, Android Studio等等

HslCommunication的使用：

  /// <summary>
    /// 西门子S7协议的PLC客户端操作类
    /// </summary>
    public class SiemensS7NetClient
    {
        /// <summary>
        /// 获取西门子S7协议的客户端
        /// </summary>
        /// <param name="ip">下位机IP地址</param>
        /// <returns>SiemensS7Net实例</returns>
        public static SiemensS7Net GetInstance(string ip)
        {
            return new SiemensS7Net(SiemensPLCS.S1200, ip)
            {
                ConnectTimeOut = 200
            };
        }

        /// <summary>
        /// 获取下位机单点数据
        /// </summary>
        /// <param name="client">西门子S7协议的客户端实例</param>
        /// <param name="dataType">数据类型</param>
        /// <param name="block">数据块</param>
        /// <param name="offset">偏移量</param>
        /// <param name="value">输出参数：点位值（成功）；</param>
        /// <param name="errorMessage">输出参数：空字符（成功）；错误信息（失败）</param>
        /// <returns>返回是否获取成功</returns>
        public static bool GetPlcSingleData(SiemensS7Net client, string dataType, string block, decimal offset, ref object value, ref string errorMessage)
        {
            bool result = false;
            if (client != null)
            {
                if (dataType.ToLower() == "int")
                {
                    var operateResult = client.ReadInt16(block + "." + offset);
                    if (operateResult.IsSuccess)
                    {
                        value = operateResult.Content;
                        errorMessage = "";
                        result = true;
                    }
                    else
                    {
                        errorMessage = operateResult.Message;
                    }
                }
                else if (dataType.ToLower() == "bool")
                {
                    var operateResult = client.ReadBool(block + "." + offset);
                    if (operateResult.IsSuccess)
                    {
                        value = operateResult.Content;
                        result = true;
                    }
                    else
                    {
                        value = operateResult.Message;
                    }
                }
                else if (dataType.ToLower() == "usint")
                {
                    var operateResult = client.ReadUInt16(block + "." + offset);
                    if (operateResult.IsSuccess)
                    {
                        value = operateResult.Content;
                        result = true;
                    }
                    else
                    {
                        value = operateResult.Message;
                    }
                }
                else if (dataType.ToLower() == "word")
                {
                    var operateResult = client.Read(block + "." + offset, 2);
                    if (operateResult.IsSuccess)
                    {
                        value = operateResult.Content;
                        result = true;
                    }
                    else
                    {
                        value = operateResult.Message;
                    }
                }
                else if (dataType.ToLower() == "wstring")
                {
                    var operateResult = client.Read(block + "." + offset, 254);
                    if (operateResult.IsSuccess)
                    {
                        value = operateResult.Content;
                        result = true;
                    }
                    else
                    {
                        value = operateResult.Message;
                    }
                }
            }
            else
            {
                errorMessage = "连接下位机的客户端引擎未初始化";
            }
            return result;
        }

        /// <summary>
        /// 设置下位机单点数据
        /// </summary>
        /// <param name="client">西门子S7协议的客户端实例</param>
        /// <param name="dataType">数据类型</param>
        /// <param name="block">数据块</param>
        /// <param name="offset">偏移量</param>
        /// <param name="value">写入的值</param>
        /// <param name="errorMessage">输出参数：空字符（成功）；错误信息（失败）</param>
        /// <returns>返回是否设置成功</returns>
        public static bool SetPlcSingleData(SiemensS7Net client, string dataType, string block, decimal offset, object value, ref string errorMessage)
        {
            bool result = false;
            if (client != null)
            {
                if (dataType.ToLower() == "int")
                {
                    var operateResult = client.Write(block + "." + offset, Convert.ToInt16(value));
                    if (operateResult.IsSuccess)
                    {
                        errorMessage = "";
                        result = true;
                    }
                    else
                    {
                        errorMessage = operateResult.Message;
                    }
                }
                else if (dataType.ToLower() == "bool")
                {
                    var operateResult = client.Write(block + "." + offset, Convert.ToBoolean(value));
                    if (operateResult.IsSuccess)
                    {
                        result = true;
                    }
                    else
                    {
                        errorMessage = operateResult.Message;
                    }
                }
                else if (dataType.ToLower() == "usint")
                {
                    var operateResult = client.Write(block + "." + offset, Convert.ToByte(value));
                    if (operateResult.IsSuccess)
                    {
                        errorMessage = "";
                        result = true;
                    }
                    else
                    {
                        errorMessage = operateResult.Message;
                    }
                }
            }
            else
            {
                errorMessage = "连接下位机的客户端引擎未初始化";
            }
            return result;
        }

        /// <summary>
        /// 获取下位机批量数据
        /// </summary>
        /// <param name="client">西门子S7协议的客户端实例</param>
        /// <param name="startAddress">读取的起始地址（例如：DB1.46.0）</param>
        /// <param name="length">读取数据的个数（1个数据2个字节）</param>
        /// <param name="values">输出参数：点位值字节数组（成功）；</param>
        /// <param name="errorMessage">输出参数：空字符（成功）；错误信息（失败）</param>
        /// <returns></returns>
        public static bool GetPlcBatchData(SiemensS7Net client, string startAddress, ushort length, ref byte[] values, ref string errorMessage)
        {
            bool result = false;
            if (client != null)
            {
                OperateResult<byte[]> read = client.Read(startAddress, length);
                {
                    if (read.IsSuccess)
                    {
                        values = read.Content;
                        errorMessage = "";
                        result = true;
                    }
                    else
                    {
                        errorMessage = read.Message;
                    }
                }
            }
            else
            {
                errorMessage = "连接下位机的客户端引擎未初始化";
            }
            return result;
        }
    }

总结

其实我也是第一次使用到这个，可能做上位机的经常会使用到，它是一种协议，让下位机和上位机之间建立某一种契约，上位机能给下位机发送命令，下位机执行命令，下位机返回信息给上位机，上位机处理。上位机监听下位机的点位信息。