usbipd-win Changelog

What's new in usbipd-win 4.2.0

Apr 29, 2024
  • 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

New in usbipd-win 4.1.0 (Feb 3, 2024)

  • 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

New in usbipd-win 4.0.0 (Dec 6, 2023)

  • 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

New in usbipd-win 3.2.0 (Sep 10, 2023)

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

New in usbipd-win 3.1.0 (Jul 19, 2023)

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

New in usbipd-win 3.0.0 (May 14, 2023)

  • 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

New in usbipd-win 2.4.1 (Oct 10, 2022)

  • Fixes winget support

New in usbipd-win 2.4.0 (Oct 2, 2022)

  • 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

New in usbipd-win 2.3.0 (Apr 27, 2022)

  • 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.

New in usbipd-win 2.2.0 (Mar 27, 2022)

  • 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

New in usbipd-win 2.1.0 (Jan 30, 2022)

  • 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

New in usbipd-win 2.0.0 (Jan 20, 2022)

  • 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
  • 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

New in usbipd-win 1.3.0 (Dec 6, 2021)

  • 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

New in usbipd-win 1.2.0 (Nov 16, 2021)

  • 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

New in usbipd-win 1.1.1 (Nov 1, 2021)

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

New in usbipd-win 1.1.0 (Oct 3, 2021)

  • 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

New in usbipd-win 1.0.0 (Sep 6, 2021)

  • 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.

New in usbipd-win 0.3.1 (Sep 2, 2021)

  • 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.