Ellisys 260 User manual

Ellisys USB Explorer 260
Getting Started Guide
Version 1.0.0
November 22, 2007
Ellisys ●Chemin du Grand-Puits 38 ●CH-1217 Meyrin Geneva ●Switzerland
www.ellisys.com ●suppor[email protected]om

Version 1.0.0 November 22, 2007
Table of Contents
Chapter 1: Starting out.....................................................................................5
Introduction........................................................................................................5
Common terms ...................................................................................................6
Front and back panels of the unit...........................................................................7
Chapter 2: Connecting the unit as protocol analyzer ................................8
Introduction........................................................................................................8
Connecting the Analyzer to a computer...................................................................8
Connecting a device under test for analysis ........................................................... 10
First data acquisition.......................................................................................... 12
Chapter 3: Connecting the unit as packet generator................................14
Introduction...................................................................................................... 14
Connecting the Generator as Host........................................................................14
Connecting the Generator as Device.....................................................................16
Connecting the Generator for Inline Error Injection................................................. 16
Chapter 4: Drivers and software installation............................................17
Installing the software and the drivers.................................................................. 17
Chapter 5: Frequently Asked Questions....................................................18
General............................................................................................................ 18
Analyzer........................................................................................................... 18
Generator.........................................................................................................19
Hardware .........................................................................................................20
Chapter 6: Troubleshooting..........................................................................21
Installation .......................................................................................................21
Chapter 7: Technical data..............................................................................22
Analyzer Characteristics .....................................................................................22
Generator Characteristics ................................................................................... 22
Requirements ................................................................................................... 22
Specifications.................................................................................................... 22
Chapter 8: Limited Warranty Terms and Conditions..............................24
Coverage .........................................................................................................24
Ellisys USB Explorer 260 Getting Started Guide Page 2 of 26

Version 1.0.0 November 22, 2007
Excluded Products and Problems.......................................................................... 24
Obtaining Warranty Service ................................................................................24
Limitations ....................................................................................................... 25
Severability ......................................................................................................25
Warranty Period ................................................................................................ 26
Governing Law .................................................................................................. 26
Jurisdiction; Venue ............................................................................................26
Ellisys USB Explorer 260 Getting Started Guide Page 3 of 26

Version 1.0.0 November 22, 2007
Figures Index
Figure 1 - Configuration with two separate computers ...............................................................8
Figure 2 - Configuration with only one computer ......................................................................9
Figure 3 - Connecting only one Device Under Test ..................................................................10
Figure 4 - Wrong connection with more than one DUT .............................................................11
Figure 5 - Correct connection with more than one DUT using a Hub........................................... 12
Ellisys USB Explorer 260 Getting Started Guide Page 4 of 26

Version 1.0.0 November 22, 2007
Chapter 1: Starting out
Introduction
The Ellisys USB Explorer 260 is a sophisticated protocol test system for USB traffic
monitoring, driver and software stack debugging, protocol compliance verification and
performance analysis. The EX260 can reduce your R&D development time by finding
issues early and debugging more efficiently, and can improve quality and reliability by
verifying compliance to the specifications.
The Ellisys USB Explorer 260 is available in three configurations:
The Ellisys USB Explorer 260 Analyzer includes Ellisys' analysis features with
real-time monitoring, hard-disk data streaming, class decoding, traffic statistics,
and triggering and filtering.
The Ellisys USB Explorer 260 Generator supplements protocol analysis by
emulating USB devices and hosts, and by testing corner cases and recovery
mechanisms. Reproducible traffic, timing and error scenarios can be created
with a scripting environment. Captured traffic can be replayed to test a
particular situation. The Generator supports Inline Error Injection feature to
insert programmed errors between a host and device to determine the impact of
transmission errors under rare conditions.
The Ellisys USB Explorer 260 Duo is a flexible bundle of two full-featured
units that can be used as one analyzer and one generator, two analyzers or two
generators depending on your testing requirements. More convenient than
having both functions on the same unit, this allows you to better share your test
equipment among your R&D team.
Ellisys USB Explorer 260 Getting Started Guide Page 5 of 26

Version 1.0.0 November 22, 2007
Common terms
The following terms are used throughout this manual:
Analysis software The analysis software enables users to record data sent
by the analyzer and subsequently displays them in a
simple, easy-to-follow format.
Generator software The generator software enables users to write, run and
debug generator scripts.
Device Under Test A USB device that is going to be analyzed with the
analyzer is called a device under test in this document.
Host Under Test The device under test will be plugged into the Host Under
Test through analyzer's Link Under Test connectors. The
Host Under Test can be any host including a PC, an
embedded computer, a PDA or even a custom piece of
equipment acting like a USB host.
Ellisys USB Explorer 260 Getting Started Guide Page 6 of 26

Version 1.0.0 November 22, 2007
Front and back panels of the unit
The Power LED is illuminated
when the unit is powered on
The Activity LED blinks in green when
packets are detected (in red when
they are recorded)
From Device
Under Test
The Trigger LED illuminated in green
when a trigger is detected in input (in
red when detected in output) To Host
Under Test
To Computer
To Auxiliary equipment
like the Trigger board
Ellisys USB Explorer 260 Getting Started Guide Page 7 of 26

Version 1.0.0 November 22, 2007
Chapter 2: Connecting the unit as protocol analyzer
Introduction
The Ellisys USB Explorer 260 Analyzer is a non-intrusive USB protocol analyzer that can
connect on any link between any host controller and device.
InterChip USB is supported with an optional analysis probe that connects directly
on the USB link between the embedded host and device on a PCB board. Please
contact [email protected] for more information about this option.
The EX260 Analyzer sends data using a High-speed USB 2.0 connection. Although the
unit can download analyzed data on a Full-speed USB 1.1 connection, it is strongly
recommended that you connect it using a High-speed USB 2.0 port to obtain optimal
performance. If you experience any trouble with your analyzer, please ensure it is
connected on a High-speed USB 2.0 enabled host controller before contacting our
technical support.
The Power LED of the front panel is illuminated in green when the unit is
connected on a High-speed USB 2.0 link, and in red when connected on a Full-
speed USB 1.1 link.
Connecting the Analyzer to a computer
Configuration with two computers: recommended configuration
The use of two computers is the recommended configuration (see Figure 1). The Host
Under Test is ascribed to the Device Under Test, and the analysis computer handles
downloads and analyses data coming from the analyzer.
Figure 1 - Configuration with two separate computers
Ellisys USB Explorer 260 Getting Started Guide Page 8 of 26

Version 1.0.0 November 22, 2007
Configuration with only one computer
It is possible to use just one computer for both testing and analysis (see Figure 2), but
this may affect the performances of the real-time data monitor and download. You
must, however, ensure that two or more host controllers are available on the
computer. If there is only one host controller on your computer, a CardBus or PCI
extension card can be purchased to add a second host controller to an existing
computer. Please refer to the chapter on Troubleshooting to determine if your computer
has two host controllers. The following diagram shows how to use the analyzer with
only one computer.
USB Explorer 260
Analyzer
Figure 2 - Configuration with only one computer
HC1
HC2
Host Under Test and
Analysis computer
Ellisys USB Explorer 260 Getting Started Guide Page 9 of 26

Version 1.0.0 November 22, 2007
Connecting a device under test for analysis
Connecting only one Device Under Test
The most straightforward configuration involves only one device to be analyzed.
Figure 3 shows how to properly connect the device under test.
Analysis compute
r
USB Explorer 260
Analyzer
Device Under Test
Host Under Test
Figure 3 - Connecting only one Device Under Test
To prevent problems which could arise from your cables' length, please follow the
following instructions:
-The blue cable must be no longer than 5 meters.
-The total length of the red and purple cables must not exceed 3 meters. A
greater length could result in an abnormally high error rate on the bus being
analyzed.
Ellisys USB Explorer 260 Getting Started Guide Page 10 of 26

Version 1.0.0 November 22, 2007
Connecting more than one Device Under Test
USB analyzers are able to analyze traffic coming only from devices connected under
them. If a device is connected above the analyzer, it will only capture data packets
coming from the host. The Figure 4 shows an incorrect connection: the USB mouse is
connected 'above' the analyzer.
Figure 4 - Wrong connection with more than one DUT
Ellisys USB Explorer 260 Getting Started Guide Page 11 of 26

Version 1.0.0 November 22, 2007
When the analyzer is used to analyze multiple devices, this analysis must necessarily
involve a USB hub. In this way, you can ensure that all the devices to be analyzed are,
in fact, 'below' the analyzer. You should be aware, however, that the analyzer will
record all hub and devices traffic. This won't cause inconvenience because the
software's functions can filter out extra traffic very easily. Figure 5 illustrates how to
connect correctly several devices under test.
Figure 5 - Correct connection with more than one DUT using a Hub
First data acquisition
Before using the analyzer to make your first data acquisition, ensure that you
have successfully completed every step needed to install the software and the
drivers.
Follow these steps to proceed with your first data acquisition:
1. Connect the USB analyzer to the analysis computer as demonstrated in the
section entitled Connecting the unit as protocol analyzer
Ellisys USB Explorer 260 Getting Started Guide Page 12 of 26

