程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> .NET網頁編程 >> C# >> C#入門知識 >> 《連載 | 物聯網框架ServerSuperIO教程》2.服務實例的配置參數說明,superio的應用實例

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

編輯:C#入門知識

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


一、綜述

     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. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved