Allied AVT Guppy User manual

Getting started
V4.0.1
02 February 2007
Allied Vision Technologies GmbH
Taschenweg 2a
D-07646 Stadtroda / Germany
AVT Guppy

GUPPY Getting Started V4.0.1
2
Legal notice
For customers in the U.S.A.
This equipment has been tested and found to comply with the limits for a Class B digital
device, pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable
protection against harmful interference when the equipment is operated in a residential envi-
ronment. This equipment generates, uses, and can radiate radio frequency energy and, if not
installed and used in accordance with the instruction manual, may cause harmful interference
to radio communications. However there is no guarantee that interferences will not occur in
a particular installation. If the equipment does cause harmful interference to radio or televi-
sion reception, the user is encouraged to try to correct the interference by one or more of the
following measures:
• Reorient or relocate the receiving antenna.
• Increase the distance between the equipment and the receiver.
• Use a different line outlet for the receiver.
• Consult a radio or TV technician for help.
You are cautioned that any changes or modifications not expressly approved in this manual
could void your authority to operate this equipment. The shielded interface cable recom-
mended in this manual must be used with this equipment in order to comply with the limits
for a computing device pursuant to Subpart B of Part 15 of FCC Rules.
For customers in Canada
This apparatus complies with the Class B limits for radio noise emissions set out in the Radio
Interference Regulations.
Pour utilisateurs au Canada
Cet appareil est conforme aux normes classe B pour bruits radioélectriques, spécifiées dans le
Règlement sur le brouillage radioélectrique.
Life support applications
These products are not designed for use in life support appliances, devices, or systems where
malfunction of these products can reasonably be expected to result in personal injury. Allied
customers using or selling these products for use in such applications do so at their own risk
and agree to fully indemnify Allied for any damages resulting from such improper use or sale.
Trademarks
Unless stated otherwise, all trademarks appearing in this document of Allied Vision
Technologies are brands protected by law.
Warranty
The information provided by Allied Vision Technologies is supplied without any guarantees or
warranty whatsoever, be it specific or implicit. Also excluded are all implicit warranties con-
cerning the negotiability, the suitability for specific applications or the non-breaking of laws
and patents. Even if we assume that the information supplied to us is accurate, errors and
inaccuracy may still occur.
Copyright
All texts, pictures and graphics are protected by copyright and other laws protecting intellec-
tual property. It is not permitted to copy or modify them for trade use or transfer, nor may
they be used on web sites.
Allied Vision Technologies GmbH 02/2007
All rights reserved.
Managing Director: Mr. Frank Grube
Tax ID: DE 184383113
Support:
Taschenweg 2A
D-07646 Stadtroda, Germany
Tel.: [phone]
Fax: [phone]
e-mail: [email protected]

GUPPY Getting Started V4.0.1
3
Contents
Introduction ............................................................................................................ 6
Document history .......................................................................................................... 6
Conventions used in this manual...................................................................................... 7
Styles ...................................................................................................................... 7
Symbols ................................................................................................................... 7
Before operation ........................................................................................................... 8
Declarations of conformity ............................................................................ 9
Safety instructions ............................................................................................11
Reference documents applicable in the United States......................................................... 11
Reference documents applicable in Europe ....................................................................... 11
Reference documents applicable in Japan......................................................................... 11
Safety instructions........................................................................................................ 12
Safety instructions for board level cameras....................................................................... 13
Environmental conditions .............................................................................................. 15
Guppy types and highlights..........................................................................16
.......................................................................................................................................19
System components .........................................................................................20
Old CS-/C-Mounting ...................................................................................................... 20
New CS-/C-Mounting ..................................................................................................... 21
Guppy board level cameras ............................................................................................. 22
Camera lenses.......................................................................................................... 24
Quick start with FirePackage......................................................................25
Hardware conditions ..................................................................................................... 25
Operating system conditions .......................................................................................... 25
Software conditions ...................................................................................................... 25
Overview FirePackage .................................................................................................... 25
Installing IEEE 1394 adapter .......................................................................................... 26
Installing FirePackage (incl. SmartView program) .............................................................. 26
Starting SmartView ....................................................................................................... 27
Connecting camera to PC or laptop.................................................................................. 27
Licensing .................................................................................................................... 28
First steps with SmartView ............................................................................................. 28
Troubleshooting ........................................................................................................... 29
Further steps with SmartView ......................................................................................... 30
Quick start with Direct FirePackage.......................................................32
Hardware conditions ..................................................................................................... 32
Operating system conditions .......................................................................................... 32

