Skip to content

README.md

Latest commit

 

History

History
32 lines (28 loc) · 1.96 KB

README.md

File metadata and controls

32 lines (28 loc) · 1.96 KB
Raw

Modbus Client Library for .NET

Yet another Modbus client library for .NET.

Features

  1. RTU, ASCII and TCP protocols via serial or network connection.
  2. Implemented read/write functions (Modbus function codes):
    • Read Coils / Discrete Inputs / Holding Registers / Input Registers (1/2/3/4)
    • Write Single Coil / Holding Register (5/6)
    • Write Multiple Coils / Holding Registers (15/16)
  3. Splitting single read/write requests into multiple requests with valid number of memory elements.
  4. Automatic reconnection to device.
  5. Support of multiple devices on the same serial port or network connection (share the same Stream instance between clients).
  6. Possibility of other Modbus function code (including user-defined) implementation.
  7. Execution of several commands as one atomic sequence via PL.Modbus.Client.CreateSession.
  8. Asynchronous counterparts (...Async methods, e.g. ReadHoldingRegistersAsync, CreateSessionAsync) for every operation, with CancellationToken support.

Not implemented and user-defined Modbus function codes

For Modbus TCP and Modbus ASCII PL.Modbus.Client.Command/CommandAsync and PL.Modbus.ClientSession.Command/CommandAsync methods can be used with any function code, since these protocols allow to receive responce data without knowing its size beforehand. For Modbus RTU descendant Client class should be created with overriden PL.Modbus.Client.ReadRtuData/ReadRtuDataAsync method.

Examples

ModbusClient

Simple Modbus client application.

ModbusSpeedTest

Tests client-server connection and measures transaction rate.

ModbusMemoryTest

Tests Modbus server by writing to random memory locations, reading back and comparing data.

Documentation

Modbus (Wikipedia)
Modbus Protocol Specification
Modbus Serial Line Protocol and Implementation Guide