次の方法で共有

手順 4: モバイル/IoT テスト システムのオンボード

Note

Windows 11 24H2 および Windows Server 2025 向けの HLK Windows Server AD 更新バージョン (2024 年 10 月にリリース) 以降、HLK プロキシ クライアントはサポートされなくなりました。 今後は、「HLK ファースト ステップ ガイド」に記載されているプロセスを使用して、クライアントをオンボードしてください。

コントローラー システムに Windows Hardware Lab Kit (Windows HLK) をインストールし、プロキシ システムに Windows HLK プロキシ クライアントをインストールした後、モバイル/IoT テスト システムを環境に追加する準備が整います。

既知の問題

問題 回避策
HLK で報告されるデバイス名が、実際のデバイス名ではなく Windows Phone となる。 デバイスを再起動します。

USB 接続デバイスのオンボード

  1. プロキシ システム上で、管理者特権でのコマンド プロンプト ウィンドウを起動します。

  2. %ProgramFiles(x86)%\WTTMobile\Tools\ に移動します

  3. 接続されているデバイスの DeviceGUID を取得します。

    1. デバイスをフラッシュ モードにします。

    2. 管理者特権でのコマンド プロンプトで、次のコマンドを実行します。

      ffutool.exe -list

      Note

      FFUTool.exe は HLK の \\<ControllerName>\HLKInstall\ProxyClient\FfuTool に含まれています。

      このディレクトリの内容をすべてプロキシ サーバーにコピーしてください。

      HLK モバイル テスト ツールとユーティリティの詳細については、「HLK モバイル テスト ツールとユーティリティ」を参照してください

      FFUTool.exe は、キットのインストール時に [イメージおよび構成デザイナー] オプションを選ぶことで、ADK と一緒にインストールすることもできます。 ADK の詳細については、Windows ADK のダウンロードに関するページを参照してください

  4. 管理者特権でのコマンド プロンプトから以下のコマンドを実行して、デバイスを大容量ストレージ モードにします。

    ffutool -MassStorage

  5. プロキシ システムからデバイスを取り外し、再び接続します。 そうすると、プロキシ システムにドライブ文字が割り当てられます。  これを次の手順で <device drive> として使います。

  6. ブート オプションで USB EEM プロトコルを有効にします。 管理者特権でのコマンド プロンプトで、次のコマンドを実行します。

    BCDEdit /store <device drive>:\EFIESP\efi\Microsoft\Boot\BCD /set {default} loadoptions "EEM"

    例:

    BCDEdit /store G:\EFIESP\efi\Microsoft\Boot\BCD /set {default} loadoptions "EEM"

  7. デバイスを再起動します (DUT にインストールされているイメージがラボまたは正常性イメージの場合は、デバイスをフラッシュ モードにします)。

  8. デバイスをオンボードするには、管理者特権でのコマンド プロンプトで、次のコマンドを実行します。

    KitsDeviceDetector.exe /Physical:Fake_PC.dll /DeviceName:<DeviceName> /DeviceId:<DeviceGUID> /machinepool:<machine pool>

    例:

    KitsDeviceDetector.exe /Physical:Fake_PC.dll /DeviceName:mydevice /DeviceId:00000015-c0fb-79c3-0000-000000000000 /machinepool:$\mypool

    - 正常性イメージでテストする場合は、次のパラメーターを含める必要があります: /imageprofile:health

    • DUT にインストールされているイメージがラボまたは正常性イメージではない場合は、次のパラメーターを含める必要があります: /SkipFFUCheck

    • KitsDeviceDetector のログは %ProgramFiles(x86)%\WTTMobile\Tools\KitsDeviceDetector.log にあります

  9. プロキシ サービスを管理者特権モードで再起動します。

    1. プロキシ サービスのコマンド プロンプト ウィンドウで、Ctrl + C キーを押してサービスを停止します。

    2. プロキシ システムのデスクトップで "WTT プロキシ" のショートカットをダブルクリックするか、管理者特権でのコマンド プロンプトで %ProgramFiles(X86)%\WTTMobile\Client\ に移動し、以下のコマンドを実行して、プロキシ サービスを再起動します。

      WTTProxy.exe -console

  10. 検証: デバイス検出機能 (上記の手順) を実行した後、デバイスは有効な OS で起動し、HLK マネージャーと HLK Studio で [準備完了] と表示される対象となっている必要があります。

