2026-06-02

STALL em endpoint USB e timeout em transferências bulk: leia a captura antes de mexer no firmware

Como depurar STALL em endpoints USB, timeouts em transferências bulk e falhas no caminho de dados do firmware usando evidência de transferência, direção do endpoint e contexto da fila.

Depois que a enumeração passa, um dispositivo USB ainda pode falhar de formas que parecem misteriosas para quem está na aplicação: "leituras bulk que dão timeout, escritas que nunca terminam, relatórios HID que param de chegar, ou o host anunciando um STALL no endpoint. Essas falhas costumam ser tratadas como bug de driver ou como travamento aleatório do firmware. Uma captura quase sempre reduz o problema a algo mais objetivo." Falhas de endpoint são evidência do caminho de dados. Elas acontecem depois que o host já aprendeu a forma do dispositivo. Isso significa que os descritores podem estar certos enquanto o comportamento do endpoint ainda está errado.

STALL é um sinal, não só um erro

Um endpoint USB pode devolver STALL para indicar que não consegue processar uma requisição ou que um comando de classe/vendor não é suportado. Stalls no endpoint de controle durante requisições de classe podem ser legítimos quando a requisição é inválida. Stalls em endpoints de dados durante o fluxo normal de transferência geralmente pedem uma investigação mais cuidadosa.

Perguntas para responder na captura:

qual endpoint travou?
era control, bulk, interrupt ou isochronous?
qual requisição ou transferência veio antes do stall?
o host limpou a condição de halt?
o tráfego voltou ao normal depois do CLEAR_FEATURE(ENDPOINT_HALT)?
o firmware travou de propósito comandos não suportados?

Sem esse contexto, "endpoint travou" é vago demais para agir.

Timeout em bulk precisa de direção e contexto de fila

Timeout em transferência bulk pode significar muitas coisas:

o host esperava dados IN, mas o dispositivo não tinha nada pronto
o dispositivo esperava dados OUT, mas a aplicação parou de escrever
o buffer do endpoint no firmware não foi preparado
o driver do host submeteu uma leitura maior do que o firmware sustenta
o dispositivo ficou mandando NAK até o timeout
endereço ou direção do endpoint estavam errados
um stall anterior nunca foi limpo

A primeira coisa a inspecionar é a direção. Um timeout em bulk IN e um timeout em bulk OUT são casos diferentes. Para IN, pergunte se o dispositivo chegou a devolver algum dado. Para OUT, pergunte se o host enviou os dados e se o dispositivo confirmou.

Descritor certo é necessário, mas não suficiente

Um descritor pode declarar corretamente um endpoint bulk IN e o dispositivo ainda assim não consegue enviar dados úteis. Um dispositivo CDC pode aparecer como porta serial e ainda ignorar line coding ou control line state. Uma interface vendor pode expor endpoints, mas exigir um comando de inicialização antes de começar a trafegar.

Por isso, depurar endpoints exige combinar:

evidência dos descritores
requisições de setup de classe ou vendor
direção da transferência
tamanho do payload
status resultante
temporização e tentativas repetidas

A captura deve mostrar se o host está pedindo algo irrazoável ou se o firmware não está cumprindo uma requisição válida.

Equipes de firmware devem capturar antes e depois da correção

Para bugs de endpoint, capturas de antes e depois valem ouro. A primeira captura prova a falha. A segunda prova a correção. Uma boa comparação mostra:

mesmo dispositivo e mesma configuração
mesmos endereços de endpoint
mesmo padrão de requisição do host
captura antiga com stall ou timeout
captura nova completando e levando o payload esperado

Isso facilita muito a revisão de regressão de firmware. E dá à equipe de suporte um artefato reproduzível quando o cliente diz que "o USB trava do nada".

Onde o Bus Scope entra

O Bus Scope mira na evidência USB, não em uma prateleira genérica de protocolos. Para casos de STALL e timeout de endpoint, ele mantém próximos o detalhe do pacote, os metadados do endpoint, os bytes brutos, o tipo de transferência e a interpretação de classe.

O resultado útil é:

endpoint e direção
tipo de transferência
requisição ou transferência antes da falha
evidência de status
payload bruto em torno da falha
se o problema vem da enumeração, do setup de classe ou do tráfego de aplicação

É essa a informação que o engenheiro de firmware precisa antes de mexer na lógica de buffer do endpoint ou no comportamento de retry do host.

Se a sua busca é "USB bulk transfer timeout" ou "USB endpoint stalled", não comece reescrevendo toda a pilha do dispositivo. Capture a evidência do endpoint primeiro.

Teste do contrato USB para “STALL em endpoint USB e timeout em transferências bulk: leia a captura antes de mexer no firmware”

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 endpoint USB e timeout em transferências bulk: leia a captura antes de mexer no firmware” é: Como depurar STALL em endpoints USB, timeouts em transferências bulk e falhas no caminho de dados do firmware usando evidência de transferência, direção do endpoint e contexto da fila. 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 endpoint USB e timeout em transferências bulk: leia a captura antes de mexer no f

