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