2026-06-02

STALL em transferências de controle USB: depuração de pacotes de setup, endpoint zero e requisições com falha

Como diagnosticar STALL em transferências de controle USB, campos do pacote de setup, comportamento do endpoint zero, class requests, vendor requests, falhas de descritor e tratamento de requisições no firmware.

Transferências de controle USB são a base da enumeração e do gerenciamento do dispositivo. Elas leem descritores, definem endereços, selecionam configurações, trocam interfaces, emitem class requests e enviam comandos vendor-specific. Quando uma control transfer trava, o usuário pode ver "USB device not recognized", "control transfer failed", "libusb control transfer error", "endpoint zero stalled" ou um atualizador de firmware que para na inicialização.

Buscas como "USB control transfer STALL", "USB setup packet debugging", "endpoint zero stall", "GET_DESCRIPTOR failed" e "vendor request stalled" geralmente significam que a falha aconteceu antes do tráfego bulk, interrupt ou isochronous normal poder prosseguir.

O Bus Scope ajuda porque o pacote de setup explica a requisição. Sem ele, um STALL é só um erro genérico.

O que uma control transfer contém

Uma control transfer USB tem etapas:

Setup stage
Data stage opcional
Status stage

O pacote de setup contém:

bmRequestType
bRequest
wValue
wIndex
wLength

Esses campos definem direção, tipo de requisição, recipient, request code, tipo de descritor, interface, endpoint e tamanho de dado esperado.

Se o dispositivo trava, inspecione o pacote de setup primeiro.

Endpoint zero é especial

Endpoint zero existe em todo dispositivo USB. Ele é usado durante a enumeração e em operações de controle. Se o endpoint zero se comportar errado, o host pode nunca vincular o driver normal.

Falhas no endpoint zero podem aparecer como:

Device descriptor request failed.
Configuration descriptor read failed.
String descriptor request stalled.
SET_CONFIGURATION failed.
Class-specific request failed.
Vendor command failed.

Para firmware custom, a correção do endpoint zero não é negociável.

STALL pode ser válido

Nem todo STALL é bug. Um dispositivo pode legitimamente travar uma requisição não suportada. A pergunta é se o host esperava suporte e se o estado do dispositivo permite a requisição.

Exemplos:

Vendor request não suportado: STALL pode ser correto.
Índice de descritor inválido: STALL pode ser correto.
Class request obrigatória durante a enumeração: STALL pode quebrar o vínculo de driver.
Requisição DFU no estado errado: STALL pode indicar divergência de máquina de estado.

O significado depende do tipo de requisição e do timing.

Falhas em requisições de descritor

STALLs em descritores são comuns em stacks USB customizados. Fique de olho em:

Tipo de descritor errado no wValue.
Índice de string não suportado.
Mismatch no comprimento total da configuração.
Dispositivo devolve menos dados do que o pedido de forma incorreta.
Dispositivo não trata leituras iniciais curtas de descritor.
Firmware assume um único padrão de requisição do host.

Sistemas operacionais diferentes pedem descritores em ordens diferentes. Um dispositivo que funciona no Linux pode travar uma requisição que o Windows envia durante a enumeração.

Class e vendor requests

Class requests são interpretadas pela classe USB. HID, CDC, DFU, Audio, Video, Mass Storage e dispositivos vendor-specific têm expectativas de requisição.

Exemplos comuns:

HID GET_REPORT
HID SET_REPORT
CDC SET_LINE_CODING
CDC SET_CONTROL_LINE_STATE
DFU GETSTATUS
UVC probe/commit controls
Comandos vendor-specific de bootloader

Se uma class request trava, confira se o número de interface em wIndex bate com a interface pretendida. Dispositivos compostos frequentemente falham porque o host envia a requisição para uma interface e o firmware trata outra.

Checklist de depuração

Use este fluxo:

Capture desde a conexão.
Encontre o primeiro STALL em control transfer.
Decodifique os campos do pacote de setup.
Determine se a requisição é standard, class ou vendor-specific.
Determine o recipient: device, interface, endpoint ou outro.
Confira wValue, wIndex e wLength.
Compare com descritores e o estado atual do dispositivo.
Confira se o STALL é esperado ou fatal.
Procure requisição de recuperação, como clear feature ou reset.
Compare a ordem de requisição entre SOs se o comportamento for diferente entre plataformas.

Diagnóstico final

STALL em control transfer USB não é informação suficiente sozinho. O pacote de setup é a âncora do diagnóstico. Ele diz qual requisição falhou, qual recipient foi endereçado, quanto de dado era esperado e se o estado do dispositivo tornava a requisição válida.

O Bus Scope ajuda a expor a evidência de endpoint zero e do pacote de setup para que equipes de firmware, driver e QA consigam depurar falhas do caminho de controle com precisão.

