LlrpSdk 2.0.5

LlrpSdk

LlrpSdk is the managed .NET API for connecting to one RFID reader and running the normal reader workflow. It hides versioned LLRP messages and resource lifecycles behind LlrpReader, ReaderSettings, and InventorySession.

What It Provides

• LLRP 1.0.1 and 1.1 connection and version negotiation;
• managed Reader Settings defaults, validation, query, apply, and clear;
• managed inventory start, monitoring, stop, and report streams;
• translated TagReport values;
• standard C1G2 tag memory read, write, lock, kill, and block erase operations;
• protocol modules and vendor extensions without an ImpinjReader inheritance tree.

Quick Start

using LlrpSdk;

await using LlrpReader reader = LlrpReader.CreateBuilder("192.0.2.10")
    .WithPort(5084)
    .Build();

await reader.ConnectAsync();

ReaderSettings settings = (await reader.GetDefaultSettingsAsync()).Settings;
await reader.ApplySettingsAsync(settings);

await using InventorySession session = await reader.StartInventoryAsync();
await foreach (TagReport report in session.ReadReportsAsync())
{
    Console.WriteLine(report.Epc);
}

await reader.StopAsync();

ValidateSettingsAsync() can be called before ApplySettingsAsync() and does not send protocol messages. ApplySettingsAsync() deploys managed settings in a stopped state; StartInventoryAsync() starts the deployed inventory and returns an isolated report stream.

The SDK has two control planes. The managed plane owns ROSpec 14150, AttachedData AccessSpec 14151, and temporary Tag Access resources. The expert plane is exposed by reader.RoSpecs, reader.AccessSpecs, and reader.Protocol side-by-side; it is available whenever the connection is Ready and callers own the resource lifecycle. Expert writes end an active managed session and mark ObservedState stale while retaining DesiredSettings. There is no separate resource-mode gate: expert resource operations are available whenever the connection is Ready.

When a resource write or exact raw frame makes the device observation stale, the desired inventory settings remain available. High-level APIs can reconcile the SDK-reserved resources immediately; the default PreserveForeign policy leaves foreign ROSpecs and AccessSpecs untouched. Use the overload accepting ResourceTakeoverPolicy.ReplaceAll only when deleting every standard resource is intentional. SynchronizeStateAsync() refreshes the observed resource snapshot and is useful for inspection, but it is not required before a managed operation. StartExistingRoSpecAsync(id) can attach a report session to an expert/raw-created ROSpec without compiling, replacing, or deleting it.

ReaderCapabilities.ResourceLimits exposes nullable ROSpec, AccessSpec, graph, OpSpec, priority, and C1G2 select-filter limits. A zero is an explicit device limit; null means the reader did not report that capability. Managed deployment preflights final capacity under PreserveForeign (the default) or explicit ReplaceAll before changing reader resources.

For connection-wide observation, use TagsReported or ReadTagReportsAsync(); these observer outlets are mutually exclusive with the session stream during an active inventory. When a reader omits the optional ROSpecID, the SDK-owned exclusive session still accepts non-conflicting inventory reports. Do not consume both InventorySession.ReadReportsAsync() and an observer outlet for the same inventory. For direct LLRP messages, expert ROSpec/AccessSpec ownership, or protocol generation, use the lower-level LlrpNet projects.

License And Standard

• This SDK is distributed under the MIT License.
• LLRP 1.0.1 and 1.1 are open standards published by GS1/EPCglobal.