User`s manual

Smart Features
BASLER A102f 5-3
DRAFT
5.5 Enabling and Parameterizing Smart Features
The camera provides a control and status register (CSR) for each smart feature (see Sect 5.7 for
details of each feature and its CSR). To enable and parameterize a smart feature, the following
steps must be performed:
1. Check to see if the camera supports smart features.
2. Ask the camera for the address of the CSR for the desired smart feature.
3. Enable and parameterize the desired smart features.
The next two sections describe steps 1 and 2. The layout of the registers used to enable and
parameterize the smart features is described in section 5.7.
5.5.1 Checking to see if the Camera Supports Smart Features
Smart features are vendor unique. Such features are referred to in the 1394 Trade Association
DCAM standard as advanced features. The DCAM standard specifies how vendors should
implement advanced features. According to the standard, advanced features must be unlocked
(that is, enabled) by writing an advanced features set identifier (Feature ID) and a time-out value
to the Advanced Features Access Control Register. From the point of view of the DCAM standard,
smart features are a set of advanced DCAM features. The Feature ID associated with Basler
smart features is 0x0030 533B 73C3.
For Basler cameras, unlocking advanced features is not strictly necessary because any
implemented smart features are always available. However, the unlock mechanism is also used
to check to see if a camera supports vendor unique features such as smart features. If a device
doesn’t recognize a Feature ID written to the Access Control Register, a value of
0xFFFF FFFF FFFF FFFF will be read back from the ACR. This value indicates that the device
does not implement the feature set associated with that Feature ID.
Assuming that the address of the Advanced Features Access Control Register is
0xFFFF F2F0 0000, perform the following steps to see if a camera is smart features capable:
1. Write the quadlet data 0x0030 533B to 0xFFFF F2F0 0000
2. Write quadlet data 0x73C3 F000* to 0xFFFF F2F0 0004
3. Read quadlet data from 0xFFFF F2F0 0000 and 0xFFFF F2F0 0004. If at least one of the
read operations returns a value that is not equal to 0xFFFF FFFF, the camera supports
smart features. If both read operations return 0xFFFF FFFF, the camera does not support
smart features.
Note that instead of performing two single quadlet write operations, a block write can be
performed.
* The last three zeros in this quadlet data represent a timeout value. (Refer to the section of the
IIDC specification that describes “CSRs for Advanced Features.”)