《連載 | 物聯網框架ServerSuperIO教程》2.服務實例的配置參數說明

1.C#跨平台物聯網通訊框架ServerSuperIO（SSIO）介紹

 《連載 | 物聯網框架ServerSuperIO教程》1.4種通訊模式機制

 

一、綜述

     SuperIO(SIO)定位在PC終端（上位機）應用，它只有一個服務實例，配置參數是全局屬性。但是，ServerSuperIO（SSIO）與SuperIO(SIO)定位不一樣，SSIO定位在服務器端，不管是串口通訊模式，還是網絡通訊模式，都支持多服務實例，所以每個服務實例都有自己的配置參數，全部配置參數的定義在ServerConfig.cs文件中。

     如下圖示意：

二、配置參數說明

#region 全局
        [Category("1.全局"),
         DisplayName("ServerSession"),
         Description("標識服務的唯ID，一般為Guid"),
         DefaultValue(""),
         ReadOnly(true)]
         public string ServerSession { get; set; }

        [Category("1.全局"),
        DisplayName("ServerName"),
        Description("標識服務的標題名稱"),
        DefaultValue("")]
        public string ServerName { get; set; }

        [Category("1.全局"),
        DisplayName("DeliveryMode"),
        Description("接收數據后的分布策略，包括：按設備IP分發（DeviceIP）、按設備編碼分發（DeviceCode）"),
        DefaultValue(DeliveryMode.DeviceIP)]
        public DeliveryMode DeliveryMode { get; set; }

        [Category("1.全局"),
         DisplayName("ControlMode"),
         Description("調度設備驅動和IO實例的策略，包括:循環模式（Loop）、並發模式（Parallel）、自主模式（Self）和單例模式（Singleton）"),
         DefaultValue(ControlMode.Loop)]
        public ControlMode ControlMode { get; set; }

        [Category("1.全局"),
         DisplayName("StartReceiveDataFliter"),
         Description("標識接收數據后是否按協議過濾器的規划過濾數據，不啟用則直接返回數據"),
         DefaultValue(false)]
        public bool StartReceiveDataFliter { get; set; }

        [Category("1.全局"),
        DisplayName("StartCheckPackageLength"),
        Description("標識是否檢測數據長度，如果開啟，那么會調用協議驅動的GetPackageLength接口，直到接收返回的數據長度的數據"),
        DefaultValue(false)]
        public bool StartCheckPackageLength { get; set; }
        #endregion

        #region 串口
        [Category("2.串口"),
         DisplayName("ComReadBufferSize"),
         Description("設置一次接收數據的字節數組最大值"),
         DefaultValue(1024)]
        public int ComReadBufferSize { get; set; }

        [Category("2.串口"),
        DisplayName("ComWriteBufferSize"),
        Description("設置一次發送數據的字節數組最大值"),
        DefaultValue(1024)]
        public int ComWriteBufferSize { get; set; }

        [Category("2.串口"),
        DisplayName("ComReadTimeout"),
        Description("設置一次讀取數據的超時時間"),
        DefaultValue(1000)]
        public int ComReadTimeout { get; set; }

        [Category("2.串口"),
        DisplayName("ComWriteTimeout"),
        Description("設置一次發送數據的超時時間"),
        DefaultValue(1000)]
        public int ComWriteTimeout { get; set; }

        [Category("2.串口"),
        DisplayName("ComLoopInterval"),
        Description("輪詢模式下，發送和接收數據中間的等待時間，串口通訊不支持其他控制模式"),
        DefaultValue(1000)]
        public int ComLoopInterval { get; set; }
        #endregion

        #region 網絡
        [Category("3.網絡"),
         DisplayName("NetReceiveBufferSize"),
         Description("設置一次接收數據的字節數組最大值"),
         DefaultValue(1024)]
        public int NetReceiveBufferSize { get; set; }

        [Category("3.網絡"),
        DisplayName("NetSendBufferSize"),
        Description("設置一次發送數據的字節數組最大值"),
        DefaultValue(1024)]
        public int NetSendBufferSize { get; set; }

        [Category("3.網絡"),
        DisplayName("NetReceiveTimeout"),
        Description("設置一次讀取數據的超時時間"),
        DefaultValue(1000)]
        public int NetReceiveTimeout { get; set; }

        [Category("3.網絡"),
         DisplayName("NetSendTimeout"),
         Description("設置一次發送數據的超時時間"),
         DefaultValue(1000)]
        public int NetSendTimeout { get; set; }

        [Category("3.網絡"),
        DisplayName("NetLoopInterval"),
        Description("輪詢模式下，發送和接收數據中間的等待時間"),
        DefaultValue(1000)]
        public int NetLoopInterval { get; set; }

        [Category("3.網絡"),
        DisplayName("MaxConnects"),
        Description("允許客戶端最大的連接數，超取最大值，自動關閉遠程連接"),
        DefaultValue(1000)]
        public int MaxConnects { get; set; }

        [Category("3.網絡"),
        DisplayName("KeepAlive"),
        Description("檢測死連接、半連接的一種機制"),
        DefaultValue(5000)]
        public uint KeepAlive { get; set; }

        [Category("3.網絡"),
        DisplayName("ListenPort"),
        Description("偵聽接收數據的端口"),
        DefaultValue(6699)]
        public int ListenPort { get; set; }

        [Category("3.網絡"),
        DisplayName("BackLog"),
        Description("定隊列中最多可容納的等待接受的傳入連接數"),
        DefaultValue(1000)]
        public int BackLog { get; set; }

        [Category("3.網絡"),
        DisplayName("CheckSameSocketSession"),
        Description("對一個固定的設備，只允許有一個有效連接，重復IP多次連接，將斷開之前的連接"),
        DefaultValue(true)]
        public bool CheckSameSocketSession { get; set; }

        [Category("3.網絡"),
        DisplayName("SocketMode"),
        Description("標識設備是TcpServer、TcpClient模式，如果標識TcpClient模式，會主動連接遠程IP和端口"),
        DefaultValue(SocketMode.Tcp)]
        public SocketMode SocketMode { get; set; }


        [Category("3.網絡"),
        DisplayName("ClearSocketSession"),
        Description("標識是否清理連接，如果一個連接在一定時間范圍內沒有接收到數據，將主動斷開連接"),
        DefaultValue(false)]
        public bool ClearSocketSession { get; set; }

        [Category("3.網絡"),
        DisplayName("ClearSocketSessionInterval"),
        Description("如果標識清理連接，那么在此標識清理連接間隔時間"),
        DefaultValue(10)]
        public int ClearSocketSessionInterval { get; set; }

        [Category("3.網絡"),
        DisplayName("ClearSocketSessionTimeOut"),
        Description("如果標識清理連接，那么在此標識多長時間沒有接收到數據進行清理"),
        DefaultValue(30)]
        public int ClearSocketSessionTimeOut { get; set; }
        #endregion

 

  三、常用配置參數說明

       常用的配置參數包括：通訊參數類、控制參數類、以及一些高級的應用參數。如下代碼

