Novolis.IO.ConnectedDevices
2026.1.1.67
See the version list below for details.
dotnet add package Novolis.IO.ConnectedDevices --version 2026.1.1.67
NuGet\Install-Package Novolis.IO.ConnectedDevices -Version 2026.1.1.67
<PackageReference Include="Novolis.IO.ConnectedDevices" Version="2026.1.1.67" />
<PackageVersion Include="Novolis.IO.ConnectedDevices" Version="2026.1.1.67" />
<PackageReference Include="Novolis.IO.ConnectedDevices" />
paket add Novolis.IO.ConnectedDevices --version 2026.1.1.67
#r "nuget: Novolis.IO.ConnectedDevices, 2026.1.1.67"
#:package Novolis.IO.ConnectedDevices@2026.1.1.67
#addin nuget:?package=Novolis.IO.ConnectedDevices&version=2026.1.1.67
#tool nuget:?package=Novolis.IO.ConnectedDevices&version=2026.1.1.67
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 | Versions 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. |
-
net10.0
- HidSharp (>= 2.6.4)
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 |