Modbus TCP 및 RTU 서버

Delphi, C++Builder, .NET 애플리케이션을 Modbus 장치로 만드세요. 스레드 안전 데이터 모델에서 TCP/IP 또는 시리얼 회선을 통해 SCADA 시스템, HMI, Modbus 클라이언트에 응답해요.

신규

TsgcModbusTCPServer와 TsgcModbusRTUServer

같은 TsgcModbusDataModel에서 응답하는 두 서버: 하나는 TCP 포트 502에서 수신하고, 다른 하나는 시리얼 회선의 Modbus RTU 슬레이브예요.

컴포넌트 클래스

TsgcModbusTCPServer
TsgcModbusRTUServer
TsgcModbusDataModel

프로토콜

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

플랫폼

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

에디션

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

Modbus TCP 서버 시작하기

데이터 모델을 채우고, 이벤트를 연결하고, Active를 True로 설정해요. OnReadRequest는 읽기 직전에 실시간 값을 갱신하고, OnWriteRequest는 범위를 벗어난 설정값을 거부해요.

uses
  sgcIndustrial;

procedure TForm1.StartServer;
begin
  FServer := TsgcModbusTCPServer.Create(Self);
  FServer.Port := 502;
  FServer.DataModel.HoldingRegisterCount := 1000;
  FServer.DataModel.SetHoldingRegister(0, 1234);
  FServer.DataModel.SetCoil(5, True);
  FServer.DataModel.VendorName := 'eSeGeCe';
  FServer.DataModel.ProductCode := 'PLC-1';
  FServer.DataModel.MajorMinorRevision := '1.0';
  FServer.OnReadRequest := OnModbusReadRequest;
  FServer.OnWriteRequest := OnModbusWriteRequest;
  FServer.Active := True;
end;

procedure TForm1.OnModbusReadRequest(Sender: TObject; aUnitId,
  aFunctionCode: Byte; aAddress, aCount: Word; var aExceptionCode: Byte);
begin
  // live value: refresh input register 0 before the client reads it
  if aFunctionCode = CS_MODBUS_FC_READ_INPUT_REGISTERS then
    FServer.DataModel.SetInputRegister(0, FTemperature);
end;

procedure TForm1.OnModbusWriteRequest(Sender: TObject; aUnitId,
  aFunctionCode: Byte; aAddress, aCount: Word; var aBits: TsgcModbusBits;
  var aRegisters: TsgcModbusRegisters; var aExceptionCode: Byte);
var
  i: Integer;
begin
  // connection thread: setpoints accept 0..1000 only
  if (aFunctionCode = CS_MODBUS_FC_WRITE_SINGLE_REGISTER) or
    (aFunctionCode = CS_MODBUS_FC_WRITE_MULTIPLE_REGISTERS) then
    for i := 0 to Length(aRegisters) - 1 do
      if aRegisters[i] > 1000 then
      begin
        aExceptionCode := CS_MODBUS_EX_ILLEGAL_DATA_VALUE;
        Exit;
      end;
end;
#include "sgcIndustrial.hpp"

void __fastcall TForm1::StartServer()
{
  FServer = new TsgcModbusTCPServer(this);
  FServer->Port = 502;
  FServer->DataModel->HoldingRegisterCount = 1000;
  FServer->DataModel->SetHoldingRegister(0, 1234);
  FServer->DataModel->SetCoil(5, true);
  FServer->DataModel->VendorName = "eSeGeCe";
  FServer->DataModel->ProductCode = "PLC-1";
  FServer->DataModel->MajorMinorRevision = "1.0";
  FServer->OnReadRequest = OnModbusReadRequest;
  FServer->OnWriteRequest = OnModbusWriteRequest;
  FServer->Active = true;
}

void __fastcall TForm1::OnModbusReadRequest(TObject *Sender, Byte aUnitId,
  Byte aFunctionCode, Word aAddress, Word aCount, Byte &aExceptionCode)
{
  // live value: refresh input register 0 before the client reads it
  if (aFunctionCode == CS_MODBUS_FC_READ_INPUT_REGISTERS)
    FServer->DataModel->SetInputRegister(0, FTemperature);
}

