Diagnosticando conexões USB com lsusb no Linux

• Bus 002 Device 003: ID 046d:c52b Logitech, Inc. Unifying Receiver: Esta é a linha padrão que lsusb sem opções detalhadas também mostraria. Ela informa o barramento (002), o número do dispositivo (003), o Vendor ID (046d) e o Product ID (c52b), juntamente com uma descrição do fabricante (Logitech, Inc.) e do produto (Unifying Receiver).
• Device Descriptor:: Esta seção descreve o dispositivo como um todo:
  • bLength: Tamanho deste descritor em bytes.
  • bDescriptorType: Tipo do descritor (1 para Dispositivo).
  • bcdUSB: Versão da especificação USB suportada pelo dispositivo (2.00 neste caso).
  • bDeviceClass, bDeviceSubClass, bDeviceProtocol: Classes, subclasses e protocolos de dispositivo. Um valor de 0 aqui geralmente indica que a classe é definida no nível da interface.
  • bMaxPacketSize0: Tamanho máximo do pacote para o endpoint 0 (controle).
  • idVendor: ID do fabricante (Logitech).
  • idProduct: ID do produto (Unifying Receiver).
  • bcdDevice: Versão do firmware do dispositivo (12.01).
  • iManufacturer: Índice da string do fabricante.
  • iProduct: Índice da string do produto.
  • iSerial: Índice da string do número de série (0 indica que não há número de série).
  • bNumConfigurations: Número de configurações que o dispositivo suporta (1 neste caso).
• Configuration Descriptor:: Descreve uma das configurações do dispositivo:
  • bLength, bDescriptorType, wTotalLength, bNumInterfaces, bConfigurationValue, iConfiguration: Informações gerais sobre a configuração.
  • bmAttributes: Atributos da configuração (Bus Powered e Remote Wakeup neste caso).
  • MaxPower: Consumo máximo de energia do dispositivo (100mA).
• Interface Descriptor:: Descreve uma interface específica dentro da configuração (um dispositivo pode ter várias interfaces, por exemplo, para teclado e mouse separados):
  • bLength, bDescriptorType, bInterfaceNumber, bAlternateSetting, bNumEndpoints, iInterface: Informações gerais sobre a interface.
  • bInterfaceClass: Classe da interface (3 para Human Interface Device – HID).
  • bInterfaceSubClass: Subclasse da interface (1 para Boot Interface Subclass).
  • bInterfaceProtocol: Protocolo da interface (2 para Mouse).
• Endpoint Descriptor:: Descreve um ponto de comunicação (endpoint) para transferência de dados:
  • bLength, bDescriptorType, bEndpointAddress: Endereço do endpoint (0x81 indica um endpoint de entrada).
  • bmAttributes: Atributos do endpoint (Interrupt Transfer Type neste caso, usado para dados sensíveis ao tempo como movimentos do mouse).
  • wMaxPacketSize: Tamanho máximo do pacote que pode ser transferido neste endpoint (8 bytes).
  • bInterval: Intervalo de polling para este endpoint (10ms).

Esta saída detalhada permite verificar se o dispositivo está reportando as informações corretas sobre suas capacidades e configuração, o que pode ser útil para diagnosticar problemas de driver ou compatibilidade.

4. Filtrando a Saída por Vendor ID ou Product ID:

Se você estiver procurando por um dispositivo específico e souber seu Vendor ID ou Product ID, pode filtrar a saída do lsusb usando a opção -d:

lsusb -d 046d:c52b

Isso listará apenas os dispositivos que correspondem ao VID 046d e ao PID c52b (neste caso, o Unifying Receiver da Logitech).

5. Exibindo a árvore de dispositivos USB:

A opção -t exibe os dispositivos USB em uma estrutura de árvore, mostrando as conexões entre hubs e dispositivos finais. Isso pode ser útil para entender a topologia das suas conexões USB.

lsusb -t

Exemplo de saída:

/:  Bus 02.Port 1.0, Hub, USB 3.0 (???5000Mbit/s)
    |__ Port 1.0, Device 3, Hub (???480Mbit/s)
        |__ Port 1.0, Device 4, Mass Storage (???480Mbit/s)
        |__ Port 2.0, Device 5, Human Interface Device (???12Mbit/s)
/:  Bus 01.Port 1.0, Hub, USB 2.0 (???480Mbit/s)
    |__ Port 1.0, Device 2, Hub (???480Mbit/s)

Esta saída mostra os barramentos USB e os dispositivos conectados, indicando se são hubs ou dispositivos finais e a velocidade da conexão.

Diagnosticando problemas com lsusb

