2026-06-02

Débogage des feature reports USB HID : GET_REPORT, SET_REPORT, commandes vendor et paramètres manquants

Comment diagnostiquer les échecs de HID Feature Report, GET_REPORT, SET_REPORT, report IDs, transferts de contrôle, paramètres vendor, configuration de périphérique et bugs firmware USB HID.

Les périphériques HID ne sont pas que des claviers et souris. Ils incluent des clés de sécurité, capteurs, panneaux de contrôle, outils vendor, périphériques industriels, manettes de jeu, onduleurs et interfaces de configuration personnalisées. Beaucoup de ces périphériques utilisent des HID Feature Reports pour la configuration et le statut. Quand les Feature Reports échouent, les utilisateurs cherchent « HID Feature Report not working », « GET_REPORT failed », « SET_REPORT failed », « HID report ID mismatch » ou « USB HID vendor command timeout » car l'entrée normale peut marcher alors que la configuration non.

Bus Scope est utile car les Feature Reports passent souvent par l'endpoint zéro comme transferts de contrôle. Le setup packet réel, le type de rapport, le report ID, la longueur et le statut de réponse comptent.

Ce que sont les Feature Reports

HID a plusieurs types de rapports :

Input reports
Output reports
Feature reports

Les input reports arrivent souvent sur des endpoints interrupt IN. Les feature reports sont généralement demandés avec des transferts de contrôle en utilisant GET_REPORT ou SET_REPORT.

Si les boutons d'un périphérique marchent mais que son panneau de paramètres échoue, la gestion des Feature Reports peut être en cause.

Décalages de report ID et de longueur

Beaucoup de périphériques HID utilisent des report IDs. Si l'hôte inclut le report ID 3 et que le firmware attend le report ID 0, la requête peut échouer ou renvoyer de mauvaises données.

Bugs fréquents :

Le firmware omet l'octet de report ID.
L'hôte envoie une mauvaise longueur de rapport.
Le descripteur déclare une longueur, le firmware en renvoie une autre.
Feature report existe dans le firmware mais pas dans le descripteur.
Le descripteur déclare un rapport que le firmware n'implémente jamais.

Le HID report descriptor et le transfert de contrôle doivent être comparés.

Preuves GET_REPORT et SET_REPORT

Cherchez :

Type de requête du setup packet.
HID GET_REPORT ou SET_REPORT.
Type de rapport Feature.
Report ID.
wLength.
Octets de la data stage.
STALL ou timeout.

Si le périphérique stall un Feature Report que son descripteur annonce, la cohérence firmware ou descripteur est suspecte.

Configuration vendor via HID

Beaucoup de produits utilisent HID parce que cela évite des pilotes noyau personnalisés. Les paramètres vendor peuvent être implémentés comme Feature Reports.

Exemples :

Changer le taux d'échantillonnage.
Lire la version firmware.
Définir le mode LED.
Configurer la plage du capteur.
Activer le bootloader.
Lire les données de calibration.

Si ces commandes échouent, le périphérique peut quand même apparaître comme un périphérique HID valide.

Checklist de débogage

Suivez ce processus :

Capturez l'énumération et le descripteur HID.
Enregistrez le HID report descriptor.
Identifiez les définitions de Feature Report.
Capturez le GET_REPORT ou SET_REPORT défaillant.
Vérifiez le report ID.
Vérifiez la longueur demandée.
Comparez la longueur du descripteur avec la longueur du transfert.
Cherchez STALL, timeout ou réponse courte.
Comparez les input reports qui marchent avec les feature reports défaillants.
Conservez ensemble descripteur et transfert de contrôle.

Diagnostic final

Les échecs de HID Feature Report sont généralement des problèmes de descripteur, report ID, longueur, état firmware ou de gestion de transfert de contrôle. L'entrée peut marcher alors que la configuration échoue.

Bus Scope aide à exposer le contrat HID et le transfert de contrôle exact qui a échoué, rendant les bugs de Feature Report diagnostiquables au lieu de mystérieuses erreurs d'outils vendor.

Test du contrat USB pour « Débogage des feature reports USB HID : GET_REPORT, SET_REPORT, commandes vendor et paramètres manquants »

