MicrosoftDocs / WSL

Source code behind the Windows Subsystem for Linux documentation.
https://docs.microsoft.com/windows/wsl
Other
1.91k stars 575 forks source link

USB Passthrough documentation does not cover ARM64 or warn about it being AMD64 / Intel x86_64 only #2032

Open Lewiscowles1986 opened 3 weeks ago

Lewiscowles1986 commented 3 weeks ago

Type of issue

Other (describe below)

Feedback

It's outdated, the code doesn't work, and none of the commands fail until a program, which cannot work is installed on my machine...

https://learn.microsoft.com/en-us/windows/wsl/connect-usb

Fails to mention that the advice provided is only for intel-compatible 64-bit processors. I tried this on a Microsoft dev kit for ARM and it didn't work, which was surprising as none of the software said why.

I've written to the author on someone else issue with the same error:

https://github.com/dorssel/usbipd-win/issues/1038

And digging through their images, I eventually found why

https://github.com/dorssel/usbipd-win/issues/1023#issuecomment-2310041856

So why:

Is just a series of cascading failures

Page URL

https://learn.microsoft.com/en-us/windows/wsl/connect-usb

Content source URL

https://github.com/MicrosoftDocs/wsl/blob/main/WSL/connect-usb.md

Author

@craigloewen-msft

Document Id

e99de78d-d27a-664d-98ba-91116b7157c8

Lewiscowles1986 commented 3 weeks ago

Ammendment, the article does have the following text, but it should be much more prominent, and ideally escalated to winget team.

A machine with an x64 processor is required. (x86 and Arm64 are currently not supported with usbipd-win).