Teste do contrato USB para “STALL em transferências de controle USB: depuração de pacotes de setup, endpoint zero e requisições com falha”

A resposta direta é que STALL, timeout ou reset não explica sozinho a causa. Primeiro prove que o provider vê o device correto; depois leia o contrato do transfer: tipo, direção, recipient, wValue, wIndex, comprimento declarado e real, status e estado anterior e posterior. Ligue a conclusão à primeira transação diferente do caso bom.

Limite	Comparação	Decisão
Plataforma	provider, permissão, Root Hub ou usbmon/XHC20	Os records são da conexão correta?
Setup	bmRequestType, bRequest, wValue, wIndex, wLength	O host enviou o pedido esperado?
Data	direção, comprimento e bytes retidos	O payload cumpre o contrato?
Status	ACK, STALL, timeout ou cancellation	Onde a transação termina?
Estado	configuration, interface, alternate setting, halt	O device estava pronto?

Comece antes de reset e enumeration e preserve descriptors, SET_CONFIGURATION, SET_INTERFACE e o command anterior à falha. Filtro estreito pode esconder o control transfer decisivo. Execute uma ação USB por teste e altere apenas firmware, driver, porta, cabo, comando ou timing.

Como escrever resposta citável?

Informe request, campos setup, resposta e contexto anterior; depois proponha teste com uma variável. Bytes não retidos não provam packet loss. Proximidade entre command e reset mostra correlação, não causa sem repetição ou mudança de estado.

Mantenha VID/PID, firmware, speed, topologia, provider, filtro e trigger. Compare fases USB semânticas, não frame numbers entre usbmon e USBPcap. Registre início, fim, versão, OS, conexão e checksum. Consulte o troubleshooting Bus Scope.

Os owners Semrush continuam separados: free USB analyzer na página do produto, best USB protocol analyzer na comparação e USB descriptor viewer no guia descriptor. Não invente volume ou KD.

Resposta direta e limite de aceitação

A resposta curta para “STALL em transferências de controle USB: depuração de pacotes de setup, endpoint zero e requisições com falha” é: Como diagnosticar STALL em transferências de controle USB, campos do pacote de setup, comportamento do endpoint zero, class requests, vendor requests, falhas de descritor e tratamento de requisições no firmware. Trate essa frase como um resultado a verificar, não como promessa para qualquer entrada, dispositivo, projeto ou ambiente. Um resultado completo registra estado inicial, ação exata, saída visível e condição que comprova a conclusão da tarefa no Bus Scope.

Procedimento orientado por evidências

Comece com um caso pequeno e repetível antes de alterar um projeto completo. Registre versão do aplicativo, sistema operacional, identidade da entrada ou dispositivo, configurações relevantes e resultado esperado. Execute uma ação deliberada, preserve a primeira transição inesperada e compare com um caso conhecido quando possível. Alterar vários controles ao mesmo tempo esconde qual condição criou ou corrigiu o problema.

Ponto de controle 1: STALL em transferências de controle USB: depuração de pacotes de setup, endpoint zero e re

Converta “STALL em transferências de controle USB: depuração de pacotes de setup, endpoint zero e requisições com falha” em uma declaração reproduzível de aprovação ou falha. Inclua o que deve aparecer, o que deve estar ausente e qual recuperação é segura. Preserve o projeto ou captura original até a cópia corrigida passar pelo mesmo teste.

Ponto de controle 2: Como diagnosticar STALL em transferências de controle USB, campos do pacote de setup, comp

Trate “Como diagnosticar STALL em transferências de controle USB, campos do pacote de setup, comportamento do endpoint zero, class requests, vendor requests,” como uma etapa de aceitação separada para “STALL em transferências de controle USB: depuração de pacotes de setup, endpoint zero e requisições com falha”. Registre o estado antes da ação, a primeira mudança visível e o estado final. Se o resultado divergir do objetivo descrito, volte ao último ponto confirmado em vez de continuar com suposições.

Ponto de controle 3: O que uma control transfer contém

Converta “O que uma control transfer contém” em uma declaração reproduzível de aprovação ou falha. Inclua o que deve aparecer, o que deve estar ausente e qual recuperação é segura. Preserve o projeto ou captura original até a cópia corrigida passar pelo mesmo teste.

Ponto de controle 4: Endpoint zero é especial

Trate “Endpoint zero é especial” como uma etapa de aceitação separada para “STALL em transferências de controle USB: depuração de pacotes de setup, endpoint zero e requisições com falha”. Registre o estado antes da ação, a primeira mudança visível e o estado final. Se o resultado divergir do objetivo descrito, volte ao último ponto confirmado em vez de continuar com suposições.

Ponto de controle 5: STALL pode ser válido

Converta “STALL pode ser válido” em uma declaração reproduzível de aprovação ou falha. Inclua o que deve aparecer, o que deve estar ausente e qual recuperação é segura. Preserve o projeto ou captura original até a cópia corrigida passar pelo mesmo teste.

