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，相機提供了一系列機制來警告使用者並協助保護相機。

這些機制會在不同的裝置溫度下生效，具體取決於警告級別以及相機是在加熱還是冷卻。

加熱路徑#

臨界溫度閾值#

當裝置溫度達到臨界溫度閾值時，相機即將過熱。

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

• 當 TemperatureState 參數值變更為 Critical.
• 相機發送 Critical Temperature 事件。

過溫閾值#

當裝置溫度達到過溫閾值時，相機即為過熱。必須立即冷卻相機。否則，相機可能會受到不可逆轉的損壞。

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

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

冷卻路徑#

過溫閾值#

當裝置溫度降至 over temperature threshold 以下時，會發生以下情況：

• 當 TemperatureState 參數值從更改為 Error 設為 Critical.

當裝置溫度降至低於過溫閾值 4 °C 時，會發生以下情況：

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

臨界溫度閾值#

當裝置溫度降至 critical temperature threshold 以下時，會發生以下情況：

• 當 TemperatureState 參數值變更為 Ok.

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

判斷 Temperature State#

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

若要充分利用 Temperature State 功能：

• 使用 Device Temperature 功能來判定確切的核心機板或感光元件機板溫度。
• 啟用 Event Notification 功能以便在相機過熱時接收事件。
• 若 buffer operator 的 Error Code 功能適用於您的相機型號，請讀取 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

您也可以 use the pylon Viewer 來輕鬆設定參數。