usbipd-win

This update:

• Adds policies to allow auto-binding (usbipd policy --help)
• Improves firewall check
• Fixes PcapNg timestamp overflow
• Fixes support for older WSL versions
• Fixes support for several WSL distributions (mount options)
• Bumps driver versions to 7.0.16

[!NOTE]
When updating from previous versions, a reboot may be required due to driver updates.

This update:

• Adds support for Composite Devices with unnamed child devices
• Fixes reporting of incompatible hubs
• Improves WSL support (no longer depends on [automount])
• Improves Docker Desktop support
• Improves firewall check
• Improves driver installation when old left-overs from VirtualBox are still present
• Improves uninstall when devices are currently forced bound
• Bumps driver versions to 7.0.14

[!NOTE]
When updating from previous versions, a reboot may be required due to driver updates.

Breaking changes:

• Windows 8.1 and Windows Server 2012 are no longer supported
• The WSL commands have changed, see the README for the new syntax
• The automation interfaces no longer expose IsWslAttached

This update:

• Removes the requirement to install client tools on WSL
• Removes the requirement to specify a distribution for WSL
• Supports WSL mirrored networking mode
• Supports host-side detach for any client, not just for WSL
• Fixes a memory leak
• Upgrades to .NET 8
• Reduces installation footprint
• Improves CLI performance
• Improves the diagnostic message for devices in use by Windows
• Bumps driver versions to 7.0.12

[!NOTE]
When updating from previous versions, a reboot may be required due to driver updates.

This update:

• Adds UNLINK to capture file
• Adds configurable port number
• Fixes port reset timing
• Fixes UNLINK race condition

This update:

• Fixes driver BSOD
• Fixes wsl list output
• Improves auto-attach script
• Bumps driver version to 7.0.10

Note
When updating from previous versions, a reboot may be required due to driver updates.

This update:

• Adds support for devices without any description
• Adds support for multiple devices with identical 'unique' serial number
• Adds option --usbids to display Linux device descriptions
• Adds support for wsl2:vmSwitch
• Fixes IP address serialization for PowerShell automation
• Reduces installation footprint on Windows 10/Windows Server 2016 and newer
• Upgrades to .NET 7
• Upgrades installer to Wix v4
• Bumps driver versions to 7.0.8
• Changes the license to GPLv3

Note
When updating from previous versions, a reboot may be required due to driver updates.

This update:

• Fixes winget support

NOTE: If you have already installed version 2.4.0, then there is no need to install this update.
NOTE: When updating from previous versions, a reboot may be required due to driver updates.

This update:

• Adds configurable TCP keepalive
• Improves compatibility with non-Linux USBIP clients
• Improves error reporting for USBIP communication errors
• Improves WSL distributions selection and error reporting
• Improves wsl --auto-attach by allowing already attached devices
• Fixes wsl --auto-attach number parsing for leading zeros
• Fixes USBIP protocol version display format
• Fixes TCP keepalive for pre-Windows 10 1709
• Fixes Windows 8.1 and Windows Server 2012 driver support
• Fixes driver paths when installed in non-standard location
• Bumps driver versions to 6.1.36

NOTE: When updating from previous versions a reboot may be required due to driver updates.

This update:

• Adds option --auto-attach for wsl attach
• Adds option --hardware-id as alternative for --busid
• Fixes support for USB hubs/filters that fail port cycling
• Improves --force by adding a short delay between driver changes
• Improves automation by adding strong PowerShell types for BusId and HardwareId
• Improves error reporting
• Removes obsolete option --usbip-path
• Bumps driver versions to latest 6.1.34

NOTE: When updating from previous versions a reboot may be required due to driver updates.

This update:

• Adds support for USB 3.1 Gen 2 devices
• Adds support for USB devices with broken low power mode
• Adds support for devices that are unknown to Windows PnP
• Adds USB capture in PcapNg format, see https://github.com/dorssel/usbipd-win/wiki/Troubleshooting#usb-capture
• Adds automation support, see https://github.com/dorssel/usbipd-win/wiki/Automation
• Adds an informational message about the default WSL instance in case more than one exists
• Adds a diagnostic message in case of VBoxUsbMon installation issues
• Improves the performance of serial devices that use full duplex endpoints
• Improves the diagnostic message in case the current user is not in the Administrator group
• Improves the diagnostic message for bind --force failures

