Configuration
CoaXPress MC258x Camera Manual
6 Configuration
6.1 Camera configuration
The MC258x is based on the CoaXPress
®
specification. CoaXPress
®
itself uses elements of
the GenICam standard to configure and control the camera. GenICam assumes that the cam
era uses a flat register layout for configuration. For example if you want to change the expos
ure time of the camera, you have to write the according value to the camera register repres
enting the exposure time (e.g. 0x1100).
All camera registers are described and summarized in an 'electronically readable manual' file.
A register element in this manual is also called a feature. The file itself is coded in ASCII using
the Extensible Markup Language (XML) to describe each register as a XML feature knot.
Each knot consists, at least, of the type of the feature (command, string, integer,...), its access
mode(R/W), a descriptive name ('friendly name') of the feature, the corresponding register ad
dress and a short description of the feature in plain ASCII text. There are also a number of ad
ditional elements that make out a complete feature description. For example the min. and
max. values for a feature or its default value. Please refer to the GenICam documentation for
further details.
The features itself in the XML file are grouped according to their meaning (e.g. Bottstrap re
gisters, Image format,...).
The XML file itself can be saved (compressed or uncompressed) in the camera or can be an
external file on the local computer or an remote host. The path (URL) to the file can be read
from the camera feature 'XmlUrlAddress' (see feature list below).
The features exposed by the camera and described in the XML file can be roughly subdivided
in four groups:
In a set of 9 mandatory features for a basic camera control as described in the
CoaXPress
®
specification.
In a set of mandatory boot registers, used by the host software to connect itself to the camera,
to do some connection related settings and to get the path to the XML file and read out the
camera feature list. This features are also a part of the CoaXPress specification. The boot re
gisters are the only camera registers that have the same address for a specific register on
every CXP compliant camera, no matter who manufactured it.
Not mandatory camera features, which names and meanings are defined in the GenICam
'Standard Features Naming Convention' (SFNC).
Custom features, which names and meaning are special to a manufacturer/camera.
A camera must implement all mandatory features and all boot registers as described in the
CoaXPress
®
specification to be CoaXPress
®
compliant. Some of them are defined in the
GenICam and in the CoaXPress
®
standard, some of them are CoaXPress
®
specific.
13