Inetkid.Modbus 1.1.0.4

Modbus Library

Modbus library for communication via RS-485 and TCP/IP. Very light and hackable. Support Modbus RTU, Modbus ASCII, Modbus TCP transport; and the role of client, server, master, slave, and gateway. Written in Visual Studio 2022 for .net6.

Quick Start

Install

dotnet add package Inetkid.Modbus
dotnet add package Inetkid.Modbus.Rtu
dotnet add package Inetkid.Modbus.Ascii
dotnet add package Inetkid.Modbus.Tcp

Communicating with a modbus device

using System.IO.Ports;
using Inetkid.Modbus.Command;

byte deviceId = 1;
ushort address = 0;
ushort length = 2;
using (SerialPort sp = new("COM1") { ReadTimeout = 500, WriteTimeout = 100 })
{
    // Initialize ModbusCommand to use the modbus RTU protocol
    var command = new ModbusCommand().UseRtu(sp);

    // Set the request content to read the first 2 holding registers (analog output) 
    // and asynchronously execute the command
    var result = command.RequestReadHoldingRegisters(deviceId, address, length).Execute().Result;

    Console.WriteLine("Value at register 400001 is " + result.Registers[0]);
    Console.WriteLine("Value at register 400002 is " + result.Registers[1]);
}

See examples in REFERENCE.md

Emulates a modbus device

See examples in REFERENCE.md

Gateway TCP to RS485

See examples in REFERENCE.md

Creating device specific adaper

See examples in REFERENCE.md

Change Log

2023-05-17 Version 1.1.0.3

Split the functionality of RTU, ASCII and TCP to 3 separate nuget package to optimize the package size.

Changes to the abstract class ModbusAdapter

Bug fixes

For history of changes please refer to the file CHANGELOG.md

Reference

Refer to the file REFERENCE.md

License

Copyright 2023 Raymond Tan.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Contributing

You are welcomed to improve the code. Please visit https://gitlab.com/inetkid/inetkid.modbus Targets .net 6 and above. Written in C# for Microsoft Visual Studio 2022.