MuttUtil

  • [アーティクル]

MuttUtil は、MUTT デバイスでさまざまなタスクを実行します。

  • テスト デバイスのファームウェアを更新します。
  • MUTT デバイスのドライバーをインストールします。
  • デバイスがエラーなしでインストールされていることを確認します。
  • デバイスの動作バス速度を変更します。
  • 指定された時間が経過した後に再開ウェイク信号を送信するようにデバイスを構成します。
  • MUTT パックの場合、ハブが最大速度または高速で動作するように設定します。シングル TT ハブまたはマルチ TT ハブとして使用できます。

MuttUtil は、含まれているテスト スクリプトのインストール セクションに埋め込まれており、テスト デバイスが最新のファームウェアに適切にアップグレードされていることを確認します。 このツールは MUTT ソフトウェア パッケージに含まれています。

Note

CMUTT (SuperMUTT) デバイスには CMUTTUtil.exe を使用します。 たとえば、CMuttUtil.exe -updatefirmware を実行して、CMUTT 上のイメージを更新します。 CMuttUtil.exe は、「マイクロソフト USB テスト ツール (MUTT) デバイスの概要」で説明されている MUTT ソフトウェア パッケージからインストールできます。 詳しくは、インストール フォルダーの TypeCSuperMUTT.pdf をご覧ください。

MuttUtil を実行する方法

MuttUtil ヘルプ

次のコマンドを実行して、コマンド ライン オプションの一覧を取得します。

MUTTUtil.exe

システムに接続されているすべての MUTT デバイスを検索する

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

上記のコマンドは、システムに SuperMUTT (1) と MUTT Pack (0) が接続されていることを示しています。 マイクロソフトによって提供されるカーネル モード ドライバー (Winusb.sys) は、SuperMUTT デバイスのファンクション ドライバーです。 Winusb.sys について詳しくは、「WinUSB」をご覧ください。

MUTT Pack デバイスの問題コード 28 は、デバイスのドライバーが読み込まれていないことを示しています。

MUTT デバイスのパーソナリティの変更

MUTT デバイスは、USB UWP アプリ サンプルのテスト デバイスとしても使用されます。 そのシナリオでは、-SetWinRTUsb オプションを実行してファームウェアを更新する必要があります。 この演習では、SuperMUTT デバイスを WinRT パーソナリティに設定します。

MUTT パーソナリティに戻すには、次のコマンドを使用します。

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

ハードウェア ID が USB\VID_045&EPID_078F&REV_0037 に変更されている点に注意してください。 リビジョン バージョンは、ファームウェアのバージョン番号を示しています。

MUTT デバイスのドライバーのインストール

インストール情報を含むドライバーの INF ファイルを指定します。 たとえば、 にします。

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

上記のコマンドは、既存のドライバーを指定した USBTCD.sys ドライバーに置き換えます。 このドライバーは MUTT ソフトウェア パッケージに含まれています。

複数の MUTT デバイスが接続されている場合、ドライバーを同時に更新できます。

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

上記のコマンドは、デバイス 0 のUSBTCD.sys、デバイス 1 のWinusb.sys などをインストールします。

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

このコマンドは、デバイスのバージョンが古い場合のみ、EEPROM をファームウェアで更新します。 ファームウェア イメージはツールに埋め込まれています。 デバイスにツールによってインストールされたファームウェアよりも新しいバージョンがある場合、デバイス内のファームウェアは置き換えられません。 バージョンに関係なくデバイス内のファームウェアを置き換える場合、代わりに -ForceUpdateFirmware オプションを指定して MuttUtil を実行します。

ファームウェアを更新するもう 1 つの方法は、EEPROM または RAM に直接書き込む方法です。 このためには、ファームウェア ファイルが必要です。

EEPROM を消去するには、-EraseEEPROM オプションを使用します。

デバイスの切断、再接続、再列挙

MuttUtil.exe -Reconnect

MuttUtil.exe -CyclePort

上記のコマンドを実行すると、デバイスは切断され、同じポートで再接続されます。

この -CyclePort オプションを選択すると、デバイスが電気的に切断されない場合を除き、デバイスが切断されてポートに接続し直されます。 デバイスが切断され、ソフトウェアで再接続されます。 この操作により、デバイスがリセットされ、PnP マネージャーによってデバイス ノードが再構築されます。

MUTT Pack または SuperMUTT Pack デバイスのハブをリセットするには、次のコマンドを使用します。

MuttUtil.exe -# 1 -ResetHub

デバイスの速度の変更

次のコマンドを使用して、MUTT デバイスのデバイス速度を変更することができます。

MuttUtil.exe -# 0 -SetFullSpeed

MuttUtil.exe -# 1 -SetHighSpeed

このコマンドにより、デバイスが切断され、同じポートにおいて指定した速度で再接続されます。

最大速度モードで動作するよう MUTT Pack または SuperMUTT Pack のハブの速度を変更する場合、-HubFS コマンドを使用します。

MuttUtil.exe -# 1 -HubFS

再開信号を送信してシステムをウェイクアップする

通常、再開信号は、特定のユーザー アクション時に (低電力状態の) デバイスによって送信されます。 この動作は、次のコマンドを使用してシミュレートできます。

MuttUtil.exe -WakeAfterSuspend 5000

このコマンドは、バスが一時停止してから 5 秒後に再開信号を送信するようデバイスを構成します。

さらに、-DisconnectAfterSuspend オプションを使用することにより、バスが一時停止した後、一定期間内に切断および再接続するようデバイスを構成することもできます。

ポート ダウンストリーム ポートでの過電流の設定とクリア - MUTT Pack および SuperMUTT Pack

これらのコマンドは、Mutt-Pack の公開ポートの過電流ピンを設定してクリアします。

MuttUtil.exe -# 1 -SetOvercurrent

MuttUtil.exe -# 1 -ClearOvercurrent

ハブを TT 高速ハブに変換する - MUTT Pack と SuperMUTT Pack

次のコマンドを使用して、ハブをマルチ TT 高速ハブまたは単一 TT 高速ハブとして動作するよう設定できます。

MuttUtil.exe -# 1 -HubHSMultiTT

MuttUtil.exe -# 1 -HubHSSingleTT

MUTT ソフトウェア パッケージに含まれるツール
Microsoft USB テスト ツール (MUTT) デバイス