Temperature State#

Temperature Stateカメラ機能は、カメラの内部温度が正常か高すぎるかを示します。

温度が高すぎる場合は、すぐに冷却する必要があります。

Device Temperature機能を使用して、カメラの現在の温度を確認します。

機能を使用する#

仕組み#

内部温度に関する情報は、次のパラメーターによって提供されます。

• DeviceTemperatureパラメーター値は、カメラの様々な場所の現在の温度を示します。詳細については、「Device Temperature」トピックを参照してください。
• イメージ TemperatureState パラメーター値は、カメラの現在の内部温度状態を示します。
  • Ok：デバイスの温度が通常の動作温度範囲内です。
  • Critical：デバイスの温度が許容最大値に近いか、許容最大値に達しています。冷却してください。
  • Error：デバイスの温度が許容最大値を超えています。すぐに冷却してください。

カメラのモデルに応じて、次の追加パラメーターを使用できます。

• BslTemperatureStatusErrorCountパラメーターは、温度状態がErrorに変化した頻度を示します。
• BslTemperatureMaxパラメーターは、動作中にカメラが到達した最大温度を示します。

TemperatureStateパラメーター値がCriticalまたはErrorの場合、カメラは、ユーザーに警告してカメラを保護するための一連のメカニズムを提供します。

これらのメカニズムは、アラートレベルやカメラが加熱中か冷却中かによって、異なるデバイス温度で有効になります。

加熱経路#

Critical Temperature Threshold#

デバイスの温度が臨界温度しきい値に達すると、カメラは高温になりすぎています。

この場合、次のようになります。

• TemperatureStateパラメーターの値がCriticalに変わります。
• カメラがCritical Temperatureイベントを送信します。

Over Temperature Threshold#

デバイスの温度が過熱しきい値に達すると、カメラは高温になりすぎています。カメラはすぐに冷却する必要があります。そうしないと、カメラが損傷し、修復できなくなる可能性があります。

この場合、次のようになります。

• 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が表示されます。
• カメラはOver Temperatureイベントを送信します。
• お使いのカメラモデルでError Code機能が使用可能な場合、カメラは過熱エラーコードを報告します。
• 使用可能な場合、BslTemperatureStatusErrorCountパラメーターは1ずつ増加します。

冷却経路#

Over Temperature Threshold#

デバイスの温度が過熱しきい値を下回ると、次のようになります。

• 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機能は手動で再度有効にする必要があります。

Critical Temperature Threshold#

デバイスの温度が臨界温度しきい値を下回ると、次のようになります。

• TemperatureStateパラメーターの値がOkに変わります。

カメラの温度状態と内部温度は正常なため、カメラは正常に動作します。

Temperature Stateの決定#

1. TemperatureStateパラメーター値を取得します。
2. パラメーター値がCriticalまたはErrorの場合、パラメーター値がOkになるまでカメラを冷却する必要があります。

Temperature State機能を最大限に活用するには：

• Device Temperature機能を使用して、コアボードまたはセンサー基板の正確な温度を確認します。
• Event Notification機能を有効にして、カメラが高温になるたびにイベントを受信できるようにします。
• お使いのカメラでError Code機能が使用可能な場合は、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を使用して、パラメーターを簡単に設定することもできます。