Temperature State#

Temperature State camera feature 用於指出相機內部的溫度是正常還是過高。

當溫度過高時，需要立即進行冷卻。

使用 Device Temperature 功能來判斷相機的目前溫度。

使用此功能#

運作原理#

有關內部溫度的資訊由以下參數提供：

• 影像 DeviceTemperature 參數值顯示相機內各個位置的目前溫度。如需詳細資訊，請參閱 Device Temperature 主題。
• 影像 TemperatureState 參數值會告訴您相機目前的內部 Temperature State：
  • Ok：裝置溫度在正常操作溫度範圍內。
  • Critical：裝置溫度接近或達到允許的最大值。請提供冷卻。
  • Error：裝置溫度高於允許的最大值。請立即提供冷卻。

根據您的 相機型號，可使用以下其他參數：

• 影像 BslTemperatureStatusErrorCount 參數表示 Temperature State 變更為 Error 的頻率。
• 影像 BslTemperatureMax 參數表示相機在運作期間達到的最高溫度。

當 TemperatureState 參數值為 Critical 或 Error，相機提供了一組機制來警告使用者並協助保護相機。

這些機制會在不同的裝置溫度下生效，具體取決於警報等級以及相機是處於 heating up 還是 cooling down 狀態。

Heating Path#

Critical Temperature Threshold#

當裝置溫度達到 critical temperature threshold 時，相機即將過熱。

在這種情況下，將會發生以下情況：

• 影像 TemperatureState 參數值變更為 Critical.
• 相機會傳送 Critical Temperature 事件。

Over Temperature Threshold#

當 Device Temperature 達到 over temperature threshold 時，表示相機過熱。必須立即冷卻相機，否則相機可能會受到不可逆的損壞。

在這種情況下，將會發生以下情況：

• 影像 TemperatureState 參數值變更為 Error.
• 相機的耗電流會降低。
• 影像擷取變更：
  • 在 ace 2、boost、dart M/R 與 racer 2 相機上，影像擷取會停止，且在裝置冷卻下來之前無法啟動。
  • 在其他相機上，會出現 test image 2。
• 相機會傳送 Over Temperature 事件。
• 如果您的相機型號支援 Error Code 功能，相機會回報過溫錯誤代碼。
• 如果適用上， BslTemperatureStatusErrorCount 參數增加 1。

Cooling Path#

Over Temperature Threshold#

當 Device Temperature 低於 over temperature threshold 時，會發生以下情況：

• 影像 TemperatureState 參數值變更自 Error 設定為 Critical.

當 Device Temperature 下降至比過溫閾值低 4 °C 時，會發生以下情況：

• 在 ace 2、boost、dart M/R 與 racer 2 相機上，可以再次啟動影像擷取。
• 在其他相機上， test image 2 會消失。影像擷取將以相機進入該 Error 狀態之前的相同設定與功能恢復。例外狀況是 Sequencer 功能，您必須手動重新啟用。

Critical Temperature Threshold#

當 Device Temperature 低於 critical temperature threshold 時，會發生以下情況：

• 影像 TemperatureState 參數值變更為 Ok.

相機的 Temperature State 與內部溫度正常，因此允許正常的相機運作。

Determining the Temperature State#

1. 取得 TemperatureState 參數值。
2. 如果參數值為 Critical 或 Error，您必須冷卻相機，直到參數值降至 Ok.

若要充分利用 Temperature State 功能：

• 使用 Device Temperature 功能來確定確切的核心板或感光元件板溫度。
• 啟用 Event Notification 功能，以便在相機過熱時接收事件。
• 如果已啟用 錯誤代碼 功能適用於您的相機型號，請讀取 LastError 參數值以確定相機是否過熱。

詳細資料#

顯示所有相機型號

範例程式碼#

ace 2、boost、dart M/R 與 racer 2 相機#

// 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 來輕鬆設定參數。