Beetech.Adv.Abstractions 1.0.3

Beetech.Adv.Abstractions

Open, zero-dependency hardware driver abstractions, pipeline middleware contracts, and CloudEvents specifications for the Beetech Universal Auto-ID Platform.

• 🌐 Live Platform: https://advautoid.com
• 📖 Interactive Documentation: https://advautoid.com/docs
• 🔑 Instant RSA-2048 Trial License Generator: https://advautoid.com/trial
• 📦 Public GitHub Repository (main): https://github.com/anhdovan/advautoid.dev/tree/main

🎯 Overview

Beetech.Adv.Abstractions defines the open interface contracts enabling 3rd-party hardware manufacturers, system integrators, and software vendors to integrate custom RFID readers, barcode scanners, PLCs, and middleware into the Beetech Auto-ID ecosystem without access to proprietary SDK sources.

Key Capabilities

• IRfidReaderDriver: Standard interface for fixed, handheld, desktop, and portal RFID readers.
• IBarcodeScannerDriver: Standard interface for 1D/2D imaging scanners and barcode sleds.
• IPlcDriver: Industrial automation discrete I/O and register memory access.
• ITagPipelineMiddleware: ASP.NET Core-style pipeline middleware for edge filtering, deduplication, and CEP rule evaluation.
• DriverMetadataAttribute: Declarative plugin auto-discovery metadata.
• DriverCertificationSuite: Automated conformance testing kit validating custom driver reliability and compliance.

🚀 Quickstart: Building a Custom RFID Reader Driver

1. Implement IRfidReaderDriver

using System;
using System.Threading;
using System.Threading.Tasks;
using Beetech.Adv.Abstractions;

namespace MyCompany.AutoId.Drivers
{
    [DriverMetadata(
        driverId: "acme-portal-9000",
        displayName: "Acme Industrial RFID Portal 9000",
        manufacturer: "Acme Auto-ID Corp",
        driverVersion: "1.2.0",
        Category = "Fixed",
        SupportedProtocols = new[] { "LLRP", "TCP/IP" }
    )]
    public class AcmePortalDriver : IRfidReaderDriver
    {
        public string DriverId => "acme-portal-9000";
        public string ModelDisplayName => "Acme Industrial RFID Portal 9000";
        public ReaderOperationalStatus Status { get; private set; } = ReaderOperationalStatus.Disconnected;
        public bool IsConnected => Status == ReaderOperationalStatus.Connected || Status == ReaderOperationalStatus.Inventory;
        public bool IsInventoryRunning => Status == ReaderOperationalStatus.Inventory;

        public ReaderCapabilities Capabilities => new()
        {
            MaxAntennaPorts = 4,
            MinPowerDbm = 10.0,
            MaxPowerDbm = 31.5,
            SupportsUhfRfid = true,
            SupportsGpio = true,
            SupportsAutonomousInventory = true
        };

        public event EventHandler<RfidTagReadEventArgs>? TagRead;
        public event EventHandler<BatchTagReadEventArgs>? BatchTagRead;
        public event EventHandler<ReaderStatusEventArgs>? StatusChanged;

        public Task<bool> ConnectAsync(string connectionString, CancellationToken cancellationToken = default)
        {
            // Connect to reader socket
            Status = ReaderOperationalStatus.Connected;
            return Task.FromResult(true);
        }

        public Task StartInventoryAsync(RfidInventoryParams? parameters = null, CancellationToken cancellationToken = default)
        {
            Status = ReaderOperationalStatus.Inventory;
            // Begin tag polling loop
            return Task.CompletedTask;
        }

        public Task StopInventoryAsync(CancellationToken cancellationToken = default)
        {
            Status = ReaderOperationalStatus.Connected;
            return Task.CompletedTask;
        }

        public Task DisconnectAsync(CancellationToken cancellationToken = default)
        {
            Status = ReaderOperationalStatus.Disconnected;
            return Task.CompletedTask;
        }

        public Task SetRfPowerAsync(double powerDbm, CancellationToken cancellationToken = default) => Task.CompletedTask;
        public Task SetSensitivityAsync(double sensitivityDbm, CancellationToken cancellationToken = default) => Task.CompletedTask;
        public Task ConfigureAntennaPortsAsync(IEnumerable<AntennaPortConfiguration> ports, CancellationToken cancellationToken = default) => Task.CompletedTask;
        public Task<bool> WriteTagEpcAsync(string currentEpc, string newEpc, string? accessPassword = null, CancellationToken cancellationToken = default) => Task.FromResult(true);
        public Task<string?> ReadTagMemoryAsync(string epc, MemoryBank bank, ushort wordAddress, ushort wordCount, string? accessPassword = null, CancellationToken cancellationToken = default) => Task.FromResult<string?>("A1B2C3D4");

        public void Dispose() => DisconnectAsync().GetAwaiter().GetResult();
    }
}

🧪 Validating Driver with Conformance Certification

Run the automated certification suite before submitting your driver to the Beetech Hardware Catalog:

using Xunit;
using Beetech.Adv.Abstractions;

public class DriverConformanceTests
{
    [Fact]
    public async Task ValidateAcmeDriver()
    {
        using var driver = new AcmePortalDriver();
        var report = await DriverCertificationSuite.CertifyDriverAsync(driver, "192.168.1.100");

        Assert.True(report.IsFullyCompliant, $"Certification failed: {string.Join(", ", report.Results)}");
        Assert.Equal(0, report.FailedAssertions);
    }
}

📦 Building Custom Tag Pipeline Middleware

using System.Threading.Tasks;
using Beetech.Adv.Abstractions;

public class CustomPartLookupMiddleware : ITagPipelineMiddleware
{
    public async ValueTask InvokeAsync(TagProcessingContext context, TagPipelineDelegate next)
    {
        // Enriched ERP metadata
        if (context.Tag.Epc.StartsWith("3034"))
        {
            context.Items["partNumber"] = "PART-99482";
            context.Items["department"] = "AssemblyLine-02";
        }

        // Pass to next middleware downstream
        await next(context);
    }
}

📄 License

Licensed under the MIT License. Copyright (c) 2026 Beetech Auto-ID Platform. All rights reserved.