2026-06-02

STALL en endpoint y timeout en bulk transfer USB: leyendo la captura antes de tocar el firmware

Cómo depurar STALLs en endpoints USB, timeouts en bulk transfers y fallos del data path en el firmware a partir de evidencia de transferencia.

Tras una enumeración correcta, los dispositivos USB pueden seguir fallando de formas que parecen misteriosas al desarrollador: "lecturas bulk con timeout, escrituras que nunca terminan, HID reports que dejan de llegar o el host reportando un STALL en el endpoint. Esas fallas se tratan a menudo como bugs del driver o cuelgues aleatorios del firmware. Una captura suele acotar el problema mucho antes." Los fallos de endpoint son evidencia del data path. Ocurren después de que el host ha aprendido la forma del dispositivo. Eso significa que los descriptores pueden ser correctos y aun así el endpoint comportarse mal.

STALL es una señal, no solo un error

Un endpoint USB puede devolver STALL para indicar que no puede procesar una petición o que un comando class/vendor no está soportado. Los stalls del endpoint de control durante class requests pueden ser legítimos si la petición es inválida. Los stalls de endpoints de datos durante el flujo normal de transferencia suelen requerir inspección más detallada.

Preguntas para la captura:

¿Qué endpoint hizo stall?
¿Era control, bulk, interrupt o isochronous?
¿Qué petición o transferencia precedió al stall?
¿El host limpió la condición de halt?
¿Se reanudó el tráfico tras CLEAR_FEATURE(ENDPOINT_HALT)?
¿El firmware hizo stall a propósito en comandos no soportados?

Sin ese contexto, "endpoint stalled" es demasiado vago para actuar.

Los timeouts en bulk necesitan contexto de dirección y cola

Un timeout en bulk transfer puede significar muchas cosas:

El host esperaba datos IN pero el dispositivo no tenía ninguno listos.
El dispositivo esperaba datos OUT pero la aplicación dejó de escribir.
El buffer del endpoint en firmware no estaba armado.
El driver del host envió una read más grande de lo que soporta el firmware.
El dispositivo hizo NAK hasta el timeout.
La dirección o el endpoint eran incorrectos.
Un stall previo no se había limpiado.

Lo primero a inspeccionar es la dirección. Un timeout en bulk IN y un timeout en bulk OUT son casos distintos. Para IN, mira si el dispositivo llegó a devolver datos. Para OUT, mira si el host mandó datos y si el dispositivo los acusó.

Que el descriptor sea correcto es necesario, pero no suficiente

Un descriptor puede declarar bien un endpoint bulk IN y aun así el dispositivo no enviar datos útiles. Un dispositivo CDC puede enumerar como puerto serie y aun así ignorar el line coding o el control line state. Una interfaz vendor-specific puede exponer endpoints pero requerir un comando de inicialización antes de mover datos.

Eso significa que la depuración de endpoints tiene que combinar:

Evidencia de descriptor.
Class o vendor setup requests.
Dirección de la transferencia.
Longitud del payload.
Resultado de status.
Timing e intentos repetidos.

La captura debería enseñar si el host está pidiendo algo irrazonable o si el firmware no está cumpliendo una petición válida.

Los equipos de firmware deberían capturar antes y después del fix

Para bugs de endpoint, las capturas antes y después valen mucho. La primera prueba el fallo. La segunda prueba el fix. Una buena comparación enseña:

Mismo dispositivo y configuración.
Mismas direcciones de endpoint.
Mismo patrón de peticiones del host.
La captura vieja hace stall o timeout.
La captura nueva completa y lleva el payload esperado.

Eso facilita mucho la revisión de regresiones de firmware. También da al equipo de soporte un artefacto repetible cuando los clientes reportan que "el USB se queda colgado al azar".

Dónde encaja Bus Scope

Bus Scope está orientado a evidencia USB, no a proliferación genérica de protocolos. Para STALLs y timeouts en endpoints, debería mantener cerca el detalle del paquete, los metadatos del endpoint, los bytes en crudo, el tipo de transferencia y la interpretación de clase.

La salida útil es:

Endpoint y dirección.
Tipo de transferencia.
Petición o transferencia antes del fallo.
Evidencia de status.
Payload en crudo alrededor del fallo.
Si el problema sigue a la enumeración, al setup de clase o al tráfico de aplicación.

Esa es la información que necesitan los ingenieros de firmware antes de tocar la lógica de buffer del endpoint o el comportamiento de reintentos del host.

Si tu búsqueda es "USB bulk transfer timeout" o "USB endpoint stalled", no empieces reescribiendo todo el stack del dispositivo. Captura primero la evidencia del endpoint.

