Skip to content

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, the camera operates in over temperature mode and immediate cooling is required.

Using the Feature#

How It Works#

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

  • The DeviceTemperature parameter value shows the current core board or sensor board temperature. 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. The camera operates in over temperature mode.
    • Error: The device temperature is above the allowed maximum. Provide cooling immediately. The camera operates in over temperature mode.

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.

Over Temperature Mode#

When the TemperatureState parameter value is Critical or Error, the camera operates in over temperature mode. This mode 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.

Info

Normal camera operation requires that the temperature state stays at Ok and the housing temperature stays within the allowed range. To ensure this, follow the guidelines set out in the Environmental Requirements section of your camera topic. You can find your camera topic in the "Models" section.

At elevated temperatures, the camera may be damaged, the camera's lifetime is shortened, and image quality can degrade. The lifetime is also shortened by frequent high-temperature incidents.

Heating Path and Cooling Path

Heating Path in Over Temperature Mode#

Critical Temperature Level

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.

Info

Another Critical Temperature event can only be sent after the device temperature has fallen to at least 4 °C below the critical temperature threshold.

Over Temperature Level

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

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 and boost cameras, image acquisition stops and can't be started until the device has cooled down (see below).
    • 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.

Info

Another Over Temperature event can only be sent after the device temperature has fallen to at least 4 °C below the over temperature threshold.

Cooling Path in Over Temperature Mode#

Over Temperature Level

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 and boost 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.

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, the camera operates in over temperature mode, and 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 is in over temperature mode.

Specifics#

Show all camera models

