Temperature State#

Temperature State 相機功能會顯示相機內部溫度是否正常，或是過高。

當溫度過高時，必須立即進行冷卻。

請使用 Device Temperature 功能來確認相機的當前溫度。

使用功能#

運作原理#

內部溫度相關資訊可透過以下參數得知：

• 當 DeviceTemperature 參數值顯示相機內各處的當前溫度。如需更多資訊，請參閱 Device Temperature 主題。
• 當 TemperatureState 此參數值會顯示相機當前的內部溫度狀態：
  • Ok: 裝置溫度處於正常運作溫度範圍內。
  • Critical: 裝置溫度已接近或達到允許的最高值。請進行散熱。
  • Error: 裝置溫度超過允許上限。請立即進行散熱。

視您的相機型號而定，可使用以下額外參數：

• 當 BslTemperatureStatusErrorCount 此參數表示溫度狀態轉為「錯誤」的頻率。
• 當 BslTemperatureMax 此參數表示相機在運作期間所達到的最高溫度。

當 TemperatureState 參數值為 Critical 或 Error, 這台相機提供了一系列機制，用以提醒使用者並協助保護相機。

這些機制會在不同的裝置溫度下生效，具體取決於警報等級，以及攝影機當時是正在升溫還是降溫。

加熱路徑#

臨界溫度閾值#

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

在此情況下，會發生以下情況：

• 當 TemperatureState 參數值變更為 Critical.
• 攝影機發送了一則「臨界溫度」事件。

超過溫度閾值#

當裝置溫度達到過熱閾值時，表示攝影機過熱。必須立即對攝影機進行冷卻。否則，攝影機可能會遭受無法修復的損壞。

在此情況下，會發生以下情況：

• 當 TemperatureState 參數值變更為 Error.
• 相機的電流消耗減少了。
• 影像擷取的變更：
  • 在 ace 2、boost、dart M/R 以及 racer 2 攝影機上，影像擷取會停止，且必須等到裝置冷卻後才能重新啟動。
  • 在其他相機上，則會顯示測試圖像 2。
• 攝影機發送了一則「超溫」事件。
• 若您的相機型號具備「錯誤代碼」功能，相機將顯示過熱錯誤代碼。
• 若適用， BslTemperatureStatusErrorCount 該參數增加 1。

冷卻路徑#

超過溫度閾值#

當裝置溫度降至超過溫度閾值以下時，將會發生以下情況：

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

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

• 在 ace 2、boost、dart M/R 以及 racer 2 攝影機上，可重新開始影像擷取。
• 在其他相機上， 測試圖片 2 消失。影像擷取將以相機進入該狀態前的相同設定與功能恢復運作。 Error 狀態。唯一的例外是 Sequencer 這是一項必須手動重新啟用的功能。

臨界溫度閾值#

當裝置溫度降至臨界溫度閾值以下時，將會發生以下情況：

• 當 TemperatureState 參數值變更為 Ok.

相機的溫度狀態與內部溫度均屬正常，因此可正常運作。

確定Temperature State#

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

要充分利用「Temperature State 」功能：

• 請使用 Device Temperature 功能來確定核心電路板或感測器電路板的確切溫度。
• 啟用 Event Notification 此功能，以便在相機過熱時接收事件通知。
• 若 buffer operator 的 錯誤代碼 若您的相機型號支援此功能，請閱讀 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 來輕鬆設定參數。