ams TMF8805 Eval Demonstration Kit User Guide
- June 5, 2024
- ams
Table of Contents
- Introduction
- Setting Up the EVM
- Using the EVM Software
- VER;ToF Serial Number;App0 Version Number;GUI Version Number;Host Driver
- Revision Information
- Legal Information
- Read User Manual Online (PDF format)
- Download This Manual (PDF format)
- VER;dc-00-40-14;2.0.30.0;1.6.0.0;4.3.2.25;7;3
- CAL;02;21;37;00;0F;15;80;F9;F0;FF;FC;17;34;00;04
ams 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
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)
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)
-
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: -
ams_raspicdc_setup.exe
-
ams_raspirndis_setup.exe
-
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 TMF8701
The relevant information and control option labels are:
- View context, consists of:
- The “Histogram Display” tab for distance and histogram information
- The “Distance vs Time” tab for object tracking over time and responsiveness
- “File upload” tab for updating various software files on the EVM demo kit
- Distance graph that plots the distance an object is detected vs the confidence in the detection of an actual object
- Histogram plotting area for various histograms
- “Control” box for data logging, continuous vs snapshot data retrieval, calibration trigger and clear, and operating mode selection
- “Histogram Display” box for selecting which histogram to display
- Distance and proximity show raw histograms directly from the TDCs.
- Processed shows a histogram that is already combined of all TDCs and corrected for ambient light effects.
- “Graph” box for changing graphing options
- “Histogram Enable” box for selecting Reference TDC channels
- Snapshot feature, serial number, EVM kit software revision, and firmware and hardware revision of the ToF sensor chip in the currently connect EVM kit
- 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/TMF8805
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.
-
Information
To get fastest ranging time, disable all histogram display functions. -
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. -
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. -
“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. -
“Control” Box
Logging Data
For logging Data: -
Click “…” and use the File Explorer to fill out a log file path
-
Select the “Save data to file” option
-
Perform desired data collection
-
De-select “Save data to file” option
-
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.
- “Control HID” is the connection status with the enclosure software
- A RED icon indicates there is no good connection with the enclosure software
- A GREEN icon means the connection is good
- “Module HID” is the connection status with the ToF demo software
- A RED icon indicates that there is a problem communicating with the ToF demo software or an internal software error.
- 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.x
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 EVM
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. 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:
-
After the connection is established, the EVM sends version and calibration information to the automation host.
This will look like this: -
VER;dc-00-40-14;2.0.30.0;1.6.0.0;4.3.2.25;7;3
-
CAL;02;21;37;00;0F;15;80;F9;F0;FF;FC;17;34;00;04
-
To trigger a single measurement the automation host has to send the character “m” to the EVM GUI
-
To switch the distance measurement algorithm mode send these characters to the EVM GUI from the automation host (only TMF8701)
-
“d” -> distance mode
-
“p” -> proximity mode
-
“b” -> combined mode
-
The EVM GUI sends all histograms the user selects with the checkboxes in the GUI. The default is the “Processed” histogram
-
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 Command
Immediate response and in the GUI the status ‘Automation On’ is displayed
Figure 10
Automation Example
Press “m” executes one measurement and transfer the enabled histograms (in this case only the average histogram):
Figure 11 : Automation Result
Disabled “Processed” histogram display and used “m” – reported an object at 107mm distance, with 63 confidence:
Figure 12
Automation Result Continued
Executing “m” several times:
Figure 13
Executing m Several Times
Windows telnet can be stopped by using Ctrl-‘]’ and then enter the command quit.
Revision Information
- 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.
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