文件列表:

Development (0, 2016-08-19)
Development\Enums (0, 2016-08-19)
Development\Enums\Access.cs (2068, 2016-08-19)
Development\Enums\AccessMode.cs (2474, 2016-08-19)
Development\Enums\ApplicationReference.cs (2419, 2016-08-19)
Development\Enums\AssociationResult.cs (1977, 2016-08-19)
Development\Enums\Authentication.cs (2129, 2016-08-19)
Development\Enums\ClockStatus.cs (2142, 2016-08-19)
Development\Enums\Command.cs (5783, 2016-08-19)
Development\Enums\ConfirmedServiceError.cs (1771, 2016-08-19)
Development\Enums\DataType.cs (5891, 2016-08-19)
Development\Enums\DateTimeSkips.cs (2589, 2016-08-19)
Development\Enums\Definition.cs (1973, 2016-08-19)
Development\Enums\ErrorCode.cs (3590, 2016-08-19)
Development\Enums\ExceptionServiceError.cs (1762, 2016-08-19)
Development\Enums\ExceptionStateError.cs (1557, 2016-08-19)
Development\Enums\HardwareResource.cs (2157, 2016-08-19)
Development\Enums\Initiate.cs (2092, 2016-08-19)
Development\Enums\InterfaceType.cs (1835, 2016-08-19)
Development\Enums\LoadDataSet.cs (2461, 2016-08-19)
Development\Enums\MethodAccessMode.cs (1871, 2016-08-19)
Development\Enums\ObjectType.cs (15356, 2016-08-19)
Development\Enums\Priority.cs (1573, 2016-08-19)
Development\Enums\RequestTypes.cs (1867, 2016-08-19)
Development\Enums\Security.cs (1796, 2016-08-19)
Development\Enums\Service.cs (1798, 2016-08-19)
Development\Enums\ServiceClass.cs (1381, 2016-08-19)
Development\Enums\ServiceError.cs (2399, 2016-08-19)
Development\Enums\SourceDiagnostic.cs (2376, 2016-08-19)
Development\Enums\Task.cs (2014, 2016-08-19)
Development\Enums\Unit.cs (10470, 2016-08-19)
Development\Enums\UpdateType.cs (1672, 2016-08-19)
Development\Enums\VdeStateError.cs (2059, 2016-08-19)
Development\GXByteBuffer.cs (27295, 2016-08-19)
Development\GXDLMS.cs (92228, 2016-08-19)
Development\GXDLMSBuilder.cs (2778, 2016-08-19)
Development\GXDLMSClient.cs (68545, 2016-08-19)
... ...