Camera Model Critical Temperature Threshold Over Temperature Threshold Additional Parameters
a2A1920-51gcBAS 76 °C (168.8 °F) 81 °C (177.8 °F) BslTemperatureMax
BslTemperatureStatusErrorCount
a2A1920-51gcPRO 76 °C (168.8 °F) 81 °C (177.8 °F) BslTemperatureMax
BslTemperatureStatusErrorCount
a2A1920-51gmBAS 76 °C (168.8 °F) 81 °C (177.8 °F) BslTemperatureMax
BslTemperatureStatusErrorCount
a2A1920-51gmPRO 76 °C (168.8 °F) 81 °C (177.8 °F) BslTemperatureMax
BslTemperatureStatusErrorCount
a2A1920-160ucBAS 76 °C (168.8 °F) 81 °C (177.8 °F) BslTemperatureMax
BslTemperatureStatusErrorCount
a2A1920-160ucPRO 76 °C (168.8 °F) 81 °C (177.8 °F) BslTemperatureMax
BslTemperatureStatusErrorCount
a2A1920-160umBAS 76 °C (168.8 °F) 81 °C (177.8 °F) BslTemperatureMax
BslTemperatureStatusErrorCount
a2A1920-160umPRO 76 °C (168.8 °F) 81 °C (177.8 °F) BslTemperatureMax
BslTemperatureStatusErrorCount
a2A3840-13gcBAS 76 °C (168.8 °F) 81 °C (177.8 °F) BslTemperatureMax
BslTemperatureStatusErrorCount
a2A3840-13gmBAS 76 °C (168.8 °F) 81 °C (177.8 °F) BslTemperatureMax
BslTemperatureStatusErrorCount
a2A3840-45ucBAS 76 °C (168.8 °F) 81 °C (177.8 °F) BslTemperatureMax
BslTemperatureStatusErrorCount
a2A3840-45umBAS 76 °C (168.8 °F) 81 °C (177.8 °F) BslTemperatureMax
BslTemperatureStatusErrorCount
acA640-90gc Temperature State feature not supported Temperature State feature not supported None
acA640-90gm Temperature State feature not supported Temperature State feature not supported None
acA640-90uc Temperature State feature not supported Temperature State feature not supported None
acA640-90um Temperature State feature not supported Temperature State feature not supported None
acA640-120gc Temperature State feature not supported Temperature State feature not supported None
acA640-120gm Temperature State feature not supported Temperature State feature not supported None
acA640-120uc Temperature State feature not supported Temperature State feature not supported None
acA640-120um Temperature State feature not supported Temperature State feature not supported None
acA640-121gm 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA640-300gc 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA640-300gm 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA640-750uc 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA640-750um 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA720-290gc 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA720-290gm 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA720-520uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA720-520um 75 °C (167 °F) 81 °C (177.8 °F) None
acA780-75gc Temperature State feature not supported Temperature State feature not supported None
acA780-75gm Temperature State feature not supported Temperature State feature not supported None
acA800-200gc 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA800-200gm 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA800-510uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA800-510um 75 °C (167 °F) 81 °C (177.8 °F) None
acA1280-60gc Temperature State feature not supported Temperature State feature not supported None
acA1280-60gm Temperature State feature not supported Temperature State feature not supported None
acA1300-22gc Temperature State feature not supported Temperature State feature not supported None
acA1300-22gm Temperature State feature not supported Temperature State feature not supported None
acA1300-30gc Temperature State feature not supported Temperature State feature not supported None
acA1300-30gm Temperature State feature not supported Temperature State feature not supported None
acA1300-30uc Temperature State feature not supported Temperature State feature not supported None
acA1300-30um Temperature State feature not supported Temperature State feature not supported None
acA1300-60gc Temperature State feature not supported Temperature State feature not supported None
acA1300-60gm Temperature State feature not supported Temperature State feature not supported None
acA1300-60gmNIR Temperature State feature not supported Temperature State feature not supported None
acA1300-75gc 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA1300-75gm 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA1300-200uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA1300-200um 75 °C (167 °F) 81 °C (177.8 °F) None
acA1440-73gc 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA1440-73gm 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA1440-220uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA1440-220um 75 °C (167 °F) 81 °C (177.8 °F) None
acA1600-20gc 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA1600-20gm Temperature State feature not supported Temperature State feature not supported None
acA1600-20uc Temperature State feature not supported Temperature State feature not supported None
acA1600-20um Temperature State feature not supported Temperature State feature not supported None
acA1600-60gc Temperature State feature not supported Temperature State feature not supported None
acA1600-60gm Temperature State feature not supported Temperature State feature not supported None
acA1920-25gc Temperature State feature not supported Temperature State feature not supported None
acA1920-25gm Temperature State feature not supported Temperature State feature not supported None
acA1920-25uc Temperature State feature not supported Temperature State feature not supported None
acA1920-25um Temperature State feature not supported Temperature State feature not supported None
acA1920-40gc 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA1920-40gm 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA1920-40uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA1920-40ucMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA1920-40um 75 °C (167.0 °F) 81 °C (177.8 °F) None
acA1920-40umMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA1920-48gc 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA1920-48gm 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA1920-50gc 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA1920-50gm 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA1920-150uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA1920-150um 75 °C (167 °F) 81 °C (177.8 °F) None
acA1920-155uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA1920-155ucMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA1920-155um 75 °C (167 °F) 81 °C (177.8 °F) None
acA1920-155umMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA2000-50gc Temperature State feature not supported Temperature State feature not supported None
acA2000-50gm Temperature State feature not supported Temperature State feature not supported None
acA2000-50gmNIR Temperature State feature not supported Temperature State feature not supported None
acA2000-165uc Temperature State feature not supported Temperature State feature not supported None
acA2000-165um Temperature State feature not supported Temperature State feature not supported None
acA2000-165umNIR Temperature State feature not supported Temperature State feature not supported None
acA2040-25gc Temperature State feature not supported Temperature State feature not supported None
acA2040-25gm Temperature State feature not supported Temperature State feature not supported None
acA2040-25gmNIR Temperature State feature not supported Temperature State feature not supported None
acA2040-35gc 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA2040-35gm 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA2040-55uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA2040-55um 75 °C (167 °F) 81 °C (177.8 °F) None
acA2040-90uc Temperature State feature not supported Temperature State feature not supported None
acA2040-90um Temperature State feature not supported Temperature State feature not supported None
acA2040-90umNIR Temperature State feature not supported Temperature State feature not supported None
acA2040-120uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA2040-120um 75 °C (167 °F) 81 °C (177.8 °F) None
acA2440-20gc 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA2440-20gm 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA2440-35uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA2440-35ucMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA2440-35um 75 °C (167 °F) 81 °C (177.8 °F) None
acA2440-35umMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA2440-75uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA2440-75ucMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA2440-75um 75 °C (167 °F) 81 °C (177.8 °F) None
acA2440-75umMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA2500-14gc Temperature State feature not supported Temperature State feature not supported None
acA2500-14gm Temperature State feature not supported Temperature State feature not supported
acA2500-14uc Temperature State feature not supported Temperature State feature not supported None
acA2500-14um Temperature State feature not supported Temperature State feature not supported None
acA2500-20gc 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA2500-20gcMED 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA2500-20gm 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA2500-20gmMED 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA2500-60uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA2500-60um 75 °C (167 °F) 81 °C (177.8 °F) None
acA3088-16gc Temperature State feature not supported Temperature State feature not supported None
acA3088-16gm Temperature State feature not supported Temperature State feature not supported None
acA3088-57uc Temperature State feature not supported Temperature State feature not supported None
acA3088-57um Temperature State feature not supported Temperature State feature not supported None
acA3800-10gc Temperature State feature not supported Temperature State feature not supported None
acA3800-10gm Temperature State feature not supported Temperature State feature not supported None
acA3800-14uc Temperature State feature not supported Temperature State feature not supported None
acA3800-14um Temperature State feature not supported Temperature State feature not supported None
acA4024-8gc Temperature State feature not supported Temperature State feature not supported None
acA4024-8gm Temperature State feature not supported Temperature State feature not supported None
acA4024-29uc Temperature State feature not supported Temperature State feature not supported None
acA4024-29um Temperature State feature not supported Temperature State feature not supported None
acA4096-11gc Temperature State feature not supported Temperature State feature not supported None
acA4096-11gm Temperature State feature not supported Temperature State feature not supported None
acA4096-30uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA4096-30ucMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA4096-30um 75 °C (167 °F) 81 °C (177.8 °F) None
acA4096-30umMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA4096-40uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA4096-40ucMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA4096-40um 75 °C (167 °F) 81 °C (177.8 °F) None
acA4096-40umMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA4112-8gc Temperature State feature not supported Temperature State feature not supported None
acA4112-8gm Temperature State feature not supported Temperature State feature not supported None
acA4112-20uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA4112-20ucMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA4112-20um 75 °C (167 °F) 81 °C (177.8 °F) None
acA4112-20umMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA4112-30uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA4112-30ucMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA4112-30um 75 °C (167 °F) 81 °C (177.8 °F) None
acA4112-30umMED 75 °C (167 °F) 81 °C (177.8 °F) None
acA4600-7gc Temperature State feature not supported Temperature State feature not supported None
acA4600-10uc Temperature State feature not supported Temperature State feature not supported None
acA5472-5gc 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA5472-5gm 72 °C (161.6 °F) 78 °C (172.4 °F) None
acA5472-17uc 75 °C (167 °F) 81 °C (177.8 °F) None
acA5472-17um 75 °C (167 °F) 81 °C (177.8 °F) None
boA4096-93cc Temperature State feature not supported Temperature State feature not supported BslTemperatureMax
BslTemperatureStatusErrorCount
boA4096-93cm Temperature State feature not supported Temperature State feature not supported BslTemperatureMax
BslTemperatureStatusErrorCount
boA4112-68cc Temperature State feature not supported Temperature State feature not supported BslTemperatureMax
BslTemperatureStatusErrorCount
boA4112-68cm Temperature State feature not supported Temperature State feature not supported BslTemperatureMax
BslTemperatureStatusErrorCount
daA1280-54lc Temperature State feature not supported Temperature State feature not supported None
daA1280-54lm Temperature State feature not supported Temperature State feature not supported None
daA1280-54uc Temperature State feature not supported Temperature State feature not supported None
daA1280-54um Temperature State feature not supported Temperature State feature not supported None
daA1600-60lc Temperature State feature not supported Temperature State feature not supported None
daA1600-60lm Temperature State feature not supported Temperature State feature not supported None
daA1600-60uc Temperature State feature not supported Temperature State feature not supported None
daA1600-60um Temperature State feature not supported Temperature State feature not supported None
daA1920-15um Temperature State feature not supported Temperature State feature not supported None
daA1920-30uc Temperature State feature not supported Temperature State feature not supported None
daA1920-30um Temperature State feature not supported Temperature State feature not supported None
daA2500-14lc Temperature State feature not supported Temperature State feature not supported None
daA2500-14lm Temperature State feature not supported Temperature State feature not supported None
daA2500-14uc Temperature State feature not supported Temperature State feature not supported None
daA2500-14um Temperature State feature not supported Temperature State feature not supported None
daA2500-60mc Temperature State feature not supported Temperature State feature not supported None
daA2500-60mci Temperature State feature not supported Temperature State feature not supported None
daA4200-30mci Temperature State feature not supported Temperature State feature not supported None
puA1280-54uc Temperature State feature not supported Temperature State feature not supported None
puA1280-54um Temperature State feature not supported Temperature State feature not supported None
puA1600-60uc Temperature State feature not supported Temperature State feature not supported None
puA1600-60um Temperature State feature not supported Temperature State feature not supported None
puA1920-30uc Temperature State feature not supported Temperature State feature not supported None
puA1920-30um Temperature State feature not supported Temperature State feature not supported None
puA2500-14uc Temperature State feature not supported Temperature State feature not supported None
puA2500-14um Temperature State feature not supported Temperature State feature not supported None

