Info for Developers of Microsoft HoloLens

HoloLens 関連イベントと情報共有に努めるブログ

(日本語訳) Using the Windows Device Portal < HoloLens Documentation - HoloLens 技術情報

この記事は、公式技術情報 Windows Holographic - Documentation の Using the Windows Device Portal の拙訳です。2016/9/27 から開始、まだ未完成。(ここまでで約3時間...)

2016/9/29 追記
ここまで作成したところで、
HoloLens 用 Device Portal に同記事の MSDN 日本語記事を確認しました。本記事は、知識吸収と整理、補足や注釈などを付けているため、正確な技術情報記事は MSDN 日本語記事を参照してください。

Windows Device Portal を使う

HoloLens 用 Windows Device Portal で、Wi-Fi または USB 経由でデバイスを構成と管理します。Device Portal は、HoloLens 上にある Web サーバーで、PC のブラウザー経由で接続できます。Device Portal には、HoloLens とデバッグ、アプリを最適化するための多くのツールが含まれています。

 

Windows Device Portal を使うため HoloLens を設定する

  1. HoloLens を起動し、装着します
  2. bloom ジェスチャーを行い、メインメニューを立ち上げます
  3. Settings タイルを見つめ (Gaze)、air tap ジェスチャーを行います。再度 air tap を行い、空間にアプリを配置します
  4. Update メニュー アイテムを選択します
  5. For developers メニュー アイテム を選択します
  6. Developer Mode を有効化します
  7. Scroll down して、Device Portal を有効化します。

Enabling developer mode in the Setting app for Windows Holographic

Wi-Fi 経由で接続する

  1. Wi-Fi に HoloLens を接続します
  2. バイス (HoloLens) の IP アドレスを確認します
    • IP アドレスはこちらから確認できます: Settings > Network & Internet > Wi-Fi > Advanced Options
  3. PC の Web ブラウザーから、次のアドレスにアクセスします: https://
    • 下記メッセージがブラウザーに表示される場合があります: "There’s a problem with this website’s security certificate". このメッセージは、Device portal に発行された証明書が、テスト証明書であるため表示されます。この証明書エラーを無視して先に進みます

USB 経由で接続する

  1. Install the tools を確認し、PC に Visual Studio Update 1 with the Windows 10 developer tools がインストールされていることを確かめます. これにより USB 経由での接続が可能になります
  2. micro-USB ケーブルで PC と HoloLens を接続します
  3. PC の Web ブラウザーから、次のアドレスにアクセスします: http://127.0.0.1:10080.

エミュレーターに接続する

Device Portalエミュレーターにも利用できます。Device Portal に接続するためには、toolbar を使用します。次のアイコンをクリックします:

ユーザー名とパスワードを作成する

Set up access to Windows Device Portal

はじめて HoloLens 上の Device Portal に接続した際、ユーザー名とパスワードを作成する必要があります。

  1. PC 上の Web ブラウザーで、HoloLens の IP アドレスを入力します。セット アップ アクセス ページが開きます。
  2. Request pin をクリックまたはタップし、生成された PIN を取得するため、HoloLens の画面を確認します。
  3. PIN displayed on your device テキストボックスに PIN を入力します
  4. Device Potal に接続するためのユーザー名を入力します。このユーザー名は、Microsoft Account (MSA) やドメイン名である必要はありません
  5. パスワードを入力し確認します。パスワードは、最低 7 文字以上の長さであることが求められます。MSA やドメイン パスワードである必要はありません。
  6. Pair をクリックし、HoloLens 内の Windows Device Portal に接続します

このユーザー名やパスワードを変更したい場合は、デバイス セキュリティ ページにアクセスすることで、このプロセスを再実行することができます。デバイス セキュリティ ページには、上部右側の Security リンクをクリックするか、以下のアドレスにアクセスします: https:///devicesecurity.htm.

セキュリティ証明書

ブラウザーで "証明書エラー" を確認した場合、HoloLens デバイスとの信頼関係を作成することで修正できます。