La réponse directe est qu’un STALL, timeout ou reset n’explique pas seul la cause. Prouvez d’abord que le fournisseur voit le bon périphérique, puis lisez le contrat du transfer : type, direction, recipient, wValue, wIndex, longueur annoncée et réelle, status et état avant/après. Pour « Débogage des feature reports USB HID : GET_REPORT, SET_REPORT, commandes vendor et paramètres manquants », reliez la conclusion à la première transaction différente d’un cas nominal.

Limite	Comparaison	Décision
Plateforme	fournisseur, droits, Root Hub ou usbmon/XHC20	Les records viennent-ils de la bonne connexion ?
Setup	bmRequestType, bRequest, wValue, wIndex, wLength	L’hôte envoie-t-il la requête prévue ?
Data	direction, longueur et bytes conservés	Le payload respecte-t-il le contrat ?
Status	ACK, STALL, timeout ou cancellation	Où finit réellement la transaction ?
État	configuration, interface, alternate setting, endpoint halt	Le périphérique était-il prêt ?

Commencez avant reset et énumération et gardez descriptors, SET_CONFIGURATION, SET_INTERFACE et la commande avant défaut. Un filtre endpoint étroit peut masquer le control transfer décisif. Exécutez une seule action USB documentée par essai et ne changez que firmware, driver, port, câble, commande ou timing.

Comment rédiger une réponse réutilisable ?

Nommez requête, champs setup, réponse et contexte précédent, puis un test à variable unique. Des bytes non retenus ne prouvent pas packet loss. La proximité entre command et reset établit une corrélation, pas la cause sans répétition ou transition d’état.

Quand la comparaison est-elle valide ?

Gardez VID/PID, firmware, speed, topologie, fournisseur, filtre et trigger. Comparez les phases USB sémantiques, pas les frame numbers entre usbmon et USBPcap. Notez début, fin, version, OS, connexion et checksum. Consultez le dépannage Bus Scope.

Les propriétaires Semrush restent distincts : free USB analyzer sur la page produit, best USB protocol analyzer dans la comparaison et USB descriptor viewer dans le guide descriptor. Aucun volume ou KD n’est inventé pour cette page de support.

Réponse directe et limite d’acceptation

La réponse courte à « Débogage des feature reports USB HID : GET_REPORT, SET_REPORT, commandes vendor et paramètres manquants » est la suivante : Comment diagnostiquer les échecs de HID Feature Report, GET_REPORT, SET_REPORT, report IDs, transferts de contrôle, paramètres vendor, configuration de périphérique et bugs firmware USB HID. Considérez cette phrase comme un résultat à vérifier, et non comme une promesse valable pour toute entrée, tout appareil, tout projet ou tout environnement. Un résultat complet consigne l’état initial, l’action exacte, la sortie visible et la condition qui prouve la fin de la tâche dans Bus Scope.

Procédure fondée sur les preuves

Commencez par un cas petit et répétable avant de modifier un projet complet. Notez version de l’application, système, identité de l’entrée ou de l’appareil, réglages pertinents et résultat attendu. Exécutez une action volontaire, conservez la première transition inattendue et comparez-la à un cas nominal si possible. Plusieurs changements simultanés masquent la condition qui a créé ou corrigé le problème.

Point de contrôle 1 : Débogage des feature reports USB HID : GETREPORT, SETREPORT, commandes vendor et paramètre

Transformez « Débogage des feature reports USB HID : GET_REPORT, SET_REPORT, commandes vendor et paramètres manquants » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Point de contrôle 2 : Comment diagnostiquer les échecs de HID Feature Report, GETREPORT, SETREPORT, report IDs,

Traitez « Comment diagnostiquer les échecs de HID Feature Report, GET_REPORT, SET_REPORT, report IDs, transferts de contrôle, paramètres vendor, configuration d » comme une porte d’acceptation distincte pour « Débogage des feature reports USB HID : GET_REPORT, SET_REPORT, commandes vendor et paramètres manquants ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Point de contrôle 3 : Ce que sont les Feature Reports

Transformez « Ce que sont les Feature Reports » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Point de contrôle 4 : Décalages de report ID et de longueur