void __fastcall TForm1::OnModbusWriteRequest(TObject *Sender, Byte aUnitId,
  Byte aFunctionCode, Word aAddress, Word aCount, TsgcModbusBits &aBits,
  TsgcModbusRegisters &aRegisters, Byte &aExceptionCode)
{
  // connection thread: setpoints accept 0..1000 only
  if ((aFunctionCode == CS_MODBUS_FC_WRITE_SINGLE_REGISTER) ||
      (aFunctionCode == CS_MODBUS_FC_WRITE_MULTIPLE_REGISTERS))
    for (int i = 0; i < aRegisters.Length; i++)
      if (aRegisters[i] > 1000)
      {
        aExceptionCode = CS_MODBUS_EX_ILLEGAL_DATA_VALUE;
        return;
      }
}
using System;
using esegece.sgcWebSockets;

class PlcServer
{
    TsgcModbusTCPServer FServer = new TsgcModbusTCPServer();
    ushort FTemperature = 215;

    public void StartServer()
    {
        FServer.Port = 502;
        FServer.DataModel.HoldingRegisterCount = 1000;
        FServer.DataModel.SetHoldingRegister(0, 1234);
        FServer.DataModel.SetCoil(5, true);
        FServer.DataModel.VendorName = "eSeGeCe";
        FServer.DataModel.ProductCode = "PLC-1";
        FServer.DataModel.MajorMinorRevision = "1.0";
        FServer.OnReadRequest += OnModbusReadRequest;
        FServer.OnWriteRequest += OnModbusWriteRequest;
        FServer.Active = true;
    }

    void OnModbusReadRequest(object Sender, byte aUnitId, byte aFunctionCode,
        ushort aAddress, ushort aCount, ref byte aExceptionCode)
    {
        // live value: refresh input register 0 before the client reads it
        if (aFunctionCode == sgcModbus_Classes.CS_MODBUS_FC_READ_INPUT_REGISTERS)
            FServer.DataModel.SetInputRegister(0, FTemperature);
    }

    void OnModbusWriteRequest(object Sender, byte aUnitId, byte aFunctionCode,
        ushort aAddress, ushort aCount, ref bool[] aBits, ref ushort[] aRegisters,
        ref byte aExceptionCode)
    {
        // connection thread: setpoints accept 0..1000 only
        if (aFunctionCode == sgcModbus_Classes.CS_MODBUS_FC_WRITE_SINGLE_REGISTER ||
            aFunctionCode == sgcModbus_Classes.CS_MODBUS_FC_WRITE_MULTIPLE_REGISTERS)
            foreach (ushort vValue in aRegisters)
                if (vValue > 1000)
                {
                    aExceptionCode = sgcModbus_Classes.CS_MODBUS_EX_ILLEGAL_DATA_VALUE;
                    return;
                }
    }
}

내부 구성

컴포넌트 하나로 만드는 Modbus 장치: 서버가 요청을 파싱하고, 검사하고, 데이터 모델에서 응답해요.

기능 코드

01~08(08은 서브 기능 0), 15, 16, 22(마스크 쓰기, 원자적으로 적용), 23(여러 레지스터 읽기/쓰기), 43/14(장치 식별, More Follows로 페이징).

데이터 모델

코일, 이산 입력, 홀딩 레지스터, 입력 레지스터를 각각 기본 10000개, 최대 65536개까지 제공해요. 모든 Get 및 Set 메서드는 스레드 안전하며, 테이블 범위를 벗어난 요청에는 예외 02가 반환돼요.

읽기 및 쓰기 이벤트

OnReadRequest는 데이터를 읽기 전에 발생하여 실시간 값을 불러와요. OnWriteRequest는 데이터를 쓰기 전에 발생하여 값을 바꾸거나 Modbus 예외 코드로 요청을 거부할 수 있어요.

연결

각 TCP 연결은 독립적으로 처리되며, 한 패킷에 담긴 여러 요청은 순서대로 응답해요. 잘못된 헤더는 OnError를 발생시키고 해당 연결을 닫아요. OnClientConnect와 OnClientDisconnect가 피어를 알려 줘요.

