Temperature State#

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

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

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

该功能的使用#

运作原理#

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

• DeviceTemperature 参数值显示了相机内各个位置的当前温度。有关更多信息，请参阅 Device Temperature 主题。
• 即： TemperatureState 参数值告诉您相机的当前内部温度状态：
  • OK：设备温度在正常工作温度范围内。
  • Critical：设备温度接近或达到允许的最高温度。提供冷却。
  • Error：设备温度高于允许的最高温度。立即提供冷却。

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

• BslTemperatureStatusErrorCount 参数指示 temperature state 更改为 Error 的频率。
• BslTemperatureMax 参数指示相机在操作过程中达到的最高温度。

当 TemperatureState 参数值为 Critical 或 Error 时，相机会提供一套机制来提醒用户并帮助保护相机。

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

加热路径#

临界温度阈值#

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

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

• TemperatureState 参数值更改为 Critical。
• 相机发送一个临界温度事件。

超温阈值#

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

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

• TemperatureState 参数值变为 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。
• 相机发送一个超温事件。
• 如果您的相机型号具有错误代码功能，则相机会报告超温错误代码。
• 如果可用，则 BslTemperatureStatusErrorCount 参数将增加 1。

冷却路径#

超温阈值#

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

• TemperatureState 参数值从 Error 变为 Critical。

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

• On ace 2, boost, dart M/R, and racer 2 cameras, image acquisition can be started again.
• 在其他相机上，测试图像 2 消失。使用与相机进入 Error 状态之前相同的设置和功能，恢复图像采集。Sequencer 功能属于例外，您必须手动重新启用。

临界温度阈值#

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

• TemperatureState 参数值变为 Ok。

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

确定温度状态#

1. 获取 TemperatureState 参数值。
2. 如果参数值为 Critical 或 Error，则必须冷却相机，直到参数值为 Ok为止。

充分利用 Temperature State 功能：

• 使用 Device Temperature 功能确定确切的核心板或传感器板温度。
• 启用 Event Notification 功能在相机温度过高时接收事件。
• 如果您的相机型号提供有错误代码功能，则读取 LastError 参数值以确定相机是否过热。

详情#

显示所有相机型号

示例代码#

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 轻松设置参数。