|
||||||||||||||||||||||||||||||
Camera Link Camera Configuration |
||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||
The sections below provide information on the following topics: |
||||||||||||||||||||||||||||||
Introduction |
||||||||||||||||||||||||||||||
Camera configuration within Camera Link is based on a simple asynchronous serial reading and writing of configuration data. Within the Camera Link standard specification, a serial communication interface is defined. This standardized serial interface is available on the frame grabber. It enables the interaction of a vendor specific camera configuration tool and the frame grabber specific implementation of the serial communication functionality. In simple words: Any Camera Link compliant camera configuration software runs in combination with any Basler Camera Link frame grabber. Furthermore, even any COM-based camera configuration software can be used with Basler framegrabbers, since the framegrabber runtime also offers the standard serial interface of the PC (COM) for communication with the camera by setting up virtual COM ports automatically. Basler also provides a terminal application "clShell" that allows to send and receive simple commands to and from a connected camera. |
||||||||||||||||||||||||||||||
Thus, the interface consists of the following components:
|
||||||||||||||||||||||||||||||
![]() |
||||||||||||||||||||||||||||||
2 clsersis.dll: An implementation of the Camera Link Serial Interface API |
||||||||||||||||||||||||||||||
The clsersis is the Basler implementation of the Camera Link serial interface API. It is fully compliant to the Camera Link standard. It is available in all Basler Runtime installation packages and will be installed at the directory structure as defined by Camera Link. Basically this implementation is an DLL, that communicates with the framegrabber and passes camera commands through the framegrabber to the connected camera device in both directions. It covers all Basler framegrabber types, which are designed to use Camera Link. Camera vendors configuration tools, which support the clser interface, can be linked directly to this comonent, either by using the clallserial component or by direct function calls to the clsersis. Remarks:
|
||||||||||||||||||||||||||||||
2.1 clser APIThe API is defined as described in the Camera Link standard specification and has functionalities for establishing a connection to a camera as well as writing and reading data. The API functions can be seen in the table below.
Table 1: clser API overview Please note: A detailled description of all functions can be found at the clsersis function reference. |
||||||||||||||||||||||||||||||
2.2 Adressing Cameras by Using the clsersisCamera ports are identified by an numerical value, called serial index starting with a 0 for the first port of the framegrabber. By using the clGetSerialPortIdentifier() function, the names can be retrieved for each port. 2.3 Adressing Cameras in Multi-Grabber SystemsWhen having multiple frame grabbers in one system, the serial indices are incremented according to the ordering of the boards. See also the correspondig section in the SDK manual. Example: System configuration: Board 1: 2 Camera link ports index 0..1 Within this example: the number of resulting indices is 5. The indices are created as shown above. The indices can be seen at the port identifiers, see the clGetSerialPortIdentifier() function for further details.
3 Using Virtual COM PortsMany software developers prefer to use a traditional COM interface to communicate with the camera. For this purpose, the Basler runtime offers a module that functions as an adapter between the software and the standard Camera Link serial interface (Clser) of the frame grabber. This module provides virtual COM ports and is called ClSerCOM Wrapper. For a quick information on how the virtual COM ports are set up automatically at system start, check the Quick Start Guide document. For detailed information on the ClSerCOM Wrapper and how to use it, refer to the User Guide Using Virtual COM Ports.
Notes:
Usage of clshell: clshell [-p port][-f file][-i][-a] Example: clshell -p 0 : Camera communicates with frame grabber board 0 over Port A |
||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||
|