Version 1.0.0 November 22, 2007
2. . You must first have successfully installed the analysis software and drivers.
3. Run the analysis software and press keys 'Ctrl+R' (Start Recording). Refer to the
chapter on Troubleshooting if the software indicates that no analyzer is
connected.
4. Connect the USB device to be analyzed as discussed in the section entitled
Connecting a device under test for analysis. For greater safety, first connect a
simple commercial device that you can understand easily. The number of valid
transactions should increase slowly. You can save data acquisition after it has
been recording for a few seconds by clicking the 'Save' button.
5. Congratulations! You have just used the analyzer to record your first data
acquisition. You can now read the USB Analysis Software User's Manual to fully
benefit from all the available power in the analysis software.
Ellisys USB Explorer 260 Getting Started Guide Page 13 of 26

Version 1.0.0 November 22, 2007
Chapter 3: Connecting the unit as packet generator
Introduction
Depending on the script and the configuration, the Ellisys USB Explorer 260 Generator
can emulate a Host controller, a Device or can inject errors on an existing link.
Connecting the Generator as Host
In this setup the Device Under Test must be connected on the A connector of the
Generator. An Analyzer can be connected between the Generator and the Device Under
Test to debug the link. Please refer to the chapter Connecting the unit as protocol
analyzer for more information about the analyzer connection. The figure below show the
correct connection of a Generator as host, a Device Under Test and an Analyzer.
As the Explorer 260 Generator is powered by the USB bus, the power supply for
the Device Under Test must be supplied by an external power supply on the B
connector of the Generator, as displayed in the figure above.
Ellisys USB Explorer 260 Getting Started Guide Page 14 of 26

Version 1.0.0 November 22, 2007
A cable for powering the Device Under Test is supplied with the Generator. The power
cable is a two-part cable:
The first part is a USB B to Jack 5.5 mm female cable. This part must be
connected on the B connector of the Generator.
The second part is a Jack 5.5 mm male to USB A cable. This second part can be
connected to the first part and to a standard USB host to supply the 5VDC to
the Device Under Test. This is the most convenient when the power supply does
not need to be controlled.
The second part can be replaced by an external 5VDC power supply. This is
convenient to control the power supply with the desired voltage. The external
power supply is not supplied by Ellisys.
The figure below illustrates the two-parts power cable.
USB B Only Vbus and GND
The D+ / D- lines
are unconnected
Jack 5.5mm female
USB A
Jack 5.5mm male
Jack 5.5mm male 5VDC power supply
Not supplied by Ellisys
Supplied by Ellisys
Supplied by Ellisys
Ellisys USB Explorer 260 Getting Started Guide Page 15 of 26

Version 1.0.0 November 22, 2007
Connecting the Generator as Device
In this setup the Host Under Test must be connected to the Generator on the
B connector. An Analyzer can be connected between the Generator and the Host Under
Test to debug the link. Please refer to the chapter Connecting the unit as protocol
analyzer for more information about the analyzer connection. The figure below show the
correct connection of a Generator as device, a Host Under Test and an Analyzer.
Connecting the Generator for Inline Error Injection
In this setup the Device Under Test and the Host Under Test must be connected
through the Generator. An Analyzer can also be connected between in-line with the
Generator to debug the link. Please refer to the chapter Connecting the unit as protocol
analyzer for more information about the analyzer connection. The figure below show the
correct connection of a Host Under Test, a Device Under Test, a Generator for Inline
Error Injection and an Analyzer.
Analysis computer
USB Explorer 260
Analyzer
Device Under Test
USB Explorer 260
Generator
Host Under Test
Ellisys USB Explorer 260 Getting Started Guide Page 16 of 26

Version 1.0.0 November 22, 2007
Chapter 4: Drivers and software installation
Installing the software and the drivers
The Analyzer and the Generator software are documented in two additional user
manuals. These user manuals describe how to install the software & drivers and how to
operate the units. The manuals are available on the supplied installation and
documentation CD-ROM and on the Ellisys website. Please refer to these manual for
more information.
Ellisys USB Explorer 260 Getting Started Guide Page 17 of 26