GUPPY Getting Started V4.0.1
4
Software conditions ...................................................................................................... 32
Overview Direct FirePackage ........................................................................................... 32
Installing IEEE 1394 adapter .......................................................................................... 33
Connecting camera to PC or laptop.................................................................................. 33
Installing Direct FirePackage .......................................................................................... 33
Starting SmartView for WDM ........................................................................................... 35
First steps with SmartView for WDM................................................................................. 35
Troubleshooting ........................................................................................................... 36
Further steps with SmartView for WDM ............................................................................. 37
Quick start with Fire4Linux..........................................................................41
Hardware conditions ..................................................................................................... 41
Operating system conditions .......................................................................................... 41
Software conditions ...................................................................................................... 41
Overview Fire4Linux ...................................................................................................... 42
Installing IEEE 1394 adapter .......................................................................................... 44
First steps with cc1394.................................................................................................. 44
Troubleshooting ........................................................................................................... 44
Further steps with cc1394.............................................................................................. 45
Specifications .......................................................................................................50
Guppy F-033B .............................................................................................................. 50
Guppy F-033C............................................................................................................... 52
Guppy F-033B BL (board level) ....................................................................................... 54
Guppy F-033C BL (board level)........................................................................................ 56
Guppy F-036B .............................................................................................................. 58
Guppy F-036C............................................................................................................... 60
Guppy F-046B .............................................................................................................. 62
Guppy F-046C............................................................................................................... 64
Guppy F-080B .............................................................................................................. 66
Guppy F-080C............................................................................................................... 68
Guppy F-080B BL (board level) ....................................................................................... 70
Guppy F-080C BL (board level)........................................................................................ 72
Spectral sensitivity ....................................................................................................... 74
Camera dimensions ..........................................................................................80
Guppy standard housing (old CS-/C-Mounting) .................................................................. 80
Guppy standard housing (new CS-/C-Mounting)................................................................. 81
Guppy board level......................................................................................................... 82
Guppy board level: CS-Mount .......................................................................................... 83
Guppy board level: C-Mount............................................................................................ 84
Guppy board level: M12-Mount ....................................................................................... 85
Tripod adapter ............................................................................................................. 86
Cross section: C-Mount (old CS-/C-Mounting) .................................................................... 87
Cross section: C-Mount (new CS-/C-Mounting)................................................................... 88
Cross section: CS-Mount (old CS-/C-Mounting) .................................................................. 89
Cross section: CS-Mount (new CS-/C-Mounting) ................................................................. 90

GUPPY Getting Started V4.0.1
5
Camera interfaces .............................................................................................91
IEEE 1394 port pin assignment ....................................................................................... 91
Board level camera: IEEE 1394 port pin assignment....................................................... 93
Camera I/O pin assignment ............................................................................................ 94
Board level camera: I/O pin assignment....................................................................... 96
Status LEDs.................................................................................................................. 97
On LED (green) ........................................................................................................ 97
Status LED............................................................................................................... 97
Operating the camera.................................................................................................... 99
Control and video data signals........................................................................................ 99
Input ................................................................................................................... 100
Trigger ............................................................................................................. 101
Outputs ................................................................................................................ 101
Output modes.................................................................................................... 102
Board level cameras: inputs and outputs.................................................................... 103
Board level cameras: pulse-width modulation ............................................................. 103
PWM: minimal and maximal periods and frequencies ............................................... 104
PWM: Examples in practice .................................................................................. 105
Firmware update...............................................................................................106
Index.........................................................................................................................107

Introduction
GUPPY Getting Started V4.0.1
6
Introduction
Document history
Version Date Remarks
PRE_V1.0.0 01.12.2005 New Manual - PRELIMINARY status
PRE_V1.0.1 01.03.2006 New Manual - PRELIMINARY status; minor corrections
V2.0.0 06.04.2006 New Manual - RELEASE status; added video modes and frame
rates for Guppy F-033 / F-046 / F-080
V2.0.1 28.06.2006 RoHS conformity; minor corrections
PRE_V3.0.0 30.10.2006 Minor corrections
Input characteristics: Added description to input voltage
(Table 30: Input characteristics on page 100)
Added Guppy F-036B/C
New CAD drawing in Figure 27: Camera dimensions (new CS-/
C-Mounting) on page 81.
New CAD drawing in Figure 34: Guppy C-Mount dimensions
(new CS-/C-Mounting) on page 88.
New CAD drawing in Figure 36: Guppy CS-Mount dimensions
(new CS-/C-Mounting) on page 90.
New CS-Mount and C-Mount adapter in Chapter Guppy types and
highlights on page 16.
Added Guppy F-33B/C BL (board level version)
PRE_V4.0.0 26.01.2007 Minor corrections
Added Guppy F-080B/C BL (board level version)
Added new features Guppy-F036B/C
V4.0.1 02.02.2007 Minor corrections
Table 1: Document history

