Modbus TCP 및 RTU 클라이언트

Delphi, C++Builder, .NET에서 TCP/IP 또는 RS-232, RS-485 시리얼 회선을 통해 PLC, 전력량계, 드라이브의 코일과 레지스터를 읽고 써요.

신규

TsgcModbusTCPClient와 TsgcModbusRTUClient

메서드가 같은 두 클라이언트: 하나는 Modbus TCP 장치나 게이트웨이에 연결하고, 다른 하나는 시리얼 회선의 Modbus RTU 마스터예요.

컴포넌트 클래스

TsgcModbusTCPClient
TsgcModbusRTUClient

프로토콜

Modbus Application Protocol V1.1b3, Modbus TCP 및 Modbus RTU

플랫폼

TCP: sgcWebSockets의 모든 플랫폼. RTU: Windows, Linux, macOS

에디션

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

Modbus TCP로 연결하고, 읽고, 쓰기

Host와 UnitId를 설정하고, Active를 True로 지정한 다음 메서드를 호출해요. 각 요청은 대응하는 응답이 도착할 때까지 블로킹되며, 장치가 오류를 보고하거나 응답하지 않으면 예외를 발생시켜요.

uses
  sgcIndustrial;

procedure TForm1.ConnectClient;
begin
  FClient := TsgcModbusTCPClient.Create(Self);
  FClient.Host := '192.168.1.50';
  FClient.Port := 502;
  FClient.UnitId := 1;
  FClient.Timeout := 1000;
  FClient.Retries := 2;
  FClient.OnConnect := OnModbusConnect;
  FClient.OnError := OnModbusError;
  FClient.Active := True;
end;

procedure TForm1.OnModbusConnect(Sender: TObject);
begin
  Memo1.Lines.Add('Connected');
end;

procedure TForm1.ReadValues;
var
  vRegisters: TsgcModbusRegisters;
  vTemperature: Single;
begin
  try
    vRegisters := FClient.ReadHoldingRegisters(0, 10);
    FClient.WriteSingleCoil(10, True);
    // 32-bit float stored low word first by many PLCs
    FClient.WordOrder := mwoCDAB;
    vTemperature := FClient.ReadFloat32(300);
    Memo1.Lines.Add(Format('HR0 = %d, temperature = %.1f',
      [vRegisters[0], vTemperature]));
  except
    on E: EsgcModbusException do
      Memo1.Lines.Add(Format('Device exception %d', [E.ExceptionCode]));
    on E: EsgcModbusTimeout do
      Memo1.Lines.Add('No response');
  end;
end;

procedure TForm1.OnModbusError(Sender: TObject; const aError: string);
begin
  Memo1.Lines.Add('Error: ' + aError);
end;
#include "sgcIndustrial.hpp"

void __fastcall TForm1::ConnectClient()
{
  FClient = new TsgcModbusTCPClient(this);
  FClient->Host = "192.168.1.50"; // Port is 502 by default
  FClient->UnitId = 1;
  FClient->Timeout = 1000;
  FClient->Retries = 2;
  FClient->OnConnect = OnModbusConnect;
  FClient->OnError = OnModbusError;
  FClient->Active = true;
}

void __fastcall TForm1::OnModbusConnect(TObject *Sender)
{
  Memo1->Lines->Add("Connected");
}

void __fastcall TForm1::ReadValues()
{
  try
  {
    TsgcModbusRegisters vRegisters = FClient->ReadHoldingRegisters(0, 10);
    FClient->WriteSingleCoil(10, true);
    // 32-bit float stored low word first by many PLCs
    FClient->WordOrder = mwoCDAB;
    float vTemperature = FClient->ReadFloat32(300);
    Memo1->Lines->Add("HR0 = " + IntToStr(vRegisters[0]) + ", temperature = " +
      FloatToStrF(vTemperature, ffFixed, 7, 1));
  }
  catch (EsgcModbusException &E)
  {
    Memo1->Lines->Add("Device exception " + IntToStr(E.ExceptionCode));
  }
  catch (EsgcModbusTimeout &E)
  {
    Memo1->Lines->Add("No response");
  }
}

void __fastcall TForm1::OnModbusError(TObject *Sender, const String aError)
{
  Memo1->Lines->Add("Error: " + aError);
}
using System;
using esegece.sgcWebSockets;

