LlrpSdk.Extensions.Impinj 2.0.5

LlrpSdk.Extensions.Impinj

LlrpSdk.Extensions.Impinj adds managed Impinj support to LlrpSdk for readers such as Speedway R420 and Revolution R700. UseImpinj() registers a protocol module and a candidate reader extension; after connection the SDK activates it only when the standard identity and negotiated protocol match. The active extension provides typed managed settings contributors and Impinj fields projected into TagReport.Extensions.

The generated wire-level messages, parameters, and codecs are kept in the independent LlrpNet.Protocol.Impinj project. This package contains the application-facing mapping and extension lifecycle.

Quick Start

using LlrpSdk;
using LlrpSdk.Extensions.Impinj;

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

await reader.ConnectAsync();
if (reader.Extensions.Get<ImpinjReaderExtension>() is null)
{
    throw new NotSupportedException(
        "The connected reader is not an active Impinj LLRP 1.0.1 reader.");
}
ReaderSettings settings = (await reader.GetDefaultSettingsAsync()).Settings;
await reader.ApplySettingsAsync(settings);

await using InventorySession session = await reader.StartInventoryAsync();
await foreach (TagReport report in session.ReadReportsAsync())
{
    if (report.Extensions.TryGetValue("impinj.serializedTid", out object? tid))
    {
        Console.WriteLine($"Serialized TID: {tid}");
    }
}

GetDefaultSettingsAsync() uses the connected reader's identity and capability tables. The core baseline selects the first advertised RF mode and receive sensitivity, the highest transmit-power value and its index, and the first usable RF channel; the Impinj contributor then adds typed model/firmware settings. The verified R420 profile enables only the optional report fields covered by the capability catalog. Unknown Impinj models retain the standard capability-derived values and an explicit, conservative vendor extension object rather than invented vendor defaults. For a disconnected, portable baseline use ReaderSettingsDefaults.CreateGeneric() instead.

When .UseImpinj() is used with a standard non-Impinj reader, connection still succeeds and all standard SDK APIs remain available, but no Impinj enable, configuration query, or report projection runs. The typed .Impinj(...) builder is local model construction only; check the active extension before applying those settings. The current SDK does not emit inactive vendor extension fields on a standard reader, so applications must not treat a successful standard apply as evidence that an Impinj option was accepted.

Common report options can be expressed with the typed inventory builder:

InventorySettings inventory = InventorySettings.Create(settings => settings
    .Antennas(1, 2)
    .Impinj(impinj => impinj
        .IncludeSerializedTid()
        .IncludeRfPhaseAngle()
        .IncludePeakRssi()));

Use only options verified for the target reader model and firmware. For an active Impinj extension, unknown or unverified vendor features are rejected by the configurator unless the explicit AllowUnverified... options are used.

Package Boundaries

• LlrpSdk.Extensions.Impinj: managed extension activation, Settings and Inventory contributors, and TagReport projections.
• LlrpNet.Protocol.Impinj: generated Impinj wire assets and codec registry module for low-level protocol users.

License And Definition Notice

• This SDK extension is distributed under the MIT License.
• Generated Impinj protocol assets are derived from Impinj LTK Definition Files. Copyright © Impinj, Inc. All rights reserved. The local definition source is not redistributed by this package.