Gerenciamento de dispositivos USB

O WSL Dashboard, por meio da integração com usbipd-win, permite que você conecte facilmente dispositivos USB locais a instâncias WSL através de uma interface GUI.

Preparação

Antes de usar esta função, certifique-se de:

1. Ter usbipd-win instalado no Windows.
2. Que seu kernel WSL suporte USB (kernels WSL 2 modernos geralmente suportam por padrão).

Etapas de uso

1. Escanear dispositivos

Acesse a guia "USB", e o aplicativo listará automaticamente todos os dispositivos USB atualmente conectados ao Windows (incluindo hubs, mouse, dispositivos de armazenamento, etc.).

2. Vincular dispositivo (Bind)

Antes de conectar um dispositivo a uma instância WSL específica, é necessário "vincular" o dispositivo. A operação de vinculação requer permissões de administrador, e o WSL Dashboard tratará automaticamente a solicitação de elevação de privilégios.

Após a vinculação, o dispositivo estará pronto para ser compartilhado com o WSL.

3. Conectar à instância (Attach)

Selecione uma instância WSL em execução e clique em "Conectar (Attach)".

• Após uma conexão bem-sucedida, o dispositivo USB desaparecerá do Windows e aparecerá na instância WSL selecionada.
• Você pode usar o comando lsusb no WSL para verificar.

4. Desconectar (Detach)

Após completar a operação, clique em "Desconectar (Detach)" e o dispositivo retornará ao controle do Windows.

Problemas comuns

• Dispositivo não encontrado?: Tente atualizar a lista ou verificar se o dispositivo está corretamente conectado ao host.
• Falha na conexão?: Certifique-se de que a instância WSL de destino está em execução e que você tem permissões suficientes.
• Comando usbipd não encontrado?: Verifique se o usbipd-win está instalado e adicionado à variável de ambiente PATH do sistema.