EDT, Inc.
2019 April 29
11
VisionLink F-series
Units, Connectors, and Channels
Units, Connectors, and Channels
This section covers how to work with multiple units, connectors, and channels, defined and used as shown in
Table 4. Definition, usage, and enumeration
Definition
Usage and Enumeration
unit
physical board
If you install one board in your host system, the system will assign the default unit number (0) to
that board. If you install multiple boards, the system will assign a unique unit number to each
board, starting with 0 (the sequence is system-dependent). Typically, the unit number is an
argument when invoking an application (such as
take
or
vlviewer
) or a parameter passed
into one of the EDT subroutines.
connector
physical Camera
Link connector
Each VisionLink board has one or two SDR connectors and one simulation channel.
•
In base mode, each camera requires one SDR connector on the EDT board, and each con-
nector provides one channel. Therefore, in base mode, an EDT frame grabber with two con-
nectors has two channels.
•
In medium or full mode, each camera requires two SDR connectors on the EDT board. In this
case, the two connectors work together to support one channel.
The software enumerates each SDR connector starting from the PCIe bus. So the first (primary)
connector is “0” and the next (secondary) connector is “1.” The simulator channel is
“2.”
See
Simulation and Testing on page 20
channel
channel or,
sometimes,
simulation channel
illustrates enumeration. Units (boards), connectors, and channels are always enumerated from 0.
also
shows the status indicator LEDs (see
), which are enumerated in the same way.
Figure 2. Illustration of enumeration
If you are using multiple EDT boards (units), or multiple connectors on a single EDT board, the software assigns a
unique handle to represent each unit and connector. Unless you specify a different unit number, connector number, or
both, all EDT example and utility applications will default to unit 0, connector 0.
The way that you address the appropriate unit and channel will depend on what you are doing.
•
In the EDT GUI (
vlviewer
or
pdvshow
), use
-pdv
U
_
C
(see
Image Capture and Display GUI on page 9
•
In the EDT example and utility applications, use
-u
unit
and
-c
channel
•
In the EDT API, use
pdv_open_channel(
..., unit, channel
)
. For each device, the open routine will return
a pointer to the structure that represents the opened device (unit and channel); this pointer appears in EDT exam-
ples and documentation as
pdv_p
. Each unit / channel combination can be opened and manipulated independent-
ly by passing the appropriate pointer to the library subroutines. For details, consult the EDT API (see
LEDs
LED enumeration is 0, 1, 2, 3 (left to right
in the
board’s
typical vertical orientation).
0 1 2 3
Units & Connectors
Unit enumeration is system-dependent,
starting with unit 0.
Unit 0,
Connector 1
(secondary
connector)
Unit 1,
Connector 1
(secondary
connector)
Connector enumeration starts at 0 with
the connector nearest the PCIe bus.
Unit 0,
Unit 1,
Connector 0
Connector 0
(primary
(primary
connector)
connector)