2026-06-02

STALL en transferencias de control USB: depurando setup packets, endpoint cero y peticiones fallidas

Cómo diagnosticar STALLs en transferencias de control USB, campos del setup packet, comportamiento del endpoint cero, class requests, vendor requests, fallos de descriptores y manejo de peticiones en el firmware.

Las transferencias de control USB son la base de la enumeración y de la gestión del dispositivo. Leen descriptores, asignan direcciones, seleccionan configuraciones, cambian interfaces, lanzan class requests y mandan comandos vendor-specific. Cuando una transferencia de control hace STALL, los usuarios pueden ver "USB device not recognized", "control transfer failed", "libusb control transfer error", "endpoint zero stalled" o un actualizador de firmware que se queda en la inicialización.

Búsquedas como "USB control transfer STALL", "USB setup packet debugging", "endpoint zero stall", "GET_DESCRIPTOR failed" y "vendor request stalled" suelen significar que el fallo pasó antes de que pudiera arrancar el tráfico bulk, interrupt o isochronous normal.

Bus Scope ayuda porque el setup packet explica la petición. Sin él, un STALL es solo un error genérico.

Qué contiene una transferencia de control

Una transferencia de control USB tiene etapas:

Setup stage.
Data stage opcional.
Status stage.

El setup packet contiene:

bmRequestType.
bRequest.
wValue.
wIndex.
wLength.

Esos campos definen la dirección, el request type, el recipient, el código de petición, el descriptor type, la interfaz, el endpoint y la longitud de datos esperada.

Si el dispositivo hace STALL, inspecciona primero el setup packet.

El endpoint cero es especial

El endpoint cero existe para todo dispositivo USB. Se usa durante la enumeración y en operaciones de control. Si el endpoint cero se comporta mal, puede que el host nunca llegue a enlazar el driver normal.

Fallos del endpoint cero pueden aparecer como:

Petición de device descriptor fallida.
Lectura de configuration descriptor fallida.
String descriptor request stalled.
SET_CONFIGURATION fallido.
Class-specific request fallida.
Comando vendor fallido.

Para firmware a medida, la corrección del endpoint cero es innegociable.

Un STALL puede ser válido

No todo STALL es un bug. Un dispositivo puede legítimamente hacer STALL en una petición no soportada. La pregunta es si el host esperaba soporte y si el estado del dispositivo admite la petición.

Ejemplos:

Vendor request no soportada: el STALL puede ser correcto.
Índice de descriptor inválido: el STALL puede ser correcto.
Class request obligatoria durante enumeración: el STALL puede romper el binding de driver.
Petición DFU en estado incorrecto: el STALL puede indicar un desajuste de state machine.

El significado depende del request type y del timing.

Fallos en peticiones de descriptor

Los STALLs de descriptor son habituales en stacks USB a medida. Fíjate en:

Descriptor type incorrecto en wValue.
Índice de string no soportado.
Desajuste de longitud total de configuración.
Dispositivo que devuelve menos datos de los pedidos de forma incorrecta.
Dispositivo que no maneja lecturas iniciales cortas del descriptor.
Firmware que asume un único patrón de petición del host.

Distintos sistemas operativos piden los descriptores en órdenes distintos. Un dispositivo que funciona en Linux puede hacer STALL en una petición que Windows envía durante la enumeración.

Class y vendor requests

Las class requests se interpretan por clase USB. HID, CDC, DFU, Audio, Video, Mass Storage y dispositivos vendor-specific tienen expectativas de peticiones.

Ejemplos habituales:

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.

Si una class request hace STALL, comprueba si el número de interfaz en wIndex coincide con la interfaz objetivo. Los dispositivos compuestos fallan a menudo porque el host envía la petición a una interfaz y el firmware la atiende en otra.

Checklist de depuración

Usa este flujo:

Captura desde el momento del plug-in.
Encuentra el primer STALL en una transferencia de control.
Decodifica los campos del setup packet.
Determina si la petición es standard, class o vendor-specific.
Determina el recipient: device, interface, endpoint u other.
Comprueba wValue, wIndex y wLength.
Compara con los descriptores y el estado actual del dispositivo.
Mira si el STALL es esperado o fatal.
Busca peticiones de recuperación como clear feature o reset.
Compara el orden de peticiones del SO si el comportamiento cambia entre plataformas.

Diagnóstico final

Un STALL en transferencia de control USB no basta por sí solo. El setup packet es el ancla del diagnóstico. Dice qué petición falló, qué recipient fue direccionado, cuánta data se esperaba y si el estado del dispositivo hacía la petición válida.

Bus Scope ayuda a exponer la evidencia del endpoint cero y los setup packets para que los equipos de firmware, driver y QA puedan depurar con precisión los fallos del camino de control.

Prueba del contrato USB para «STALL en transferencias de control USB: depurando setup packets, endpoint cero y peticiones fallidas»