各 HoloLens は SSL 接続用に固有の自己署名証明書を生成します。既定では、この証明書は PC の Web ブラウザーでは信頼されていないため、"証明書エラー" が表示されます。HoloLens からこの証明書をダウンロードし (USB や 信頼できるWi-Fi ネットワーク経由)、PC で信頼することで、HoloLens デバイスにセキュアに接続できます。

  1. セキュアなネットワーク (USB または信頼できる Wi-Fi ネットワーク)であることを確認します
  2. Device Portal の "Security" ページから、デバイス証明書をダウンロードします
    • 上部右側アイコン一覧の Security リンクをクリックするか、次のアドレスにアクセスします: https:///devicesecurity.htm
  3. PC の "信頼されたルート証明機関" ストアに証明書をインストールします
    • Windows メニューから、"コンピューター証明書の管理" と入力しアプレットを開始します 
    • 信頼されたルート証明機関フォルダーを展開します
    • 証明書フォルダーをクリックします。
    • アクション メニューから、次の項目を選択します: All Tasks > Import...
    • Device Portal からダウンロードした証明書ファイルを使用して、証明書のインポート ウィザードを完了します
  4. ブラウザーを再起動します

Device Portal Pages

Home

Windows Device Portal home page on Microsoft HoloLens

Device Portal セッションは ホーム ページから開始します。ホーム ページの左側にあるナビゲーション バーから他のページにアクセスできます。

ページ上部のツールバーは、よく使われるステータスや機能へのアクセスできます

  • Online: デバイスが Wi-Fi に接続されているか示します
  • Shutdown: デバイスをシャットダウンします
  • Restart: デバイスを再起動します
  • Security: デバイス セキュリティ ページを開きます
  • Cool: デバイスの温度を示します
  • A/C: デバイスが接続され充電されているか示します
  • Help: REST インターフェイス 情報ページを開きます

ホーム ページは次の情報を表示します:

  • Device Status: デバイスの健全性をモニターし、重大なエラーを報告します
  • Windows information: shows the name of the HoloLens and the currently installed version of Windows.
  • Preferences section contains the following settings:
    • IPD: Sets the interpupillary distance (IPD), which is the distance, in millimeters, between the center of the user's pupils when looking straight ahead. The setting takes effect immediately. The default value was calculated automatically when you set up your device.
    • Device name: Assign a name to the HoloLens. You must reboot the device after changing this value for it to take effect. After clicking Save, a dialog will ask if you want to reboot the device immediately or reboot later.
    • Sleep settings: Sets the length of time to wait before the device goes to sleep when it's plugged in and when it's on battery.

3D View

3D View page in Windows Device Portal on Microsoft HoloLens

Use the 3D View page to see how HoloLens interprets your surroundings. Navigate the view by using the mouse:

  • Rotate: left click + mouse;
  • Pan: right click + mouse;
  • Zoom: mouse scroll.
  • Tracking options: Turn on continuous visual tracking by checking Force visual tracking. Pause stops visual tracking.
  • View options: Set options on the 3D view:
    • Tracking: Indicates whether visual tracking is active.
    • Show floor: Displays a checkered floor plane.
    • Show frustum: Displays the view frustum.
    • Show stabilization plane: Displays the plane that HoloLens uses for stabilizing motion.
    • Show mesh: Displays the spatial mapping mesh that represents your surroundings.
    • Show spatial anchors: Displays spatial anchors for the active app. You must click the Update button to get and refresh the anchors.
    • Show details: Displays hand positions, head rotation quaternions, and the device origin vector as they change in real time.
    • Full screen button: Shows the 3D View in full screen mode. Press ESC to exit full screen view.
  • Surface reconstruction: Click or tap Update to display the latest spatial mapping mesh from the device. A full pass may take some time to complete, up to a few seconds. The mesh does not update automatically in the 3D view, and you must manually click Updateto get the latest mesh from the device. Click Save to save the current spatial mapping mesh as an obj file on your PC.
  • Spatial anchors: Click Update to display or update the spatial anchors for the active app.

Mixed Reality Capture

Mixed Reality Capture page in Windows Device Portal on Microsoft HoloLens