유닛 ID

기본적으로 TCP 서버는 모든 유닛 ID에 응답해요. UnitId를 설정하면 해당 ID에만 응답해요. 다른 ID의 요청에는 응답이 없고 연결은 유지되며, 이는 게이트웨이가 없는 장치를 처리하는 방식과 같아요.

장치 식별

VendorName, ProductCode, MajorMinorRevision이 기본 객체이고, VendorUrl, ProductName, ModelName이 일반 객체이며, 기능 43/14에 응답해요.

RS-232 및 RS-485 RTU 슬레이브

TsgcSerialPort를 연결하고 UnitId(1~247)에 슬레이브 주소를 설정해요. 서버는 시작할 때 포트를 열고 데이터 모델에서 응답해요.

procedure TForm1.StartRTUServer;
begin
  FPort := TsgcSerialPort.Create(Self);
  FPort.Port := 'COM5';
  FPort.BaudRate := 19200;
  FPort.Parity := spEven;

  FRTUServer := TsgcModbusRTUServer.Create(Self);
  FRTUServer.SerialPort := FPort;
  FRTUServer.UnitId := 17;
  FRTUServer.DataModel.SetInputRegister(0, 215);
  // the server opens the port when it is closed
  FRTUServer.Active := True;
end;
void __fastcall TForm1::StartRTUServer()
{
  FPort = new TsgcSerialPort(this);
  FPort->Port = "COM5";
  FPort->BaudRate = 19200;
  FPort->Parity = spEven;

  FRTUServer = new TsgcModbusRTUServer(this);
  FRTUServer->SerialPort = FPort;
  FRTUServer->UnitId = 17;
  FRTUServer->DataModel->SetInputRegister(0, 215);
  // the server opens the port when it is closed
  FRTUServer->Active = true;
}
using System;
using esegece.sgcWebSockets;

class RtuSlave
{
    TsgcSerialPort FPort = new TsgcSerialPort();
    TsgcModbusRTUServer FRTUServer = new TsgcModbusRTUServer();

    public void StartRTUServer()
    {
        FPort.Port = "COM5";
        FPort.BaudRate = 19200;
        FPort.Parity = TsgcSerialParity.spEven;

        FRTUServer.SerialPort = FPort;
        FRTUServer.UnitId = 17;
        FRTUServer.DataModel.SetInputRegister(0, 215);
        // the server opens the port when it is closed
        FRTUServer.Active = true;
    }
}

사양 및 참고문헌

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

Modbus 서버 관련 질문

TCP 연결을 처리하는 스레드, 또는 RTU 서버의 프레임 스레드에서 실행돼요. 서버가 응답을 만들려면 핸들러의 결과가 필요하므로 메인 스레드와 동기화되지 않아요. 이벤트에서 사용자 인터페이스에 직접 접근하지 말고, TCP 서버의 이벤트 핸들러에서 Active를 False로 설정하지 마세요.

값이 바뀔 때마다 데이터 모델에 쓰거나, 매 읽기 전에 기능 코드, 주소, 개수와 함께 발생하는 OnReadRequest에서 불러오세요. 데이터 모델 메서드는 이벤트 안에서도, 다른 어떤 스레드에서도 호출할 수 있어요.

OnWriteRequest에서 aExceptionCode를 설정하세요. 예를 들어 CS_MODBUS_EX_ILLEGAL_DATA_VALUE(03)로 설정해요. 클라이언트는 해당 Modbus 예외를 받고 테이블은 변경되지 않아요. 이벤트에서 값을 쓰기 전에 바꿀 수도 있어요.

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

문서 및 데모

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

Online Help: TsgcModbusTCPServer Modbus TCP 서버의 전체 속성, 메서드, 이벤트 레퍼런스예요.
Online Help: TsgcModbusRTUServer Modbus RTU 서버의 전체 속성, 메서드, 이벤트 레퍼런스예요.
Online Help: TsgcModbusDataModel 테이블, 장치 식별 객체, 데이터 모델의 이벤트.
데모 프로젝트: Industrial\03.Modbus_TCP_Server 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 팩에 포함.