AW00123409000 Physical Interface
Basler ace USB 3.0 99
5.12.4 Setting and Checking the Status of All User
Settable Output Lines
You can set and check the current status of all output lines with a single operation by using the
UserOutputValueAll parameter value. The UserOutputValueAll parameter value is expressed as a
hexadecimal number in the Basler pylon Viewer and as a 32-bit word in the Basler pylon API (with
0 as a constant value on bit 0).
As shown in Figure 50, each bit from bit 1 through 3 is associated with a different user settable
output line. The status of each output line is expressed by its related binary parameter value: If a bit
is 0, it indicates that the line status of the associated line is currently low. If a bit is 1, it indicates that
the line status of the associated line is currently high.
When you read the hexadecimal number of the UserOutputValueAll parameter value, convert it to
its binary equivalent to make the current status of each output line immediately apparent.
Fig. 50: Bit Field of the UserOutputValueAll Parameter: Bit Numbers and Assignment of Output Lines
See Section 5.13.1 on page 103 for details about the relation between line status and its
determining factors, e.g. electrical signal level, line inverter setting, and user output setting.
1. Set the value of the UserOutputValueAll parameter to set all user output values. For example:
If you wanted to set each one of bits 1 through 3 to 1 you would set the UserOutputValueAll
parameter value to xE or to 14 (the hexadecimal and decimal equivalents of 1110).
2. Read the value of the UserOutputValueAll parameter to determine the current settings of all
user output values.
You can set and read the UserOutputValueAll parameter value from within your application software
by using the Basler pylon API. The following code snippet illustrates using the API to read the
parameter value. In this example, the UserOutputValueAll parameter value is set to 0:
To set and check the status of all user outputs with a single operation:
Parameter value of UserOutputValue for Line 2
Parameter value of UserOutputValue for Line 3 (configured for output)
Parameter value of UserOutputValue for Line 4 (configured for output)
Reserved
Bit 1
Bit 2
Bit 3
Bit 0