class PlcClient
{
    TsgcModbusTCPClient FClient = new TsgcModbusTCPClient();

    public void ConnectClient()
    {
        FClient.Host = "192.168.1.50";
        FClient.Port = 502;
        FClient.UnitId = 1;
        FClient.Timeout = 1000;
        FClient.Retries = 2;
        FClient.OnConnect += OnModbusConnect;
        FClient.OnError += OnModbusError;
        FClient.Active = true;
    }

    void OnModbusConnect(object Sender, EventArgs e)
    {
        Console.WriteLine("Connected");
    }

    public void ReadValues()
    {
        try
        {
            ushort[] vRegisters = FClient.ReadHoldingRegisters(0, 10);
            FClient.WriteSingleCoil(10, true);
            // 32-bit float stored low word first by many PLCs
            FClient.WordOrder = TsgcModbusWordOrder.mwoCDAB;
            float vTemperature = FClient.ReadFloat32(300);
            Console.WriteLine($"HR0 = {vRegisters[0]}, temperature = {vTemperature:F1}");
        }
        catch (EsgcModbusException E)
        {
            Console.WriteLine("Device exception " + E.ExceptionCode);
        }
        catch (EsgcModbusTimeout)
        {
            Console.WriteLine("No response");
        }
    }

    void OnModbusError(object Sender, string aError)
    {
        Console.WriteLine("Error: " + aError);
    }
}

내부 구성

Modbus의 프레이밍, 타이밍, 오류 처리는 컴포넌트가 수행하므로, 코드는 주소와 값만 다루면 돼요.

기능 코드

01~06, 15, 16, 22(마스크 쓰기), 23(여러 레지스터 읽기/쓰기), 43/14(장치 식별, 페이징 지원). RTU 클라이언트는 07(예외 상태 읽기)과 08(진단)을 추가로 지원해요.

타입 값

ReadInt32, ReadUInt32, ReadFloat32, ReadString과 대응하는 쓰기 메서드, 그리고 입력 레지스터 읽기. WordOrder로 장치에 맞는 ABCD, DCBA, BADC, CDAB를 선택해요.

스레드 안전 요청

어떤 스레드에서도 메서드를 호출할 수 있어요. 요청은 직렬화되고 모든 응답은 트랜잭션 ID로 대응돼요. Timeout은 각 시도에 적용되고, Retries는 시도 횟수를 늘려요.

명확한 오류

Modbus 예외 응답은 예외 코드와 기능 코드를 담은 EsgcModbusException을 발생시키고, 무응답은 EsgcModbusTimeout을, 그 밖의 모든 문제는 EsgcModbusError를 발생시켜요. 사양을 벗어난 수량은 아무것도 전송하기 전에 거부돼요.

TLS, 프록시, 재연결

TCP 클라이언트는 TLS, Proxy, 자동 재연결을 위한 WatchDog를 지원해요. 연결이 끊길 때 대기 중이던 요청은 타임아웃을 기다리지 않고 즉시 예외를 발생시켜요.

게이트웨이와 유닛 ID

모든 메서드에는 앞에 유닛 ID를 받는 오버로드가 있으므로, UnitId를 바꾸지 않고도 하나의 TCP 연결로 Modbus TCP-RTU 게이트웨이 뒤의 모든 장치에 접근할 수 있어요.

RS-232 및 RS-485 RTU 마스터

TsgcSerialPort를 열고 SerialPort로 연결한 다음 UnitId에 슬레이브 주소를 설정해요. 클라이언트가 CRC16이 포함된 RTU 프레임을 만들고 슬레이브를 기다려요.

procedure TForm1.ReadSlave;
var
  vRegisters: TsgcModbusRegisters;
begin
  FPort := TsgcSerialPort.Create(Self);
  FPort.Port := 'COM4';
  FPort.BaudRate := 19200;
  FPort.Parity := spEven;
  FPort.Open;

  FRTU := TsgcModbusRTUClient.Create(Self);
  FRTU.SerialPort := FPort;
  FRTU.UnitId := 17;
  FRTU.Timeout := 500;
  FRTU.Retries := 2;
  vRegisters := FRTU.ReadHoldingRegisters(107, 3);
  Memo1.Lines.Add(Format('Register 107 = %d', [vRegisters[0]]));

  // unit id 0 = broadcast: every slave executes the write, none answers
  FRTU.WriteSingleRegister(0, 1, 100);
