Vagabond K Protocol Library

Modbus RTU/ASCII/TCP 프로토콜, LS ELECTRIC(구 LS산전)의 Cnet, FEnet 프로토콜 등으로 장치와 통신하는 기능들을 구현했습니다.

Documentation

VagabondK.Protocols.Abstractions

여러 프로토콜에 대한 추상 형식들과, 기본적인 Logging 관련 기능들을 제공합니다.

Console 기반 Logger 설정 예시

using VagabondK.Protocols.Logging;
using VagabondK.Protocols.Channels;

...

TcpChannel channel = new TcpChannel("127.0.0.1", 502)
{
    Logger = new ConsoleChannelLogger()
};

VagabondK.Protocols.Channels

여러 프로토콜들에 사용되는 Communication Channel 관련 기능들을 제공합니다.
기본적인 TCP 및 UDP Socket 기반 Channel을 구현합니다.

TCP Client Channel 생성 예시

var tcpChannel = new TcpChannel("127.0.0.1", 502);

TCP Server Channel 생성 예시

var tcpChannelProvider = new TcpChannelProvider(502);

UDP Channel 생성 예시

var udpChannel = new UdpChannel("127.0.0.1", 502);

Local port가 포함된 UDP 수신 Channel 생성 예시

var udpChannelProvider = new UdpChannelProvider(502);

VagabondK.Protocols.Channels.SerialPort

Serial Port 기반 Communication Channel 관련 기능들을 제공합니다.

Serial Port Channel 생성 예시

var serialPortChannel = new SerialPortChannel("COM3", 9600, 8, StopBits.One, Parity.None, Handshake.None);

VagabondK.Protocols.Modbus

Modbus RTU, TCP, ASCII 등의 직렬화 기능을 제공하고, Modbus Master와 Modbus Slave를 구현할 수 있습니다.

또한 Modbus Master와 Modbus Slave 모두 VagabondK.Protocols.Channels 패키지의 TCP Server/Clinet Channel을 사용할 수 있으며, UDP Socket Channel도 사용 가능합니다. 그리고 VagabondK.Protocols.Channels.SerialPort 패키지를 이용하면, Serial Port 기반으로도 통신이 가능해집니다.

Modbus Master 읽기 요청 예시

using System;
using VagabondK.Protocols.Channels;
using VagabondK.Protocols.Modbus;
using VagabondK.Protocols.Modbus.Data;
using VagabondK.Protocols.Modbus.Serialization;

class Program
{
    static void Main(string[] args)
    {
        TcpChannel channel = new TcpChannel("127.0.0.1", 502);

        ModbusMaster modbusMaster = new ModbusMaster(channel, new ModbusTcpSerializer());

        var response = modbusMaster.ReadInputRegisters(1, 100, 8);

        int int_ABCD = response.GetInt32(100);
        int int_DCBA = response.GetInt32(102, ModbusEndian.AllLittle);
        int int_BADC = response.GetInt32(104, ModbusEndian.OuterBig);
        int int_CDAB = response.GetInt32(106, ModbusEndian.InnerBig);

        Console.WriteLine(int_ABCD);
        Console.WriteLine(int_DCBA);
        Console.WriteLine(int_BADC);
        Console.WriteLine(int_CDAB);
    }
}

Modbus Master 쓰기 요청 예시

using VagabondK.Protocols.Channels;
using VagabondK.Protocols.Modbus;
using VagabondK.Protocols.Modbus.Serialization;

class Program
{
    static void Main(string[] args)
    {
        TcpChannel channel = new TcpChannel("127.0.0.1", 502);

        ModbusMaster modbusMaster = new ModbusMaster(channel, new ModbusTcpSerializer());

        modbusMaster.Write(1, 100, (ushort)12345);
    }
}

Modbus Slave 구현 예시

using System;
using VagabondK.Protocols.Channels;
using VagabondK.Protocols.Logging;
using VagabondK.Protocols.Modbus;
using VagabondK.Protocols.Modbus.Serialization;

