nanoFramework.System.Device.UsbStream 1.0.62

欢迎使用 .NET nanoFramework USB 客户端仓库

构建状态

组件	构建状态	NuGet 包
System.Device.UsbStream

用法

USB 流

UsbStream 类提供了一个无缝的接口访问一个可以从中读取和写入 USB 设备的流，该设备被枚举为 WinUSB 设备。这允许您在不需要任何 INF 文件或特定驱动程序安装的情况下，将 .NET nanoFramework 设备作为 USB 设备发货。

创建 UsbStream

创建 UsbStream 需要2个参数：一个 Guid，它将被用作设备接口标识符；以及一个 string，它将被用作 USB 设备的说明。

private static Guid deviceInterfaceId = new Guid("9e48651c-fa68-4b39-8731-1ee84659aac5");
private static string deviceDescription = "nanoDevice";

// create USB Stream
var usbStream = UsbClient.CreateUsbStream(deviceInterfaceId, deviceDescription);

写入到 UsbStream

要写入到 UsbStream，只需调用 Write() 方法，就像任何其他的 .NET 流一样。例如

// buffer with dummy data 
var bufer = new byte[] { 1, 2, 3 };

usbStream.Write(bufer, 0, bufer.Length);

调试提示

USB 可能很复杂。请做好这方面的准备！有许多问题可能导致挫败感。以下是一些（希望是有价值的）建议。

• 如果您需要调试设备枚举问题并检查从设备传递的内容，您需要安装一些工具，比如来自Uwe Sieber的USB设备树查看器。使用它，您可以深入研究USB设备、其接口、端点、字符串等每个细节。

• 另一个很好的工具是来自NirSoft的USBDeview。此工具列出了当前连接到您电脑的所有USB设备以及您之前使用的所有USB设备。为每个USB设备显示详细信息。可以从此工具卸载禁用或启用USB设备。

• Windows缓存USB设备的枚举。这有什么问题呢？在开发过程中，如果在某些点枚举失败，设备很可能被标记为已枚举，在下一次连接时，Windows不会再次尝试。这可能导致枚举数据不正确或不完整。为了修复此问题并真正强制从头开始枚举，请确保以下内容：

  1. 从设备管理器中删除设备。

  2. 从注册表中删除枚举缓存条目。它在HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\usbflags\vvvvpppprrrr处。

     其中vvvv是厂商ID，pppp是PID，rrrr是设备版本号。

反馈和文档

有关文档、提供反馈、问题以及了解如何贡献，请参阅Home仓库。

加入我们的Discord社区这里。

致谢

该项目贡献者的列表可在CONTRIBUTORS中找到。

许可证

nanoFramework类库采用MIT许可证。

行为准则

本工程已采用贡献者公约中定义的行为准则，以明确在我们社区中期望的行为。更多信息请参阅.NET Foundation行为准则。

.NET Foundation

该项目由.NET Foundation支持。