C#과 .NET 신규

.NET용 C# Modbus TCP 및 RTU 라이브러리

이더넷이나 RS-485를 통해 C#에서 PLC, 드라이브, 계량기를 읽고 쓰거나, 내 데이터를 Modbus 슬레이브로 제공해 보세요.

Modbus TCP와 Modbus RTU
클라이언트와 서버
임의의 워드 순서를 지원하는 Float32, Int32, 문자열
스레드 안전 블로킹 호출

sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access, 또는 독립형 sgcIndustrial 팩에 포함.

C#으로 장치 읽고 쓰기 → · Modbus FAQ →

C# Modbus TCP 클라이언트
using esegece.sgcWebSockets;

var modbus = new TsgcModbusTCPClient();
modbus.Host = "192.168.1.50";
modbus.Port = 502;
modbus.Active = true;

ushort[] registers = modbus.ReadHoldingRegisters(0, 10);  // FC 03
float temperature = modbus.ReadFloat32(200);               // 2 registers
modbus.WriteSingleCoil(5, true);                           // FC 05

.NET용 Modbus 클라이언트와 서버

컴포넌트 네 개, TCP와 RTU를 위한 하나의 API, 서버 뒤의 스레드 안전 데이터 모델.

sgcWebSockets .NET의 C# Modbus 라이브러리는 esegece.sgcIndustrial 패키지의 esegece.sgcWebSockets 네임스페이스에 있어요. TsgcModbusTCPClient와 TsgcModbusRTUClient는 장치를 폴링하는 Modbus 마스터이고, TsgcModbusTCPServer와 TsgcModbusRTUServer는 TsgcModbusDataModel을 바탕으로 SCADA 시스템, HMI, 다른 마스터에 응답하는 Modbus 슬레이브예요. 시리얼 회선은 같은 패키지의 TsgcSerialPort이며 System.IO.Ports 기반이에요.

두 클라이언트는 TsgcModbusClient_Base를 공유하므로, 이더넷으로 레지스터를 읽는 메서드로 RS-485에서도 읽을 수 있어요. 각 호출은 응답이 도착하거나 Timeout이 만료될 때까지 블로킹되고, 일반 .NET 배열(레지스터는 ushort[], 코일은 bool[])을 반환하며, 장치가 오류를 보고하면 타입이 있는 예외를 던져요. 패키지는 .NET 8, .NET 9, .NET 10, .NET Standard 2.0을 대상으로 해요.

기능 코드

01~08, 15, 16, 22, 23, 43/14를 각각 메서드 하나로 제공해요.

타입 값

ReadFloat32, ReadInt32, ReadUInt32, ReadString과 대응하는 쓰기 메서드, 그리고 네 가지 레지스터 배치를 위한 WordOrder.

Modbus TCP

기본 포트 502, 선택적 TLS, HTTP 또는 SOCKS 프록시, 자동 재연결을 지원해요.

Modbus RTU

3.5 문자 프레이밍, CRC 검사, 브로드캐스트 쓰기를 지원하는 RS-232와 RS-485예요.

C#으로 배우는 Modbus, 단계별로

esegece.sgcIndustrial 패키지를 참조한 다음 전송 방식을 고르세요. 이 페이지의 모든 샘플은 .NET 8에서 컴파일돼요.

using esegece.sgcWebSockets;

var modbus = new TsgcModbusTCPClient();
modbus.Host = "192.168.1.50";
modbus.Port = 502;
modbus.UnitId = 1;
modbus.Timeout = 2000;            // ms per attempt
modbus.Retries = 2;               // extra attempts after a timeout
modbus.WatchDog.Enabled = true;   // reconnect after a network drop
modbus.OnError += (sender, error) => Console.WriteLine("#error: " + error);
modbus.Active = true;

ushort[] registers = modbus.ReadHoldingRegisters(0, 10);       // FC 03
bool[] coils = modbus.ReadCoils(0, 8);                         // FC 01
Console.WriteLine("HR0 = " + registers[0] + ", coil 0 = " + coils[0]);

