Partager via


MuttUtil

MuttUtil effectue diverses tâches sur les appareils MUTT.

  • Met à jour le microprogramme des appareils de test.
  • Installe les pilotes des appareils MUTT.
  • Vérifie que les appareils sont installés sans erreur.
  • Modifie la vitesse du bus de fonctionnement de l'appareil.
  • Configure l'appareil pour qu'il envoie un signal de reprise de réveil après une période de temps spécifiée.
  • Pour le pack MUTT, il configure le hub pour qu'il fonctionne à pleine vitesse ou à grande vitesse, en tant que hub mono-TT ou multi-TT.

MuttUtil est intégré dans la section d'installation des scripts de test inclus pour s'assurer que l'appareil de test est correctement mis à jour avec le dernier microprogramme. L'outil est inclus dans le package logiciel MUTT.

Remarque

Utilisez CMUTTUtil.exe pour les appareils CMUTT (SuperMUTT). Par exemple, exécutez CMuttUtil.exe -updatefirmware pour mettre à jour l'image sur le CMUTT. CMuttUtil.exe peut être installé à partir du package logiciel MUTT décrit dans Vue d'ensemble des appareils Microsoft USB Test Tool (MUTT). Pour plus de détails, voir TypeCSuperMUTT.pdf dans le dossier d'installation.

Comment exécuter MuttUtil

Aide MuttUtil

Exécutez la commande suivante pour obtenir une liste des options de la ligne de commande :

MUTTUtil.exe

Trouver tous les appareils MUTT attachés au système.

MUTTUtil.exe -list

       :   : HARDWARE ID                    : PROBLEM CODE : DRIVER
DEVICE : 0 : USB\VID_045E&PID_0611&REV_0034 : 0            : WINUSB
DEVICE : 1 : USB\VID_045E&PID_078E&REV_8011 : 28           :

Return value: 1

La commande précédente indique que le système est équipé d'un SuperMUTT (1) et d'un MUTT Pack (0). Le pilote en mode noyau fourni par Microsoft, Winusb.sys, est le pilote de fonction pour l'appareil SuperMUTT. Pour plus d’informations sur Winusb.sys, consultez Présentation de WinUSB pour les développeurs.

Le CODE DE PROBLÈME 28 pour l'appareil MUTT Pack indique qu'aucun pilote n'est chargé pour l'appareil.

Modifier la personnalité d'un appareil MUTT

Les appareils MUTT sont également utilisés comme appareils de test pour l'échantillon d'application USB UWP. Pour ce scénario, le microprogramme doit être mis à jour en exécutant l'option -SetWinRTUsb. Dans cet exercice, l'appareil SuperMUTT est configuré avec la personnalité WinRT.

Pour le ramener à la personnalité MUTT, utilisez cette commande :

MuttUtil.exe -# 1 -MuttPersonality

c:\Program Files (x86)\USBTest\x64>MuttUtil.exe -MuttPersonality
Looking for MUTT devices
Send command to change device personality
Return value: 0

c:\Program Files (x86)\USBTest\x64>MuttUtil.exe -list
       :    : HARDWARE ID                    :  PROBLEM CODE  : DRIVER
DEVICE :  0 : USB\VID_045E&PID_078F&REV_0034 :             0  : WINUSB
Return value: 1

Remarquez que l'ID du matériel est remplacé par USB\VID_045E&PID_078F&REV_0037. La version de révision indique le numéro de version du microprogramme.

Installation d'un pilote pour un appareil MUTT

Indiquez le fichier INF du pilote qui contient les informations d'installation. Par exemple,

MUTTUtil.exe -UpdateDriver USBTCD.inf

c:\Program Files (x86)\USBTest\x64>MuttUtil.exe -UpdateDriver USBTCD.inf
Return value: 0

c:\Program Files (x86)\USBTest\x64>MuttUtil.exe -list
       :    : HARDWARE ID                    :  PROBLEM CODE  : DRIVER
DEVICE :  0 : USB\VID_045E&PID_078F&REV_0034 :             0  : USBTCD
Return value: 1

La commande précédente remplace le pilote existant par le pilote USBTCD.sys spécifié. Le pilote est inclus dans le package logiciel MUTT.

Si plusieurs appareils MUTT sont connectés, vous pouvez mettre à jour le pilote simultanément.

MUTTUtil.exe -# 0 -# 1 -MultiUpdateDriver USBTCD.inf usbfx2.inf

