Line Status#

相机的 Line Status 功能使您可以确定一个或所有 I/O 线路的状态（高电平或低电平）。

该功能的使用#

确定 I/O 线路的状态#

要确定 I/O 线路的状态：

1. 设置 LineSelector parameter to the desired I/O line.
2. Get the value of the LineStatus parameter.
   此为只读参数。

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.

确定所有 I/O 线路的状态#

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

该值中的部分位与 I/O 线路相关联。每一位均指示其关联线路的状态：

• 如果某位为 0，则关联线路的状态当前为低电平。
• 如果某位为 1，则关联线路的状态当前为高电平。

哪个位与哪条线路相关联取决于您的相机型号。

Line Status and I/O Status#

GPIO 线路配置为输入#

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:

这意味着线路逻辑为正。

GPIO 线路配置为输出#

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.

光电耦合输入线路#

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

这意味着线路逻辑为正。

光电耦合输出线路#

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

这意味着线路逻辑为负。

详情#

显示所有相机型号

示例代码#

// 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

您也可以使用 pylon Viewer 轻松设置参数。