Quando “STALL em endpoint USB e timeout em transferências bulk: leia a captura antes de mexer no firmware” for ambíguo, compare um caso bom e outro falho sob condições equivalentes. Marque a primeira diferença significativa, não todos os sintomas posteriores. Esse limite costuma produzir uma solicitação de suporte mais clara e um experimento mais seguro.

Ponto de controle 2: Como depurar STALL em endpoints USB, timeouts em transferências bulk e falhas no caminho d

Verifique “Como depurar STALL em endpoints USB, timeouts em transferências bulk e falhas no caminho de dados do firmware usando evidência de transferência, direç” com a menor entrada representativa. Mantenha configurações não relacionadas, repita a mesma ação e confira o resultado após reabrir ou reconectar. Uma captura isolada é mais fraca que um registro com entrada, configuração, ação, saída e horário.

Ponto de controle 3: STALL é um sinal, não só um erro

Quando “STALL é um sinal, não só um erro” for ambíguo, compare um caso bom e outro falho sob condições equivalentes. Marque a primeira diferença significativa, não todos os sintomas posteriores. Esse limite costuma produzir uma solicitação de suporte mais clara e um experimento mais seguro.

Ponto de controle 4: Timeout em bulk precisa de direção e contexto de fila

Verifique “Timeout em bulk precisa de direção e contexto de fila” com a menor entrada representativa. Mantenha configurações não relacionadas, repita a mesma ação e confira o resultado após reabrir ou reconectar. Uma captura isolada é mais fraca que um registro com entrada, configuração, ação, saída e horário.

Ponto de controle 5: Descritor certo é necessário, mas não suficiente

Quando “Descritor certo é necessário, mas não suficiente” for ambíguo, compare um caso bom e outro falho sob condições equivalentes. Marque a primeira diferença significativa, não todos os sintomas posteriores. Esse limite costuma produzir uma solicitação de suporte mais clara e um experimento mais seguro.

Ponto de controle 6: Equipes de firmware devem capturar antes e depois da correção

Verifique “Equipes de firmware devem capturar antes e depois da correção” com a menor entrada representativa. Mantenha configurações não relacionadas, repita a mesma ação e confira o resultado após reabrir ou reconectar. Uma captura isolada é mais fraca que um registro com entrada, configuração, ação, saída e horário.

Ponto de controle 7: Onde o Bus Scope entra

Quando “Onde o Bus Scope entra” for ambíguo, compare um caso bom e outro falho sob condições equivalentes. Marque a primeira diferença significativa, não todos os sintomas posteriores. Esse limite costuma produzir uma solicitação de suporte mais clara e um experimento mais seguro.

Ponto de controle 8: Teste do contrato USB para “STALL em endpoint USB e timeout em transferências bulk: leia a

Verifique “Teste do contrato USB para “STALL em endpoint USB e timeout em transferências bulk: leia a captura antes de mexer no firmware”” com a menor entrada representativa. Mantenha configurações não relacionadas, repita a mesma ação e confira o resultado após reabrir ou reconectar. Uma captura isolada é mais fraca que um registro com entrada, configuração, ação, saída e horário.

Ponto de controle 9: Como escrever resposta citável?

Quando “Como escrever resposta citável?” for ambíguo, compare um caso bom e outro falho sob condições equivalentes. Marque a primeira diferença significativa, não todos os sintomas posteriores. Esse limite costuma produzir uma solicitação de suporte mais clara e um experimento mais seguro.

Ponto de controle 10: qual endpoint travou?

Verifique “qual endpoint travou?” com a menor entrada representativa. Mantenha configurações não relacionadas, repita a mesma ação e confira o resultado após reabrir ou reconectar. Uma captura isolada é mais fraca que um registro com entrada, configuração, ação, saída e horário.

Matriz de aceitação

Ponto	Evidência a manter	Condição de aprovação
STALL em endpoint USB e timeout em transferências bulk: leia a captura antes de mexer no firmware	Estado inicial, uma ação e estado resultante	Outra pessoa reproduz o resultado declarado
Como depurar STALL em endpoints USB, timeouts em transferências bulk e falhas no caminho de dados do firmware usando evi	Estado inicial, uma ação e estado resultante	Outra pessoa reproduz o resultado declarado
STALL é um sinal, não só um erro	Estado inicial, uma ação e estado resultante	Outra pessoa reproduz o resultado declarado
Timeout em bulk precisa de direção e contexto de fila	Estado inicial, uma ação e estado resultante	Outra pessoa reproduz o resultado declarado
Descritor certo é necessário, mas não suficiente	Estado inicial, uma ação e estado resultante	Outra pessoa reproduz o resultado declarado
Equipes de firmware devem capturar antes e depois da correção	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: