Temperature State#

The Temperature State camera feature indicates whether the camera's internal temperature is normal or too high.

When the temperature is too high, immediate cooling is required.

Use the Device Temperature feature to determine the camera's current temperature.

Using the Feature#

How It Works#

Information about the internal temperature is provided by the following parameters:

• The DeviceTemperature parameter value shows the current temperature at various locations within the camera. For more information, see the Device Temperature topic.
• The TemperatureState parameter value tells you the camera's current internal temperature state:
  • Ok: The device temperature is within the normal operating temperature range.
  • Critical: The device temperature is close to or at the allowed maximum. Provide cooling.
  • Error: The device temperature is above the allowed maximum. Provide cooling immediately.

Depending on your camera model, the following additional parameters are available:

• The BslTemperatureStatusErrorCount parameter indicates how often the temperature state changed to Error.
• The BslTemperatureMax parameter indicates the maximum temperature the camera reached during operation.

When the TemperatureState parameter value is Critical or Error, the camera provides a set of mechanisms that alert the user and help to protect the camera.

The mechanisms take effect at different device temperatures, depending on the alert level and on whether the camera is heating up or cooling down.

Heating Path#

Critical Temperature Threshold#

When the device temperature reaches the critical temperature threshold, the camera is close to becoming too hot.

In this situation, the following happens:

• The TemperatureState parameter value changes to Critical.
• The camera sends a Critical Temperature event.

Over Temperature Threshold#

When the device temperature reaches the over temperature threshold, the camera is too hot. The camera must be cooled immediately. Otherwise, the camera may get irreversibly damaged.

In this situation, the following happens:

• The TemperatureState parameter value changes to Error.
• The camera's current draw reduces.
• Image acquisition changes:
  • 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.
  • On other cameras, test image 2 appears.
• The camera sends an Over Temperature event.
• If the Error Code feature is available on your camera model, the camera reports an over temperature error code.
• If available, the BslTemperatureStatusErrorCount parameter increases by 1.

Cooling Path#

Over Temperature Threshold#

When the device temperature falls below the over temperature threshold, the following happens:

• The TemperatureState parameter value changes from Error to Critical.

When the device temperature falls to 4 °C below the over temperature threshold, the following happens:

• On ace 2, boost, dart M/R, and racer 2 cameras, image acquisition can be started again.
• On other cameras, test image 2 disappears. Image acquisition resumes with the same settings and features as before the camera entered the Error state. The exception is the Sequencer feature which you have to re-enable manually.

Critical Temperature Threshold#

When the device temperature falls below the critical temperature threshold, the following happens:

• The TemperatureState parameter value changes to Ok.

The camera's temperature state and internal temperature are normal and therefore allow normal camera operation.

Determining the Temperature State#

1. Get the TemperatureState parameter value.
2. If the parameter value is Critical or Error, you must cool the camera until the parameter value is Ok.

To make full use of the Temperature State feature:

• Use the Device Temperature feature to determine the exact core board or sensor board temperature.
• Enable the Event Notification feature to receive events whenever the camera gets too hot.
• If the Error Code feature is available on your camera model, read the LastError parameter value to determine whether the camera was too hot.

Specifics#

Show all camera models

Sample Code#

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

Other Cameras#

// 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

You can also use the pylon Viewer to easily set the parameters.