Dispositivos USB

O WSL Dashboard, por meio da integração com usbipd-win, permite conectar facilmente dispositivos USB locais às instâncias WSL pela interface gráfica.

Preparação

Antes de usar este recurso, certifique-se de que:

1. Você instalou o usbipd-win no Windows.
2. O kernel do seu WSL suporta USB (os kernels padrão modernos do WSL 2 geralmente já suportam).

Passos de uso

1. Escanear dispositivos

Entre na guia "USB"; o aplicativo listará automaticamente todos os dispositivos USB conectados ao Windows (incluindo hubs, mouses, dispositivos de armazenamento, etc.).

2. Vincular dispositivo (Bind)

Antes de conectar o dispositivo a uma instância WSL específica, é necessário primeiro "vincular" (bind) o dispositivo. A operação de vinculação requer privilégios de administrador; o WSL Dashboard lida automaticamente com a solicitação de elevação.

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 a conexão bem-sucedida, o dispositivo USB desaparecerá do Windows e aparecerá na instância WSL selecionada.
• Você pode verificar usando o comando lsusb dentro do WSL.

4. Desconectar (Detach)

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

Perguntas frequentes

• Não encontra o dispositivo?: tente atualizar a lista ou verificar se o dispositivo está conectado corretamente 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?: confirme se o usbipd-win está instalado e adicionado à variável de ambiente PATH do sistema.