Skip to content

Commit e992ec4

Browse files
committed
Update README
1 parent ecdc64f commit e992ec4

File tree

1 file changed

+32
-19
lines changed

1 file changed

+32
-19
lines changed

README.md

Lines changed: 32 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -36,50 +36,65 @@ This will install:
3636
- A command line tool `usbipd`.\
3737
The location of this tool will be added to the `PATH` environment variable.
3838
- A firewall rule called `usbipd` to allow all local subnets to connect to the service.\
39-
You can modify this firewall rule to fine tune access control.\
40-
:information_source:\
41-
If you are using a third-party firewall, you may have to reconfigure it to allow
42-
incoming connections on TCP port 3240.
39+
You can modify this firewall rule to fine tune access control.
40+
41+
> [!NOTE]
42+
> If you are using a third-party firewall, you may have to reconfigure it to allow
43+
> incoming connections on TCP port 3240.
4344
4445
## How to use
4546

4647
### Share Devices
4748

4849
By default devices are not shared with USBIP clients.
49-
To lookup and share devices, open a command prompt as an Administrator and use the `usbipd` tool.
50-
For example:
50+
To lookup and share devices, run the following commands with administrator privileges:
5151

5252
```powershell
5353
usbipd --help
5454
usbipd list
5555
usbipd bind --busid=<BUSID>
5656
```
5757

58+
Sharing a device is persistent; it survives reboots.
59+
60+
> [!TIP]
61+
> See the [wiki](https://github.com/dorssel/usbipd-win/wiki/Tested-Devices) for a list of tested devices.
62+
5863
### Connecting Devices
5964

60-
From another (possibly virtual) machine running Linux, use `usbip` to claim the USB device:
65+
Attaching devices to a client is non-persistent. You will have to re-attach after a reboot,
66+
or when the device resets or is physically unplugged/replugged.
67+
68+
#### Non-WSL 2
69+
70+
From another (possibly virtual) machine running Linux, use the `usbip` client-side tool:
6171

6272
```bash
6373
usbip list --remote=<HOST>
6474
sudo usbip attach --remote=<HOST> --busid=<BUSID>
6575
```
6676

67-
A list of tested devices can be found on the [wiki](https://github.com/dorssel/usbipd-win/wiki).
68-
Please file an issue if your device is not working.
77+
> [!NOTE]
78+
> Client-side tooling exists for other operating systems such as Microsoft Windows, but not as part of this project.
6979
70-
### WSL 2
80+
#### WSL 2
7181

72-
You can use the `usbipd wsl` subcommand to share and connect a device with a single command.
73-
For example, open a command prompt:
82+
You can attach the device from within Windows with the following command, which does not require administrator privileges:
7483

7584
```powershell
76-
usbipd wsl --help
77-
usbipd wsl list
78-
usbipd wsl attach --busid=<BUSID>
85+
usbipd attach --wsl --busid=<BUSID>
7986
```
8087

81-
:information_source:\
82-
Instructions on how to prepare WSL 2 for USBIP can be found on the [wiki](https://github.com/dorssel/usbipd-win/wiki/WSL-support).
88+
> [!TIP]
89+
> In case you have used `usbipd` with WSL 2 before, the following has changed since version 4.0.0:
90+
> - You have to share the device using `usbipd bind` first.
91+
> - You no longer have to install any client-side tooling.
92+
> - You no longer have to specify a specific distribution.
93+
> - The syntax for the command to attach has changed slightly.
94+
95+
> [!TIP]
96+
> See the [wiki](https://github.com/dorssel/usbipd-win/wiki/WSL-support) on how to add drivers
97+
> for USB devices that are not supported by the default WSL 2 kernel.
8398
8499
### GUI
85100

@@ -97,5 +112,3 @@ Alternatively, use the Windows Package Manager:
97112
```powershell
98113
winget uninstall usbipd
99114
```
100-
101-
There should be no left-overs; please file an issue if you do find any.

0 commit comments

Comments
 (0)