NOTE: This version re-introduces the USB port cycling on attach/detach from version 1.x. This means you will hear a Windows notification sound on attach/detach again. This is intended behavior.

This update:

• Adds support for more device types using 'bind --force'
• Adds a diagnostic message in case of version conflict with VirtualBox
• Fixes a race condition where devices could experience out-of-order packets
• Fixes an issue that prevented the service from logging to Windows EventLog
• Fixes an issue with 'wsl list' showing disconnected devices
• Improves the installer resulting in fewer cases requiring a reboot

Breaking changes:

• WSL requires the new instructions for setting up the usbip client on the Linux side, see https://github.com/dorssel/usbipd-win/wiki/WSL-support#usbip-client-tools
• Updating from a previous version will require you to bind your devices again; previous bindings are not preserved.

This update:

• No longer requires administrator privileges on Windows when attaching/detaching a device to WSL
• No longer requires root privileges within WSL when attaching a device
• Enables standard users that are not a member of the Administrators group to use the WSL commands
• Adds support for devices/hubs/filters that previously would not attach due to driver incompatibilities, using the new usbipd bind --force option
• Adds support for preventing the host from using the device when no client has the device attached, using the new usbipd bind --force option
• Adds support for command line completion, see https://github.com/dotnet/command-line-api/blob/main/docs/dotnet-suggest.md
• Adds console colors to errors, warnings, and informational messages
• Fixes support for devices that do not allow disable/enable (CR_NOT_DISABLEABLE)
• Fixes alignment for device descriptions with non-western characters
• Improves error reporting for common configuration errors

This update:

• Adds support for devices with REMOTE_WAKE (e.g. Bluetooth devices)
• Adds support for selecting device configurations other than the first configuration
• Adds support for WSL 2 on older Windows 10 versions (>= 1903)
• Improves compatibility with certain hubs and devices that failed to attach with earlier versions
• Improves device descriptions
• Speeds up device enumeration
• Reduces installation footprint

EDIT: This version has a regression w.r.t. version 1.2.0, see #152. If you are experiencing this problem, please revert to version 1.2.0.

This update:

• Upgrades to .NET 6
• Adds support for more WSL distributions (e.g. Arch, Debian)
• Adds support for USB devices with more than one configuration
• Adds support for WSL Store Preview
• Improves WSL status checks and error reporting
• Improves protocol compatibility with other USBIP software
• Fixes USB STALL recovery

This update improves the installer:

• Silent driver installation by using Microsoft Hardware Compatibility Publisher drivers
• Support for the latest Windows 11 Insider Dev Channel
• Support for winget install --location

This update:

• Adds support for isochronous devices (e.g. audio and video)
• Adds support for integrated, non-removable devices (e.g. built-in webcam)
• Provides a descriptive friendly name for device manager

This version is feature complete.

This update:

• Adds support for more USB devices.
• Adds a command line tool for persistently sharing specific devices.
• Adds a command line tool for Windows Subsystem for Linux (WSL 2).

Breaking change:

• The software no longer automatically shares all devices.

This version does not support isochronous USB devices, such as audio and video devices.

This version supports USB devices with bulk endpoints only (e.g. USB flash drives, FTDI USB-to-serial, etc.).

This update adds the ability to install using the winget package manager.

This version supports USB devices with bulk endpoints only (e.g. USB flash drives, FTDI USB-to-serial, etc.).

This update improves device compatibility:

• STALL recovery
• USB 3

This update fixes:

• error handling/recovery
• report correct device speed

This version supports USB devices with bulk endpoints only (e.g. USB flash drives, FTDI USB-to-serial, etc.).
This update uses .NET 5 instead of .NET Core 3.1.