modbus.WriteSingleRegister(100, 1234);                         // FC 06
modbus.WriteMultipleRegisters(110, new ushort[] { 1, 2, 3 });  // FC 16
modbus.WriteSingleCoil(5, true);                               // FC 05
modbus.WordOrder = TsgcModbusWordOrder.mwoCDAB;   // low word first
float temperature = modbus.ReadFloat32(200);       // 2 holding registers
int counter = modbus.ReadInt32(202);
string name = modbus.ReadString(300, 8);           // 8 registers, 16 characters
Console.WriteLine($"{name}: {temperature:F1} C, {counter} cycles");

modbus.WriteFloat32(210, 21.5f);
modbus.WriteUInt32(212, 3000000000);

// explicit unit id, for a gateway with several devices behind it
float flow = modbus.ReadInputFloat32(7, 0);        // unit 7, FC 04
Console.WriteLine("flow = " + flow);

try
{
    modbus.ReadHoldingRegisters(9000, 4);
}
catch (EsgcModbusException e)   // the device answered with an exception
{
    Console.WriteLine($"exception {e.ExceptionCode}, function {e.FunctionCode}");
}
catch (EsgcModbusTimeout e)     // no answer after Retries + 1 attempts
{
    Console.WriteLine(e.Message);
}
using esegece.sgcWebSockets;

var port = new TsgcSerialPort();
port.Port = "COM3";                              // "/dev/ttyUSB0" on Linux
port.BaudRate = 19200;
port.Parity = TsgcSerialParity.spEven;           // 8E1, the Modbus RTU default
port.Open();

var rtu = new TsgcModbusRTUClient();
rtu.SerialPort = port;
rtu.UnitId = 17;                                 // slave address
rtu.Timeout = 500;
rtu.Retries = 1;

ushort[] values = rtu.ReadInputRegisters(0, 4);  // FC 04
byte status = rtu.ReadExceptionStatus();         // FC 07
Console.WriteLine($"IR0 = {values[0]}, status = {status}");

rtu.WriteSingleRegister(0, 10, 500);             // unit 0: broadcast, no reply
using esegece.sgcWebSockets;

var server = new TsgcModbusTCPServer();
server.Port = 502;
server.UnitId = 0;                                  // answer every unit id
server.DataModel.HoldingRegisterCount = 1000;
server.DataModel.SetHoldingRegister(0, 42);
server.DataModel.SetCoil(0, true);
server.DataModel.VendorName = "My Company";         // FC 43/14 identification
server.DataModel.ProductCode = "GW-100";

var random = new Random();

// runs on the connection thread, before the table is read
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));
};

// registers 0..9 are read only
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();

호출은 동기식이에요. WinForms, WPF, ASP.NET 애플리케이션에서는 폴링 루프를 워커 스레드나 Task.Run 안에서 실행하세요. 클라이언트는 스레드 안전하므로 여러 태스크가 하나의 연결을 공유할 수 있어요.

지원하는 Modbus 펑션 코드

클라이언트는 아무것도 전송하기 전에 수량을 사양에 맞게 검사하며, 서버는 이 표의 모든 코드에 응답해요.

FC기능C# 메서드
01Read CoilsReadCoils
02Read Discrete InputsReadDiscreteInputs
03Read Holding RegistersReadHoldingRegisters, ReadInt32, ReadUInt32, ReadFloat32, ReadString
04Read Input RegistersReadInputRegisters, ReadInputInt32, ReadInputUInt32, ReadInputFloat32
05Write Single CoilWriteSingleCoil
06Write Single RegisterWriteSingleRegister
07Read Exception Status (시리얼 회선)RTU 클라이언트의 ReadExceptionStatus
08Diagnostics (시리얼 회선)RTU 클라이언트의 Diagnostics
15Write Multiple CoilsWriteMultipleCoils
16Write Multiple RegistersWriteMultipleRegisters, WriteInt32, WriteUInt32, WriteFloat32, WriteString
22Mask Write RegisterMaskWriteRegister
23Read/Write Multiple RegistersReadWriteMultipleRegisters
43/14Read Device IdentificationReadDeviceIdentification과 TsgcModbusDeviceIdCode: basic, regular, extended 또는 specific

운영 환경을 위해 만든 Modbus 마스터

워드 순서

TsgcModbusWordOrder.mwoABCD는 Modbus 기본값인 빅 엔디안이에요. mwoCDAB는 낮은 워드를 먼저 두고, mwoBADC는 각 레지스터 안의 바이트를 바꾸며, mwoDCBA는 완전한 리틀 엔디안이에요. 문자열은 레지스터당 두 문자로 담겨요.

