2026-06-02

Recuperación de halt en endpoints USB: CLEAR_FEATURE, bucles de STALL, fallos bulk y comportamiento de reset del driver

Cómo resolver la recuperación de halt en endpoints USB, CLEAR_FEATURE ENDPOINT_HALT, bucles de STALL repetidos, fallos en bulk transfers, resets del driver y bugs de estado en el firmware.

Los halts en endpoints USB son una fuente frecuente de bugs del estilo "funciona una vez y luego falla". Una bulk transfer se stalled, el driver limpia el halt, el dispositivo hace STALL otra vez y, al final, la aplicación reporta timeout, error de E/S, reset del dispositivo o desconexión. Los usuarios buscan "USB endpoint halt", "CLEAR_FEATURE ENDPOINT_HALT", "USB STALL loop", "bulk endpoint stalled" y "libusb clear halt" cuando el dispositivo no desaparece sin más, pero deja de aceptar tráfico en un endpoint concreto.

Bus Scope ayuda porque la recuperación de un halt es una secuencia, no un único evento. Necesitas ver el primer STALL, la petición de recuperación del host, qué hizo el dispositivo después y si el mismo comando volvió a causar el halt.

Qué significa endpoint halt

Un endpoint halt significa que el endpoint está stalled y no puede continuar con transferencias normales hasta que se limpie la condición de halt. El host puede emitir:

CLEAR_FEATURE(ENDPOINT_HALT)

sobre el endpoint afectado. Después, el data toggle del endpoint y el estado del lado del dispositivo tienen que ser consistentes para que la transferencia se reanude bien.

Si el firmware solo limpia el flag hardware del USB pero no su estado interno de protocolo, la siguiente transferencia puede volver a fallar.

STALL frente a timeout

STALL es explícito. Timeout significa que no hubo completion en el tiempo esperado. Un timeout puede pasar porque el endpoint nunca respondió, porque el dispositivo siguió haciendo NAK, o porque se desconectó.

La recuperación de un endpoint halt empieza con un STALL. Si el host nunca ve un STALL y solo ve un timeout, el camino de recuperación es distinto.

Halt en endpoint bulk

Los endpoints bulk suelen hacer halt cuando un comando es inválido, una fase del protocolo está mal, o el firmware detecta un error.

Ejemplo:

Host -> Device bulk OUT command
Device -> Host STALL on bulk IN
Host -> Device CLEAR_FEATURE(ENDPOINT_HALT)
Host retries bulk IN
Device stalls again

Este patrón sugiere que el halt es síntoma del estado de protocolo del dispositivo, no solo un error de bus transitorio.

La recuperación debe coincidir con la dirección del endpoint

Las direcciones de endpoint incluyen la dirección. El endpoint 0x81 y el 0x01 son direcciones distintas. Limpiar el endpoint equivocado no recupera el pipe stalled.

Comprueba:

¿Qué endpoint hizo STALL?
¿Dirección IN u OUT?
¿El host limpió el mismo endpoint?
¿Las transferencias se reanudaron tras el clear?
¿El data toggle y el estado se recuperaron bien?

Es una fuente frecuente de informes engañosos tipo "el clear halt no funcionó".

Bucles de STALL repetidos

Un STALL repetido tras el clear significa que la causa de fondo sigue ahí:

El host vuelve a mandar un comando no soportado.
El state machine del firmware sigue en error.
El dispositivo espera un reset antes del reintento.
El host lee desde el endpoint equivocado.
La longitud o el checksum del comando están mal.
El data toggle o el estado del endpoint son inconsistentes.
El firmware requiere una class/vendor request antes de reanudar.

La traza debería incluir el comando anterior al primer STALL, no solo los intentos de recuperación.

Comportamiento de reset del driver

Si la recuperación con clear-halt falla, los drivers pueden resetear el dispositivo. Eso puede tapar el error original de endpoint. El usuario ve una reconexión o desaparición del dispositivo, pero la evidencia del bus muestra que el primer fallo real fue un bucle de STALL.

Conserva la línea de tiempo:

Último comando correcto.
Primer STALL.
Intento de clear halt.
Reintento.
STALL o timeout repetido.
Reset del dispositivo o desconexión.

Checklist de depuración

Usa este flujo:

Identifica el endpoint que hizo STALL.
Apunta la dirección del endpoint y el tipo de transferencia.
Inspecciona el comando o transferencia inmediatamente antes del STALL.
Comprueba si el host manda CLEAR_FEATURE(ENDPOINT_HALT).
Confirma que apunta al endpoint correcto.
Mira si la transferencia se reanuda.
Si el STALL se repite, inspecciona el estado del protocolo del firmware.
Busca un reset del dispositivo tras la recuperación fallida.
Compara con una secuencia de comandos conocida como buena.
Conserva suficiente contexto antes del STALL.

Diagnóstico final

La recuperación de halt en un endpoint USB es un problema de state machine. CLEAR_FEATURE(ENDPOINT_HALT) puede limpiar la condición USB del endpoint, pero no arregla automáticamente el estado de protocolo del firmware, los comandos inválidos, los endpoints equivocados ni la lógica de reintento del driver.