Introduction
GUPPY Getting Started V4.0.1
7
Conventions used in this manual
To give this manual an easily understood layout and to emphasize important
information, the following typographical styles and symbols are used:
Styles
Symbols
Style Function Example
Bold Programs, inputs or highlighting
important things
bold
Courier Code listings etc. Input
Upper case Register REGISTER
Italics Modes, fields Mode
Parentheses and/or blue Links (Link)
Table 2: Styles
Note
L
This symbol highlights important information.
Caution
a
This symbol highlights important instructions. You have to
follow these instructions to avoid malfunctions.
Caution-ESD This symbol highlights important ESD instructions. Only
qualified personnel is allowed to install and operate compo-
nents marked with this symbol.
www
Ý
This symbol highlights URLs for further information. The URL
itself is shown in blue.
Example:
http://www.alliedvisiontec.com

Introduction
GUPPY Getting Started V4.0.1
8
Before operation
We place the highest demands for quality on our cameras. The Getting
Started Manual is the guide to the installation of the GUPPY cameras. You
will also find the specifications and interfaces here.
Note
L
Please read through this manual carefully before operating
the camera.

Declarations of conformity
GUPPY Getting Started V4.0.1
9
Declarations of conformity
Allied Vision Technologies declares under its sole responsibility that the fol-
lowing products
to which this declaration relates are in conformity with the following stan-
dard(s) or other normative document(s):
• EN 55022
• EN 55024
• EN 61000
• FCC Class B
• RoHS (2002/95/EC)
following the provisions of 89/336/EEC directive(s), amended by directive
91/263 EEC, 92/31/EEC and 93/68/EEC.
Category name Model name
Digital camera (IEEE 1394) Guppy F-025B
Guppy F-025C
Guppy F-029B
Guppy F-029C
Guppy F-033B
Guppy F-033C
Guppy F-033B BL (board level)
Guppy F-033C BL (board level)
Guppy F-036B
Guppy F-036C
Guppy F-046B
Guppy F-046C
Guppy F-080B
Guppy F-080C
Guppy F-080B BL (board level)
Guppy F-080C BL (board level)
Table 3: Model names

Declarations of conformity
GUPPY Getting Started V4.0.1
10
Note
L
Customer samples may not comply with above regulations.

Safety instructions
GUPPY Getting Started V4.0.1
11
Safety instructions
Reference documents applicable in the United
States
The reference documents include
• Information Processing and Business Equipment, UL 478
• National Electric Code, ANSI/NFPA 70
• Standard for the Protection of Electronic Computer/Data-Processing
Equipment, ANSI/NFPA 75
Reference documents applicable in Europe
The reference documents include materials to ensure European Union CE
marking as follows:
• Telecommunications Terminal Equipment (91/263/EEC)
• EMC Directive (89/339/EEC)
• CE Marking Directive (93/68/EEC)
• LOW Voltage Directive (73/23/EEC) as amended by the CE Marking
Reference documents applicable in Japan
The reference documents include:
• Electronic Equipment Technology Criteria by the Ministry of Trading and
Industry (Similar to NFPA 70)
Note
L
• There are no switches or parts inside the camera that
require adjustment. The guarantee becomes void upon
opening the camera casing.
• If the product is disassembled, reworked or repaired by
other than a recommended service person, AVT or its
suppliers will take no responsibility for the subsequent
performance or quality of the camera.
• The camera does NOT generate dangerous voltages
internally. However, because the IEEE 1394a standard
permits cable power distribution at voltages higher
than 24 V, various international safety standards apply.

Safety instructions
GUPPY Getting Started V4.0.1
12
• Wired Electric Communication Detailed Law 17 by the Ministry of Posts
and Telecom Law for Electric Equipment
• Dentori law issued by the Ministry of Trading and Industry
• Fire law issued by the Ministry of Construction
Safety instructions
Caution
a
• Make sure NOT to touch the shield of the camera cable
connected to a computer and the ground terminal of
the lines at the same time.
• Use only DC power supplies with insulated cases. These
are identified by having only TWO power connectors.
• Although IEEE 1394a is functionally plug and play, the
physical ports may be damaged by excessive ESD (elec-
trostatic discharge), when connected under powered
conditions. It is good practice to bring the metal part,
which is the shield of the IEEE 1394 cable, in contact
with the housing of the camera (before plugging it into
the camera) and, at the other end, in contact with
metal parts of the computer, before plugging it into the
port of the computer. This ensures that excessive
charge can flow safely to ground.
• If you feel uncomfortable with the previous advice, or if
you have no knowledge about the connectivity of an
installation, we strongly recommend powering down all
systems before connecting or disconnecting a camera.