스레드 안전

클라이언트마다 한 번에 하나의 트랜잭션만 실행되며, 모든 재시도를 포함하는 락 아래에서 처리돼요. TCP에서는 수신 스레드가 응답을 매칭해 대기 중인 호출에 전달하므로, UI 스레드에서 호출해도 교착 상태가 생기지 않아요.

타임아웃과 재시도

Timeout은 시도당 대기 시간이고 Retries는 추가 시도 횟수예요. TCP 재시도는 새 트랜잭션 ID를 쓰고, 오래되었거나 중복된 응답은 버려져요.

타입 예외

EsgcModbusException은 ExceptionCode와 FunctionCode를 담고, EsgcModbusTimeout은 응답이 없음을 알리며, EsgcModbusError는 닫힌 연결, 포트 문제, RTU CRC 오류를 다뤄요.

게이트웨이와 유닛 ID

모든 메서드에 맨 앞에 byte aUnitId가 붙은 오버로드가 있어서, 게이트웨이에 연결한 TCP 연결 하나로 그 뒤의 모든 장치에 접근할 수 있어요.

TLS, 프록시, 재연결

TLS, TLSOptions, Proxy, WatchDog는 아래의 sgcWebSockets TCP 클라이언트로 전달되므로, Modbus TCP도 라이브러리의 다른 부분과 같은 TLS 스택, 프록시 지원, 자동 재연결을 사용해요.

RTU 프레이밍

RTU 클라이언트는 전송 전에 3.5 문자 무음 구간을 기다리고, 예상 길이만큼 응답을 읽고, 모든 프레임의 CRC를 검사하고, 다른 슬레이브 주소의 프레임은 무시해요. 유닛 ID 0은 브로드캐스트 쓰기를 보내고 응답 대신 TurnaroundDelay를 기다려요.

RS-485 방향

RtsControl = TsgcSerialRtsControl.srcToggle이면 시리얼 포트는 쓰기마다 RTS를 올리고 출력 버퍼가 비워지면 내려요. .NET에서는 이것이 소프트웨어로 타이밍되므로, 엄격한 버스 타이밍이 필요하면 방향을 자동 제어하는 어댑터를 권장해요.

이벤트

OnConnect, OnDisconnect, OnError는 NotifyEvents를 통해 발생한 순서대로 전달돼요. 연결에 실패해도 예외를 던지지 않아요. 대신 OnError가 발생하고 Active는 false로 유지돼요.

C#의 Modbus TCP 및 RTU 서버

데이터베이스나 클라우드 값을 SCADA 시스템에 노출하는 게이트웨이, 하드웨어 없이 HMI 화면을 테스트하는 시뮬레이터, 또는 내 장치의 Modbus 인터페이스를 만들어 보세요. 각 서버는 네 개의 테이블(코일, 디스크리트 입력, 홀딩 레지스터, 입력 레지스터, 기본 각 10,000개 항목, 최대 65,536개)과 FC 43/14용 식별 문자열, FC 07용 예외 상태를 가진 TsgcModbusDataModel을 소유해요. 데이터 모델의 모든 멤버는 스레드 안전해요.

OnReadRequest는 테이블을 읽기 전에 실행되므로 값을 갱신하거나 예외 코드로 응답할 수 있어요. OnWriteRequest는 값을 저장하기 전에 받아서 바꾸거나 쓰기를 거부할 수 있고, 거부하면 테이블은 그대로 유지돼요. 둘 다 락을 잡지 않은 채 요청을 처리하는 서버 스레드(TCP 연결 또는 RTU 프레임 리더)에서 실행돼요.

TsgcModbusTCPServer

많은 동시 연결, 도착 순서대로 응답하는 요청, 분할된 요청의 재조립, 잘못된 헤더는 OnError와 함께 연결 종료. UnitId = 0은 모든 유닛 ID에 응답해요. Bindings로 엔드포인트를 선택하고, Port = 0은 빈 포트를 고르며, OnClientConnect와 OnClientDisconnect는 피어를 알려 줘요.

TsgcModbusRTUServer

