DBI.Drivers.Omron 1.0.0

DBI.Drivers.Omron

Thư viện giao tiếp PLC Omron qua giao thức FINS (Factory Interface Network Service) cho .NET 8.

Liên kết

• Project URL: https://github.com/buiminhduc23011/DBI.Drivers/tree/main/DBI.Drivers.Omron
• Repository: https://github.com/buiminhduc23011/DBI.Drivers
• NuGet: https://www.nuget.org/packages/DBI.Drivers.Omron

Tính năng

• FINS/TCP — Giao tiếp qua Ethernet (port 9600)
• 8 vùng nhớ — DM, CIO, WR, HR, AR, EM, TIM, CNT
• Nhiều kiểu dữ liệu — Word (Int16), DWord (Int32), Float (IEEE 754), BCD, String
• Thread-safe — SemaphoreSlim bảo vệ truy cập FINS master
• Auto-reconnect — Tự kết nối lại khi mất kết nối
• Generic API — Đọc/ghi bằng địa chỉ chuỗi: "DM100", "CIO0", "WR50"

Cài đặt

dotnet add package DBI.Drivers.Omron

Sử dụng nhanh

using DBI.Drivers.Omron;

// Kết nối FINS/TCP
var plc = new OmronClient("192.168.1.10", 9600);
plc.AutoReconnect = true;
plc.Connect();

// Đọc/Ghi DM (Data Memory)
short[] dm100 = plc.ReadDM(100, 5);              // DM100–DM104
plc.WriteDM(200, new short[] { 123, 456 });

// Đọc DINT (32-bit) và REAL (float)
int dint = plc.ReadDMInt(300);                    // DM300–DM301 as int
float real = plc.ReadDMFloat(700);                // DM700–DM701 as float

// Đọc/Ghi CIO bits
bool[] cio = plc.ReadCIO(0, 8);                   // CIO 0.0–0.7
plc.WriteCIO(10, new bool[] { true, false });

// Đọc WR, HR
short[] wr = plc.ReadWRWord(0, 10);               // WR0–WR9
short[] hr = plc.ReadHRWord(0, 5);                // HR0–HR4

// Timer / Counter
short[] timPv = plc.ReadTIM(0, 4);                 // Timer 0–3 present values
bool[] timFlag = plc.ReadTIMStatus(0, 4);          // Timer 0–3 completion flags

// Extended Memory (bank)
short[] em = plc.ReadEM(0, 100, 10);               // EM bank 0, address 100–109

// BCD
int bcd = plc.ReadBCD(500);                        // DM500 as BCD
plc.WriteBCD(500, 1234);

// String
string str = plc.ReadString(600, 10);              // DM600–DM609 as ASCII string
plc.WriteString(600, "Hello", 10);

// Generic API
var val = plc.Read("DM400");                       // Returns short
plc.Write("DM400", (short)999);

// Ngắt kết nối
plc.Disconnect();
plc.Dispose();

Vùng nhớ hỗ trợ

PLC tương thích

• Compact: CP1E, CP1H, CP1L, CP2E
• Modular: CJ1M, CJ2M, CJ2H
• Next-gen: NJ, NX series
• Large-scale: CS1H, CS1G

Kiến trúc

OmronClient (IOmronClient)
    └── FinsTcpMaster (IFinsMaster)
          └── FinsEthernetAdapter (IFinsTransport)
                └── TCP Socket (port 9600)

Cấu trúc project

DBI.Drivers.Omron/
├── Comm/                  # Transport abstraction
│   ├── IFinsTransport.cs
│   ├── IFinsMaster.cs
│   └── FinsEthernetAdapter.cs
├── TCP/                   # FINS/TCP protocol
│   ├── FinsTcpMaster.cs
│   ├── FinsMessage.cs
│   └── FinsTcpHeader.cs
├── Interfaces/
│   └── IOmronClient.cs
├── DataTypes/
│   ├── OmronMemoryArea.cs
│   └── OmronTag.cs
├── Converters/
│   ├── WordConverter.cs
│   ├── DoubleWordConverter.cs
│   ├── FloatConverter.cs
│   ├── BcdConverter.cs
│   └── StringConverter.cs
├── Exceptions/
│   ├── FinsException.cs
│   ├── FinsNetworkException.cs
│   └── FinsEndCodeException.cs
├── OmronClient.cs
├── OmronConnectionType.cs
└── OmronAddressMap.cs

License

MIT