Wiki

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
resources:eval:user-guides:eval-adsd3100-nxz-gui [01 Aug 2021 11:08] – [EVAL_ADSD3100_NXZ Software Package] Harshvardhan Bhatiaresources:eval:user-guides:eval-adsd3100-nxz-gui [10 Apr 2024 18:26] (current) – More txt updates. Andre Straker-Payne
Line 1: Line 1:
-====== EVAL-ADSD3100-NXZ Software Package ====== +====== ADIToFGUI Eval Kit 5.0.0 or later ======
-This user guide is to step through installation steps for the EVAL-ADSD3100-NXZ software package.+
  
-==== Download Installer ==== +With Eval Kit software 5.0.0 there have been some major updates to ADIToFGUI, starting with the UX.
-  * Download installer from here : +
  
-==== Intro ==== +===== Usage =====
-  * Once installer is downloaded, run the application to see this window. Click 'Next'+
-{{ :resources:eval:user-guides:eval_adsd3100_softpackage_installation_1.png?nolink&400 |}} +
-==== License ==== +
-  * Read through license and select 'I accept the agreement' option. Click 'Next' +
-{{ :resources:eval:user-guides:eval_adsd3100_softpackage_installation_2.png?nolink&400 |}} +
-==== Installation Location ==== +
-  * Select a location to install the package +
-  * Click 'Next', and click 'Install' on the next page +
-{{ :resources:eval:user-guides:eval_adsd3100_softpackage_installation_3.png?nolink&400 |}} +
-==== GPU Capability ==== +
-  * Select Yes to test GPU compatibility +
-  * If GPU is compatible ....+
  
