manualshive.com logo in svg

AMS TMF882X, User Manual

Share
Download
AMS TMF882X User Manual Download Page 24

 

 

Document Feedback 

TMF882X 

 

 

Using the EVM Software 

 

 

Demo Kit Manual 

• PUBLIC 

 

UG000495 

• v4-00 • 2021-Dec-01 

33

 

│ 24 

 

● 

After the connection is established, the EVM sends version and calibration information to the 
automation host. This will look like this: 

 
#VER;4c-c0-00-00;2.49.4.2;2.4.23.0;2.6.2.19;8;0                                      
#CAL;1594814890830;0;2;00;0B;03;00;01;FF;26;02;79;56;34;12;53;49;47;F7;6B;A2;
07;00;6B;A2;07;00;6B;A2;07;00;6B;A2;07;00;6B;A2;07;00;6B;A2;07;00;6B;A2;07;00
;6B;A2;07;00;6B;A2;07;00;6B;A2;07;00;77;09;02;00;02;00;00;00;02;00;00;00;02;0
0;00;00;02;00;00;00;02;00;00;00;02;00;00;00;02;00;00;00;02;00;00;00;02;00;00;
00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00
;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;0
0;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;
00;00;00;00;00;00;00;00;00;00;00;00;00;00;00;00

 

● 

The EVM GUI also sends header information for easy import of the log output into Microsoft 
Excel. The header output is too long to include it here into this document. 

● 

To trigger a single measurement the automation host 

has to send the command string “(m0)” to 

the EVM GUI. 

● 

The EVM GUI sends all histograms the user selects with the checkboxes in the GUI. The 
default is the "Measurement" histograms. 

● 

The protocol for the measurement data is described in the document 
"TMF_8820_EVM_GUI_Logfile_Format.docx". 

3.6.2 

Automation Interface Reference 

These commands are simple strings the remote control programs sends to the GUI via the TCP/IP 
connection. The GUI sends the command response back to the remote control program over the same 
connection (socket). 

Each command starts witch an opening parenthesis "(". The GUI executes the command after the 
remote control sends a closing parenthesis ")". 

The first character in the command (after the opening parenthesis) is the command code. All 
characters after that are the command parameter (until the closing parenthesis). Command codes are 
case-insensitive. 

e.g.: (I1000) sets the "Iterations [k]" spin box in the GUI to the value 1000. 

Summary of Contents for TMF882X

Page 1: ...User Guide UG000495 TMF882X EVM User Guide TMF882X EVM v4 00 2021 Dec 01 ...

Page 2: ... 4 2 Setting Up the EVM 5 2 1 Setting Up the EVM Hardware 5 3 Using the EVM Software 8 3 1 Controls for All Tabs 10 3 2 EVM GUI Main Tab 14 3 3 EVM GUI 3D Tab 20 3 4 EVM GUI Interrupt Tab 21 3 5 EVM GUI File Upload Tab 22 3 6 Automation of Measurements 23 4 Drivers 28 5 Schematics Layers and BOM 29 5 1 Daughter Card 29 6 Revision Information 32 7 Legal Information 33 ...

Page 3: ...e ToF optical sensor s from ams AG This document is a basic user guide to the setup and operation of the ToF EVM software 1 1 Kit Content Below is a checklist of what is included in the ToF EVM kit ToF sensor EVM enclosure and sample glass some EVMs come without an enclosure USB type A to micro USB cable s USB flash drive with EVM GUI software EVM documentation including this guide Figure 1 Kit Co...

Page 4: ...iption TMF8821 EVM TMF8821 EVM TMF8828 EVM TMF8828 EVM As TMF8821 is a superset of the functions of TMF8820 ams recommends to use the TMF8821 EVM for evaluating the performance of TMF8820 and TMF8821 The TMF8828 is a superset of the TMF8821 ams recommends to use the TMF8828 EVM for evaluating the performance of TMF8820 TMF8821 and TMF8828 ...

Page 5: ...M software 2 1 Setting Up the EVM Hardware The ToF sensor enclosure is already assembled and ready to plug in to a PC The EVM with the enclosure exposes only one micro USB connector Figure 2 EVM with Enclosure On EVMs without enclosure or if the enclosure has been removed plug in the micro USB connector to the USB connector closer to the center of the Raspberry PI Zero W board see Figure 3 ...

Page 6: ... Back Side TMF882X facing to ceiling 2 1 1 Install the EVM USB Windows one time only When the EVM is plugged into the PC Windows should recognize the EVM as a Removable Disk If your PC does not automatically install the necessary USB driver the mountable drive contains USB drivers for both Windows and Mac Install this necessary USB driver ams_raspirndis_setup exe This step is only necessary during...