Use the Mixed Reality Capture page to save media streams from the HoloLens.

  • Settings: Control the media streams that are captured by checking the following settings:
    • Holograms: Captures the holographic content in the video stream. Holograms are rendered in mono, not stereo.
    • PV camera: Captures the video stream from the photo/video camera.
    • Mic Audio: Captures audio from the microphone array.
    • App Audio: Captures audio from the currently running app.
    • Live preview quality: Select the screen resolution, frame rate, and streaming rate for the live preview.
  • Click or tap the Live preview button to show the capture stream. Stop live preview stops the capture stream.
  • Click or tap Record to start recording the mixed-reality stream, using the specified settings. Stop recording ends the recording and saves it.
  • Click or tap Take photo to take a still image from the capture stream.
  • Videos and photos: Shows a list of video and photo captures taken on the device.

Note that HoloLens apps will not be able to capture an MRC photo or video while you are recording or streaming a live preview from the Device Portal.

Performance Tracing

Performance Tracing page in Windows Device Portal on Microsoft HoloLens

Capture Windows Performance Recorder (WPR) traces from your HoloLens.

  • Available profiles: Select the WPR profile from the dropdown, and click or tap Start to start tracing.
  • Custom profiles: Click or tap Browse to choose a WPR profile from your PC. Click or tap Upload and start to start tracing.

To stop the trace click on the stop link. Stay on this page until the trace file has completed downloading.

Captured ETL files can be opened for analysis in Windows Performance Analyzer.

Processes

Processes page in Windows Device Portal on Microsoft HoloLens

Shows details about currently running processes. This includes both apps and system processes.

System Performance

System Performance page in Windows Device Portal on Microsoft HoloLens

Shows real-time graphs of system diagnostic info, like power usage, frame rate, and CPU load.

These are the available metrics:

  • SoC power: Instantaneous system-on-chip power utilization, averaged over one minute
  • System power: Instantaneous system power utilization, averaged over one minute
  • Frame rate: Frames per second, missed VBlanks per second, and consecutive missed VBlanks
  • GPU: GPU engine utilization, percent of total available
  • CPU: percent of total available
  • I/O: Reads and writes
  • Network: Received and sent
  • Memory: Total, in use, committed, paged, and non-paged

Apps

Apps page in Windows Device Portal on Microsoft HoloLens

Manages the apps that are installed on the HoloLens.

  • Installed apps: Remove and start apps.
  • Running apps: Lists apps that are running currently.
  • Install app: Select app packages for installation from a folder on your computer/network.
  • Dependency: Add dependencies for the app you are going to install.
  • Deploy: Deploy the selected app + dependencies to the HoloLens.

App Crash Dumps

App Crash Dumps page in Windows Device Portal on Microsoft HoloLens

This page allows you to collect crash dumps for your side-loaded apps. Check the Crash Dumps Enabled checkbox for each app for which you want to collect crash dumps. Return to this page to collect crash dumps. Dump files can be opened in Visual Studio for debugging.

File Explorer

File Explorer page in Windows Device Portal on Microsoft HoloLens

Use the file explorer to browse, upload, and download files. You can work with files in the Documents folder, Pictures folder, and in the local storage folders for apps that you deployed from Visual Studio or the Device Portal.

Kiosk Mode

Available only with the Microsoft HoloLens Commercial Suite. Kiosk Mode page in Windows Device Portal on Microsoft HoloLens

Enables kiosk mode, which limits the user's ability to launch new apps or change the running app. When kiosk mode is enabled, the Bloom gesture and Cortana are disabled, and placed apps aren't shown in the user's surroundings.

Check Enable Kiosk Mode to put the HoloLens into kiosk mode. Select the app to run at startup from the Startup app dropdown. Click or tap Save to commit the settings.

Note that the app will run at startup even if kiosk mode is not enabled. Select None to have no app run at startup.

Logging

Logging page in Windows Device Portal on Microsoft HoloLens

Manages realtime Event Tracing for Windows (ETW) on the HoloLens.

Check Hide providers to show the Events list only.

  • Registered providers: Select the ETW provider and the tracing level. Tracing level is one of these values:
  1. Abnormal exit or termination
  2. Severe errors
  3. Warnings
  4. Non-error warnings