• Dispositivo não listado: Se o seu dispositivo USB não aparecer na saída do lsusb após ser conectado, pode haver um problema físico (cabo defeituoso, porta USB com problema, falha no dispositivo) ou uma questão de energia. Tente conectar o dispositivo a outra porta USB.
• Erros ou informações incompletas: Na saída detalhada (lsusb -v), procure por mensagens de erro ou descritores incompletos, que podem indicar problemas de comunicação ou um driver inadequado.
• Classe incorreta: A classe do dispositivo (Interface Class na saída detalhada) deve corresponder ao tipo de dispositivo. Se estiver incorreta, pode haver um problema com o driver.

Próximos passos após a identificação

Após usar o lsusb para obter informações sobre um dispositivo USB problemático, você pode seguir estes passos:

• Verificar os logs do kernel (dmesg | grep usb): Procure por mensagens de erro específicas relacionadas ao dispositivo.
• Verificar se o driver correto está carregado (lsmod | grep <nome_do_driver>): Se você souber o nome do driver esperado para o dispositivo.
• Tentar carregar ou recarregar o driver: sudo modprobe <nome_do_driver> ou sudo modprobe -r <nome_do_driver> seguido de sudo modprobe <nome_do_driver>.
• Pesquisar online pelo Vendor ID e Product ID: Isso pode fornecer informações sobre o dispositivo e possíveis soluções para problemas comuns.

Dicas e cenários comuns de problema de USB no Linux

• Dispositivo Intermitente: Se um dispositivo USB conecta e desconecta aleatoriamente, use lsusb imediatamente após uma desconexão inesperada. Verifique se o dispositivo ainda aparece na lista. Se não, pode indicar um problema de energia (a porta USB não está fornecendo energia suficiente ou o dispositivo está consumindo demais), um cabo defeituoso ou uma conexão física solta. Se o dispositivo ainda estiver listado, o problema pode ser um driver instável ou um problema de comunicação que é melhor investigado com dmesg.
• Identificando Dispositivos Desconhecidos: Às vezes, um dispositivo pode aparecer na lista do lsusb com uma descrição genérica ou com um Vendor ID/Product ID numérico sem um nome amigável. Isso pode indicar que o sistema não tem informações detalhadas sobre o dispositivo, possivelmente devido à falta de um driver específico. Anote o Vendor ID e o Product ID e use-os para pesquisar online por drivers ou informações sobre compatibilidade com Linux.
• Verificando a Velocidade da Conexão: Para dispositivos que dependem de altas velocidades de transferência (como HDDs externos ou webcams de alta resolução), use lsusb -t para verificar a velocidade da conexão (por exemplo, “Speed: 5000Mbit/s” para USB 3.0 SuperSpeed). Se um dispositivo USB 3.0 estiver conectado a uma porta USB 3.0, mas o lsusb -t mostrar uma velocidade de “480Mbit/s” (USB 2.0 High-Speed), pode haver um problema com a porta, o cabo ou o próprio dispositivo.
• Problemas de Energia: Se vários dispositivos conectados à mesma porta USB via um hub apresentarem problemas, use lsusb -t para visualizar a topologia. Um hub com muitos dispositivos de alto consumo de energia pode estar sobrecarregado. Tente conectar alguns dispositivos diretamente às portas USB do computador ou use um hub com alimentação externa. O lsusb -v também pode mostrar informações sobre o consumo de energia do dispositivo nas seções de descritores de configuração.
• Dispositivos Mal Funcionando Após Atualizações do Kernel: Se um dispositivo USB que funcionava anteriormente parar de funcionar após uma atualização do kernel, use lsusb para confirmar que ele ainda está sendo detectado. Em seguida, verifique os logs do kernel (dmesg) para ver se há novas mensagens de erro relacionadas ao dispositivo. Pode ser que um driver específico precise ser atualizado ou que haja uma incompatibilidade temporária com a nova versão do kernel.
• Comparando Antes e Depois: Se você instalar um novo driver para um dispositivo USB, execute lsusb -v antes e depois da instalação. Compare as informações, especialmente a seção de descritores de interface e quaisquer informações sobre o driver sendo usado (isso pode não ser explicitamente listado pelo lsusb, mas as informações da classe e protocolo podem mudar).

Conclusão

O comando lsusb é uma ferramenta fundamental para diagnosticar problemas com dispositivos USB no Linux. Ao listar os dispositivos conectados e fornecer informações detalhadas sobre eles, você pode identificar se um dispositivo está sendo reconhecido pelo sistema, obter seus identificadores únicos e investigar problemas de comunicação ou configuração. Combinado com outras ferramentas de diagnóstico do Linux, o lsusb ajuda a garantir que seus periféricos USB funcionem corretamente.