Version 1.0.0 November 22, 2007
Chapter 5: Frequently Asked Questions
General
What is the Ellisys USB Explorer 260?
The Ellisys USB Explorer 260 is an advanced multifunction USB protocol test system
capable of:
analyzing any USB 1.1 or USB 2.0 link, including OTG and IC-USB
emulating USB hosts and devices
injecting pre-defined errors for stress testing or error recovery
verifying the compliance to the USB specification
Is the same hardware able to act either as analyzer or generator?
Yes. Each hardware unit is capable of acting either as a protocol analyzer or packet
generator depending on the options purchased.
Analyzer
Which recording speeds can be analyzed by the Ellisys USB Explorer 260
Analyzer?
The USB Explorer 260 supports recording of Low-speed (1.5 Mbit/s), Full-speed (12
Mbit/s) and Hig-speed (480 Mbit/s) links. It can record traffic from any USB 2.0
device, including USB OTG devices and InterChip USB. The analyzer automatically
detects the appropriate recording speed for an unequalled ease of use.
Which type of configuration do I need to analyze a device?
A computer and a host under test are necessary to analyze a device. The computer
may be used as host under test, but two host controllers are necessary in this case:
the first to connect the peripheral to be tested and the other to record the data. You
must therefore have either:
•A separate computer and host under test, the first for analysis and the other
for testing
•One computer with two host controllers. This is the case when an USB 2.0
extension card is used.
To obtain the best performance, we highly recommend the use of two computers.
The analyzer records data using a USB 2.0 connection. Do I need a USB 2.0
host controller?
No. In most cases, the analyzer works just as fine with a high speed connection (480
Mbit/s) than with a full speed one (12 Mbit/s). But you must be aware that a full
speed connection may not be adequate if the data flow is too large. If you
experience any kind of trouble with the analyzer, please ensure that you are using
the recommended configuration.
Ellisys USB Explorer 260 Getting Started Guide Page 18 of 26

Version 1.0.0 November 22, 2007
What is the maximum quantity of data that I can record?
The analyzer uses the host-computer memory to store recorded traffic. Since the
Ellisys USB analysis software records data to the central memory (RAM), the
maximum amount of data is usually limited to a few hundreds of megabytes. The
hard-disk streaming recording mode permits to record a huge amount of data by
storing the analyzed data directly on the hard-disk into several consecutive files.
This is the peferred mode of recording for debugging intermittent issues that are not
catchable by a trigger.
Generator
What is the Ellisys USB Explorer 260 Generator useful for?
The Ellisys USB Explorer 260 Generator supplements protocol analysis by emulating
USB devices and hosts, and by testing corner cases and recovery mechanisms.
Reproducible traffic, timing and error scenarios can be created with a powerful
scripting environment. Captured traffic can be replayed to test a particular situation.
Is the Ellisys 260 Generator able to generate packets interactively?
Yes. The timing constaints of the USB protocol are very straight and no equipment
was previously able to generate packets interactively based on received responses,
still having a low-level control over the packets, the timings and the errors. The
Ellisys generator achieve this by using a specialized processor designed by Ellisys.
Why is the Ellisys 260 Generator so powerful?
The Ellisys 260 Generator contains specialized processor designed by Ellisys. The
specialized processor is able to react fast enough to compute responses the adapted
answer depending on the application and the protocol. Standard USB products
contains a dedicated hardware managing USB transactions and transfers. For testing
purposes, this has the drawback to not let the developer fully define error cases,
timings and scenario. The Ellisys generator permits at the same time to write scripts
able to implement high-level protocols, still having a low-level control over the
packets, and timings and the errors.
What is Inline Error Injection?
The new error injection features lets developers deliberately introduce errors to see
how the device under test reacts. This helps increase the robustness of a product --
to test not just a device's compliance with protocol-correct traffic, but its ability to
handle and recover from error situations.
I saw a suspect behavior of my device with my Ellisys' analyzer, but I am
unable to reproduce the same conditions to verify whether the error is fixed.
Can the generator help?
Traces recorded with the 260 Analyzer can be exported from the analysis software to
the generator. If your trace contains enough information, you will be able to
reproduce the problem using the generator, and verify that you fixed the the issue
by using the protocol analyzer in conjunction.
Ellisys USB Explorer 260 Getting Started Guide Page 19 of 26

Version 1.0.0 November 22, 2007
Hardware
Is it possible to upgrade the analyzer firmware?
Yes, the analyzer firmware is automatically upgraded with each new USB analysis
software release. No user intervention is required. Our newsletter is sent to all
subscribers when a new software is released.
Which packets light up the Activity indicator?
DATA packets light up the Activity indicator for around ten milliseconds. In a busy
bus case, this indicator blinks rapidly.
Ellisys USB Explorer 260 Getting Started Guide Page 20 of 26