La commande précédente installe USBTCD.sys pour l'appareil 0, Winusb.sys pour l'appareil 1, et ainsi de suite.

Mise à jour du microprogramme d'un appareil MUTT

MuttUtil.exe -UpdateFirmware

c:\Program Files (x86)\USBTest\x64>MuttUtil.exe -UpdateFirmware
Looking for MUTT devices
0: Updating device firmware from version 34 to version 37
  Erasing EEPROM -- this takes approx 30 seconds
Writing core firmware image
Writing Table at sector 0x09
Writing Table at sector 0x0A
Writing Table at sector 0x0B
Writing Table at sector 0x0C
Writing Table at sector 0x0D
Writing Table at sector 0x0E
Writing Table at sector 0x0F
Writing Table at sector 0x10
Writing Table at sector 0x08
0: Resetting device
Return value: 0
c:\Program Files (x86)\USBTest\x64>MuttUtil.exe -list
       :    : HARDWARE ID                    :  PROBLEM CODE  : DRIVER
DEVICE :  0 : USB\VID_045E&PID_078F&REV_0037 :             0  : USBTCD
Return value: 1

La commande ne met à jour l'EEPROM avec le microprogramme que si la version présente dans l'appareil est ancienne. L'image du microprogramme est intégrée dans l'outil. Si l'appareil possède une version plus récente que le microprogramme installé par l'outil, celui-ci ne remplace pas le microprogramme de l'appareil. Si vous souhaitez remplacer le microprogramme de l'appareil quelle que soit sa version, exécutez MuttUtil avec l'option -ForceUpdateFirmware à la place.

Une autre façon de mettre à jour le microprogramme est de l'écrire directement dans l'EEPROM ou la RAM. Cette option nécessite que vous disposiez du fichier du microprogramme.

Pour effacer l'EEPROM, utilisez l'option -EraseEEPROM.

Déconnexion, reconnexion et ré-énumération de l'appareil

MuttUtil.exe -Reconnect

MuttUtil.exe -CyclePort

La commande précédente entraîne la déconnexion puis la reconnexion de l'appareil sur le même port.

L'option -CyclePort entraîne la déconnexion de l'appareil et sa reconnexion au port, sauf que l'appareil n'est pas déconnecté électriquement. L'appareil est déconnecté et reconnecté par logiciel. Cette opération entraîne la réinitialisation de l'appareil et le gestionnaire PnP reconstruit le nœud de l'appareil.

Pour réinitialiser le hub d'un appareil MUTT Pack ou SuperMUTT Pack, utilisez cette commande :

MuttUtil.exe -# 1 -ResetHub

Modification de la vitesse de l'appareil

Vous pouvez modifier la vitesse des appareils MUTT à l'aide de cette commande :

MuttUtil.exe -# 0 -SetFullSpeed

MuttUtil.exe -# 1 -SetHighSpeed

La commande fait en sorte que l'appareil se déconnecte puis se reconnecte sur le même port à la vitesse spécifiée.

Si vous souhaitez modifier la vitesse du hub, d'un pack MUTT ou d'un pack SuperMUTT, pour qu'il fonctionne en mode pleine vitesse, utilisez la commande -HubFS :

MuttUtil.exe -# 1 -HubFS

Envoi d'un signal de reprise pour réveiller le système

En règle générale, l'appareil (à faible consommation) envoie un signal de reprise à la suite d'une action de l'utilisateur. Vous pouvez simuler ce comportement en utilisant cette commande :

MuttUtil.exe -WakeAfterSuspend 5000

La commande configure l'appareil pour qu'il envoie un signal de reprise, 5 secondes après la suspension du bus.

Vous pouvez également configurer l'appareil pour qu'il se déconnecte et se reconnecte dans un certain délai après la suspension du bus en utilisant l'option -DisconnectAfterSuspend.

Réglage et effacement de la surintensité sur le port aval - MUTT Pack et SuperMUTT Pack

Ces commandes règlent et effacent la broche de surintensité pour le port exposé du Mutt-Pack.

MuttUtil.exe -# 1 -SetOvercurrent

MuttUtil.exe -# 1 -ClearOvercurrent

Convertir le hub en hub TT haute vitesse - MUTT Pack et SuperMUTT Pack

Vous pouvez configurer le hub pour qu'il fonctionne comme un hub haute vitesse multi-TT ou comme un hub haute vitesse simple-TT en utilisant les commandes suivantes

MuttUtil.exe -# 1 -HubHSMultiTT

MuttUtil.exe -# 1 -HubHSSingleTT