Temperature State#

相机的 Temperature State 功能指示相机的内部温度是正常还是过高。

当温度过高时，需要立即冷却。

使用 Device Temperature 功能可确定相机的当前温度。

该功能的使用#

运作原理#

有关内部温度的信息通过以下参数提供：

• 即： DeviceTemperature parameter value shows the current temperature at various locations within the camera. For more information, see the Device Temperature topic.
• 即： TemperatureState 参数值告诉您相机的当前内部温度状态：
  • Ok: The device temperature is within the normal operating temperature range.
  • Critical: The device temperature is close to or at the allowed maximum. Provide cooling.
  • Error: The device temperature is above the allowed maximum. Provide cooling immediately.

根据您的相机型号,可以使用以下附加参数：

• 即： BslTemperatureStatusErrorCount parameter indicates how often the temperature state changed to Error.
• 即： BslTemperatureMax parameter indicates the maximum temperature the camera reached during operation.

When the TemperatureState parameter value is Critical 或 Error, the camera provides a set of mechanisms that alert the user and help to protect the camera.

这些机制会在不同的 device temperature 下生效，具体取决于警报级别以及相机是在升温还是在冷却。

加热路径#

临界温度阈值#

当设备温度达到临界温度阈值时，相机即将过热。

在这种情况下，将发生以下情况：

• 即： TemperatureState parameter value changes to Critical.
• 相机发送一个临界温度事件。

超温阈值#

当设备温度达到过温阈值时，则表明相机过热。必须立即对相机进行冷却，否则，相机可能会发生不可挽回的损坏。

在这种情况下，将发生以下情况：

• 即： TemperatureState parameter value changes to Error.
• 相机的电流消耗会降低。
• 图像采集更改：
  • On ace 2, boost, dart M/R, and racer 2 cameras, image acquisition stops and can't be started until the device has cooled down.
  • 在其他相机上，出现测试图像 2。
• 相机发送一个超温事件。
• 如果您的相机型号具有错误代码功能，则相机会报告超温错误代码。
• If available, the BslTemperatureStatusErrorCount parameter increases by 1.

冷却路径#

超温阈值#

当设备温度降至超温阈值以下时，将发生以下情况：

• 即： TemperatureState parameter value changes from Error to Critical.

当设备温度下降到低于超温阈值 4°C 时，将发生以下情况：

• On ace 2, boost, dart M/R, and racer 2 cameras, image acquisition can be started again.
• On other cameras, test image 2 disappears. Image acquisition resumes with the same settings and features as before the camera entered the Error state. The exception is the Sequencer feature which you have to re-enable manually.

临界温度阈值#

当设备温度降至临界温度阈值以下时，将发生以下情况：

• 即： TemperatureState parameter value changes to Ok.

相机的温度状态和内部温度正常，因此相机可以正常工作。

确定温度状态#

1. Get the TemperatureState parameter value.
2. 如果参数值为 Critical 或 Error, you must cool the camera until the parameter value is Ok.

充分利用 Temperature State 功能：

• 使用 Device Temperature 功能确定确切的核心板或传感器板温度。
• 启用 Event Notification 功能在相机温度过高时接收事件。
• If the Error Code feature is available on your camera model, read the LastError parameter value to determine whether the camera was too hot.

详情#

显示所有相机型号

示例代码#

ace 2, boost, dart M/R, and racer 2 Cameras#

// Get the current temperature state
BslTemperatureStatusEnums e = camera.BslTemperatureStatus.GetValue();
// Get the maximum temperature the camera reached during operation
double temperatureMax = camera.BslTemperatureMax.GetValue();
// Determine how often the temperature state changed to Error
int64_t i = camera.BslTemperatureStatusErrorCount.GetValue();

INodeMap& nodemap = camera.GetNodeMap();
// Get the current temperature state
String_t e = CEnumParameter(nodemap, "BslTemperatureStatus").GetValue();
// Get the maximum temperature the camera reached during operation
double temperatureMax = CFloatParameter(nodemap, "BslTemperatureMax").GetValue();
// Determine how often the temperature state changed to Error
int64_t i = CIntegerParameter(nodemap, "BslTemperatureStatusErrorCount").GetValue();

// Get the current temperature state
string e = camera.Parameters[PLCamera.BslTemperatureStatus].GetValue();
// Get the maximum temperature the camera reached during operation
double temperatureMax = camera.Parameters[PLCamera.BslTemperatureMax].GetValue();
// Determine how often the temperature state changed to Error
Int64 i = camera.Parameters[PLCamera.BslTemperatureStatusErrorCount].GetValue();

size_t len = 0;
char e_str[64] = {0};
double temperatureMax = 0;
int64_t i = 0;
/* Get the current temperature state */
len = sizeof(e_str);
errRes = PylonDeviceFeatureToString(hdev, "BslTemperatureStatus", e_str, &len);
CHECK(errRes);
/* Get the maximum temperature the camera reached during operation */
errRes = PylonDeviceGetFloatFeature(hdev, "BslTemperatureMax", &temperatureMax);
CHECK(errRes);
/* Determine how often the temperature state changed to Error */
errRes = PylonDeviceGetIntegerFeature(hdev, "BslTemperatureStatusErrorCount", &i);
CHECK(errRes);

# Get the current temperature state
e = camera.BslTemperatureStatus.Value
# Get the maximum temperature the camera reached during operation
temperatureMax = camera.BslTemperatureMax.Value
# Determine how often the temperature state changed to Error
i = camera.BslTemperatureStatusErrorCount.Value

其他相机#

// Get the current temperature state
TemperatureStateEnums e = camera.TemperatureState.GetValue();

INodeMap& nodemap = camera.GetNodeMap();
// Get the current temperature state
String_t e = CEnumParameter(nodemap, "TemperatureState").GetValue();

// Get the current temperature state
string e = camera.Parameters[PLCamera.TemperatureState].GetValue();

size_t len = 0;
char e_str[64] = {0};
/* Get the current temperature state */
len = sizeof(e_str);
errRes = PylonDeviceFeatureToString(hdev, "TemperatureState", e_str, &len);
CHECK(errRes);

# Get the current temperature state
e = camera.TemperatureState.Value

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