See An [Gurux](http://www.gurux.org/ "Gurux") for an overview. Join the Gurux Community or follow [@Gurux](https://twitter.com/guruxorg "@Gurux") for project updates. Gurux.DLMS library is a high-performance .NET component that helps you to read you DLMS/COSEM compatible electricity, gas or water meters. We have try to make component so easy to use that you do not need understand protocol at all. For more info check out [Gurux.DLMS](http://www.gurux.fi/index.php?q=Gurux.DLMS "Gurux.DLMS"). We are updating documentation on Gurux web page. Read should read [DLMS/COSEM FAQ](http://www.gurux.org/index.php?q=DLMSCOSEMFAQ) first to get started. Read Instructions for making your own [meter reading application](http://www.gurux.org/index.php?q=DLMSIntro) or build own DLMS/COSEM [meter/simulator/proxy](http://www.gurux.org/index.php?q=OwnDLMSMeter). If you have problems you can ask your questions in Gurux [Forum](http://www.gurux.org/forum). You do not nesessary need to use Gurux.Serial or Gurux.Net. You can use any connection library you want to. Gurux.DLMS classes only parse the data. Simple example =========================== Before use you must set following device parameters. Parameters are manufacturer spesific. ```csharp GXDLMSClient client = new GXDLMSClient(); // Is used Logican Name or Short Name referencing. client.UseLogicalNameReferencing = true; // Is used HDLC or COSEM transport layers for IPv4 networks (WRAPPER) client.InterfaceType = InterfaceType.HDLC; // Read http://www.gurux.org/dlmsAddress // to find out how Client and Server addresses are counted. // Some manufacturers might use own Server and Client addresses. client.ClientAddress = 16; client.ServerAddress = 1; ``` HDLC addressing =========================== Each meter has own server address. Server address is divided to Logical address and Physical address. Usually you can use value 1 for meter address. You can count server address from serial number of the meter. You can use GetServerAddress method for that. ```csharp //Count server address from serial number. int serverAddress = GXDLMSClient.GetServerAddress(Serial number); //Count server address from logican and physical address. serverAddress = CGXDLMSClient.GetServerAddress(logical Address, physical Address); ``` If you are using IEC handshake you must first send identify command and move to mode E. ```csharp void InitSerial() { GXSerial serial = Media as GXSerial; byte Terminator = (byte)0x0A; if (serial != null && InitializeIEC) { serial.BaudRate = 300; serial.DataBits = 7; serial.Parity = Parity.Even; serial.StopBits = StopBits.One; } Media.Open(); //Query device information. if (Media != null && InitializeIEC) { string data = "/?!\r\n"; if (Trace) { Console.WriteLine("HDLC sending:" + data); } ReceiveParameters p = new ReceiveParameters() { Eop = Terminator, WaitTime = WaitTime }; lock (Media.Synchronous) { Media.Send(data, null); if (!Media.Receive(p)) { //Try to move away from mode E. throw new Exception("Failed to receive reply from the device in given time."); } //If echo is used. if (p.Reply == data) { p.Reply = null; if (!Media.Receive(p)) { //Try to move away from mode E. throw new Exception("Failed to receive reply from the device in given time."); } } } if (Trace) { Console.WriteLine("HDLC received: " + p.Reply); } if (p.Reply[0] != '/') { p.WaitTime = 100; Media.Receive(p); throw new Exception("Invalid responce."); } string manufactureID = p.Reply.Substring(1, 3); //UpdateManufactureSettings(manufactureID); char baudrate = p.Reply[4]; int BaudRate = 0; switch (baudrate) { case '0': BaudRate = 300; break; case '1': BaudRate = 600; break; case '2': BaudRate = 1200; break; case '3': BaudRate = 2400; break; case '4': BaudRate = 4800; break; case '5': BaudRate = 9600; break; case '6': BaudRate = 19200; break; default: throw new Exception("Unknown baud rate."); } Console.WriteLine("BaudRate is :", BaudRate.ToString()); //Send ACK //Send Protocol control character byte controlCharacter = (byte)'2';// "2" HDLC protocol procedure (Mode E) //Send Baudrate character //Mode control character byte ModeControlCharacter = (byte)'2';//"2" //(HDLC protocol procedure) (Binary mode) //Set mode E. byte[] arr = new byte[] { 0x06, controlCharacter, (byte)baudrate, ModeControlCharacter, 13, 10 }; if (Trace) { Console.WriteLine("Moving to mode E", BitConverter.ToString(arr)); } lock (Media.Synchronous) { Media.Send(arr, null); p.Reply = null; p.WaitTime = 500; if (!Media.Receive(p)) { //Try to move away from mode E. this.ReadDLMSPacket(m_Parser.DisconnectRequest()); throw new Exception("Failed to receive reply from the device in given time."); } } if (serial != null) { serial.BaudRate = BaudRate; serial.DataBits = 8; serial.Parity = Parity.None; serial.StopBits = StopBits.One; } } } ``` After you have set parameters you can try to connect to the meter. First you should send SNRM request and handle UA response. After that you will send AARQ request and handle AARE response. ```csharp GXReplyData reply = new GXReplyData(); GXDLMSClient client = new GXDLMSClient(); byte[] data; data = client.SNRMRequest(); if (data != null) { ReadDLMSPacket(data, reply); //Has server accepted client. client.ParseUAResponse(reply.Data); Console.WriteLine("Parsing UA reply succeeded."); } //Generate AARQ request. //Split requests to multiple packets if needed. //If password is used all data might not fit to one packet. foreach (byte[] it in client.AARQRequest(null)) { reply.Clear(); ReadDLMSPacket(it, reply); } //Parse reply. client.ParseAAREResponse(reply.Data); Console.WriteLine("Connection succeeded."); ``` If parameters are right connection is made. Next you can read Association view and show all objects that meter can offer. ```csharp /// Read Association View from the meter. GXReplyData reply = new GXReplyData(); ReadDataBlock(client.GetObjects(), reply); GXDLMSObjectCollection objects = client.ParseObjects(reply.Data, true); ``` Now you can read wanted objects. After read you must close the connection by sending disconnecting request. ```csharp GXReplyData reply = new GXReplyData(); ReadDLMSPacket(m_Parser.DisconnectRequest(), reply); Media.Close(); ``` ```csharp ///

/// Read DLMS Data from the device. ///

/// Data to send. /// Received data. public void ReadDLMSPacket(byte[] data, GXReplyData reply) { if (data == null) { return; } object eop = (byte)0x7E; //In network connection terminator is not used. if (Client.InterfaceType == InterfaceType.WRAPPER && Media is GXNet) { eop = null; } int pos = 0; bool succeeded = false; ReceiveParameters p = new ReceiveParameters() { AllData = true, Eop = eop, Count = 5, WaitTime = WaitTime, }; lock (Media.Synchronous) { while (!succeeded && pos != 3) { WriteTrace("<- " + DateTime.Now.ToLongTimeString() + "\t" + GXCommon.ToHex(data, true)); Media.Send(data, null); succeeded = Media.Receive(p); if (!succeeded) { //If Eop is not set read one byte at time. if (p.Eop == null) { p.Count = 1; } //Try to read again... if (++pos != 3) { System.Diagnostics.Debug.WriteLine("Data send failed. Try to resend " + pos.ToString() + "/3"); continue; } throw new Exception("Failed to receive reply from the device in given time."); } } //Loop until whole COSEM packet is received. while (!Client.GetData(p.Reply, reply)) { //If Eop is not set read one byte at time. if (p.Eop == null) { p.Count = 1; } if (!Media.Receive(p)) { //Try to read again... if (pos != 3) { System.Diagnostics.Debug.WriteLine("Data send failed. Try to resend " + pos.ToString() + "/3"); continue; } throw new Exception("Failed to receive reply from the device in given time."); } } } WriteTrace("-> " + DateTime.Now.ToLongTimeString() + "\t" + GXCommon.ToHex(p.Reply, true)); if (reply.Error != 0) { throw new GXDLMSException(reply.Error); } } ``` Using authentication When authentication (Access security) is used server(meter) can allow different rights to the client. Example without authentication (None) only read is allowed. Gurux DLMS component supports five different authentication level: + None + Low + High + HighMD5 + HighSHA1 In default Authentication level None is used. If other level is used password must also give. Used password depends from the meter. ```csharp client.Authentication = Authentication.HighMD5; client.Password = ASCIIEncoding.ASCII.GetBytes("12345678"); ``` When authentication is High or above High Level security (HLS) is used. After connection is made client must send challenge to the server and server must accept this challenge. This is done checking is Is Authentication Required after AARE message is parsed. If authentication is required client sends challenge to the server and if everything succeeded server returns own challenge that client checks. ```csharp //Parse reply. Client.ParseAAREResponse(reply); //Get challenge Is HSL authentication is used. if (Client.IsAuthenticationRequired) { reply.Clear(); ReadDLMSPacket(Client.GetApplicationAssociationRequest(), reply); Client.ParseApplicationAssociationResponse(reply.Data); } ``` Writing values Writing values to the meter is very simple. There are two ways to do this. First is using Write -method of GXDLMSClient. ```csharp ReadDLMSPacket(Client.Write("0.0.1.0.0.255", DateTime.Now, 2, DataType.OctetString, ObjectType.Clock, 2), reply); ``` Note! Data type must be correct or meter returns usually error. If you are reading byte value you can't write UIn16. It is easy to write simple data types like this. If you want to write complex data types like arrays there is also another way to do this. You can Update Object's propery and then write it. In this example we want to update listening window of GXDLMSAutoAnswer object. ```csharp //Read Association view and find GXDLMSAutoAnswer object first. GXDLMSAutoAnswer item = Client.Object.FindByLN("0.0.2.2.0.255", ObjectType.AutoAnswer); //Window time is from 6am to 8am. item.ListeningWindow.Add(new KeyValuePair(new GXDateTime(-1, -1, -1, 6, -1, -1, -1), new GXDateTime(-1, -1, -1, 8, -1, -1, -1))); ReadDLMSPacket(Client.Write(item, 3), reply); ``` Transport security DLMS supports tree different transport security. When transport security is used each packet is secured using GMAC security. Security level are: * Authentication * Encryption * AuthenticationEncryption Using secured messages (glo services) is easy. Before security can be used following properties must set: * Security * SystemTitle * AuthenticationKey * BlockCipherKey * FrameCounter If we want communicate with Gurux DLMS server you just need to set the following settings. ```csharp GXDLMSSecureClient sc = new GXDLMSSecureClient(); sc.Ciphering.Security = Security.Encryption; //Default security when using Gurux test server. sc.Ciphering.SystemTitle = ASCIIEncoding.ASCII.GetBytes("GRX12345"); ```

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：