Line Status#

The Line Status camera feature allows you to determine the status (high or low) of one or all I/O lines.

Using the Feature#

Determining the Status of an I/O Line#

To determine the status of an I/O line:

1. Set the LineSelector parameter to the desired I/O line.
2. Get the value of the LineStatus parameter.
   This parameter is read-only.

A value of false (0) means that the line's status was low at the time of polling.

A value of true (1) means the line's status was high at the time of polling.

Determining the Status of All I/O Lines#

To determine the current status of all I/O lines, read the LineStatusAll parameter. The parameter is reported as a 64-bit value.

Certain bits in the value are associated with the I/O lines. Each bit indicates the status of its associated line:

• If a bit is 0, the status of the associated line is currently low.
• If a bit is 1, the status of the associated line is currently high.

Which bit is associated with which line depends on your camera model.

Line Status and I/O Status#

GPIO Line Configured as Input#

If your camera has a GPIO line and that line is configured as input, the relation between its input status and the LineStatus parameter is as follows:

This means that the line logic is positive.

GPIO Line Configured as Output#

If your camera has a GPIO line and that line is configured as output, the relation between its output status and the linestatus parameter depends on your camera model.

Opto-Coupled Input Line#

If your camera has an opto-coupled input line, the relation between its input status and the LineStatus parameter is as follows:

This means that the line logic is positive.

Opto-Coupled Output Line#

If your camera has an opto-coupled output line, the relation between its output status and the LineStatus parameter is as follows:

This means that the line logic is negative.

Specifics#

Show all camera models

Sample Code#

// Select a line
camera.LineSelector.SetValue(LineSelector_Line1);
// Get the status of the line
bool status = camera.LineStatus.GetValue();
// Get the line status of all I/O lines. Because the GenICam interface does not
// support 32-bit words, the line status is reported as a 64-bit value.
int64_t lineStatusAll = camera.LineStatusAll.GetValue();

INodeMap& nodemap = camera.GetNodeMap();
// Select a line
CEnumParameter(nodemap, "LineSelector").SetValue("Line1");
// Get the status of the line
bool status = CBooleanParameter(nodemap, "LineStatus").GetValue();
// Get the line status of all I/O lines. Because the GenICam interface does not
// support 32-bit words, the line status is reported as a 64-bit value.
int64_t lineStatusAll = CIntegerParameter(nodemap, "LineStatusAll").GetValue();

// Select a line
camera.Parameters[PLCamera.LineSelector].SetValue(PLCamera.LineSelector.Line1);
// Get the status of the line
bool status = camera.Parameters[PLCamera.LineStatus].GetValue();
// Get the line status of all I/O lines. Because the GenICam interface does not
// support 32-bit words, the line status is reported as a 64-bit value.
Int64 lineStatusAll = camera.Parameters[PLCamera.LineStatusAll].GetValue();

/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
_Bool status = false;
int64_t lineStatusAll = 0;
/* Select a line */
errRes = PylonDeviceFeatureFromString(hdev, "LineSelector", "Line1");
CHECK(errRes);
/* Get the status of the line */
errRes = PylonDeviceGetBooleanFeature(hdev, "LineStatus", &status);
CHECK(errRes);
/* Get the line status of all I/O lines. Because the GenICam interface does not */
/* support 32-bit words, the line status is reported as a 64-bit value. */
errRes = PylonDeviceGetIntegerFeature(hdev, "LineStatusAll", &lineStatusAll);
CHECK(errRes);

# Select a line
camera.LineSelector.Value = "Line1"
# Get the status of the line
status = camera.LineStatus.Value
# Get the line status of all I/O lines. Because the GenICam interface does not
# support 32-bit words, the line status is reported as a 64-bit value.
lineStatusAll = camera.LineStatusAll.Value

You can also use the pylon Viewer to easily set the parameters.