ThreeByte.LinkLib.TcpLink 1.1.5

🌐 ThreeByte.LinkLib.TcpLink

Asynchronous TCP client with automatic reconnection, message queuing, and thread-safe operation.

✨ Features

📦 Installation

dotnet add package ThreeByte.LinkLib.TcpLink

or via the NuGet Package Manager:

Install-Package ThreeByte.LinkLib.TcpLink

🚀 Quick Start

using ThreeByte.LinkLib.TcpLink;

// Create a TCP link to a remote device
var tcp = new AsyncTcpLink("192.168.1.100", 5000);

// Subscribe to events
tcp.IsConnectedChanged += (s, connected) =>
    Console.WriteLine(connected ? "✅ Connected" : "❌ Disconnected");

tcp.DataReceived += (s, e) =>
    Console.WriteLine($"Data arrived: {tcp.GetMessage()?.Length} bytes");

tcp.ErrorOccurred += (s, ex) =>
    Console.WriteLine($"Error: {ex.Message}");

// Send a message
byte[] command = System.Text.Encoding.ASCII.GetBytes("HELLO\r\n");
tcp.SendMessage(command);

// Retrieve queued incoming data
if (tcp.HasData)
{
    byte[]? response = tcp.GetMessage();
}

// Clean up
tcp.Dispose();

📖 API Reference

AsyncTcpLink

Constructors

AsyncTcpLink(string address, int port)
AsyncTcpLink(string address, int port, bool enabled = true)

Properties

Methods

Events

🔧 Configuration

Use TcpLinkSettings for structured configuration:

var settings = new TcpLinkSettings("192.168.1.100", 5000);
// Access settings.Address, settings.Port

🏗️ Architecture

┌─────────────────────────────────────────────┐
│              AsyncTcpLink                   │
│                                             │
│  ┌───────────┐  ┌───────────┐  ┌─────────┐ │
│  │  Connect   │  │   Read    │  │  Write  │ │
│  │  (Async)   │  │  (Async)  │  │ (Async) │ │
│  └─────┬─────┘  └─────┬─────┘  └────┬────┘ │
│        │              │              │      │
│        ▼              ▼              ▼      │
│  ┌─────────────────────────────────────────┐│
│  │         Thread-Safe Message Queue       ││
│  │            (FIFO, max 100)              ││
│  └─────────────────────────────────────────┘│
│        │                                    │
│        ▼                                    │
│  ┌─────────────────────────────────────────┐│
│  │     Auto-Reconnect Timer (3 sec)        ││
│  └─────────────────────────────────────────┘│
└─────────────────────────────────────────────┘

🎯 Platform Support

📄 License

Part of the ThreeByte.LinkLib family of communication libraries.