IServer server = new ServerFactory().CreateServer(new ServerConfig()
            {
                ServerName = "服務1",   //服務實例的名稱
                ComReadTimeout = 1000, //串口讀數據超時
                ComWriteTimeout = 1000, //串口發送數據超時
                NetReceiveTimeout = 1000, //網絡接收數據超時
                NetSendTimeout = 1000,//網絡發送數據超時
                ControlMode = ControlMode.Parallel,//控制模式
                SocketMode = SocketMode.Tcp, //網絡通訊是TCP模式還是UDP模式
                StartReceiveDataFliter = false,//是否開啟接收數據過濾器，后面重要介紹
                ClearSocketSession = false,//是否檢測網絡實例的有效性，后面重要介紹
                StartCheckPackageLength = false //是否檢測包長度，后面重要介紹
            });

       ControlMode參數是SSIO結合現實應用場景的控制模式，主要用於調用設備的發送和接收數據的調度方式。請參見：《連載 | 物聯網框架ServerSuperIO教程》1.4種通訊模式機制。

四、配置工具

      二次開發者，可以通過ServerSuperIO.Tool項目來配置服務實例、設備驅動和服務實例的參數。如下圖：

 

注：下篇文章介紹設備驅動

 

1.[連載]《C#通訊（串口和網絡）框架的設計與實現》

2.[開源]C#跨平台物聯網通訊框架ServerSuperIO（SSIO）介紹

2.應用SuperIO（SIO）和開源跨平台物聯網框架ServerSuperIO（SSIO）構建系統的整體方案

3.C#工業物聯網和集成系統解決方案的技術路線（數據源、數據采集、數據上傳與接收、ActiveMQ、Mongodb、WebApi、手機App）

5.ServerSuperIO開源地址：https://github.com/wxzz/ServerSuperIO

物聯網&集成技術(.NET) QQ群：54256083