【亲测免费】 HidLibrary 使用教程

项目介绍

HidLibrary 是一个开源的 .NET 库，用于在 .NET 环境中枚举和与 HID 兼容的 USB 设备进行通信。该库提供了同步和异步的读写功能，以及设备插入和移除的通知。HidLibrary 支持 x86 和 x64 架构，适用于多种操作系统和 .NET 版本。

项目快速启动

1. 下载并引用库

首先，通过 NuGet 包管理器安装 HidLibrary：

Install-Package hidlibrary

在你的项目中引用 HidLibrary：

using HidLibrary;

2. 变量声明

声明必要的变量，包括 VendorId 和 ProductId：

private const int VendorId = 0x0483;
private const int ProductId = 0x5753;
private HidDevice _device;

3. 初始化

初始化设备并检查是否成功连接：

_device = HidDevices.Enumerate(VendorId, ProductId).FirstOrDefault();
if (_device != null)
{
    // 设备连接成功
}
else
{
    // 设备连接失败
}

4. 发送信息

发送数据到 USB 设备：

byte[] data = new byte[] { 0x00, 0x01, 0x02 };
_device.Write(data);

5. 数据接收

从 USB 设备接收数据：

_device.ReadReport(report =>
{
    // 处理接收到的数据
    byte[] receivedData = report.Data;
});

6. USB 插入触发

监听 USB 设备的插入事件：

HidDevices.Changed += (sender, args) =>
{
    // 处理设备插入事件
};

7. USB 拔出触发

监听 USB 设备的拔出事件：

HidDevices.Removed += (sender, args) =>
{
    // 处理设备拔出事件
};

应用案例和最佳实践

案例一：与硬件设备通信

假设你有一个自定义的 USB 设备，使用 HidLibrary 可以轻松实现与该设备的通信。以下是一个简单的示例：

private void ConnectToDevice()
{
    _device = HidDevices.Enumerate(VendorId, ProductId).FirstOrDefault();
    if (_device != null)
    {
        _device.OpenDevice();
        _device.Inserted += DeviceInserted;
        _device.Removed += DeviceRemoved;
        _device.MonitorDeviceEvents = true;
    }
}

private void DeviceInserted()
{
    // 处理设备插入事件
}

private void DeviceRemoved()
{
    // 处理设备拔出事件
}

最佳实践

1. 错误处理：在实际应用中，确保添加适当的错误处理逻辑，以应对设备连接失败或通信错误的情况。
2. 资源管理：确保在不再需要设备时正确释放资源，避免内存泄漏。
3. 异步操作：尽可能使用异步操作以提高应用的响应性能。

典型生态项目

HidLibrary 在多个项目中被广泛使用，以下是一些典型的生态项目：

1. QMK Toolbox：一个与 QMK 固件配合使用的工具箱，用于刷写键盘固件。
2. Sleddog Blink1：实现与 thingM blink(1) 设备的通信。
3. NZXTSharp：NZXT 设备的 C# SDK。
4. SharpLibStreamDeck：提供对 Elgato Gaming Stream Deck 设备的功能访问。
5. DeskToys：用于控制各种桌面玩具的 .NET 驱动程序。

这些项目展示了 HidLibrary 在不同领域的应用，为开发者提供了丰富的参考和实践案例。