end;
void __fastcall TForm1::ReadSlave()
{
  FPort = new TsgcSerialPort(this);
  FPort->Port = "COM4";
  FPort->BaudRate = 19200;
  FPort->Parity = spEven;
  FPort->Open();

  FRTU = new TsgcModbusRTUClient(this);
  FRTU->SerialPort = FPort;
  FRTU->UnitId = 17;
  FRTU->Timeout = 500;
  FRTU->Retries = 2;
  TsgcModbusRegisters vRegisters = FRTU->ReadHoldingRegisters(107, 3);
  Memo1->Lines->Add("Register 107 = " + IntToStr(vRegisters[0]));

  // unit id 0 = broadcast: every slave executes the write, none answers
  FRTU->WriteSingleRegister(0, 1, 100);
}
using System;
using esegece.sgcWebSockets;

class RtuMaster
{
    TsgcSerialPort FPort = new TsgcSerialPort();
    TsgcModbusRTUClient FRTU = new TsgcModbusRTUClient();

    public void ReadSlave()
    {
        FPort.Port = "COM4";
        FPort.BaudRate = 19200;
        FPort.Parity = TsgcSerialParity.spEven;
        FPort.Open();

        FRTU.SerialPort = FPort;
        FRTU.UnitId = 17;
        FRTU.Timeout = 500;
        FRTU.Retries = 2;
        ushort[] vRegisters = FRTU.ReadHoldingRegisters(107, 3);
        Console.WriteLine("Register 107 = " + vRegisters[0]);

        // unit id 0 = broadcast: every slave executes the write, none answers
        FRTU.WriteSingleRegister(0, 1, 100);
    }
}

사양 및 참고문헌

이 컴포넌트가 구현하는 프로토콜의 공식 출처예요.

Modbus 클라이언트 관련 질문

메서드는 0부터 시작하는 프로토콜 주소를 받아요. 많은 매뉴얼에서 40001로 문서화한 레지스터는 홀딩 레지스터 0이므로, ReadHoldingRegisters(0, 1)을 호출하세요.

두 레지스터 중 첫 번째 주소로 ReadFloat32를 호출하세요. 값이 이상하면 장치가 바이트를 다른 순서로 저장하는 것이므로, WordOrder를 장치가 사용하는 순서로 설정하세요. 많은 PLC가 하위 워드를 먼저 저장하며, 이는 mwoCDAB이에요.

각 시도는 Timeout 밀리초 동안 기다려요. 유효한 응답 없이 Retries + 1회 시도하면 요청은 EsgcModbusTimeout을 발생시키며, 메시지에 기능 코드, 유닛 ID, 시도 횟수가 포함돼요.

아니요. TsgcSerialPort를 직접 열고 OnData 이벤트는 비워 두세요. 클라이언트가 Read로 응답을 읽기 때문이에요. 포트가 지정되지 않았거나, 열려 있지 않거나, OnData가 지정되어 있으면 요청은 EsgcModbusError를 발생시켜요.

sgcIndustrial 팩의 일부로 sgcWebSockets Enterprise(Delphi 및 .NET)와 All-Access에 포함돼요. Delphi에서는 uses 절에 sgcIndustrial을 추가하세요.

문서 및 데모

컴포넌트 레퍼런스로 바로 이동하고, 데모 프로젝트를 열고, 기술 문서를 읽어 보세요.

Online Help: TsgcModbusTCPClient Modbus TCP 클라이언트의 전체 속성, 메서드, 이벤트 레퍼런스예요.
Online Help: TsgcModbusRTUClient Modbus RTU 클라이언트의 전체 속성, 메서드, 이벤트 레퍼런스예요.
데모 프로젝트: Industrial\02.Modbus_TCP_Client Delphi, C++Builder, .NET용 Modbus TCP 클라이언트. sgcWebSockets 패키지에 포함되어 있어요.
기술 문서 (PDF) 이 컴포넌트만을 위한 기능, 빠른 시작, 코드 샘플, 1차 자료 레퍼런스.
사용자 매뉴얼 (PDF) 라이브러리의 모든 컴포넌트를 다루는 종합 매뉴얼이에요.
최고의 가성비: All-Access모든 eSeGeCe 제품과 프리미엄 지원이 포함되어 연 €1,059부터 이용할 수 있어요.
All-Access 가격 보기

sgcWebSockets Enterprise에 포함

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