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