Teledyne LSIB-1 User manual

Operator’s
Manual
LSIB-1 Host
Interfaces

LSIB-1 Host Interfaces
Operator's Manual
January, 2013

700 Chestnut Ridge Road
Chestnut Ridge, NY, 10977-6499
Tel: [phone] Fax: [phone]
teledynelecroy.com
LSIB-1 Host Interfaces Operator's Manual
© 2013 Teledyne LeCroy, Inc. All rights reserved.
Unauthorized duplication of Teledyne LeCroy
documentation materials other than for internal sales and
distribution purposes is strictly prohibited. However,
clients are encouraged to distribute and duplicate
Teledyne LeCroy documentation for their own internal
educational purposes.
LSIB-1 and Teledyne LeCroy are registered trademarks of
Teledyne LeCroy, Inc. Windows is a registered trademark
of Microsoft Corporation. Other product or brand names
are trademarks or requested trademarks of their
respective holders. Information in this publication
supersedes all earlier versions. Specifications are subject
to change without notice.
LSIB-OM-E Rev C
921923-00 Rev A

Operator's Manual
LSIB-OM-E Rev C
i
TABLE OF CONTENTS
Welcome ................................................................ 1
Package Contents................................................... 2
LSIB-HOSTCARD .....................................................2
LSIB-HOSTBOARD ...................................................3
System Requirements ............................................ 4
LSIB-HOSTCARD Description, Unpacking, and
Installation ............................................................ 5
Description .............................................................5
Unpacking ..............................................................5
Installation .............................................................6
LSIB HOSTBOARD Description, Unpacking, and
Installation ............................................................ 8
Description .............................................................8
Unpacking ..............................................................8
Installation .............................................................9
Powering Sequence.............................................. 10
Laptop or PC Application and Driver Installation.. 10
Laptop or PC Application, Linux Driver Installation,
and Libraries ........................................................ 12
Overview .............................................................. 12
Requirements........................................................ 12
Installation Steps .................................................. 13

LSIB-1 Host Interfaces
ii
LSIB-OM-E Rev C
Samples and Demo Applications .......................... 15
Overview .............................................................. 15
Control Sample ..................................................... 16
Remote Control Commands .................................... 20
Export Sample ...................................................... 21
Performance Demo Application ................................ 26
Compiling Custom Code........................................ 32
Specifications....................................................... 33
Certifications........................................................ 33
EC Declaration of Conformity - EMC ......................... 33
EC Declaration of Conformity –Low Voltage.............. 33
EC Declaration of Conformity - Restriction of Hazardous
Substances (RoHS) ................................................ 34
End-of-Life Handling .............................................. 34
ISO Certification .................................................... 34
Contact Teledyne LeCroy...................................... 35

Operator's Manual
LSIB-OM-E Rev C
1
Welcome
Thank you for purchasing an LSIB Host Interface
accessory for your Teledyne LeCroy oscilloscope. Used
properly, this piece of hardware provides reliable
Oscilloscope and PC/Laptop network connections.
When your LSIB Host Interface accessory is delivered,
verify all items on the packing list or invoice copy have
been shipped to you. Contact your nearest Teledyne
LeCroy customer service center or national distributor if
anything is missing or damaged. You must contact us
immediately for a replacement. If you have any problems
with your product, please refer to the Technical Support
contacts and support material at teledynelecroy.com, or
at the back of this manual.
We truly hope these materials provide increased
comprehension when using Teledyne LeCroy's fine
products.
Sincerely,
David C. Graef
Vice President and Chief Technology Officer
Teledyne LeCroy

LSIB-1 Host Interfaces
2
LSIB-OM-E Rev C
Package Contents
The package should contain your hardware based on what
you ordered, LSIB-HOSTCARD (for laptops) or LSIB-
HOSTBOARD (for PCs). It also contains the cable you
ordered (either 3M or 7M). Your configuration should look
similar to one of the following paths.
LSIB-HOSTCARD

Operator's Manual
LSIB-OM-E Rev C
3
LSIB-HOSTBOARD
LSIB-HOSTBOARD comes with a bracket for proper 4x
motherboard installation.
LSIB-HOSTCARD or LSIB-HOSTBOARD comes with your
choice of a 7M (pictured below) or 3M x4 connection
cable.
Attach the cable to LSIB-HOSTCARD or LSIB-HOSTBOARD
by pushing forward on the retractor ring to lock the cable
into place.