Page 7: ...v4 00 2021 Dec 01 33 7 2 1 2 Installing the EVM Graphical User Interface The ToF EVM GUI software is included on the USB flash drive Launch the Windows installer and choose the desired installation options The EVM graphical user interface executable is titled TMF882X_EVM_GUI exe ...

Page 8: ...6 and 4x4 Pixel Mode 1 Main Tab Selector see section 3 1 2 2 Histogram Display Selector see section 3 1 3 6 Distance Bar Chart see section 3 2 1 7 Histograms Plot see section 3 2 1 8 Histograms Box see section 3 2 2 3 Control Box see section 3 1 4 4 Data Logging Box see section 3 1 5 5 Connection Status Indicators see section 3 1 6 9 Display Box see section 3 2 2 10 Information Box see section 3 2...

Page 9: ...M GUI Overview in 8x8 Pixel Mode 1 Main Tab Selector see section 3 1 2 3 Control Box see section 3 1 4 4 Data Logging Box see section 3 1 5 5 Connection Status Indicators see section 3 1 6 6 Distance Bar Chart see section 3 2 1 10 Information Box see section 3 2 2 11 Measurement Box see section 3 2 2 1 3 4 5 6 10 11 ...

Page 10: ...text here The Main tab shows histograms also in a histogram matrix and data for the object in the sensor s field of view as a bar chart distance and confidence The 3D tab shows a 3D graphical representation the same object data distance and confidence The Interrupt tab is similar to the 3D tab and allows you to set object detection parameters e g relevant object distance You can update the firmwar...

Page 11: ...vides the field of view into nine zones arranged in a 3 by 3 rectangle 4 x 4 divides the field of view into sixteen zones arranged in a 4 by 4 rectangle 3 x 6 divides the field of view into eighteen zones arranged in a 3 by 6 rectangle 8 x 8 divides the field of view into 64 zones arranged in a 8 by 8 rectangle SPAD Map Combo Box Define the field of view with the entries in this combo box For a na...

Page 12: ... GUI will display the frame rate depending on the number of iterations The maximum framerate is 15 samples second Threshold Spin Box Select the minimum confidence threshold for target detection here If the calculated target detection confidence is below this level the GUI will not display the corresponding object in the graphs Run Check Box Enable this check box to run target measurements continuo...

Page 13: ... 1 5 Data Logging Box 4 Figure 9 Data Logging Box To log measurement data to a file you need to Click on the button Select File to select an existing log file or enter the file name for a new file The EVM GUI then displays the log file name in the text field below Enable the check box Save Data To File From now on the EVM GUI logs all measurement results and configuration changes to the selected l...

Page 14: ...ed label indicates there is no working connection with the enclosure software A green label means the connection is working Module HID is the connection status with the TMF882X demo software A red label indicates that there is a problem communicating with the TMF882X demo software or an internal software error A green label means the TMF882X software connection is working A third indicator display...

Page 15: ...this value increases with the reflectivity of the target object surface Photon Count Reference related to the optical reference channel not influenced by the target object Background Light related to the IR only ambient light the TMF882X sensor sees Temperature the temperature of the TMF882X sensor on chip SPAD sensor array temperature Histograms Plot 7 Figure 12 Histograms Plot This is a plot of ...

Page 16: ...G000495 v4 00 2021 Dec 01 33 16 Histogram Matrix Figure 13 Histogram Matrix This is a plot of the TDC histograms for each of the zones pixels in the field of view Information The 8x8 histogram view is not enabled in the EVM GUI It automatically hides this element in 8x8 mode ...

Page 17: ...tic scaling for the Y axis with the check box Auto Scale Y axis If this check box is disabled the histogram plots use the value of the check box Y Axis as maximum value As default the histogram graphs are linear in x direction and y direction You can change the scaling for the Y axis to logarithmic This allows to better observe very low values in the first few bins and in the object and cross talk...

Page 18: ...plotting the measurement histograms concurrently This gives you the ability examine two histogram plots one current the other one a snapshot at the same time in the histogram plotting area Releasing the Snapshot button deletes the saved snapshot histograms Information The 8x8 histogram view is not enabled in the EVM GUI It automatically hides this element in 8x8 mode Information To get fastest ran...

Page 19: ...I log file format for more details Measurement Box 11 Figure 17 Measurement Box The controls in this box allow you to select one zone in the field of view For this zone the GUI displays the current object data values Zone select the zone you are interested in Dist 1 distance to the first object in the selected zone Conf 1 confidence for the object detection of the first object in the selected zone...

Page 20: ... plate is fully colored If the confidence is low the plate becomes transparent In the example screenshot the sensor sees a close target at around 20 cm in all zones In addition it detects the ceiling above the test setup at around 250 cm The ceiling does not reflect much light The confidence values for detecting the ceiling are low because of that You can freely rotate and zoom this graph with you...

Page 21: ...at allow setting parameters for object detection Set the minimum and maximum distance for object detection with the corresponding spin boxes Use the Persistence control to set the required minimum number of sequential object detections e g only display an object if it is detected six times in a row You can also define which of the zones in the field of view are relevant for object detection with t...

Page 22: ...ld of view satisfies the defined requirements If Persistence is set to zero all other parameters are not relevant anymore The EVM GUI will then display all objects in the field of view The GUI has a timeout implemented if there is no object detection within one second the GUI automatically clears the graph Object logging will be stopped too 3 5 EVM GUI File Upload Tab Figure 20 File Upload Tab ...

Page 23: ...ate process on the EVM finished updating the binaries on the controller board If the update was not successful after several minutes all connection indicators have to be green after a successful update disconnect and reconnect again Click on the Clear Log button to clear the log file area if necessary 3 6 Automation of Measurements 3 6 1 Overview The EVM firmware allows control through a separate ...

Page 24: ...formation for easy import of the log output into Microsoft Excel The header output is too long to include it here into this document To trigger a single measurement the automation host has to send the command string m0 to the EVM GUI The EVM GUI sends all histograms the user selects with the checkboxes in the GUI The default is the Measurement histograms The protocol for the measurement data is de...

Page 25: ... Example I Number of iterations 0 iterations 65535 I1000 Set Object Detection Threshold Sets the object detection threshold Threshold spin box Figure 23 Command Overview Command Code Parameter Example T Object detection threshold 0 threshold 255 T128 Run Measurement Run one GUI measurement and send the results to the remote control program via the TCP IP connection Figure 24 Command Overview Comma...

Page 26: ...4 2 2 4 23 0 2 6 2 19 8 0 CAL 1594816397308 0 2 00 0B 03 00 01 FF 26 02 79 56 34 12 53 49 47 F7 6B A2 07 00 6B A2 07 00 6B A2 07 00 6B A2 07 00 6B A2 07 00 6B A2 07 00 6B A2 07 00 6B A2 07 00 6B A2 07 00 6B A2 07 00 77 09 02 00 02 00 00 00 02 00 00 00 02 00 00 00 02 00 0 0 00 02 00 00 00 02 00 00 00 02 00 00 00 02 00 00 00 02 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ...

Page 27: ...14 23 17 12 23 15 22 10 19 11 13 16 19 15 22 13 19 15 13 15 20 16 19 14 11 9 19 18 16 9 14 17 26 16 18 15 23 13 11 12 23 19 14 23 21 20 17 16 15 17 10 22 9 11 19 17 22 16 7 16 17 11 17 8 14 14 12 17 21 15 20 14 12 17 ITT 1594816405325 550 6 1 2 5 m 3 x 3 Disable measurement histograms and trigger another measurement send the command m0 again m0 TMP 1594816859466 251 38 OBJ 1594816859470 251 3 3 19...

Page 28: ...MF882X The following drivers are available Linux driver use this for any Linux system e g Android where the driver is running on the application processor MCU driver sometimes referenced as bare metal driver the hardware functions for executing the I2 C routines can be easily replaced to simply port this driver to systems without operating systems or systems not running Linux ...

Page 29: ...Feedback TMF882X Schematics Layers and BOM Demo Kit Manual PUBLIC UG000495 v4 00 2021 Dec 01 33 29 5 Schematics Layers and BOM 5 1 Daughter Card Figure 26 Daughter Card Picture Figure 27 Daughter Card Schematic ...

Page 30: ...Document Feedback TMF882X Schematics Layers and BOM Demo Kit Manual PUBLIC UG000495 v4 00 2021 Dec 01 33 30 Figure 28 Daughter Card Layout Layers 1 4 ...

Page 31: ...Document Feedback TMF882X Schematics Layers and BOM Demo Kit Manual PUBLIC UG000495 v4 00 2021 Dec 01 33 31 5 1 1 BOM Figure 29 Daughter Card BOM ...

Page 32: ...6 Revision Information Changes from previous version to current revision v4 00 Page Extended for TFM8828 specific information All Page and figure numbers for the previous version may differ from page and figure numbers in the current revision Correction of typographical errors is not explicitly mentioned ...

Page 33: ... the technical data herein No obligation or liability to recipient or any third party shall arise or flow out of ams AG rendering of technical or other services RoHS Compliant ams Green Statement RoHS Compliant The term RoHS compliant means that ams AG products fully comply with current RoHS directives Our semiconductor products do not contain any chemicals for all 6 substance categories plus addi...

Page 34: ...Mouser Electronics Authorized Distributor Click to View Pricing Inventory Delivery Lifecycle Information ams OSRAM TMF8821 EVM ...

Reviews:

No comments

Brands by name

Popular brands

Load more brands