QuickStart
Modbus w C#, krok po kroku
Dodaj odwołanie do pakietu esegece.sgcIndustrial, a następnie wybierz transport. Każdy przykład na tej stronie kompiluje się w .NET 8.
using esegece.sgcWebSockets;
var modbus = new TsgcModbusTCPClient();
modbus.Host = "192.168.1.50";
modbus.Port = 502;
modbus.UnitId = 1;
modbus.Timeout = 2000;
modbus.Retries = 2;
modbus.WatchDog.Enabled = true;
modbus.OnError += (sender, error) => Console.WriteLine("#error: " + error);
modbus.Active = true;
ushort[] registers = modbus.ReadHoldingRegisters(0, 10);
bool[] coils = modbus.ReadCoils(0, 8);
Console.WriteLine("HR0 = " + registers[0] + ", coil 0 = " + coils[0]);
modbus.WriteSingleRegister(100, 1234);
modbus.WriteMultipleRegisters(110, new ushort[] { 1, 2, 3 });
modbus.WriteSingleCoil(5, true);
modbus.WordOrder = TsgcModbusWordOrder.mwoCDAB;
float temperature = modbus.ReadFloat32(200);
int counter = modbus.ReadInt32(202);
string name = modbus.ReadString(300, 8);
Console.WriteLine($"{name}: {temperature:F1} C, {counter} cycles");
modbus.WriteFloat32(210, 21.5f);
modbus.WriteUInt32(212, 3000000000);
float flow = modbus.ReadInputFloat32(7, 0);
Console.WriteLine("flow = " + flow);
try
{
modbus.ReadHoldingRegisters(9000, 4);
}
catch (EsgcModbusException e)
{
Console.WriteLine($"exception {e.ExceptionCode}, function {e.FunctionCode}");
}
catch (EsgcModbusTimeout e)
{
Console.WriteLine(e.Message);
}
using esegece.sgcWebSockets;
var port = new TsgcSerialPort();
port.Port = "COM3";
port.BaudRate = 19200;
port.Parity = TsgcSerialParity.spEven;
port.Open();
var rtu = new TsgcModbusRTUClient();
rtu.SerialPort = port;
rtu.UnitId = 17;
rtu.Timeout = 500;
rtu.Retries = 1;
ushort[] values = rtu.ReadInputRegisters(0, 4);
byte status = rtu.ReadExceptionStatus();
Console.WriteLine($"IR0 = {values[0]}, status = {status}");
rtu.WriteSingleRegister(0, 10, 500);
using esegece.sgcWebSockets;
var server = new TsgcModbusTCPServer();
server.Port = 502;
server.UnitId = 0;
server.DataModel.HoldingRegisterCount = 1000;
server.DataModel.SetHoldingRegister(0, 42);
server.DataModel.SetCoil(0, true);
server.DataModel.VendorName = "My Company";
server.DataModel.ProductCode = "GW-100";
var random = new Random();
server.OnReadRequest += (object sender, byte unitId, byte functionCode,
ushort address, ushort count, ref byte exceptionCode) =>
{
if (functionCode == sgcModbus_Classes.CS_MODBUS_FC_READ_INPUT_REGISTERS)
server.DataModel.SetInputRegister(0, (ushort)random.Next(1000));
};
server.OnWriteRequest += (object sender, byte unitId, byte functionCode,
ushort address, ushort count, ref bool[] bits, ref ushort[] registers,
ref byte exceptionCode) =>
{
if (registers.Length > 0 && address < 10)
exceptionCode = sgcModbus_Classes.CS_MODBUS_EX_ILLEGAL_DATA_ADDRESS;
};
server.Active = true;
Console.ReadLine();
Wywołania są synchroniczne. W aplikacji WinForms, WPF lub ASP.NET uruchom pętlę odpytywania w wątku roboczym albo wewnątrz Task.Run; klient jest bezpieczny wątkowo, więc kilka zadań może współdzielić jedno połączenie.