LSIB-1 Host Interfaces
4
LSIB-OM-E Rev C
Remove the cable by first pulling on the retractor ring
which releases the locking mechanism.
The connectors on either end of the cables are identical
and allow for upstream and downstream transfers.
System Requirements
Operating System - Windows 7 x86 and Windows
7 X64, Windows Vista x86, Windows Vista x64,
Windows XP, or certain versions of Linux.
PC - Your motherboard must support PCIe x4.
Laptop - You must have a 34 Form Factor
Expresscard slot.

Operator's Manual
LSIB-OM-E Rev C
5
LSIB-HOSTCARD Description,
Unpacking, and Installation
Description
LSIB-HOSTCARD is a PCIe x1 ExpressCard/34 adapter
that adds high-speed PCI Express (PCIe) expansion
capability to your laptop. The PCIe cable port provides
PCIe x1 connectivity to oscilloscopes configured with the
LSIB-1 option.
Unpacking
1. If the carton is damaged upon receipt:
Request the carrier's agent be present when
unpacking and inspecting the contents.
If the contents appear damaged, contact your
local Teledyne LeCroy Corporation representative
to obtain a Return Materials Authorization (RMA)
number and further shipping instructions for any
repair and/or replacement needs.
If all is well, proceed to unpack the carton.

LSIB-1 Host Interfaces
6
LSIB-OM-E Rev C
2. After unpacking, verify all items listed in the
packing list are present.
3. Inspect the equipment for shipping damage.
4. Save all packing material for storage or return
shipment of the equipment.
5. Remove LSIB-HOSTCARD from the anti-static bag.
Installation
1. Shut down the host laptop into which you are
installing the card.
2. Remove the plastic filler plate (if necessary) from
the ExpressCard slot and guide the card in place
following the manufacturer's instructions.
NOTE: The card may be installed in any
ExpressCard/34 (single wide) or ExpressCard/54
(double wide) slot.

Operator's Manual
LSIB-OM-E Rev C
7
3. Attach the cable by first pulling on the retractor
ring which releases the locking mechanism.
Connection ends are interchangeable and allow for
upstream and downstream transfers.
4. Push the cable into the ExpressCard slot until it
locks into place.
5. Attach the other end of the cable to the
oscilloscope.
NOTE: Reverse these steps to remove the cable and the
LSIB-HOSTCARD being sure to first pull the cable's
retractor ring which releases the locking mechanism
before removing the cable.

LSIB-1 Host Interfaces
8
LSIB-OM-E Rev C
LSIB HOSTBOARD Description,
Unpacking, and Installation
Description
LSIB-HOSTBOARD allows communication between a
processor and an I/O port.
Unpacking
1. If the carton is damaged upon receipt:
Request the carrier's agent be present when
unpacking and inspecting the contents.
If the contents appear damaged, contact your
local Teledyne LeCroy Corporation representative
to obtain a Return Materials Authorization (RMA)
number and further shipping instructions for any
repair and/or replacement needs.
If all is well, proceed to unpack the carton.
2. After unpacking, verify all items listed in the
packing list are present.
3. Inspect the equipment for shipping damage.
4. Save all packing material for storage or return
shipment of the equipment.
5. Remove LSIB-HOSTBOARD from the anti-static
bag.

Operator's Manual
LSIB-OM-E Rev C
9
Installation
1. Shut down the host PC in which you are installing
the card.
2. Open the chassis according to your PC
documentation and let the power supply cool down
(if necessary).
3. Install LSIB-HOSTBOARD into a PCIe x4, x8, x16
add-in card slot. Make sure the card is well seated
and tighten the screw.
NOTE: Motherboard manufacturers may limit the
bandwidth to x1 speeds when up-plugging the
Target Cable Adapter into an x8 or x16 slot. Be
sure to check with the motherboard manufacturer
for up-plugging details. A PCIe x4 board does not
physically fit in a x1 slot.
4. Attach the cable by first pulling on the retractor
ring which releases the locking mechanism.
Connection ends are interchangeable and allow for
upstream and downstream transfers.
5. Push the cable into the ExpressCard slot until it
locks into place.
6. Attach the other end of the cable to the
oscilloscope.

LSIB-1 Host Interfaces
10
LSIB-OM-E Rev C
NOTE: Reverse these steps to remove the cable and the
LSIB-HOSTBOARD being sure to first pull the cable's
retractor ring which releases the locking mechanism
before removing the cable.
Powering Sequence
The connection from the oscilloscope to the PC or Laptop
is not "plug-and-play." You must first power on the
oscilloscope, then the PC/Laptop. However, you do not
have to wait for the oscilloscope software to fully load
before powering on the PC.
NOTE: At power on, your PC/Laptop may indicate it has
found new hardware. Be sure to click Cancel if prompted
to install drivers. Install the drivers using the CD provided
with the Interface. Do not disconnect cables while your
Laptop/PC and the instrument are powering up.
Laptop or PC Application and Driver
Installation
Instead of using the installation CD provided with the
Interface, the software can also be accessed from the
Teledyne LeCroy website at teledynelecroy.com.
Cancel Found New Hardware Procedure on the
Laptop or PC if Prompted
After installing the LSIB-HOSTCARD or LSIB-HOSTBOARD
and powering on, if your computer shows a Windows
Found New Hardware prompt, cancel the operation and
instead run the installation CD.
NOTE: It's very important to use the installation CD
and not the Found New Hardware function.

Operator's Manual
LSIB-OM-E Rev C
11
Insert the CD in the PC or Laptop and follow the prompts.
Choose components - Drivers, Docs, and Example
check boxes are checked by default and should be
left this way. The Desktop Shortcut check box is
unchecked by default. Include or exclude the
shortcut as desired.
One of the installation prompts has check boxes
checked by default for viewing the Readme file and
running the Control Sample Setup... when the
installation is complete. It's recommended to leave
these check boxes checked.

LSIB-1 Host Interfaces
12
LSIB-OM-E Rev C
Laptop or PC Application, Linux
Driver Installation, and Libraries
Instead of using the installation CD provided with the
Interface, the software can also be accessed from the
Teledyne LeCroy website at teledynelecroy.com.
Overview
The software for LSIB Linux consists of the following
components and their associated include and make files.
The kernel driver.
A user library named lecroylsiblib.
Three demo programs named LSIBPerformance,
LSIBexportsample, and LSIBcontrolsample.
These are all supplied as source files, written in C/C++,
and packaged in a bzip2 compressed tar file named
LSIB -xxxxxx.tz2.
NOTE: You need to compile the source files and install
them on your system.
Requirements
The LSIB Linux driver requires the use of MTRRs
(Memory Type Range Registers) to map the memory
used for communications. This requires kernel
version 2.6.20 or greater.
The use of the MTRRs also require the CPU be a 64-
bit AMD or an Intel processor running a 64-bit
version of Linux.
The gcc compilers.
The kernel sources. These can be obtained by
issuing the following Redhat Linux command:
# yum install kernel-devel Kernel-headers

Operator's Manual
LSIB-OM-E Rev C
13
NOTE: You must have superuser privileges or be logged
in as root for successful completion of the following
instructions.
Installation Steps
1. Navigate to the complete set of LSIB files on your
system. They are typically named LSIB-
xxxxxx.tz2.
cd /
tar xvfj directory_path/LSIB_xxxxxx.tz2
2. Compile and install the driver and libraries.
cd directory_path/LSIB_xxxxxx/LSIB
make all
3. Install the driver.
make install
4. Start the driver.
make startdriver
NOTE: At this point, you may need to shutdown
the oscilloscope and the host computer/laptop. If
so, be sure to power-up the oscilloscope first
followed by the host computer/laptop after the
shutdown. The driver is then loaded automatically
during the system restart.
The files in the Linux_ExpressNet-X.Y.ZZZ.tz2 file
all untar into an LSIB subdirectory. Untar these
files to the standard Linux system ( / ) location by
logging in as root and doing the following:
cd /
tar xvfj directory_path/LSIB-xxxxxx.tz2

LSIB-1 Host Interfaces
14
LSIB-OM-E Rev C
The resulting /LSIB directory contains the following
Directories/Files.
driver - The directory containing the LSIB Linux
driver.
EnDemo - Test application.
Include - Directory containing the LSIB include
files.
Lecroylsib - Directory containing the LSIB library
files.
Lsibcontrolsample - Application demonstrating
LSIB control functionality.
Lsibexportsample - Application demonstrating
LSIB export functionality.
Lsibperformance - Application demonstrating link
performance.
UNINSTALL - A Perl script that removes all
ExpressNet files on the system.