USBIPD-WIN : Connecter un périphérique USB à WSL 2

Introduction

WSL 2 (Windows Subsystem for Linux version 2) est un outil puissant pour exécuter un environnement GNU/Linux directement sur Windows, sans machine virtuelle complète. Toutefois, l’accès aux périphériques USB (comme un smartphone Android pour le débogage ou une clé USB série) a longtemps été une limite importante. C’est ici qu’intervient usbipd-win, un outil open source de Microsoft qui permet de rediriger des périphériques USB du noyau Windows vers le noyau WSL 2.

Dans cet article, nous allons voir comment l’utiliser efficacement, pas à pas.

Prérequis

  • Windows 11 ou Windows 10 version 22H2 avec les dernières mises à jour.
  • WSL 2 déjà installé et fonctionnel (Ubuntu, Debian, etc.).
  • Une distribution Linux active (Ubuntu par exemple).
  • Avoir usbipd-win installé :
winget install --source winget dorssel.usbipd-win

Puis redémarrez WSL :

wsl --shutdown

Lister et attacher un périphérique USB

1. Identifier le périphérique USB

Dans PowerShell en mode administrateur :

usbipd list

Vous verrez un résultat du type :

BUSID  VID:PID    DEVICE
1-9    18D1:4EE7  Google Pixel (ADB)

2. Partager le périphérique USB (« bind »)

Toujours en mode administrateur :

usbipd bind --busid 1-9

3. Attacher à WSL

Dans une console normale :

usbipd attach --wsl --busid 1-9

4. Vérifier dans WSL

Dans votre distribution Linux :

lsusb

Et pour un smartphone Android :

adb devices

Détacher un périphérique

Pour libérer le périphérique USB (par exemple pour l’utiliser de nouveau dans Windows) :

usbipd detach --busid 1-9

Cas d’usage : Déboguer un smartphone Android via ADB dans WSL

sudo apt install android-sdk-platform-tools
adb kill-server
adb start-server
adb devices

Si le statut est unauthorized, vérifiez que le smartphone affiche une demande d’autorisation de clé RSA.

Problèmes fréquents

ProblèmeSolution
L’USB n’apparaît pas dans lsusbVérifiez que le bind + attach ont bien réussi.
adb devices renvoie unauthorizedSupprimez les clés locales : rm ~/.android/adbkey* et rebranchez le téléphone.
usbipd renvoie une erreur de syntaxeAssurez-vous d’utiliser la nouvelle syntaxe (plus de usbipd wsl, remplacé par --wsl).

Sécurité et droits

  • Le bind nécessite les droits administrateur.
  • L’attach peut être fait en session utilisateur.
  • Le partage USB est persistant : bind reste actif jusqu’à redémarrage ou unbind explicite.

Conclusion

L’écosystème WSL 2 devient de plus en plus mature grâce à des outils comme usbipd-win, qui rendent le développement Android, l’interfaçage série ou l’exploitation de clés USB possible directement depuis un terminal Linux. L’adoption de cette solution dans votre flux de travail permet de rester dans l’environnement WSL sans compromis.

Nuage de tags SEO

usbipd, usbipd-win, connect usb wsl2, wsl usb access, adb wsl2, android debug wsl, wsl2 connect smartphone, usbipd adb android, débogage usb wsl2, connecter périphérique usb wsl, accès usb wsl2, wsl2 adb unauthorized, usbipd bind attach detach

Étiquettes

Publications similaires