Sample Code#

ace 2 and boost Cameras#

// Get the current temperature state
TemperatureStateEnums e = camera.TemperatureState.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 = CEnumerationPtr(nodemap.GetNode("TemperatureState"))->ToString();
// Get the maximum temperature the camera reached during operation
double temperatureMax = CFloatPtr(nodemap.GetNode("BslTemperatureMax"))->GetValue();
// Determine how often the temperature state changed to Error
int64_t i = CIntegerPtr(nodemap.GetNode("BslTemperatureStatusErrorCount"))->GetValue();
INodeMap& nodemap = camera.GetNodeMap();
// Get the current temperature state
String_t e = CEnumParameter(nodemap, "TemperatureState").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.TemperatureState].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();
// Get the current temperature state
string e = Pylon.DeviceFeatureToString(hdev, "TemperatureState");
// Get the maximum temperature the camera reached during operation
double temperatureMax = Pylon.DeviceGetFloatFeature(hdev, "BslTemperatureMax");
// Determine how often the temperature state changed to Error
Int64 i = Pylon.DeviceGetIntegerFeature(hdev, "BslTemperatureStatusErrorCount");
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, "TemperatureState", 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);

Other Cameras#

// Get the current temperature state
TemperatureStateEnums e = camera.TemperatureState.GetValue();
INodeMap& nodemap = camera.GetNodeMap();
// Get the current temperature state
String_t e = CEnumerationPtr(nodemap.GetNode("TemperatureState"))->ToString();
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();
// Get the current temperature state
string e = Pylon.DeviceFeatureToString(hdev, "TemperatureState");
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);

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