La respuesta directa es que STALL, timeout o reset no explica por sí solo la causa. Primero demuestra que el proveedor observa el dispositivo correcto; después lee el contrato de transferencia: tipo, dirección, recipient, wValue, wIndex, longitud declarada y real, status y estado anterior y posterior. En «STALL en transferencias de control USB: depurando setup packets, endpoint cero y peticiones fallidas», relaciona la conclusión con la primera transacción que difiere de un caso bueno.

Límite	Qué comparar	Decisión útil
Plataforma	proveedor, permiso, Root Hub o usbmon/XHC20	¿Llegan records de la conexión correcta?
Setup	bmRequestType, bRequest, wValue, wIndex, wLength	¿El host envía la petición prevista?
Data	dirección, longitud y bytes retenidos	¿El payload cumple el contrato?
Status	ACK, STALL, timeout o cancellation	¿Dónde termina la transacción?
Estado	configuration, interface, alternate setting, endpoint halt	¿El dispositivo estaba preparado?

Empieza antes de reset y enumeración y conserva descriptors, SET_CONFIGURATION, SET_INTERFACE y el comando previo al fallo. Un filtro estrecho de endpoint puede ocultar el control transfer decisivo. Ejecuta una sola acción USB documentada por prueba y cambia solo firmware, driver, puerto, cable, comando o timing.

¿Cómo se escribe una respuesta citable?

Indica la petición observada, sus campos setup, la respuesta y el contexto anterior; propone después una prueba con un solo cambio. Bytes no retenidos por el límite de captura no prueban packet loss. La proximidad entre command y reset demuestra correlación, no causa sin repetición o transición de estado.

¿Cuándo vale una comparación?

Mantén VID/PID, firmware, speed, topología, proveedor, filtro y trigger. Compara fases USB semánticas y no frame numbers entre usbmon y USBPcap. Anota inicio, final, versión, OS, conexión y checksum. Revisa la solución de problemas de Bus Scope.

Los propietarios Semrush siguen separados: free USB analyzer en la página de producto, best USB protocol analyzer en la comparación y USB descriptor viewer en la guía de descriptors. Esta página de soporte no recibe volumen o KD inventado.

Respuesta directa y límite de aceptación

La respuesta breve a «STALL en transferencias de control USB: depurando setup packets, endpoint cero y peticiones fallidas» es: Cómo diagnosticar STALLs en transferencias de control USB, campos del setup packet, comportamiento del endpoint cero, class requests, vendor requests, fallos de descriptores y manejo de peticiones en el firmware. Trate esa frase como un resultado que debe comprobarse, no como una promesa para cualquier entrada, dispositivo, proyecto o entorno. Un resultado completo registra estado inicial, acción exacta, salida visible y condición que demuestra que la tarea terminó en Bus Scope.

Procedimiento basado en evidencia

Empiece con un caso pequeño y repetible antes de cambiar un proyecto completo. Anote versión de la aplicación, sistema operativo, identidad de entrada o dispositivo, ajustes relevantes y resultado esperado. Ejecute una acción deliberada, conserve la primera transición inesperada y compárela con un caso conocido cuando exista. Cambiar varios controles a la vez oculta qué condición creó o corrigió el problema.

Punto de control 1: STALL en transferencias de control USB: depurando setup packets, endpoint cero y peticione

Convierta «STALL en transferencias de control USB: depurando setup packets, endpoint cero y peticiones fallidas» en una afirmación de aprobado o fallo que otra persona pueda repetir. Incluya qué debe aparecer, qué debe estar ausente y qué recuperación es segura. Mantenga intacto el proyecto o captura original hasta que la copia corregida pase la misma prueba.

Punto de control 2: Cómo diagnosticar STALLs en transferencias de control USB, campos del setup packet, compor

Trate «Cómo diagnosticar STALLs en transferencias de control USB, campos del setup packet, comportamiento del endpoint cero, class requests, vendor requests,» como una puerta de aceptación independiente para «STALL en transferencias de control USB: depurando setup packets, endpoint cero y peticiones fallidas». Registre el estado inicial, el primer cambio visible y el estado final. Si el resultado no coincide con el objetivo descrito, vuelva al último punto confirmado en lugar de continuar sobre suposiciones.

Punto de control 3: Qué contiene una transferencia de control

Convierta «Qué contiene una transferencia de control» en una afirmación de aprobado o fallo que otra persona pueda repetir. Incluya qué debe aparecer, qué debe estar ausente y qué recuperación es segura. Mantenga intacto el proyecto o captura original hasta que la copia corregida pase la misma prueba.

Punto de control 4: El endpoint cero es especial

Trate «El endpoint cero es especial» como una puerta de aceptación independiente para «STALL en transferencias de control USB: depurando setup packets, endpoint cero y peticiones fallidas». Registre el estado inicial, el primer cambio visible y el estado final. Si el resultado no coincide con el objetivo descrito, vuelva al último punto confirmado en lugar de continuar sobre suposiciones.