TsgcSerialPort에서 슬레이브 UnitId(1~247)로 응답하고, 길이와 3.5 문자 무음으로 요청을 프레이밍하고, 잘못된 CRC와 다른 주소는 무시하고, 브로드캐스트 쓰기는 응답 없이 실행해요.

양방향으로 테스트했어요

.NET 클라이언트와 서버는 TCP에서 pymodbus에 대해, 그리고 sgcWebSockets Delphi Modbus 컴포넌트에 대해 같은 상호 운용성 검사를 통과했고, 각 방향에서 35개 중 35개가 성공했어요.

sgcWebSockets Enterprise에 포함

Modbus와 시리얼 포트 컴포넌트는 다른 sgcWebSockets .NET 패키지와 함께 esegece.sgcIndustrial 패키지로 sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access에 포함돼요. 에디션은 가격 페이지(.NET 탭) 또는 .NET 기능 매트릭스에서 비교해 보세요.

C# Modbus FAQ

TsgcModbusTCPClient를 만들고 Host, Port, UnitId를 설정한 다음 Active = true로 지정하고 ReadHoldingRegisters(address, count)를 호출하세요. 레지스터당 값 하나가 담긴 ushort[]를 반환해요. 주소는 전송선에서 쓰는 방식 그대로 0부터 시작해요.

홀딩 레지스터는 ReadFloat32(address), 입력 레지스터는 ReadInputFloat32(address)를 호출하세요. 숫자가 이상하면 장치가 두 레지스터를 다른 순서로 저장한 것이므로 WordOrder를 mwoCDAB, mwoBADC, mwoDCBA 중 하나로 설정하세요.

네. RS-485 어댑터에서 TsgcSerialPort를 열고 TsgcModbusRTUClient.SerialPort 또는 TsgcModbusRTUServer.SerialPort에 지정하세요. 방향을 자동 제어하는 어댑터를 쓰거나, RTS로 전환하는 어댑터에는 RtsControl을 srcToggle로 설정하세요.

네. TsgcModbusTCPServer를 만들고, SetHoldingRegister, SetCoil 등의 세터로 DataModel을 채운 다음 Active = true로 지정하세요. 필요할 때 값을 계산하거나 Modbus 예외 코드로 쓰기를 거부하려면 OnReadRequest와 OnWriteRequest를 처리하세요.

아니요, 클라이언트 메서드는 동기식이며 스레드 안전해요. 워커 스레드에서 호출하거나 Task.Run으로 감싸세요. 여러 스레드나 태스크가 클라이언트 하나를 공유할 수 있고, 각 호출은 자기 응답을 기다려요.

esegece.sgcIndustrial 패키지는 .NET 8, .NET 9, .NET 10, .NET Standard 2.0을 대상으로 해요. 시리얼 포트는 System.IO.Ports를 사용하므로, Modbus RTU는 해당 패키지가 시리얼 포트를 열 수 있는 플랫폼이 필요해요.

Modbus와 시리얼 포트 컴포넌트는 sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access, 또는 독립형 sgcIndustrial 팩에 포함돼요.

sgcWebSockets .NET 더 알아보기

산업용 컴포넌트

시리얼 포트, Modbus, OPC UA와 전체 컴포넌트 레퍼런스예요.

C# OPC UA 클라이언트

같은 .NET 애플리케이션에서 Modbus 장치와 함께 OPC UA 서버를 읽고, 쓰고, 구독해 보세요.

C# MQTT 클라이언트

같은 애플리케이션에서 Modbus 측정값을 MQTT 브로커로 게시해 보세요.

C# WebSocket 라이브러리

실시간 장치 데이터를 보여 주는 대시보드를 위한 WebSocket 클라이언트와 서버예요.

Delphi와 C++Builder에서도 쓸 수 있어요

같은 클래스 이름과 메서드를 가진 동일한 Modbus 컴포넌트를 Delphi 7~Delphi 13에서 쓸 수 있어요.

최고의 가성비: All-Access모든 eSeGeCe 제품과 프리미엄 지원이 포함되어 연 €1,059부터 이용할 수 있어요.
All-Access 가격 보기

C#으로 첫 Modbus 레지스터를 읽어 보세요

sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access, 또는 독립형 sgcIndustrial 팩에 포함.