Aries 接続デバイスのオンボード

  1. プロキシ システム上で、管理者特権でのコマンド プロンプトを起動します。

  2. %ProgramFiles(x86)%\WTTMobile\Tools\ に移動します

  3. デバイスをオンボードするには、管理者特権でのコマンド プロンプトで、次のコマンドを実行します。

    KitsDeviceDetector.exe /devicefilters:<aries name> /machinepool:<machine pool>

    例:

    KitsDeviceDetector.exe /devicefilters:myaries  /machinepool:$\mypool

    • デバイス上のイメージは、ラボ イメージまたは正常性イメージのいずれかである必要があります。

    - 正常性イメージでテストする場合は、次のパラメーターを含める必要があります: /imageprofile:health

    - オンボード プロセスの一環としてデバイス上のイメージをフラッシュするには、次のパラメーター /ImagePath:<full path to the flash_lab.ffu image> を含めます

    例:

    /ImagePath:C:\flash_lab.ffu

    • ネットワーク上の Aries ドングルの名前を調べるには、%ProgramFiles(x86)%\WTTMobile\Tools\AriesUtil.exe を使います。 AriesUtil.exe Discover というコマンドを実行すると、利用可能なデバイスのすべての一覧が返されます。 AriesUtil.exe を使うには、事前にファイアウォールの例外を追加する必要があります。 デバイスが検出されない場合は、/Adapter パラメーターの使用が必要になることがあります。 アダプターの種類は、コントローラーで [ネットワークと共有センター] を開くことで確認できます。アダプターは [接続] の下で一覧表示されます。 最も一般的なアダプターの値は "イーサネット" です。 AriesUtil.exe /? コマンドを使うと、利用できるコマンドの完全な一覧を確認できます。

    • KitsDeviceDetector のログは %ProgramFiles (x86)> %WTTMobile\Tools\KitsDeviceDetector.log にあります

    HLK モバイル テスト ツールとユーティリティの詳細については、「HLK モバイル テスト ツールとユーティリティ」を参照してください

  4. プロキシ サービスを管理者特権モードで再起動します。

    1. プロキシ サービスのコマンド プロンプト ウィンドウで、Ctrl + C キーを押してサービスを停止します。

    2. プロキシ システムのデスクトップで "WTT プロキシ" のショートカットをダブルクリックするか、管理者特権でのコマンド プロンプトで %ProgramFiles(X86)%\WTTMobile\Client\ に移動し、以下のコマンドを実行して、プロキシ サービスを再起動します。

      WTTProxy.exe -console

  5. [正常性イメージのみ] - KitsDeviceDetector が完了したら、%ProgramFiles (x86)%\WTTMobile\Tools\ から以下のコマンドを実行します

    AriesUtil.exe ResetDevice /Aries:<aries-name> [/Autoskip:true]

  6. 検証: デバイス検出機能 (上記の手順) を実行した後、デバイスは有効な OS で起動し、HLK マネージャーと HLK Studio で [準備完了] と表示される対象となっている必要があります。

イーサネット接続デバイスのオンボード

  1. プロキシ システム上で、管理者特権でのコマンド プロンプトを起動します。

  2. %ProgramFiles(x86)%\WTTMobile\Tools\ に移動します

  3. デバイスの接続文字列を取得します。

    1. デバイスを起動し、IP アドレスを確認します。

    2. 管理者特権でのコマンド プロンプトで、次のコマンドを実行します。

      KitsDeviceDetector.exe /rundevicediscovery

      このコマンドを実行すると、Sirep が動作しているサブネット上のすべてのデバイスが出力されます。 それぞれの文字列は以下のようになります。

      Name: 8CAE4CF5D6A5 | UniqueId: 00000000-0000-0000-0000-8cae4cf5d6a5 | Address: 10.131.2.211 | Connection: SirepBroadcast1 | Location:

  4. デバイス文字列 (IP アドレスと一致) を見つけ、次のフィールドをメモします。

    1. "Name:"
    2. "UniqueId:"

  5. デバイスをオンボードするには、管理者特権でのコマンド プロンプトで、次のコマンドを実行します。

    KitsDeviceDetector.exe /machinepool:$\Pool /Physical:Fake_PC.dll /DeviceName:NAME_OF_DEVICE /DeviceId:<DeviceGUID> /SkipFFUCheck

    例:

    KitsDeviceDetector.exe /machinepool:$\Test_Pool /Physical:Fake_PC.dll /DeviceName:8CAE4CF5D6A5 /DeviceId:00000000-0000-0000-0000-8CAE4CF5D6A5 /SkipFFUCheck

  6. プロキシ サービスを管理者特権モードで再起動します。

    1. プロキシ サービスのコマンド プロンプト ウィンドウで、Ctrl + C キーを押してサービスを停止します。

    2. プロキシ システムのデスクトップで "WTT プロキシ" のショートカットをダブルクリックするか、管理者特権でのコマンド プロンプトで %ProgramFiles(X86)%\WTTMobile\Client\ に移動し、以下のコマンドを実行して、プロキシ サービスを再起動します。

      WTTProxy.exe -console

  7. 検証: デバイス検出機能 (上記の手順) を実行した後、デバイスは有効な OS で起動し、HLK マネージャーと HLK Studio で [準備完了] と表示される対象となっている必要があります。