-==== Done ==== +==== Connecting ====
-  * Once installation is done you can navigate to the installation folder to run the following applications: +
-    * ADIToFGUI +
-    * Data Collect +
-    * Depth Compute+
  
 +1. Open ADIToFGUI located in the installation "bin" folder.
  
 +{{:resources:eval:user-guides:eval-adtf3175d-nxz:adi-tof-nvidia-aditofgui-1.png?600|}}
  
 +2. Select "config_adsd3500_adsd3100.json" -> Open
  
 +{{:resources:eval:user-guides:eval-adtf3175d-nxz:adi-tof-nvidia-aditofgui-2.png?600|}}
  
 +3. Select the desired mode -> Play
  
 +{{:resources:eval:user-guides:eval-adtf3175d-nxz:adi-tof-nvidia-aditofgui-3.png?600|}}
 +
 +4. Streaming frames
 +
 +{{:resources:eval:user-guides:eval-adtf3175d-nxz:adi-tof-nvidia-aditofgui-4.png?600|}}
 +
 +===== New Features =====
 +
 +==== Adjusting the Ini Parameters ====
 +
 +It is now possible to adjust some of the configuration parameters during use. These parameters are generally stored in ini/JSON files are a per mode basis. The ADSD3500 and depth compute libraries receive the changed parameter values.
 +
 +The **Ini Parameter** window can be selected at any point. Select **Ini Params** in the **Tools** menu.. To do so follow the image below.
 +
 +{{:resources:eval:user-guides:eval-adtf3175d-nxz:adi-tof-aditofgui-ini-1.png?300|}}
 +
 +Once opened the **Ini Parameter** window can be use to adjust the parameter. 
 +
 +{{:resources:eval:user-guides:eval-adtf3175d-nxz:adi-tof-aditofgui-ini-2.png?600|}}
 +
 +**Modify** is needed to write the parameters to the device. Please note, the stream is stopped, the ADSD3500 and depth compute library updated, then the stream is restarted.
 +
 +**Reset** is used to set the values in the ADSD3500 and depth compute library back to those from the original ini file.
 +
 +**Save** saves the parameters listed in the window to the a file.
 +
 +===== Trouble Shooting =====
 +
 +==== Slow Point Cloud Rendering ====
 +
 +If rendering of the point cloud is slow, it may be necessary to ensure the GPU is rendering and not the CPU. With an NVIDIA GPU you can do the following.
 +
 +1. NVIDIA Control Panel -> Manage 3D Settings -> Program Settings -> Add
 +
 +{{:resources:eval:user-guides:eval-adtf3175d-nxz:adi-tof-nvidia-control_panel_1.png?600|}}
 +
 +2. Browse
 +
 +{{:resources:eval:user-guides:eval-adtf3175d-nxz:adi-tof-nvidia-control_panel_2.png?600|}}
 +
 +3. Select the folder "C:\Analog Devices\TOF_Evaluation_ADTF3175D-Rel5.0.0\bin" -> ADIToFGUI.exe -> Open
 +
 +{{:resources:eval:user-guides:eval-adtf3175d-nxz:adi-tof-nvidia-control_panel_3.png?600|}}
 +
 +4. For the select program "ADIToFGUI" -> Select "High-performance NVIDIA processor" -> Apply
 +
 +{{:resources:eval:user-guides:eval-adtf3175d-nxz:adi-tof-nvidia-control_panel_4.png?600|}}
 +
 +
 +
 +
 +
 +====== ADIToFGUI Eval Kit 4.3.0 or earlier ======
 +This is a guide for the ToF module viewer. This page applies to the viewer for the following modules:
 +  - [[:resources:eval:user-guides:eval-adsd3100-nxz]]
 +  - [[:resources:eval:user-guides:eval-adtf3175-nxz]]
 +  - [[:resources:eval:user-guides:eval-adtf3175d-nxz]]
 +
 +==== Start ====
 +
 +
 +  * Find the ADIToFGUI.exe in the 'viewer' or 'bin' folder located at the install location
 +    * v2.x.x
 +      * Default location : C:\Analog Devices\TOF_Evaluation_BM-RelX.X.X\viewer\
 +    * v3.x.x
 +      * Default location : C:\Analog Devices\TOF_Evaluation_BM-RelX.X.X\bin\
 +  * If you are evaluating the **EVAL-ADTF3175D-NXZ**:
 +    * Confirm that an unidentified local network has been discovered by the pc - IP address = 10.42.0.1
 +    * Run TOF_Evaluation_BM-Relx.x.x
 +    * Hit refresh until a Device is found
 +    * **Select .json file based on your kits serial number** - Software Release version 4.2.0+ 
 +      * If your serial number starts with 'DV11' or 'CR' select **tof-viewer_config.json**
 +      * If your serial number starts with 'am' select **tof_crosby_adsd3500_new_modes_config.json**
 +  * If you are evaluating the following modules : **EVAL-ADTF3175-NXZ** or **EVAL-ADSD3100-NXZ** (only supported with software release 2.1.1)
 +    * Start the viewer to get to the window below
 +      * If a camera is connected it should show up in the 'Device' drop down menu
 +      * Select your device
 +      * Select correct config file (depends on which module you are using)
 +        * [[:resources:eval:user-guides:eval-adtf3175-nxz| EVAL-ADTF3175-NXZ]] : **tof-viewer-config-adtf3175.json**
 +        * [[:resources:eval:user-guides:eval-adsd3100-nxz| EVAL-ADSD3100-NXZ]] : **tof-viewer-config-adsd3100.json**
 +      * Click 'Open Device'
 +
 +{{ :resources:eval:user-guides:selecting_config.png?nolink |}}
 +
 +==== Run Camera ====
 +  * Once the device has been initialized the 'ToF Camera Options' menu should be available
 +  * Available modes will depend on the module serial number : [[:resources:eval:user-guides:eval-adtf3175d-nxz:mode_table]]
 +  * Select preferred view option (described below) and click play to run camera
 +
 +{{:resources:eval:user-guides:gui_initialization_screen.png?nolink|}}
 +
 +<note important>If the user disconnects the camera via USB-C cable while the GUI has initialized the camera. The user must restart the GUI</note>
 +
 +==== Active Brightness and Depth ====
 +  * If this option is selected, the first window will show active brightness/intensity, while the second window will show depth
 +  * Depth is shown in mm, the user can hover over the image to see real-time depth data
 +{{ :resources:eval:user-guides:ab_and_depth.png?nolink |}}
 +
 +==== Mode Switching ====
 +  * If the user wants to switch modes while the camera is running frames:
 +    * Click 'Stop'
 +    * Select mode in drop down menu
 +    * Click 'Play'
 +
 +==== Point Cloud and Depth ====
 +  * If camera is already running 'Active Brightness and Depth' viewer:
 +    * Click 'Stop'
 +    * Select 'Point Cloud and Depth'
 +    * Click 'Play'
 +  * If this option is selected, the first window will show a point-cloud generated from the depth on the second window.
 +  * Point Cloud Controls:
 +    * Zoom In/Out
 +      * Use the mouse wheel and scroll forward to zoom in, scroll backwards to zoom out.
 +    * Grab image and move it in all directions
 +      * Hover over the Point Cloud Image and and drag the mouse while the right mouse button is pressed. Move slowly
 +    * Rotate image
 +      * Drage the mouse while pressing the left mouse button
 +    * Increase / Decrease Point Cloud point size 
 +      * Grab the slider at the bottom of the Point Cloud window and move it left or right to decrease or increase the point size. 
 +    * Reset View
 +      * Press the “Reset View” button to restore to default image size and position
 +{{:resources:eval:user-guides:adtf3175_depth_pc.png?nolink|}}
 +
 +==== Recording ====
 +  * Recording via the GUI is deprecated, please use [[:resources:eval:user-guides:eval-adsd3100-nxz-gui:datacollect_cli|data_collect]] for recording data during evaluation. 
 +
 +===== Troubleshooting =====
 +  * Visit [[:resources:eval:user-guides:aditofgui_ts| Troubleshooting Guide]]
resources/eval/user-guides/eval-adsd3100-nxz-gui.1627808910.txt.gz · Last modified: 01 Aug 2021 11:08 by Harshvardhan Bhatia