Click or tap Enable to start tracing. The provider is added to the Enabled Providers dropdown.

  • Custom providers: Select a custom ETW provider and the tracing level. Identify the provider by its GUID. Don't include brackets in the GUID.
  • Enabled providers: Lists the enabled providers. Select a provider from the dropdown and click or tap Disable to stop tracing. Click or tap Stop all to suspend all tracing.
  • Providers history: Shows the ETW providers that were enabled during the current session. Click or tap Enable to activate a provider that was disabled. Click or tap Clear to clear the history.
  • Events: Lists ETW events from the selected providers in table format. This table is updated in real time. Beneath the table, click on the Clear button to delete all ETW events from the table. This does not disable any providers. You can click Save to file to export the currently collected ETW events to a CSV file locally.
  • Filters: Allow you to filter the ETW events collected by ID, Keyword, Level, Provider Name, Task Name, or Text. You can combine several criteria together:
  1. For criteria applying to the same property - events can satisfy any one of these criteria are shown.
  2. For criteria applying to different property - events must satisfy all of the criteria

For example, you can specify the criteria (Task Name contains 'Foo' or 'Bar') AND (Text contains 'error' or 'warning')

Simulation

Simulation page in Windows Device Portal on Microsoft HoloLens

Allows you to record and play back input data for testing.

  • Capture room: Used to download a simulated room file that contains the spatial mapping mesh for the user's surroundings. Name the room and then click Capture to save the data as a .xef file on your PC. This room file can be loaded into the HoloLens emulator.
  • Recording: Check the streams to record, name the recording, and click or tap Record to start recoding. Perform actions with your HoloLens and then click Stop to save the data as a .xef file on your PC. This file can be loaded on the HoloLens emulator or device.
  • Playback: Click or tap Upload recording to select a xef file from your PC and send the data to the HoloLens.
  • Control mode: Select Default or Simulation from the dropdown, and click or tap the Set button to select the mode on the HoloLens. Choosing "Simulation" disables the real sensors on your HoloLens and uses uploaded simulated data instead. If you switch to "Simulation", your HoloLens will not respond to the real user until you switch back to "Default".

Networking

Networking page in Windows Device Portal on Microsoft HoloLens

Manages Wi-Fi connections on the HoloLens.

  • WiFi adapters: Select a Wi-Fi adapter and profile by using the dropdown controls. Click or tap Connect to use the selected adapter.
  • Available networks: Lists the Wi-Fi networks that the HoloLens can connect to. Click or tap Refresh to update the list.
  • IP configuration: Shows the IP address and other details of the network connection.

Virtual Input

Virtual Input page in Windows Device Portal on Microsoft HoloLens

Sends keyboard input from the remote machine to the HoloLens.

Click or tap the region under Virtual keyboard to enable sending keystrokes to the HoloLens. Type in the Input text textbox and click or tap Send to send the keystrokes to the active app.

Device Portal REST API's

Everything in the device portal is built on top of REST API's that you can optionally use to access the data and control your device programmatically.

 

 

以下翻訳時の公式ドキュメント (2016/9/27 確認済)

 

Using the Windows Device Portal

The Windows Device Portal for HoloLens lets you configure and manage your device remotely over Wi-Fi or USB. The Device Portal is a web server on your HoloLens that you can connect to from a web browser on your PC. The Device Portal includes many tools that will help you manage your HoloLens and debug and optimize your apps.

Setting up HoloLens to use Windows Device Portal

  1. Power on your HoloLens and put on the device.
  2. Perform the bloom gesture to launch the main menu.
  3. Gaze at the Settings tile and perform the air tap gesture. Perform a second air tap to place the app in your environment. The Settings app will launch after you place it.
  4. Select the Update menu item.
  5. Select the For developers menu item.
  6. Enable Developer Mode.
  7. Scroll down and enable Device Portal.

Enabling developer mode in the Setting app for Windows Holographic

Connecting over Wi-Fi

  1. Connect your HoloLens to Wi-Fi.
  2. Look up your device's IP address.
    • Find the IP address on the device under Settings > Network & Internet > Wi-Fi > Advanced Options.
  3. From a web browser on your PC, go to https://
    • The browser will display the following message: "There’s a problem with this website’s security certificate". This happens because the certificate which is issued to the Device Portal is a test certificate. You can ignore this certificate error for now and proceed.