Prueba del contrato USB para «STALL en endpoint y timeout en bulk transfer USB: leyendo la captura antes de tocar el firmware»

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 endpoint y timeout en bulk transfer USB: leyendo la captura antes de tocar el firmware», 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 endpoint y timeout en bulk transfer USB: leyendo la captura antes de tocar el firmware» es: Cómo depurar STALLs en endpoints USB, timeouts en bulk transfers y fallos del data path en el firmware a partir de evidencia de transferencia. 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 endpoint y timeout en bulk transfer USB: leyendo la captura antes de tocar el fir

Si «STALL en endpoint y timeout en bulk transfer USB: leyendo la captura antes de tocar el firmware» es ambiguo, compare un caso bueno y otro fallido bajo condiciones equivalentes. Marque la primera diferencia significativa en vez de enumerar todos los síntomas posteriores. Ese límite suele producir una consulta más clara y un experimento más seguro.

Punto de control 2: Cómo depurar STALLs en endpoints USB, timeouts en bulk transfers y fallos del data path en

Compruebe «Cómo depurar STALLs en endpoints USB, timeouts en bulk transfers y fallos del data path en el firmware a partir de evidencia de transferencia.» con la entrada representativa más pequeña. Mantenga iguales los ajustes no relacionados, repita la misma acción y revise el resultado después de reabrir o reconectar. Una captura aislada es más débil que un registro con entrada, ajuste, acción, salida y hora.

Punto de control 3: STALL es una señal, no solo un error

Si «STALL es una señal, no solo un error» es ambiguo, compare un caso bueno y otro fallido bajo condiciones equivalentes. Marque la primera diferencia significativa en vez de enumerar todos los síntomas posteriores. Ese límite suele producir una consulta más clara y un experimento más seguro.

Punto de control 4: Los timeouts en bulk necesitan contexto de dirección y cola

Compruebe «Los timeouts en bulk necesitan contexto de dirección y cola» con la entrada representativa más pequeña. Mantenga iguales los ajustes no relacionados, repita la misma acción y revise el resultado después de reabrir o reconectar. Una captura aislada es más débil que un registro con entrada, ajuste, acción, salida y hora.

Punto de control 5: Que el descriptor sea correcto es necesario, pero no suficiente

Si «Que el descriptor sea correcto es necesario, pero no suficiente» es ambiguo, compare un caso bueno y otro fallido bajo condiciones equivalentes. Marque la primera diferencia significativa en vez de enumerar todos los síntomas posteriores. Ese límite suele producir una consulta más clara y un experimento más seguro.

Punto de control 6: Los equipos de firmware deberían capturar antes y después del fix

Compruebe «Los equipos de firmware deberían capturar antes y después del fix» con la entrada representativa más pequeña. Mantenga iguales los ajustes no relacionados, repita la misma acción y revise el resultado después de reabrir o reconectar. Una captura aislada es más débil que un registro con entrada, ajuste, acción, salida y hora.

Punto de control 7: Dónde encaja Bus Scope

Si «Dónde encaja Bus Scope» es ambiguo, compare un caso bueno y otro fallido bajo condiciones equivalentes. Marque la primera diferencia significativa en vez de enumerar todos los síntomas posteriores. Ese límite suele producir una consulta más clara y un experimento más seguro.

Punto de control 8: Prueba del contrato USB para «STALL en endpoint y timeout en bulk transfer USB: leyendo la

Compruebe «Prueba del contrato USB para «STALL en endpoint y timeout en bulk transfer USB: leyendo la captura antes de tocar el firmware»» con la entrada representativa más pequeña. Mantenga iguales los ajustes no relacionados, repita la misma acción y revise el resultado después de reabrir o reconectar. Una captura aislada es más débil que un registro con entrada, ajuste, acción, salida y hora.

Punto de control 9: ¿Cómo se escribe una respuesta citable?

Si «¿Cómo se escribe una respuesta citable?» es ambiguo, compare un caso bueno y otro fallido bajo condiciones equivalentes. Marque la primera diferencia significativa en vez de enumerar todos los síntomas posteriores. Ese límite suele producir una consulta más clara y un experimento más seguro.

Punto de control 10: ¿Cuándo vale una comparación?

Compruebe «¿Cuándo vale una comparación?» con la entrada representativa más pequeña. Mantenga iguales los ajustes no relacionados, repita la misma acción y revise el resultado después de reabrir o reconectar. Una captura aislada es más débil que un registro con entrada, ajuste, acción, salida y hora.

Matriz de aceptación

Punto	Evidencia que conservar	Condición de aprobado
STALL en endpoint y timeout en bulk transfer USB: leyendo la captura antes de tocar el firmware	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
Cómo depurar STALLs en endpoints USB, timeouts en bulk transfers y fallos del data path en el firmware a partir de evide	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
STALL es una señal, no solo un error	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
Los timeouts en bulk necesitan contexto de dirección y cola	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
Que el descriptor sea correcto es necesario, pero no suficiente	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
Los equipos de firmware deberían capturar antes y después del fix	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: