readme.txt part of Tektronix readme readme.txt, Tektronix TDS7000 TekScope_Opt_App_1.0.10_071-1883-01_063-3914-10 TekScope_Opt_App_1.0.10_071-1883-01_063-3914-10 Applications 00_DPOJET DPOJET readme.txt text manual preview

Text preview for : readme.txt part of Tektronix readme Tektronix TDS7000 TekScope_Opt_App_1.0.10_071-1883-01_063-3914-10 TekScope_Opt_App_1.0.10_071-1883-01_063-3914-10 Applications 00_DPOJET DPOJET readme.txt

Back to : readme.txt | Home

Date: 10/10/2007

Product: DPOJET (Jitter and Eye Diagram Analysis Tools)
Version: v1.0.0

================================================================================

Contents of this Readme File:

1. System Requirements
2. Contents of Distribution
3. New Features
4. Release Notes
5. Known Problems
6. Installation
7. Contact Information

================================================================================

1. System Requirements

- The DPOJET application is compatible with all DPO7K, DPO70K and DSA70K
oscilloscopes.

- The oscilloscope firmware version required for this release is:

Model Number Firmware

DPO & DSA scopes v4.0.0 or greater

- The TekVisa version required for this release is 3.3.0 or greater.

- The MATLAB Component Runtime, v7.5 (Release 2006b) from The MathWorks, Inc
is required for this release; it will automatically be installed if necessary
as part of the DPOJET installation process.

- The DPOJET application is incompatible with versions of DPOPWR prior to
1.0.6.

- Disk space requirements:

* 126 MB of free disk space to install this application.
* 15 GB or more of free disk space for file-backed data objects created
when performing up to 99 measurements on long-record waveforms.

- A keyboard and mouse are highly recommended, although not required.

- It may be necessary to configure file/folder properties to allow users
privileges to create and modify files. Consult the appropriate Microsoft
documentation for details.

The following folders and their contents may need to be so configured:
C:\Program Files\TekApplications\DPOJET
C:\TekApplications\DPOJET

================================================================================

2. Contents of Distribution

- Tektronix DPOJET v1.0.0
- Tektronix Datastore v1.0.0
- Tektronix AIL v2.0.2
- The MathWorks, Inc. MATLAB Component Runtime v7.5
- Application files located in C:\TekApplications\DPOJET:
* Example code showing use of the programmable (GPIB) interface
* Example waveform files for use with the embedded tutorial
* Mask files to support many industry standards
* Pattern files for several common data patterns

================================================================================

3. New Features

- 10/10/2007 (V1.0.0)
* Initial product release. Provides advanced timing, jitter and eye diagram
analysis for DPO & DSA oscilloscopes.

================================================================================

4. Release Notes

- OPTION LEVELS
DPOJET is available in two versions, known as DPOJET Essentials and DPOJET
Advanced. Both versions are installed by default; a software security key
determines which version is run.

- FREE TRIALS
This application generally requires a software security key to operate. The
application offers five (5) free trials for evaluation. Once the five free
trials are exhausted, a software security key may be purchased from
Tektronix to permanently enable the software on your oscilloscope.

- SOFTWARE UPDATES: REQUIRED REBOOTS
When upgrading to a newer version of the software, reboots may be required
both when uninstalling the old version and when installing the new. Please
heed any reboot instructions provided by the InstallShield.

- SWITCHING BETWEEN APPLICATIONS
* It is possible to switch between DPOJET and some other applications while
retaining measurement setup and results. However, DPOJET's sequencer must
be halted before switching. Switching while an advanced measurement is
running may cause the system to stop responding. Likewise, the other
application's sequencer must be halted before switching back to DPOJET.
* Switching between DPOJET and DPOPWR requires that the oscilloscope
application (TekScope) be restarted. You will be offered a chance to
cancel such an operation. The two applications cannot run concurrently.

- HARD DISK SPACE AND FRAGMENTATION
* The required memory space for double-precision advanced measurement
results and intermediate results representing up to 99 measurements, for
long-record waveforms, far exceeds the the addressable physical RAM
in a 32-bit operating system. For this reason, results are cached as
necessary to hard disk.
* The binary files used to store results are located at C:\TekScope\wfmObj.
Some of the required objects are allocated when the TekScope application
is launched. Remaining objects are only allocated when needed. This
saves disk space since many users will never approach 99 measurements.
Once instantiated, the file objects are never deleted, so they reserve
disk space for future measurement instantiation.
* Substantial hard disk space is required for the wfmObj directory, with
some dependence on the number and type of measurements simultaneously
used. In the worst case, this can exceed 15 GB in addition to the 6 GB
allocated to store scope waveforms (channels, maths and reference wfms).
If the hard disk becomes too full before these objects are allocated for
the first time, the application could be prevented from creating them.
Fragmentation of the disk can also aggravate efficient memory allocation.
Periodic defragmentation of your hard drive can help avoid problems.

- RECORD LENGTH LIMITATIONS
* The maximum number of individual measurement events that can be recorded
within a single waveform acquisition is 37.5 million. For example, a
waveform of 200 Meg record length and 8 samples per unit interval would
contain 25 million unit intervals, and could be entirely accomodated. As
more measurements are added, the allocated buffer sizes are smaller,
according to the following chart:
1 or 2 measurements 37.5000 million events
3rd and 4th measurements 18.7500 million events
5th through 8th measurements 9.3750 million events
9th through 99th measurements 4.6875 million events
* For measurements that perform clock recovery, the number of unit intervals
is limited according to a similar sliding scale. For data signals, the
unit interval cap may impose a stricter limit than the measurement cap.
* If a waveform contains more measurement events than its allocated buffer
can hold, the associated measurement algorithm will simply stop when the
buffer is full. A warning will be given that the waveform was not
completely processed. A time trend plot of such a measurement will reflect
the incomplete processing by only extending to the right as far as the
processed data allows.

- PLOT LENGTH LIMITATIONS
* For any waveform with greater than 20 million samples, only the first 20
million samples are used for associated eye diagrams and waveform plots.
* A maximum of 10 million time trend points may be plotted. These may be in
a single time trend plot or distributed across multiple plots. A partial
plot may result when the 10 million allocation is reached. Data array
plots draw from the same allocation of 10 million points.
* Frequency-domain plots (Spectrum, Transfer Function and Phase Noise) are
based on an FFT of, at most, 4 million points.
* Eye diagrams are limited to 500 points of horizontal resolution, and the
horizontal scale normally adjusts automatically to provide about two
unit intervals across the diagram. If the horizontal time scale is manually
set to less than 1/500th of a unit interval, then the eye diagram will be
unable to display a full unit interval.

================================================================================

5. Known Problems

- Before recalling setup files that include DPOJET configuration, the DPOJET
application needs to be launched at least once from the analyze menu.
Otherwise, the scope state will be recalled but the application will remain
uninitialized.

- When using the query :DPOJET:MEAS:NAME? over the programmable interface,
some commands return names containing non-ASCII characters that may affect
readability (both human and machine). It is recommended that the query
:DPOJET:Meas:TYPE? be used instead if this is a problem.

- DPOJET will not start if initiated over the programmable interface with
command headers enabled (:HEADER 1 or :HEADER ON). Command headers must
be turned off (:HEADER O or :HEADER OFF) prior to starting DPOJET, after
which they can be turned on again.

- It is normally possible to concatenate GPIB commands sent on the programmable
interface, for example ":DPOJET:ADDMEAS TIE; DPOJET:NUMMeas?". However,
some commands don't operate sequentially when sent in this fashion;
particularly when a file recall is followed by a query. It is recommended
that care be taken if more than one command / query is sent per line.

- Over the programmable interface, the report filename autoincrement feature
("DPOJET:REPORT:AUTOincrement 1") does not work. You can avoid overwriting
saved reports by specifying a unique report name before each 'save' operation.

- The Eye Mask Hits measurement does not support the Population Control and
Measurement Limits features.

- When performing channel deskew from within DPOJET, both selected sources
must be turned on manually prior to running the deskew.

- When performing a measurement on a math waveform that relies on another math
expression rather than a live source (for example, Period(MATH1) where
MATH1 = arbFilt(MATH2) and MATH2 = CH1 - CH3), the reference level autoset
code will fail to recognize that an acquisition must be triggered. Try to
avoid math-on-math expressions. For the above example, use Period(MATH1)
where MATH1 = arbFilt(CH1 - CH3).

- On rare occasions (particularly with very long record lengths), if you try
to halt the measurement sequence before it is complete, the sequencing
buttons will return to the ready state but the sequencing indicator will
show that the measurement is still progressing. This resolves itself
automatically but you may need to wait for 30 seconds or more.

- If the scope is driven far into interpolated time (< 1ps/sample) and an eye
diagram is created, the eye's horizontal scale becomes corrupted if more
than one acquisition is accumulated. (This is a corner case since such a
horizontal setting wastes record length and offers no benefits.)

================================================================================

6. Installation

Normally, the DPOJET application resides on the hard drive of your
oscilloscope. If the application is not installed on the hard disk, perform
the following steps to install the application from the Optional Applications
Software on a Windows-Based Oscilloscope DVD Media.

1. If the keyboard is not installed, connect it to the oscilloscope rear
panel.

2. Power on the oscilloscope and wait for it to finish booting.

3. On most systems, the TekScope application will auto-launch as part of the
boot process. If so, exit the TekScope application by choosing File>Exit
or by using the red icon in the upper right corner.

4. Insert the Optional Applications Software DVD in the DVD drive
of the oscilloscope.

5. The autorun utility will start the installation program. If the autorun
utility doesn't start up automatically, browse to the DVD and double-
click 'Launch.exe'.

6. Select the menu option 'Jitter and Eye Diagram Analysis Tools'.

7. Select the option 'Install Now'.

8. Follow the instructions given by the InstallShield Wizard.
Do not change the default locations to install the files.
The oscilloscope must reboot to complete the installation process.

9. You will need to enter the authorized Option Installation Key to enable
the application. The key is specific to the serialized oscilloscope and
options for which it was purchased, and is obtained seperately through
your Tektronix salesperson. To enter the key number, follow
these steps:

a. If the oscilloscope application is in the toolbar mode, select the menu
button (triangular icon at the top of the display, near the right) and
choose Show Menu to put the oscilloscope into menu-bar mode. In menu-bar
mode you should see a PC-style menu across the top of the display.

b. Go to the Utilities menu in the menu bar and select Option
Installation...

c. Follow the on-screen instructions to enter the alphanumeric key
number exactly as it is printed on the new rear-panel option key label
or in the confirmation email.

The DPOJET application is now ready for use. Start the application through
any of the oscilloscope menu selections under Analyze>Jitter and Eye Analysis

================================================================================

7. Contact Information

- Telephone:
Contact your North America Tektronix Representative at 1-800-833-9200
Sales support, select option 1
Service support, select option 2
Technical support, select option 3

For product support outside of North America, contact your local Tektronix
sales office or distributor.

-WEB:
http://www.tektronix.com/Measurement/scopes/home.html

To check for software updates, click on "Software Downloads" under the
"Oscilloscope Product Resources" heading on the right. Then search by
keyword using "DPOJET".

---End of File---