Safety instructions
GUPPY Getting Started V4.0.1
13
Safety instructions for board level cameras
Note
L
Read the Guppy Technical Manual and this safety instruc-
tions before use.
Abuse or misapplication of the camera may result in lim-
ited warranty or cancelation of warranty.
Caution-ESD Board level cameras: ESD warnings
•Onlyqualified personnel is allowed to install and oper-
ate the Board level cameras.
• Board level camerass are delivered without housing.
Handle the sensor board and main board with care. Do
not bend the boards. Do not touch the components or
contacts on a board. Hold a board by its edges.
• Sensor board and main board are sensitive to electro-
static discharge. To avoid possible damage, handle all
static-sensitive boards and components in a static-safe
work area. Follow the procedures below.
• ESD (electrostatic discharge): Static electricity can
damage the sensor board or the main board of your
Board level cameras. To prevent static damage, dis-
charge static electricity from your body before you
touch any of your Board level cameras’s electronic com-
ponents, such as sensor board or main board. To do so,
use a static-safe workarea with static-dissipative mat
and wear a static-dissipative wrist strap. Do not hold
any components of your Board level cameras against
your clothing. Even if you are wearing a wrist strap,
your body is grounded but your clothes are not.
• Do not remove the sensor board and main board from its
anti-static packaging unless your body is grounded.
•ESD shielding: To protect the boards from radiation of
other modules or devices use a special ESD protective
housing.

Safety instructions
GUPPY Getting Started V4.0.1
14
Caution
a
Board level cameras: General Warnings
• Be sure that all power to your board level cameras is
switched off, before mounting the sensor board or mak-
ing connections to the camera.
• Do not connect or disconnect any cables during an elec-
trical storm.
• Do not use your board level cameras during an electrical
storm.
• To help avoid possible damage to the sensor board or
main board, wait 5 seconds after power is switched off,
before connecting or disconnecting any cable to the
board level cameras.
• Ensure that nothing rests on the cables of your board
level cameras.
• Keep your board level cameras away from radiators and
heat sources.
• Do not spill food or liquids on your board level cameras.
Caution
a
Board level cameras: Loading
• Avoid any mechanical forces to the board level cameras,
the boards and its components, especially torsional,
tensile and compressive forces. Any of these forces may
result in damage of the board level cameras, the boards
and its components.
• To avoid damages of the boards, provide cables with an
external pull relief so that no force is applied to the
connectors itself.
Caution
a
Board level cameras: Dirty environments
• Always use clean boards.
• To protect the boards from dirt like dust, liquids or
swarf always use the board level cameras only in clean
room environment or use a protective housing.

Safety instructions
GUPPY Getting Started V4.0.1
15
Environmental conditions
Housing temperature (when camera in use): + 5 °C ... + 50 °C
Ambient temperature during storage: - 10 °C ... + 60 °C
Relative humidity: 20 % … 80 % without condensation
Protection (for cased models): IP 30
Protection (for board level): IP 00

Guppy types and highlights
GUPPY Getting Started V4.0.1
16
Guppy types and highlights
With Guppy cameras, entry into the world of digital image processing is sim-
pler and more cost-effective than ever before.
With the new GUPPY, Allied Vision Technologies presents a whole series of
attractive digital camera entry-level models of the FireWire™ type.
These products offer an unequalled price-performance relationship and make
the decision to switch from using analogue to digital technology easier than
ever before.
The AVT Guppy family consists of six very compact IEEE 1394 C-Mount cam-
eras, which are equipped with highly sensitive high-quality sensors (CCD,
CMOS).
Each of these cameras is available in black/white and color versions.
A large selection of different sensor sizes (type 1/2, type 1/3) and resolu-
tions (VGA, SVGA, XGA) ensures the suitability of the cameras for all applica-
tions.
The Guppy family consists of the following models:
Operating in 8-bit mode (CCD b/w only), the cameras ensure very high quality
images under almost all circumstances. The GUPPY is equipped with an asyn-
chronous trigger shutter as well as true partial scan, and integrates a number
of useful and intelligent smart features for image processing.
Guppy type Sensor Picture size Frame rates
GUPPY F-025B/C Type 1/3 SONY ICX404AL/AK
Interlaced EIA CCD imager
(NTSC) 508 (h) x 492 (v) up to 30 fps
(60 fields per
second)
GUPPY F-029B/C Type 1/3 SONY ICX405AL/AK
Interlaced CCIR CCD imager
(PAL) 500 (h) x 582 (v) up to 25 fps
(50 fields per
second)
GUPPY F-033B/C and
board level version
Type 1/3 Sony ICX424AL/AQ
Progressive Scan CCD imager
(VGA) 656 (h) x 494 (v) up to 60 fps
GUPPY F-036B/C Type 1/3 Micron Imaging
MT9V022
Global Shutter CMOS imager
(WideVGA) 752 (h) x 480 (v) up to 64 fps
GUPPY F-046B/C Type 1/2 Sony ICX415AL/AQ
Progressive Scan CCD imager
(SVGA) 780 (h) x 582 (v) up to 49 fps
GUPPY F-080B/C and
board level version
Type 1/3 Sony ICX 204AL/AK
Progressive Scan CCD imager
(XGA) 1032 (h) x 778 (v) up to 30 fps
Table 4: GUPPY camera types

Guppy types and highlights
GUPPY Getting Started V4.0.1
17
Old CS-/C-Mounting New CS-/C-Mounting
starting with serial no. 06/05-84312215
Color models are equipped with an optical filter to
eliminate the influence of infrared light hitting
the sensor. Please be advised that, as a side
effect, this filter reduces sensitivity in the visible
spectrum.
Color models are equipped with an optical filter to
eliminate the influence of infrared light hitting
the sensor. Please be advised that, as a side
effect, this filter reduces sensitivity in the visible
spectrum.
B/w models are delivered with sensor protection
glass to ensure maximum sensitivity. In certain
applications and depending on the lighting source
and optics, the use of either IR blocking or pass-
ing filter may be required to improve the image
quality.
B/w models are delivered with sensor protection
glass to ensure maximum sensitivity. In certain
applications and depending on the lighting source
and optics, the use of either IR blocking or pass-
ing filter may be required to improve the image
quality.
CS-Mount models have the filter or protection
glass mounted directly in front of the sensor. Tak-
ing out the filter or protection glass is not possi-
ble at customer site.
Ask your dealer for a camera with the respective
filter already installed.
All models have the filter or protection glass
mounted directly in the CS-Mount adapter. (Stan-
dard delivery is a CS-Mount camera). Taking out
the filter or protection glass is not possible at cus-
tomer site.
Ask your dealer for a camera with the respective
filter already installed.
C-Mount models have the filter or protection glass
mounted in the CS- to C-Mount extension adapter.
Ask your dealer for an extension adapter with the
intended filter already mounted.
In order to get a C-Mount camera, screw the 5 mm
C-Mount adapter onto the CS-Mount camera.
Unscrew the 5 mm C-Mount adapter to get again a
CS-Mount camera.
Removing the C-Mount adapter opens the front
section of the camera. This greatly enhances the
risk for dust or particles to migrate on the sensor's
protection glass.
In order to remove the adapter:
Hold the camera so that the adapter points down-
wards while changing the adapter. Use optical
cleaning tissues for cleaning the sensor's protec-
tion glass if needed. Never use compressed air
for cleaning purposes.
Ask your dealer if you are not familiar with these
procedures.
Removing the CS-Mount adapter opens the front
section of the camera. This greatly enhances the
risk for dust or particles to migrate on the sensor's
protection glass.
In order to remove the adapter:
Hold the camera so that the adapter points down-
wards while changing the adapter. Use optical
cleaning tissues for cleaning the sensor's protec-
tion glass if needed. Never use compressed air
for cleaning purposes.
Ask your dealer if you are not familiar with these
procedures.
Table 5: Old and new CS-/C-Mounting of GUPPY cameras

Guppy types and highlights
GUPPY Getting Started V4.0.1
18
Warning
a
Mount/dismount lenses and filters in a dust-free environ-
ment, and do not use compressed air (which can push dust
into cameras and lenses).
Use only optical quality tissue/cloth if you must clean a
lens or filter.

GUPPY Getting Started V4.0.1
19

System components
GUPPY Getting Started V4.0.1
20
System components
Old CS-/C-Mounting
Each camera package consists of the following system components:
AVT Guppy C-Mount camera 4.5 m 1394 standard cable Color version:
Jenofilt 217 IR cut filter (built-in)
B/w version:
only protection glass (no filter)
CD with driver and documentation
Optional: tripod adapter Optional: 4.5 m latching cable Optional: HIROSE connector for
cable mount HR25 7TP-8S
Figure 1: System components (new CS-/C-Mounting)