NNModbus 0.5.1

NNModbus

NNModbus is an all-in-one C# / .NET library for the Modbus communication protocol. It is an enhanced fork of NModbus featuring built-in typed data extensions (ReadInt32, ReadFloat, ReadDouble, ReadString, etc.), full endianness support, Modbus TCP, Modbus UDP, Modbus RTU / ASCII (Serial), raw TCP/IP sockets, and extensible slave services.

Installation

dotnet add package NNModbus

Features

• All-in-One Transports: TCP, UDP, Serial RTU, Serial ASCII, raw TCP/IP Sockets.
• Roles: Master (Client) & Slave (Server) with full async/await support.
• Typed Data Extensions: Direct read & write for Float (IEEE 754), Double, Int16, UInt16, Int32, UInt32, Int64, UInt64, String, and bool[].
• Endianness Formatting: Support for ABCD (Big-Endian), CDAB (Word Swap), BADC (Byte Swap), and DCBA (Little-Endian).
• Custom Function Codes: Pluggable IModbusFunctionService.
• Enron 32-bit Modbus: Read & Write native 32-bit registers.

Quick Examples

1. Modbus TCP Master

using System;
using System.Net.Sockets;
using NNModbus;

using (var client = new TcpClient("192.168.1.100", 502))
{
    var factory = new ModbusFactory();
    IModbusMaster master = factory.CreateMaster(client);

    // Read 5 Holding Registers
    ushort[] registers = master.ReadHoldingRegisters(slaveAddress: 1, startAddress: 0, numberOfPoints: 5);

    // Read Float (IEEE 754) with Endianness
    float temperature = master.ReadFloat(slaveAddress: 1, startAddress: 100, format: EndianFormat.ABCD);

    // Write Float
    master.WriteFloat(slaveAddress: 1, startAddress: 100, 36.5f, format: EndianFormat.ABCD);
}

2. Modbus Serial RTU Master

using System;
using System.IO.Ports;
using NNModbus;
using NNModbus.Serial;

using (var port = new SerialPort("COM1", 9600, Parity.None, 8, StopBits.One))
{
    port.Open();

    var factory = new ModbusFactory();
    IModbusSerialMaster master = factory.CreateRtuMaster(port);

    ushort[] registers = master.ReadHoldingRegisters(slaveAddress: 1, startAddress: 0, numberOfPoints: 10);
}

License

Licensed under the MIT License.