SiLA2.SerialPort.Features 10.2.3

SiLA2.SerialPort.Features

A SiLA2 Feature package that exposes serial port communication capabilities via gRPC. This module provides a complete SiLA2 Feature Definition (FDL) and gRPC service implementation for serial port discovery, connection management, and data transfer.

Features

• SiLA2-Compliant Interface: Full FDL-defined feature with gRPC service implementation
• Port Discovery: Enumerate available serial ports with USB device metadata (VID/PID/Serial)
• Connection Management: Connect/disconnect to multiple ports simultaneously
• Data Transfer: Send data, read lines, and execute command-response protocols (SCPI)
• Observable Properties: Subscribe to real-time updates for available and connected ports
• USB Device Identification: Connect by VID/PID for reliable device identification
• Cross-Platform: Windows, Linux, and macOS support

Installation

dotnet add package SiLA2.SerialPort.Features

This package requires SiLA2.Core and SiLA2.SerialPort which will be installed automatically as dependencies.

Quick Start

Register Services

// Program.cs
builder.Services.AddSerialPortManager();
builder.Services.AddSingleton<SerialCommunicationService>();

var app = builder.Build();

// Initialize SiLA2 features
app.InitializeSiLA2Features(siLA2Server);

// Map gRPC service
app.MapGrpcService<SerialCommunicationService>();

Client Usage

// Create channel and client
var channel = GrpcChannel.ForAddress("https://localhost:5001");
var client = new SerialCommunication.SerialCommunicationClient(channel);

// Connect to a port
await client.ConnectAsync(new Connect_Parameters
{
    PortName = new String { Value = "COM3" },
    BaudRate = new Integer { Value = 9600 },
    DataBits = new Integer { Value = 8 },
    StopBits = new String { Value = "One" },
    Parity = new String { Value = "None" }
});

// Send a SCPI command and get response
var response = await client.SendCommandAsync(new SendCommand_Parameters
{
    PortName = new String { Value = "COM3" },
    Command = new String { Value = "*IDN?" },
    TimeoutMs = new Integer { Value = 5000 }
});

Console.WriteLine($"Device ID: {response.Response.Value}");

Feature Definition

The SerialCommunication feature (FDL v1.0) provides:

Properties

Commands

Defined Execution Errors

Data Types

SerialPortInfo - Structured information about a serial port:

• PortName - System port name (e.g., "COM3", "/dev/ttyUSB0")
• Description - Friendly name or description
• IsAvailable - Whether the port can be opened
• IsConnected - Whether this service has it connected
• VendorId - USB VID (hexadecimal, e.g., "0403")
• ProductId - USB PID (hexadecimal, e.g., "6001")
• SerialNumber - USB device serial number
• Manufacturer - Device manufacturer name

Observable Properties

Subscribe to real-time port updates:

// Subscribe to available ports
using var call = client.Subscribe_AvailablePorts(new Subscribe_AvailablePorts_Parameters());

await foreach (var response in call.ResponseStream.ReadAllAsync())
{
    foreach (var port in response.AvailablePorts)
    {
        Console.WriteLine($"{port.SerialPortInfo.PortName.Value}: " +
                          $"{port.SerialPortInfo.Description.Value}");
    }
}

USB Device Identification

Connect to devices by VID/PID for reliable identification regardless of port assignment:

// Find FTDI devices (VID=0403)
var ftdiPorts = await client.FindPortByUsbIdAsync(new FindPortByUsbId_Parameters
{
    VendorId = new String { Value = "0403" },
    ProductId = new String { Value = "6001" }
});

// Connect by USB ID
var result = await client.ConnectByUsbIdAsync(new ConnectByUsbId_Parameters
{
    VendorId = new String { Value = "0403" },
    ProductId = new String { Value = "6001" },
    SerialNumber = new String { Value = "" },  // Match any
    BaudRate = new Integer { Value = 115200 },
    DataBits = new Integer { Value = 8 },
    StopBits = new String { Value = "One" },
    Parity = new String { Value = "None" }
});

Console.WriteLine($"Connected to port: {result.PortName.Value}");

Server Implementation

To implement the service in your SiLA2 server:

public class Program
{
    public static void Main(string[] args)
    {
        var builder = WebApplication.CreateBuilder(args);

        // Add SiLA2 services
        builder.Services.AddSingleton<ISiLA2Server, SiLA2Server>();
        builder.Services.AddSerialPortManager();
        builder.Services.AddSingleton<SerialCommunicationService>();
        builder.Services.AddGrpc();

        var app = builder.Build();

        // Initialize SiLA2
        var silaServer = app.Services.GetRequiredService<ISiLA2Server>();
        app.InitializeSiLA2Features(silaServer);

        // Map gRPC services
        app.MapGrpcService<SerialCommunicationService>();

        silaServer.Start();
        app.Run();
    }
}

Feature Definition Location

The SiLA2 Feature Definition XML file is embedded in the assembly:

• Features/SerialCommunication-v1_0.sila.xml

At runtime, copy this file to your output directory or include it as embedded resource.

Related Packages

• SiLA2.SerialPort: Core serial port library (non-gRPC)
• SiLA2.Core: Core SiLA2 server implementation
• SiLA2.AspNetCore: ASP.NET Core integration

Platform Support

• Windows: Full support with native COM port and WMI-based USB enumeration
• Linux: Supported via .NET (ports at /dev/ttyUSB*, /dev/ttyACM*)
• macOS: Supported via .NET (ports at /dev/tty.*)

License

MIT License - See LICENSE file for details.