dorssel / usbipd-win

Windows software for sharing locally connected USB devices to other machines, including Hyper-V guests and WSL 2.
GNU General Public License v3.0
3.78k stars 234 forks source link

Incorrect configuration path in wiki (WSL support) #629

Open o-alquimista opened 1 year ago

o-alquimista commented 1 year ago

From https://github.com/dorssel/usbipd-win/wiki/WSL-support#building-your-own-usbip-enabled-wsl-2-kernel:

These are the necessary additional features in menuconfig. Device Drivers -> USB Support Device Drivers -> USB Support -> USB announce new devices Device Drivers -> USB Support -> USB Modem (CDC ACM) support Device Drivers -> USB Support -> USB/IP Device Drivers -> USB Support -> USB/IP -> VHCI HCD Device Drivers -> USB Support -> USB/IP -> Debug messages for USB/IP Device Drivers -> USB Serial Converter Support Device Drivers -> USB Serial Converter Support -> USB FTDI Single port Serial Driver

The path to USB Serial Converter Support has changed. It's under USB Support now.

Device Drivers -> USB Support -> USB Serial Converter Support
Device Drivers -> USB Support -> USB Serial Converter Support -> USB FTDI Single port Serial Driver
dorssel commented 1 year ago

Thanks for the report!

I will leave this issue open for others to find. It may take a bit before I finally get around to updating the docs (I need to overhaul the entre thing, there are more issues...)

ejhuff commented 11 months ago

For custom kernel building, the make install is unnecessary and confusing. It turns out that wsl never uses the kernels in /boot, while make install puts them there.

sudo make -j 8 && sudo make modules_install -j 8 && sudo make install -j 8

should omit the make install, include headers_install, and use nproc:

np=$(nproc) #counts which processors are allocated to this process sudo make -j $np && sudo make modules_install headers_install -j $np

Although, I haven't figured out how wsl knows where to find the modules, if it does find them. lsmod says no modules are installed. Since there is only one kernel for all distros, the install modules and headers would need to be done for every distro.

Official custom kernel for wsl instructions here: https://learn.microsoft.com/en-us/community/content/wsl-user-msft-kernel-v6

dorssel commented 11 months ago

@ejhuff Thanks for the improvements. The WSL kernel docs in wiki are rather old; they actually pre-date the USBIP-capable kernels from years ago. At some point, I will replace the wiki with a reference to the Microsoft docs (now that they exist).

About the modules: the WSL kernel is monolithic; there are no modules to find.

timsu92 commented 9 months ago

The path to USB Serial Converter Support has changed. It's under USB Support now.

This is correct. However, at the time I'm building this right now, the options mentioned above are already turned on in WSL2.