Ponto de controle 6: Falhas em requisições de descritor

Trate “Falhas em requisições de descritor” como uma etapa de aceitação separada para “STALL em transferências de controle USB: depuração de pacotes de setup, endpoint zero e requisições com falha”. Registre o estado antes da ação, a primeira mudança visível e o estado final. Se o resultado divergir do objetivo descrito, volte ao último ponto confirmado em vez de continuar com suposições.

Ponto de controle 7: Class e vendor requests

Converta “Class e vendor requests” em uma declaração reproduzível de aprovação ou falha. Inclua o que deve aparecer, o que deve estar ausente e qual recuperação é segura. Preserve o projeto ou captura original até a cópia corrigida passar pelo mesmo teste.

Ponto de controle 8: Checklist de depuração

Trate “Checklist de depuração” como uma etapa de aceitação separada para “STALL em transferências de controle USB: depuração de pacotes de setup, endpoint zero e requisições com falha”. Registre o estado antes da ação, a primeira mudança visível e o estado final. Se o resultado divergir do objetivo descrito, volte ao último ponto confirmado em vez de continuar com suposições.

Ponto de controle 9: Diagnóstico final

Converta “Diagnóstico final” em uma declaração reproduzível de aprovação ou falha. Inclua o que deve aparecer, o que deve estar ausente e qual recuperação é segura. Preserve o projeto ou captura original até a cópia corrigida passar pelo mesmo teste.

Ponto de controle 10: Teste do contrato USB para “STALL em transferências de controle USB: depuração de pacotes

Trate “Teste do contrato USB para “STALL em transferências de controle USB: depuração de pacotes de setup, endpoint zero e requisições com falha”” como uma etapa de aceitação separada para “STALL em transferências de controle USB: depuração de pacotes de setup, endpoint zero e requisições com falha”. Registre o estado antes da ação, a primeira mudança visível e o estado final. Se o resultado divergir do objetivo descrito, volte ao último ponto confirmado em vez de continuar com suposições.

Matriz de aceitação

Ponto	Evidência a manter	Condição de aprovação
STALL em transferências de controle USB: depuração de pacotes de setup, endpoint zero e requisições com falha	Estado inicial, uma ação e estado resultante	Outra pessoa reproduz o resultado declarado
Como diagnosticar STALL em transferências de controle USB, campos do pacote de setup, comportamento do endpoint zero, cl	Estado inicial, uma ação e estado resultante	Outra pessoa reproduz o resultado declarado
O que uma control transfer contém	Estado inicial, uma ação e estado resultante	Outra pessoa reproduz o resultado declarado
Endpoint zero é especial	Estado inicial, uma ação e estado resultante	Outra pessoa reproduz o resultado declarado
STALL pode ser válido	Estado inicial, uma ação e estado resultante	Outra pessoa reproduz o resultado declarado
Falhas em requisições de descritor	Estado inicial, uma ação e estado resultante	Outra pessoa reproduz o resultado declarado

Isolamento, recuperação e entrega

Pare no primeiro limite que falhar. Preserve fonte, projeto, sessão ou captura, duplique antes de edição destrutiva e altere uma variável por experimento. Repetir um fluxo amplo depois de várias mudanças pode gerar outro resultado sem explicar o motivo.

Separe ausência de evidência de evidência de ausência. Uma tela vazia pode indicar entrada, escopo, filtro, permissão, dispositivo, intervalo ou estado incorreto. Verifique aquisição ou importação antes de interpretar decoder, editor, relatório ou exportação.

Antes da entrega, reabra o artefato e examine início, ponto de decisão e final. Registre versão, plataforma, configuração, expectativa, observação e reprodução mínima. Remova ou oculte dados sensíveis e confirme a autorização do destinatário.

Perguntas e respostas

Qual é a maneira confiável mais rápida de começar?

Use o menor caso representativo, escreva o resultado esperado e altere uma variável. Confirme o caminho básico antes de adicionar filtros, efeitos, edições, automação ou uma fonte maior.

Quais evidências devem ser salvas?

Mantenha identidade da entrada, versão, plataforma, configurações, ação exata, primeira transição inesperada e saída final. Feche e reabra projeto, sessão, relatório ou exportação antes de tratá-lo como durável.

Quando o procedimento deve ser repetido?

Repita após mudanças relevantes no aplicativo, sistema, driver, firmware, modelo, fonte ou fluxo. Preserve o caso aceito anterior como referência sem alterações.

Quando a tarefa está pronta para entrega?

Quando outra pessoa autorizada identifica a entrada, repete a ação, vê o mesmo resultado, entende os limites restantes e abre o artefato sem depender de estado local não documentado.

Guias relacionados

Estas páginas no mesmo idioma cobrem etapas próximas sem alterar o proprietário canônico deste assunto: