ams TMF8805 Eval Demonstration Kit User Guide

June 5, 2024
ams

ams-logoams TMF8805 Eval Demonstration

Introduction

The Time-of-Flight (hereafter referred to as ‘ToF’) EVM demonstration kit provides a way to evaluate the latest prototype ToF optical sensor(s) from ams AG. This document is a basic user guide to the setup and operation of the ToF EVM software.

EVM 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)

Kit Content Figure 1

Ordering Information ams-TMF8805-Eval-Demonstration-
Kit-3

Setting Up the EVM

This section describes the setup steps necessary to start using the EVM software.

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)

Figure 3
EVM Without Enclosure – Front Side (TMF8x0x facing to table) ams-TMF8805
-Eval-Demonstration-Kit-5

The TMF8x0x is shown when placing the Raspberry PI Zero W on the backside (see Figure 4)
Figure 4
EVM Without Enclosure – Back Side (TMF8x0x facing to ceiling)

ams-TMF8805-Eval-Demonstration-Kit-6

  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 drivers, the mountable drive contains USB drivers for both Windows and Mac. Install the necessary USB drivers:

  2. ams_raspicdc_setup.exe

  3. ams_raspirndis_setup.exe

  4. 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 ToF_EVM_GUI.exe.

Using the EVM Software

This section describes the operation and capabilities of the EVM Graphical User Interface.

EVM GUI “Histogram Display” Tab
The Histogram Display Tab is the primary context of the ToF EVM demo software and it has the most control options available. Here the user can get an overview of object detection as well as histogram graphing. Please refer to Figure 5 for a breakdown of the various components in the Histogram Display Tab.

Information
If you want to use the histograms for TMF8701 please contact ams to provide the software which shows histograms. The default software with the EVM only shows the distance chart. TMF8801 software shows the histograms by default.

Figure 5
Histogram Display Tab TMF8701ams-TMF8805-Eval-Demonstration-
Kit-7

The relevant information and control option labels are:

  1. View context, consists of:
  2. The “Histogram Display” tab for distance and histogram information
  3. The “Distance vs Time” tab for object tracking over time and responsiveness
  4. “File upload” tab for updating various software files on the EVM demo kit
  5. Distance graph that plots the distance an object is detected vs the confidence in the detection of an actual object
  6. Histogram plotting area for various histograms
  7. “Control” box for data logging, continuous vs snapshot data retrieval, calibration trigger and clear, and operating mode selection
  8. “Histogram Display” box for selecting which histogram to display
  9. Distance and proximity show raw histograms directly from the TDCs.
  10. Processed shows a histogram that is already combined of all TDCs and corrected for ambient light effects.
  11. “Graph” box for changing graphing options
  12. “Histogram Enable” box for selecting Reference TDC channels
  13. Snapshot feature, serial number, EVM kit software revision, and firmware and hardware revision of the ToF sensor chip in the currently connect EVM kit
  14. Connection status indicators

EVM GUI “Histogram Display” Tab TMF8801/TMF8805
The GUI from version 2.x.x.x onwards automatically detects if a TMF8701 or TMF8801/TMF8805 is connected. If a TMF8701 is connected, see section just above. For TMF8801/TMF8805 the Histogram display Tab is shown in following Figure 6:

Figure 6
Histogram Display Tab TMF8801/TMF8805ams-TMF8805-Eval-Demonstration-
Kit-8

Additionally to all the controls available for TMF8701, the TMF8801/TMF8805 GUI adds following control (10):

  • Mode of operation: High Performance mode, default mode, low power mode. These are predefined setting for iterations and threshold.
  • Iterations / threshold:
    • Define the number of iterations for acquisition. An iteration is typically 26.6ns, so e.g. 900k iterations result in 24ms acquisition time. Calculation time is approximately 9ms, so the total ranging time is 33ms.
    • Threshold: Detection threshold. It is ok to stay at default 0 setting.
  1. Information
    To get fastest ranging time, disable all histogram display functions.

  2. Distance vs Confidence Graph
    This is a plot of the detected object’s distance vs the confidence value (range 0 – 63) of the given detection. The X axis indicate the distance in millimeters and the Y axis indicates the confidence value.

  3. Histogram Plot
    This is a plot of the TDC histogram information based off the selections in the “Data” box and the “Histogram Display” box. The X axis indicates the “time buckets” in 100 picosecond increments, and the Y axis indicates the number of photonic triggers/hits at the given time interval.

  4. “Graph” Box
    The Graph box controls the display parameters of the histogram plots. You can enable/disable auto scaling of the independent axes or optionally set a fixed range to display. The graphing legend box will show labels for the various histograms as well as precise distance and confidence values in the distance vs confidence graph.

  5. “Control” Box
    Logging Data
    For logging Data:

  6. Click “…” and use the File Explorer to fill out a log file path

  7. Select the “Save data to file” option

  8. Perform desired data collection

  9. De-select “Save data to file” option

  10. View the contents of the entered file path to observe the collected data

Attention
Be careful when logging with multiple data options selected over a long period of time. With all histograms enabled and continuous logging the resulting log file can be almost 1 GB in size in 1 – 2 hours.

Finding Software Version Information
The software versions of the ToF EVM GUI, EVM kit, and ToF firmware are displayed in the lower right hand corner of the ToF EVM GUI as well as logged to the data file selected in section Logging Data.
The format of the version information in the log file:

VER;ToF Serial Number;App0 Version Number;GUI Version Number;Host Driver

Version Number #VER;01-00-80-0b;01.02.04.00;1.0.0.0;01.01.00.00

Continuous vs Snapshot Data Retrieval
Selecting the “Continuous Mode” box will force the EVM GUI to continuously pull data from the EVM demo kit for displaying in real time. If continuous is not selected the data will only be updated each time the user selects the “Start” button.
Operating Mode Selection
This drop-down box shows the available operating modes available to the ToF device. Some examples are “distance + proximity” or “proximity” only. The object detection graph will scale accordingly for the supported distances in the current operating mode.
Trigger/Clear Calibration
The “Clear Calibration” button will clear the current devices factory calibration data and resume measurements with the current EVM GUI parameters. During this short time the device is reset and all graphs will stop updating until the reset is complete. The “Calibrate” button will trigger a factory calibration measurement. Both calibration and clearing the calibration take approximately 1 – 2 seconds to complete.

Attention
When performing factory calibration no object should be within 400mm of the ToF sensor’s field of view and use low ambient light (avoid high IR content).

“Histogram Display” Box
TMF8701
The Data box indicates which histogram types are displayed in the histogram plotting area.

  • Distance measurement histograms (only applicable when “distance” mode is enabled)

    • Proximity histograms
    • Processed histograms
  • TMF8801/TMF8805 The Data box indicates which histogram types are displayed in the histogram plotting area.

    • Short and long range histograms
      These are the raw histograms directly from the TDC channels. See datasheet for description of long / short range.

    • Processed histograms
      Processed shows a histogram which is already combined of all TDCs and corrected for ambient light effects

“Histogram Enable” Box
This box allows the user to select the reference TDC channels for display in the histogram plotting area. The GUI will always display TDC channels 1-4 if long range / short range respectively distance or proximity histograms are enabled.
Histogram Snapshot Control
The Histogram Snapshot button allows the user to “freeze frame” the current histogram plot while still plotting the real time histograms concurrently. This gives the ability examine two histogram plots (one in real time, the other a snapshot) at the same time in the histogram plotting area. Hitting the “Clear” button deletes the saved snapshot histograms.
Connection Status Indicators
Connection status indicators between the EVM GUI software and the ToF EVM software running in the enclosure.

  1. “Control HID” is the connection status with the enclosure software
  2. A RED icon indicates there is no good connection with the enclosure software
  3. A GREEN icon means the connection is good
  4. “Module HID” is the connection status with the ToF demo software
  5. A RED icon indicates that there is a problem communicating with the ToF demo software or an internal software error.
  6. A GREEN icon means the ToF software connection is good

EVM GUI “Distance vs Time” Tab
The Distance versus Time tab replaces the distance vs confidence graph and histogram plot with a single display of the object data reported over the previous 3.5 seconds. The control options to the right of the window have the same meaning as the “Histogram Display” tab with some of the histogram displaying options removed.

EVM GUI “File Upload” Tab
The File Upload tab provides a way to upload new firmware binaries to the EVM kit. When logging is enabled the various software versions and revisions of the GUI and on the EVM kit are logged as well.
Active Modules Box
After selecting the “Update Information” button the relevant information about the currently running user modules and kernel modules will be updated.
Upload File Box
You can enter a specific target file path and select a desired local file to upload to the EVM kit software. If updating a currently running module, that module must be unloaded first by using the “Unload” button, then uploading the new version of the module and then selecting the “Load” button to reload the module. The user must select whether it is a kernel module or user module that is to be loaded/unloaded and fill in the module name.

Upgrading the EVM Firmware
To upgrade the EVM use following tab:
Figure 7
Firmware Upgrade GUI 2.x.x.xams-TMF8805-Eval-Demonstration-
Kit-9

Press “Update All Binaries” – see 11 above – and select directory where the new firmware is located. Use “Select Folder” in the directory selection box to start the firmware upgrade. Power cycle the EVMonce firmware upgrade is finished (see Figure 8).

Figure 8
Firmware Upgrade Finished -> Power Cycle EVMams-TMF8805-Eval-Demonstration-
Kit-10

Automation of Measurements
The EVM firmware allows control through a separate (e.g. customer) program. The communication link is achieved through TCP/IP using TCP port 39999 on the host where the EVM GUI is running.

  1. 1. To start the automation mode the automation host needs to open a TCP connection to 127.0.01 port 39999  

    To use 127.0.0.1 (localhost), the automation host must run on the same machine as the EVM GUI. Once connected the GUI shows the following status:

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

  3. VER;dc-00-40-14;2.0.30.0;1.6.0.0;4.3.2.25;7;3

  4. CAL;02;21;37;00;0F;15;80;F9;F0;FF;FC;17;34;00;04

  5. To trigger a single measurement the automation host has to send the character “m” to the EVM GUI

  6. To switch the distance measurement algorithm mode send these characters to the EVM GUI from the automation host (only TMF8701)

  7. “d” -> distance mode

  8. “p” -> proximity mode

  9. “b” -> combined mode

  10. The EVM GUI sends all histograms the user selects with the checkboxes in the GUI. The default is the “Processed” histogram

  11. The protocol for the measurement data is described in document
    TMF8XXX_Logfile_Format.docx

Automation Example Session
To operate following example, the EVM GUI needs to be started first. Start the Windows shell “cmd” and connect through the Windows program telnet:
Figure 9
Telnet Commandams-TMF8805-Eval-Demonstration-Kit-12

Immediate response and in the GUI the status ‘Automation On’ is displayed
Figure 10
Automation Example

ams-TMF8805-Eval-Demonstration-Kit-13

Press “m” executes one measurement and transfer the enabled histograms (in this case only the average histogram):

Figure 11 : Automation Resultams-TMF8805-Eval-Demonstration-
Kit-14

Disabled “Processed” histogram display and used “m” – reported an object at 107mm distance, with 63 confidence:

Figure 12
Automation Result Continued

ams-TMF8805-Eval-Demonstration-Kit-15

Executing “m” several times:
Figure 13
Executing m Several Times

ams-TMF8805-Eval-Demonstration-Kit-16

Windows telnet can be stopped by using Ctrl-‘]’ and then enter the command quit.

Revision Information

ams-TMF8805-Eval-Demonstration-
Kit-17

  1. Page and figure numbers for the previous version may differ from page and figure numbers in the current revision.
  2. Correction of typographical errors is not explicitly mentioned.

Legal Information

Copyrights & Disclaimer
Copyright ams AG, Tobelbader Strasse 30, 8141 Premstaetten, Austria-Europe. Trademarks Registered. All rights reserved. The material herein may not be reproduced, adapted, merged, translated, stored, or used without the prior written consent of the copyright owner.
Demo Kits, Evaluation Kits and Reference Designs are provided to recipient on an “as is” basis for demonstration and evaluation purposes only and are not considered to be finished end-products intended and fit for general consumer use, commercial applications and applications with special requirements such as but not limited to medical equipment or automotive applications. Demo Kits, Evaluation Kits and Reference Designs have not been tested for compliance with electromagnetic compatibility (EMC) standards and directives, unless otherwise specified. Demo Kits, Evaluation Kits and Reference Designs shall be used by qualified personnel only.
ams AG reserves the right to change functionality and price of Demo Kits, Evaluation Kits and Reference Designs at any time and without notice.
Any express or implied warranties, including, but not limited to the implied warranties of merchantability and fitness for a particular purpose are disclaimed. Any claims and demands and any direct, indirect, incidental, special, exemplary or consequential damages arising from the inadequacy of the provided Demo Kits, Evaluation Kits and Reference Designs or incurred losses of any kind (e.g. loss of use, data or profits or business interruption however caused) as a consequence of their use are excluded.
ams AG shall not be liable to recipient or any third party for any damages, including but not limited to personal injury, property damage, loss of profits, loss of use, interruption of business or indirect, special, incidental or consequential damages, of any kind, in connection with or arising out of the furnishing, performance or use of 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 additional 4 substance categories (per amendment EU 2015/863), including the requirement that lead not exceed 0.1% by weight in homogeneous materials. Where designed to be soldered at high temperatures, RoHS compliant products are suitable for use in specified lead-free processes.
ams Green (RoHS compliant and no Sb/Br/Cl): ams Green defines that in addition to RoHS compliance, our products are free of Bromine (Br) and Antimony (Sb) based flame retardants (Br or Sb do not exceed 0.1% by weight in homogeneous material) and do not contain Chlorine (Cl not exceed 0.1% by weight in homogeneous material).
Important Information: The information provided in this statement represents ams AG knowledge and belief as of the date that it is provided. ams AG bases its knowledge and belief on information provided by third parties, and makes no representation or warranty as to the accuracy of such information. Efforts are underway to better integrate information from third parties. ams AG has taken and continues to take reasonable steps to provide representative and accurate information but may not have conducted destructive testing or chemical analysis on incoming materials and chemicals. ams AG and ams AG suppliers consider certain information to be proprietary, and thus CAS numbers and other limited information may not be available for release.

Headquarters    Please visit our website at www.ams.com
ams AG  Buy our products or get free samples online at www.ams.com/Products Technical Support is available at www.ams.com/Technical-Support
Provide feedback about this document at www.ams.com/Document- Feedback For sales offices, distributors and representatives go to www.ams.com/Contact For further information and requests, e-mail us at ams_sales@ams.com 

Tobelbader Strasse 30 8141 Premstaetten Austria, Europe
Tel: +43 (0) 3136 500 0

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>

Related Manuals