Connecting over USB

  1. Install the tools to make sure you have Visual Studio Update 1 with the Windows 10 developer tools installed on your PC. This enables USB connectivity.
  2. Connect your HoloLens to your PC with a micro-USB cable.
  3. From a web browser on your PC, go to http://127.0.0.1:10080.

Connecting to an emulator

You can also use the Device Portal with your emulator. To connect to the Device Portal, use the toolbar. Click on this icon:

Creating a Username and Password

Set up access to Windows Device Portal

The first time you connect to the Device Portal on your HoloLens, you will need to create a username and password.

  1. In a web browser on your PC, enter the IP address of the HoloLens. The Set up access page opens.
  2. Click or tap Request pin and look at the HoloLens display to get the generated PIN.
  3. Enter the PIN in the PIN displayed on your device textbox.
  4. Enter the user name you will use to connect to the Device Portal. It doesn't need to be a Microsoft Account (MSA) name or a domain name.
  5. Enter a password and confirm it. The password must be at least seven characters in length. It doesn't need to be an MSA or domain password.
  6. Click Pair to connect to Windows Device Portal on the HoloLens.

If you wish to change this username or password at any time, you can repeat this process by visiting the device security page by either clicking the Security link along the top right, or navigating to: https:///devicesecurity.htm.

Security certificate

If you are see a "certificate error" in your browser, you can fix it by creating a trust relationship with the device.

Each HoloLens generates a unique self-signed certificate for its SSL connection. By default, this certificate is not trusted by your PC's web browser and you may get a "certificate error". By downloading this certificate from your HoloLens (over USB or a Wi-Fi network you trust) and trusting it on your PC, you can securely connect to your device.

  1. Make sure you are on a secure network (USB or a Wi-Fi network you trust).
  2. Download this device's certificate from the "Security" page on the Device Portal.
  3. Install the certificate in the "Trusted Root Certification Authorities" store on your PC.
    • From the Windows menu, type: Manage Computer Certificates and start the applet.
    • Expand the Trusted Root Certification Authority folder.
    • Click on the Certificates folder.
    • From the Action menu, select: All Tasks > Import...
    • Complete the Certificate Import Wizard, using the certificate file you downloaded from the Device Portal.
  4. Restart the browser.

Device Portal Pages

Home

Windows Device Portal home page on Microsoft HoloLens

Your Device Portal session starts at the Home page. Access other pages from the navigation bar along the left side of the home page.

The toolbar at the top of the page provides access to commonly used status and features.

  • Online: Indicates whether the device is connected to Wi-Fi.
  • Shutdown: Turns off the device.
  • Restart: Cycles power on the device.
  • Security: Opens the Device Security page.
  • Cool: Indicates the temperature of the device.
  • A/C: Indicates whether the device is plugged in and charging.
  • Help: Opens the REST interface documentation page.

The home page shows the following info:

  • Device Status: monitors the health of your device and reports critical errors.
  • Windows information: shows the name of the HoloLens and the currently installed version of Windows.
  • Preferences section contains the following settings:
    • IPD: Sets the interpupillary distance (IPD), which is the distance, in millimeters, between the center of the user's pupils when looking straight ahead. The setting takes effect immediately. The default value was calculated automatically when you set up your device.
    • Device name: Assign a name to the HoloLens. You must reboot the device after changing this value for it to take effect. After clicking Save, a dialog will ask if you want to reboot the device immediately or reboot later.
    • Sleep settings: Sets the length of time to wait before the device goes to sleep when it's plugged in and when it's on battery.

3D View

3D View page in Windows Device Portal on Microsoft HoloLens

