Skip to content

Commit 4fa8f27

Browse files
authored
Merge pull request #3015 from jwidess/patch-1
Add dialout fix instructions for WSL2
2 parents 9b2e3ee + 61d66ab commit 4fa8f27

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

doc/md/Installation_Instructions/Windows-WSL2-Installation-Instructions.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -393,6 +393,26 @@ sudo service udev restart
393393
sudo udevadm trigger --action=change
394394
```
395395

396+
#### USB device access in WSL2 (tty permissions)
397+
398+
When you attach the Proxmark3 to WSL2 via `usbipd`, the Linux device node (for example `/dev/ttyACM0`) is created inside the WSL distro. That device is usually owned by `root:dialout` and is only readable/writable by `root` and members of the `dialout` group.
399+
400+
If you are seeing `Could not find Proxmark3 on /dev/ttyACM0`, it usually means your user doesn't have permission to open the serial device.
401+
402+
Fix:
403+
```bash
404+
# add your user to the dialout group (this is persistent)
405+
sudo usermod -aG dialout $USER
406+
407+
# apply the new group membership in the current shell (no restart)
408+
newgrp dialout
409+
410+
# verify the changes:
411+
id # should show 'dialout' in the groups list
412+
ls -l /dev/ttyACM* # device should be group 'dialout' and group-writable
413+
```
414+
415+
396416
## Verify Device Exists
397417
^[Top](#top)
398418

0 commit comments

Comments
 (0)