Traitez « Décalages de report ID et de longueur » comme une porte d’acceptation distincte pour « Débogage des feature reports USB HID : GET_REPORT, SET_REPORT, commandes vendor et paramètres manquants ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Point de contrôle 5 : Preuves GETREPORT et SETREPORT

Transformez « Preuves GETREPORT et SETREPORT » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Point de contrôle 6 : Configuration vendor via HID

Traitez « Configuration vendor via HID » comme une porte d’acceptation distincte pour « Débogage des feature reports USB HID : GET_REPORT, SET_REPORT, commandes vendor et paramètres manquants ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Point de contrôle 7 : Checklist de débogage

Transformez « Checklist de débogage » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Point de contrôle 8 : Diagnostic final

Traitez « Diagnostic final » comme une porte d’acceptation distincte pour « Débogage des feature reports USB HID : GET_REPORT, SET_REPORT, commandes vendor et paramètres manquants ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Point de contrôle 9 : Test du contrat USB pour « Débogage des feature reports USB HID : GETREPORT, SETREPORT, co

Transformez « Test du contrat USB pour « Débogage des feature reports USB HID : GETREPORT, SETREPORT, commandes vendor et paramètres manquants » » en critère réussite/échec reproductible. Indiquez ce qui doit être présent, absent et quelle reprise reste sûre. Conservez le projet ou la capture d’origine jusqu’à ce que la copie corrigée réussisse le même contrôle.

Point de contrôle 10 : Comment rédiger une réponse réutilisable ?

Traitez « Comment rédiger une réponse réutilisable ? » comme une porte d’acceptation distincte pour « Débogage des feature reports USB HID : GET_REPORT, SET_REPORT, commandes vendor et paramètres manquants ». Consignez l’état avant l’action, le premier changement visible et l’état final. Si le résultat diffère de l’objectif décrit, revenez au dernier point confirmé au lieu de poursuivre sur des hypothèses.

Matrice d’acceptation

Point	Preuve à conserver	Critère de réussite
Débogage des feature reports USB HID : GETREPORT, SETREPORT, commandes vendor et paramètres manquants	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Comment diagnostiquer les échecs de HID Feature Report, GETREPORT, SETREPORT, report IDs, transferts de contrôle, paramè	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Ce que sont les Feature Reports	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Décalages de report ID et de longueur	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Preuves GETREPORT et SETREPORT	État initial, une action et état obtenu	Une seconde personne reproduit le résultat
Configuration vendor via HID	État initial, une action et état obtenu	Une seconde personne reproduit le résultat

Isolation, reprise et transmission

Arrêtez-vous à la première limite en échec. Conservez source, projet, session ou capture, dupliquez avant toute modification destructive et changez une variable par essai. Rejouer un flux entier après plusieurs changements peut modifier le résultat sans expliquer pourquoi.

Distinguez absence de preuve et preuve d’absence. Une vue vide peut signaler mauvaise entrée, portée, filtre, permission, appareil, période ou état du projet. Vérifiez acquisition ou import avant d’interpréter décodeur, éditeur, rapport ou export.

Avant transmission, rouvrez l’artefact durable et inspectez début, point de décision et fin. Notez version, plateforme, configuration, attente, observation et reproduction minimale. Retirez ou masquez les données sensibles et confirmez l’autorisation du destinataire.

Questions et réponses

Quelle est la manière fiable la plus rapide de commencer ?

Utilisez le plus petit cas représentatif, écrivez le résultat attendu et ne changez qu’une variable. Validez le parcours de base avant d’ajouter filtres, effets, modifications, automatisation ou grande source.

Quelles preuves faut-il conserver ?

Gardez identité de l’entrée, version, plateforme, réglages, action exacte, première transition inattendue et sortie finale. Fermez puis rouvrez projet, session, rapport ou export avant de le considérer durable.

Quand faut-il répéter la procédure ?

Répétez-la après un changement pertinent d’application, système, pilote, firmware, modèle, source ou processus. Conservez le cas accepté précédent comme référence non modifiée.

Quand le résultat est-il transmissible ?

Lorsqu’une seconde personne autorisée identifie l’entrée, répète l’action, obtient le même résultat, comprend les limites et ouvre l’artefact sans état local non documenté.

Guides associés

Ces pages dans la même langue couvrent les étapes voisines sans changer le propriétaire canonique du sujet :