class Program
{
    static void Main(string[] args)
    {
        TcpChannelProvider channel = new TcpChannelProvider(502)
        {
            Logger = new ConsoleChannelLogger() //Logger에 콘솔 기반 Logger를 설정
        };

        var modbusSlaveService = new ModbusSlaveService(channel, new ModbusTcpSerializer());

        var modbusSlave = new ModbusSlave();
        modbusSlaveService[1] = modbusSlave;
        modbusSlave.InputRegisters[100] = 1234;  //Input Register 100에 1234 설정

        channel.Start();
        Console.ReadKey();
        channel.Stop();
    }
}

VagabondK.Protocols.LSElectric

LS ELECTRIC(구 LS산전)의 PLC 제품들과 Cnet, FEnet 프로토콜 기반으로 통신하는 기능들을 제공합니다.
Cnet I/F 모듈, FEnet I/F 모듈, MASTER-K PLC 등과 통신할 수 있습니다.

Cnet 프로토콜의 경우 통신 채널은 주로 Serial Port Channel을 사용하지만, Serial Device Server(Serial to Ethernet Converter) 등의 장치를 이용해 통신할 경우에는 TCP 및 UDP 기반 Channel로도 통신할 수 있습니다.

FEnet 프로토콜은 TCP 및 UDP 기반 Channel로 통신 가능하며 기본적인 포트로 TCP는 2004, UDP는 2005를 사용합니다.

Cnet 프로토콜 기반 Read, Write, Monitor 사용 예시

using System;
using System.IO.Ports;
using VagabondK.Protocols.Channels;
using VagabondK.Protocols.LSElectric.Cnet;

class Program
{
    static void Main(string[] args)
    {
        CnetClient client = new CnetClient(new SerialPortChannel("COM4", 9600, 8, StopBits.One, Parity.None, Handshake.None));

        foreach (var item in client.Read(1, "%MW100", "%MW200"))
            Console.WriteLine($"변수: {item.Key}, 값: {item.Value.WordValue}");
            
        foreach (var item in client.Read(1, "%MW100", 5))
            Console.WriteLine($"변수: {item.Key}, 값: {item.Value.WordValue}");
            
        client.Write(1, ("%MW102", 10), ("%MW202", 20));
        
        client.Write(1, "%MW300", 10, 20);
        
        var monitorExecute1 = client.RegisterMonitor(1, 1, "%MW100", "%MW200");
        foreach (var item in client.Read(monitorExecute1))
            Console.WriteLine($"변수: {item.Key}, 값: {item.Value.WordValue}");
            
        var monitorExecute2 = client.RegisterMonitor(1, 2, "%MW100", 5);
        foreach (var item in client.Read(monitorExecute2))
            Console.WriteLine($"변수: {item.Key}, 값: {item.Value.WordValue}");
    }
}

FEnet 프로토콜 기반 Read, Write 실행 예시

using System;
using System.Linq;
using VagabondK.Protocols.Channels;
using VagabondK.Protocols.LSElectric;
using VagabondK.Protocols.LSElectric.FEnet;

class Program
{
    static void Main(string[] args)
    {
        FEnetClient client = new FEnetClient(new TcpChannel("127.0.0.1", 2004));

        foreach (var item in client.Read("%MW100", "%MW200"))
            Console.WriteLine($"변수: {item.Key}, 값: {item.Value.WordValue}");

        var bytes = client.Read(DeviceType.M, 200, 10).ToArray();
        for (int i = 0; i < bytes.Length; i+=2)
            Console.WriteLine($"변수: %MW{100 + i / 2}, 값: {BitConverter.ToInt16(bytes, i)}");

        client.Write(("%MW102", 10), ("%MW202", 20));

        client.Write(DeviceType.M, 600, 10, 0, 20, 0);
    }
}

BadaProject / VagabondK.Protocols