Bus Scope ayuda a exponer la secuencia completa de halt y recuperación para que los fallos de endpoint se diagnostiquen desde el comportamiento USB real.

Prueba del contrato USB para «Recuperación de halt en endpoints USB: CLEAR_FEATURE, bucles de STALL, fallos bulk y comportamiento de reset del driver»

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 «Recuperación de halt en endpoints USB: CLEAR_FEATURE, bucles de STALL, fallos bulk y comportamiento de reset del driver», 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 «Recuperación de halt en endpoints USB: CLEAR_FEATURE, bucles de STALL, fallos bulk y comportamiento de reset del driver» es: Cómo resolver la recuperación de halt en endpoints USB, CLEAR_FEATURE ENDPOINT_HALT, bucles de STALL repetidos, fallos en bulk transfers, resets del driver y bugs de estado 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: Recuperación de halt en endpoints USB: CLEARFEATURE, bucles de STALL, fallos bulk y compor

Cierre «Recuperación de halt en endpoints USB: CLEAR_FEATURE, bucles de STALL, fallos bulk y comportamiento de reset del driver» solo cuando el resultado guardado, exportado o reabierto conserve el estado observado. La respuesta temporal de la interfaz orienta, pero la evidencia duradera es más fuerte. Documente cualquier límite pendiente para quien continúe.

Punto de control 2: Cómo resolver la recuperación de halt en endpoints USB, CLEARFEATURE ENDPOINTHALT, bucles

Para «Cómo resolver la recuperación de halt en endpoints USB, CLEAR_FEATURE ENDPOINT_HALT, bucles de STALL repetidos, fallos en bulk transfers, resets del d», separe una decisión del producto de un límite del sistema, hardware, archivo fuente, permiso o proceso. Confirme qué capa produjo la evidencia antes de atribuir una causa. Así evita convertir un síntoma cercano en una causa raíz supuestamente probada.

Punto de control 3: Qué significa endpoint halt

Cierre «Qué significa endpoint halt» solo cuando el resultado guardado, exportado o reabierto conserve el estado observado. La respuesta temporal de la interfaz orienta, pero la evidencia duradera es más fuerte. Documente cualquier límite pendiente para quien continúe.

Punto de control 4: STALL frente a timeout

Para «STALL frente a timeout», separe una decisión del producto de un límite del sistema, hardware, archivo fuente, permiso o proceso. Confirme qué capa produjo la evidencia antes de atribuir una causa. Así evita convertir un síntoma cercano en una causa raíz supuestamente probada.

Punto de control 5: Halt en endpoint bulk

Cierre «Halt en endpoint bulk» solo cuando el resultado guardado, exportado o reabierto conserve el estado observado. La respuesta temporal de la interfaz orienta, pero la evidencia duradera es más fuerte. Documente cualquier límite pendiente para quien continúe.

Punto de control 6: La recuperación debe coincidir con la dirección del endpoint

Para «La recuperación debe coincidir con la dirección del endpoint», separe una decisión del producto de un límite del sistema, hardware, archivo fuente, permiso o proceso. Confirme qué capa produjo la evidencia antes de atribuir una causa. Así evita convertir un síntoma cercano en una causa raíz supuestamente probada.

Punto de control 7: Bucles de STALL repetidos

Cierre «Bucles de STALL repetidos» solo cuando el resultado guardado, exportado o reabierto conserve el estado observado. La respuesta temporal de la interfaz orienta, pero la evidencia duradera es más fuerte. Documente cualquier límite pendiente para quien continúe.

Punto de control 8: Comportamiento de reset del driver

Para «Comportamiento de reset del driver», separe una decisión del producto de un límite del sistema, hardware, archivo fuente, permiso o proceso. Confirme qué capa produjo la evidencia antes de atribuir una causa. Así evita convertir un síntoma cercano en una causa raíz supuestamente probada.

Punto de control 9: Checklist de depuración

Cierre «Checklist de depuración» solo cuando el resultado guardado, exportado o reabierto conserve el estado observado. La respuesta temporal de la interfaz orienta, pero la evidencia duradera es más fuerte. Documente cualquier límite pendiente para quien continúe.

Punto de control 10: Diagnóstico final

Para «Diagnóstico final», separe una decisión del producto de un límite del sistema, hardware, archivo fuente, permiso o proceso. Confirme qué capa produjo la evidencia antes de atribuir una causa. Así evita convertir un síntoma cercano en una causa raíz supuestamente probada.

Matriz de aceptación

Punto	Evidencia que conservar	Condición de aprobado
Recuperación de halt en endpoints USB: CLEARFEATURE, bucles de STALL, fallos bulk y comportamiento de reset del driver	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
Cómo resolver la recuperación de halt en endpoints USB, CLEARFEATURE ENDPOINTHALT, bucles de STALL repetidos, fallos en	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
Qué significa endpoint halt	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
STALL frente a timeout	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
Halt en endpoint bulk	Estado inicial, una acción y estado resultante	Otra persona reproduce el resultado declarado
La recuperación debe coincidir con la dirección del endpoint	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: