Camera Link PCI Express (PCIe) Gen1 Framegrabbers
Example and Utility Applications
EDT, Inc.
2012 March 16
10
EDT installation package provides a DLL named
clseredt.dll
which, per the Camera Link 2.0
specification, is installed at:
•
%PROGRAMFILES%\Cameralink\Serial
(64-bit version); or
•
%PROGRAMFILES(X86)%\CameraLink\Serial
(32-bit version)
Camera GUIs typically provide some method for specifying the DLL pathname; for details, see your camera
documentation.
If it becomes necessary to rename the file or copy it to a different location, be sure to recopy any newer
versions of the file to the appropriate location when you reinstall the EDT installation package.
From Your Application
To see all of the routines needed for user applications to send and receive serial commands: In the EDT
API (see
), follow the link to the EDT Digital Imaging Library, and then —
under Modules at the bottom of the page — to Communications / Control.
Example and Utility Applications
EDT provides a variety of example, utility, and diagnostic applications. All can be run from the command
line, using Unix-style options and arguments.
To help those developing Camera Link PCIe applications, C source code is provided for all the examples.
The source code file is the name of the application with a
.c
extension (e.g., “
take.c
”).
For those just beginning, we recommend starting with the source for
simple_take
or
simplest_take,
as those applications are the easiest to understand.
The most commonly useful options for these programs are described below. Placeholders shown in italics
should be replaced with your own values.
For a complete list of usage options, at the command line, enter the application name with the
--help
option to display the help message.
pciload
Used to query the boards or, optionally, to update and verify the board’s flash PROM. After installation, you
may want to run
pciload
with no arguments and review the output to help verify that the board and driver
did install correctly. To use
pciload
to update and verify the flash PROM, see
.
initcam
Command-line utility that initializes the board and device driver for a specific camera. It initializes board
registers; sets various parameters (width, height, depth, etc.) to specific values; and optionally sends serial
initialization commands to the camera from the referenced configuration file. The EDT configuration files are
in your installation directory under
camera_config
. The EDT camera selector GUI applications (e.g.
pdvshow, camconfig
) are simply wrappers to provide a way to select the correct file, then shell out to call
initcam
. To initialize from your own application code, you can use
initcam.c
as example code. For a
detailed description of configuration files and directives, consult the Camera Configuration Guide (see
).
Several of the most useful options are...
-f
pathname
The (required) name of the configuration file to use for initialization.
-u
unit
The unit number, if multiple boards are installed; default is 0 (first board).