Use the 3D View page to see how HoloLens interprets your surroundings. Navigate the view by using the mouse:

  • Rotate: left click + mouse;
  • Pan: right click + mouse;
  • Zoom: mouse scroll.
  • Tracking options: Turn on continuous visual tracking by checking Force visual tracking. Pause stops visual tracking.
  • View options: Set options on the 3D view:
    • Tracking: Indicates whether visual tracking is active.
    • Show floor: Displays a checkered floor plane.
    • Show frustum: Displays the view frustum.
    • Show stabilization plane: Displays the plane that HoloLens uses for stabilizing motion.
    • Show mesh: Displays the spatial mapping mesh that represents your surroundings.
    • Show spatial anchors: Displays spatial anchors for the active app. You must click the Update button to get and refresh the anchors.
    • Show details: Displays hand positions, head rotation quaternions, and the device origin vector as they change in real time.
    • Full screen button: Shows the 3D View in full screen mode. Press ESC to exit full screen view.
  • Surface reconstruction: Click or tap Update to display the latest spatial mapping mesh from the device. A full pass may take some time to complete, up to a few seconds. The mesh does not update automatically in the 3D view, and you must manually click Updateto get the latest mesh from the device. Click Save to save the current spatial mapping mesh as an obj file on your PC.
  • Spatial anchors: Click Update to display or update the spatial anchors for the active app.

Mixed Reality Capture

Mixed Reality Capture page in Windows Device Portal on Microsoft HoloLens

Use the Mixed Reality Capture page to save media streams from the HoloLens.

  • Settings: Control the media streams that are captured by checking the following settings:
    • Holograms: Captures the holographic content in the video stream. Holograms are rendered in mono, not stereo.
    • PV camera: Captures the video stream from the photo/video camera.
    • Mic Audio: Captures audio from the microphone array.
    • App Audio: Captures audio from the currently running app.
    • Live preview quality: Select the screen resolution, frame rate, and streaming rate for the live preview.
  • Click or tap the Live preview button to show the capture stream. Stop live preview stops the capture stream.
  • Click or tap Record to start recording the mixed-reality stream, using the specified settings. Stop recording ends the recording and saves it.
  • Click or tap Take photo to take a still image from the capture stream.
  • Videos and photos: Shows a list of video and photo captures taken on the device.

Note that HoloLens apps will not be able to capture an MRC photo or video while you are recording or streaming a live preview from the Device Portal.

Performance Tracing

Performance Tracing page in Windows Device Portal on Microsoft HoloLens

Capture Windows Performance Recorder (WPR) traces from your HoloLens.

  • Available profiles: Select the WPR profile from the dropdown, and click or tap Start to start tracing.
  • Custom profiles: Click or tap Browse to choose a WPR profile from your PC. Click or tap Upload and start to start tracing.

To stop the trace click on the stop link. Stay on this page until the trace file has completed downloading.

Captured ETL files can be opened for analysis in Windows Performance Analyzer.

Processes

Processes page in Windows Device Portal on Microsoft HoloLens

Shows details about currently running processes. This includes both apps and system processes.

System Performance

System Performance page in Windows Device Portal on Microsoft HoloLens

Shows real-time graphs of system diagnostic info, like power usage, frame rate, and CPU load.

These are the available metrics:

  • SoC power: Instantaneous system-on-chip power utilization, averaged over one minute
  • System power: Instantaneous system power utilization, averaged over one minute
  • Frame rate: Frames per second, missed VBlanks per second, and consecutive missed VBlanks
  • GPU: GPU engine utilization, percent of total available
  • CPU: percent of total available
  • I/O: Reads and writes
  • Network: Received and sent
  • Memory: Total, in use, committed, paged, and non-paged

Apps

Apps page in Windows Device Portal on Microsoft HoloLens

Manages the apps that are installed on the HoloLens.

  • Installed apps: Remove and start apps.
  • Running apps: Lists apps that are running currently.
  • Install app: Select app packages for installation from a folder on your computer/network.
  • Dependency: Add dependencies for the app you are going to install.
  • Deploy: Deploy the selected app + dependencies to the HoloLens.

App Crash Dumps

App Crash Dumps page in Windows Device Portal on Microsoft HoloLens

This page allows you to collect crash dumps for your side-loaded apps. Check the Crash Dumps Enabled checkbox for each app for which you want to collect crash dumps. Return to this page to collect crash dumps. Dump files can be opened in Visual Studio for debugging.

File Explorer

File Explorer page in Windows Device Portal on Microsoft HoloLens