Punto de control 5: Un STALL puede ser válido

Convierta «Un STALL puede ser válido» en una afirmación de aprobado o fallo que otra persona pueda repetir. Incluya qué debe aparecer, qué debe estar ausente y qué recuperación es segura. Mantenga intacto el proyecto o captura original hasta que la copia corregida pase la misma prueba.

Punto de control 6: Fallos en peticiones de descriptor

Trate «Fallos en peticiones de descriptor» como una puerta de aceptación independiente para «STALL en transferencias de control USB: depurando setup packets, endpoint cero y peticiones fallidas». Registre el estado inicial, el primer cambio visible y el estado final. Si el resultado no coincide con el objetivo descrito, vuelva al último punto confirmado en lugar de continuar sobre suposiciones.

Punto de control 7: Class y vendor requests

Convierta «Class y vendor requests» en una afirmación de aprobado o fallo que otra persona pueda repetir. Incluya qué debe aparecer, qué debe estar ausente y qué recuperación es segura. Mantenga intacto el proyecto o captura original hasta que la copia corregida pase la misma prueba.

Punto de control 8: Checklist de depuración

Trate «Checklist de depuración» como una puerta de aceptación independiente para «STALL en transferencias de control USB: depurando setup packets, endpoint cero y peticiones fallidas». Registre el estado inicial, el primer cambio visible y el estado final. Si el resultado no coincide con el objetivo descrito, vuelva al último punto confirmado en lugar de continuar sobre suposiciones.

Punto de control 9: Diagnóstico final

Convierta «Diagnóstico final» en una afirmación de aprobado o fallo que otra persona pueda repetir. Incluya qué debe aparecer, qué debe estar ausente y qué recuperación es segura. Mantenga intacto el proyecto o captura original hasta que la copia corregida pase la misma prueba.

Punto de control 10: Prueba del contrato USB para «STALL en transferencias de control USB: depurando setup pack

Trate «Prueba del contrato USB para «STALL en transferencias de control USB: depurando setup packets, endpoint cero y peticiones fallidas»» como una puerta de aceptación independiente para «STALL en transferencias de control USB: depurando setup packets, endpoint cero y peticiones fallidas». Registre el estado inicial, el primer cambio visible y el estado final. Si el resultado no coincide con el objetivo descrito, vuelva al último punto confirmado en lugar de continuar sobre suposiciones.

Matriz de aceptación

Punto	Evidencia que conservar	Condición de aprobado
STALL en transferencias de control USB: depurando setup packets, endpoint cero y peticiones fallidas	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
Cómo diagnosticar STALLs en transferencias de control USB, campos del setup packet, comportamiento del endpoint cero, cl	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
Qué contiene una transferencia de control	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
El endpoint cero es especial	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
Un STALL puede ser válido	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
Fallos en peticiones de descriptor	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado

Aislamiento, recuperación y entrega

Deténgase en el primer límite que falla. Conserve fuente, proyecto, sesión o captura, duplíquelo antes de una edición destructiva y cambie una variable por experimento. Repetir un flujo amplio después de varios cambios puede dar otro resultado sin explicar la causa.

Separe ausencia de evidencia de evidencia de ausencia. Una vista vacía puede indicar entrada, alcance, filtro, permiso, dispositivo, intervalo o estado equivocado. Verifique adquisición o importación antes de interpretar el decoder, editor, informe o exportación.

Antes de entregar, reabra el artefacto y revise inicio, punto de decisión y final. Registre versión, plataforma, configuración, expectativa, observación y reproducción mínima. Elimine o redacte datos sensibles y confirme que el destinatario está autorizado.

Preguntas y respuestas

¿Cuál es la forma fiable más rápida de empezar?

Use el caso representativo más pequeño, escriba el resultado esperado y cambie una variable. Confirme el recorrido básico antes de añadir filtros, efectos, ediciones, automatización o una fuente mayor.

¿Qué evidencia debe guardarse?

Conserve identidad de entrada, versión, plataforma, ajustes, acción exacta, primera transición inesperada y salida final. Cierre y reabra cualquier proyecto, sesión, informe o exportación antes de considerarlo duradero.

¿Cuándo debe repetirse el procedimiento?

Repítalo después de cambios relevantes en aplicación, sistema, driver, firmware, modelo, fuente o flujo. Preserve el caso aceptado anterior como referencia sin modificar.

¿Cuándo está listo para entregar?

Cuando otra persona autorizada identifica la entrada, repite la acción, obtiene el mismo resultado, entiende los límites restantes y abre el artefacto sin depender de estado local no documentado.

Guías relacionadas

Estas páginas en el mismo idioma cubren etapas contiguas sin cambiar el propietario canónico del tema: