Novolis.IO.ConnectedDevices 2026.1.1.69

There is a newer version of this package available.
See the version list below for details.
dotnet add package Novolis.IO.ConnectedDevices --version 2026.1.1.69
                    
NuGet\Install-Package Novolis.IO.ConnectedDevices -Version 2026.1.1.69
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Novolis.IO.ConnectedDevices" Version="2026.1.1.69" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Novolis.IO.ConnectedDevices" Version="2026.1.1.69" />
                    
Directory.Packages.props
<PackageReference Include="Novolis.IO.ConnectedDevices" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Novolis.IO.ConnectedDevices --version 2026.1.1.69
                    
#r "nuget: Novolis.IO.ConnectedDevices, 2026.1.1.69"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Novolis.IO.ConnectedDevices@2026.1.1.69
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Novolis.IO.ConnectedDevices&version=2026.1.1.69
                    
Install as a Cake Addin
#tool nuget:?package=Novolis.IO.ConnectedDevices&version=2026.1.1.69
                    
Install as a Cake Tool

Novolis

Novolis · Docs · Source

Novolis.IO.ConnectedDevices

Cross-platform discovery of connected HID interfaces, including USB keyboards, macro pads, knob controllers, and composite peripherals. The package uses HidSharp and leaves device-specific report interpretation to the host.

Install

dotnet add package Novolis.IO.ConnectedDevices

Usage

Enumerate devices

using Novolis.IO.ConnectedDevices;

using var catalog = new ConnectedDeviceCatalog();

foreach (var device in catalog.EnumerateHidDevices())
{
    var info = device.Descriptor;
    Console.WriteLine(
        $"{info.HardwareId} {info.FriendlyName} " +
        $"input={info.MaxInputReportLength} path={info.DevicePath}");
}

This prints every HID interface visible to the current account. A composite peripheral may appear more than once, with one interface for its keyboard surface and another for its controls.

Select a controller and read reports

Use the product name after the initial enumeration, or pin the device by its vendor/product identifiers when they are known.

var controller = catalog.FindHidDevice(
    new ConnectedDeviceFilter
    {
        ProductNameContains = "knob",
        // VendorId = 0x1234,
        // ProductId = 0x5678,
    });

if (controller is not null)
{
    using var stream = controller.OpenStream();
    var buffer = new byte[Math.Max(1, controller.Descriptor.MaxInputReportLength)];
    var bytesRead = await stream.ReadAsync(buffer);
    Console.WriteLine(Convert.ToHexString(buffer.AsSpan(0, bytesRead)));
}

OpenStream returns raw HID reports. Knob, key, LED, and vendor-specific report layouts are intentionally not guessed by this package; decode the bytes according to the controller's report descriptor. Some operating systems own keyboard-class interfaces; use TryOpenStream when a composite device contains an interface that may be unavailable for application access.

Configure the full 4x4 Keytron macro pad

The WebHub/SDCX family exposes a separate vendor HID interface for its 16 keys and three rotary controls. The exact full-size target is 6D7D:DCFC; a different HID interface from the same physical device is the ordinary keyboard.

var macroPad = WebHubMacroPad.Find(catalog);

if (macroPad is null)
{
    Console.WriteLine("Keytron was not found.");
}
else if (!macroPad.SupportsWebHubFrames)
{
    Console.WriteLine(macroPad.ProtocolSupportDescription);
}
else
{
    using var session = macroPad.OpenSession();
    var info = session.ReadDeviceInfo();
    var actions = session.ReadActions();
    Console.WriteLine(
        $"profile={info.ActiveProfile} actions={actions.Count}");
}

WebHubMacroPadSession supports read-only device/configuration reads and explicit action, profile, and backlight writes for interfaces with the documented 64-byte report shape. WebHubMacroPadAction.Description provides an operator-facing interpretation of the four bytes, and WebHubMacroPadPresets.CreateUsefulKnobActions() supplies a starting map with counter-clockwise volume down, clockwise volume up, and useful media/workspace press actions. WebHubMacroPad.ProbeReadOnly() can safely inspect a mismatched interface without enabling writes. The API deliberately does not expose factory-reset or bootloader commands.

The exact factory-firmware 6D7D:DCFC interface is handled by KeytronLegacySession. It supports the verified three-byte action table and the factory lighting command: effect/pattern mode, master brightness, animation speed, custom-color selection, and HSV color bytes are written as a 32-byte report-ID-2 transaction. KeytronLegacyLightingSettings exposes both the protocol-compatible fields and meaningful aliases such as EffectMode, MasterBrightness, AnimationSpeed, and UseCustomColor. Lighting responses are retained as raw reports because this firmware's read response does not echo the full setting record.

Hot-plug changes

catalog.DevicesChanged += (_, _) =>
{
    var current = catalog.EnumerateHidDevices();
    Console.WriteLine($"HID interfaces connected: {current.Count}");
};

The event does not identify the changed interface. Re-enumerate the catalog to obtain current metadata.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2026.1.1.71 85 11/10/2026
2026.1.1.70 120 10/25/2026
2026.1.1.69 97 10/19/2026
2026.1.1.68 96 10/19/2026
2026.1.1.67 100 10/19/2026
2026.1.1.66 102 10/18/2026
2026.1.1.64 101 10/18/2026
2026.1.1.63 92 10/18/2026
2026.1.1.62 104 10/18/2026
2026.1.1.61 99 10/18/2026
2026.1.1.60 90 10/18/2026