Use the file explorer to browse, upload, and download files. You can work with files in the Documents folder, Pictures folder, and in the local storage folders for apps that you deployed from Visual Studio or the Device Portal.

Kiosk Mode

Available only with the Microsoft HoloLens Commercial Suite. Kiosk Mode page in Windows Device Portal on Microsoft HoloLens

Enables kiosk mode, which limits the user's ability to launch new apps or change the running app. When kiosk mode is enabled, the Bloom gesture and Cortana are disabled, and placed apps aren't shown in the user's surroundings.

Check Enable Kiosk Mode to put the HoloLens into kiosk mode. Select the app to run at startup from the Startup app dropdown. Click or tap Save to commit the settings.

Note that the app will run at startup even if kiosk mode is not enabled. Select None to have no app run at startup.

Logging

Logging page in Windows Device Portal on Microsoft HoloLens

Manages realtime Event Tracing for Windows (ETW) on the HoloLens.

Check Hide providers to show the Events list only.

  • Registered providers: Select the ETW provider and the tracing level. Tracing level is one of these values:
  1. Abnormal exit or termination
  2. Severe errors
  3. Warnings
  4. Non-error warnings

Click or tap Enable to start tracing. The provider is added to the Enabled Providers dropdown.

  • Custom providers: Select a custom ETW provider and the tracing level. Identify the provider by its GUID. Don't include brackets in the GUID.
  • Enabled providers: Lists the enabled providers. Select a provider from the dropdown and click or tap Disable to stop tracing. Click or tap Stop all to suspend all tracing.
  • Providers history: Shows the ETW providers that were enabled during the current session. Click or tap Enable to activate a provider that was disabled. Click or tap Clear to clear the history.
  • Events: Lists ETW events from the selected providers in table format. This table is updated in real time. Beneath the table, click on the Clear button to delete all ETW events from the table. This does not disable any providers. You can click Save to file to export the currently collected ETW events to a CSV file locally.
  • Filters: Allow you to filter the ETW events collected by ID, Keyword, Level, Provider Name, Task Name, or Text. You can combine several criteria together:
  1. For criteria applying to the same property - events can satisfy any one of these criteria are shown.
  2. For criteria applying to different property - events must satisfy all of the criteria

For example, you can specify the criteria (Task Name contains 'Foo' or 'Bar') AND (Text contains 'error' or 'warning')

Simulation

Simulation page in Windows Device Portal on Microsoft HoloLens

Allows you to record and play back input data for testing.

  • Capture room: Used to download a simulated room file that contains the spatial mapping mesh for the user's surroundings. Name the room and then click Capture to save the data as a .xef file on your PC. This room file can be loaded into the HoloLens emulator.
  • Recording: Check the streams to record, name the recording, and click or tap Record to start recoding. Perform actions with your HoloLens and then click Stop to save the data as a .xef file on your PC. This file can be loaded on the HoloLens emulator or device.
  • Playback: Click or tap Upload recording to select a xef file from your PC and send the data to the HoloLens.
  • Control mode: Select Default or Simulation from the dropdown, and click or tap the Set button to select the mode on the HoloLens. Choosing "Simulation" disables the real sensors on your HoloLens and uses uploaded simulated data instead. If you switch to "Simulation", your HoloLens will not respond to the real user until you switch back to "Default".

Networking

Networking page in Windows Device Portal on Microsoft HoloLens

Manages Wi-Fi connections on the HoloLens.

  • WiFi adapters: Select a Wi-Fi adapter and profile by using the dropdown controls. Click or tap Connect to use the selected adapter.
  • Available networks: Lists the Wi-Fi networks that the HoloLens can connect to. Click or tap Refresh to update the list.
  • IP configuration: Shows the IP address and other details of the network connection.

Virtual Input

Virtual Input page in Windows Device Portal on Microsoft HoloLens

Sends keyboard input from the remote machine to the HoloLens.

Click or tap the region under Virtual keyboard to enable sending keystrokes to the HoloLens. Type in the Input text textbox and click or tap Send to send the keystrokes to the active app.

Device Portal REST API's

Everything in the device portal is built on top of REST API's that you can optionally use to access the data and control your device programmatically.