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 two 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.
    • OverTemperature: The device temperature is above the allowed maximum. Provide cooling immediately. The camera operates in over temperature mode.

Over Temperature Mode#

When the temperature state parameter value is Critical or OverTemperature, the camera operates in over temperature mode. This mode provides of 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 (heating path) or cooling down (cooling path).

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 model's topic.

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 from Ok to Critical.
  • The camera sends an CriticalTemperature event.

Info

Another CriticalTemperature 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 camera's current draw reduces.
  • Image acquisition stops and test image 2 appears instead.
  • The TemperatureState parameter value changes from Ok to OverTemperature.
  • The camera sends an OverTemperature event.
  • If the Error Code feature is available on your camera model, the camera reports an over temperature error code.

Info

  • Powering down the camera is meant to protect the camera by allowing it to cool. However, if the surrounding temperature is sufficiently high, the camera's internal temperature will stay high regardless or even increase further. Therefore, you should also do the following:
    • Take immediate action to improve heat dissipation in order to quickly leave the Over Temperature state.
    • Provide more efficient heat dissipation to ensure that the camera never returns to the Over Temperature state.
  • Another OverTemperature 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 OverTemperature to Critical.

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

  • Test image 2 disappears.
  • Image acquisition resumes with the same settings and features as before the camera entered the OverTemperature 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 OverTemperature, 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
a2A1920-51gcBAS Temperature State feature not supported Temperature State feature not supported
a2A1920-51gmBAS Temperature State feature not supported Temperature State feature not supported
a2A1920-160ucBAS Temperature State feature not supported Temperature State feature not supported
a2A1920-160umBAS Temperature State feature not supported Temperature State feature not supported
acA640-90gc Temperature State feature not supported Temperature State feature not supported
acA640-90gm Temperature State feature not supported Temperature State feature not supported
acA640-90uc Temperature State feature not supported Temperature State feature not supported
acA640-90um Temperature State feature not supported Temperature State feature not supported
acA640-120gc Temperature State feature not supported Temperature State feature not supported
acA640-120gm Temperature State feature not supported Temperature State feature not supported
acA640-120uc Temperature State feature not supported Temperature State feature not supported
acA640-120um Temperature State feature not supported Temperature State feature not supported
acA640-121gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA640-300gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA640-300gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA640-750uc Temperature State feature not supported Temperature State feature not supported
acA640-750um Temperature State feature not supported Temperature State feature not supported
acA720-290gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA720-290gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA720-520uc 75 °C (167 °F) 81 °C (177.8 °F)
acA720-520um 75 °C (167 °F) 81 °C (177.8 °F)
acA780-75gc Temperature State feature not supported Temperature State feature not supported
acA780-75gm Temperature State feature not supported Temperature State feature not supported
acA800-200gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA800-200gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA800-510uc 75 °C (167 °F) 81 °C (177.8 °F)
acA800-510um 75 °C (167 °F) 81 °C (177.8 °F)
acA1280-60gc Temperature State feature not supported Temperature State feature not supported
acA1280-60gm Temperature State feature not supported Temperature State feature not supported
acA1300-22gc Temperature State feature not supported Temperature State feature not supported
acA1300-22gm Temperature State feature not supported Temperature State feature not supported
acA1300-30gc Temperature State feature not supported Temperature State feature not supported
acA1300-30gm Temperature State feature not supported Temperature State feature not supported
acA1300-30uc Temperature State feature not supported Temperature State feature not supported
acA1300-30um Temperature State feature not supported Temperature State feature not supported
acA1300-60gc Temperature State feature not supported Temperature State feature not supported
acA1300-60gm Temperature State feature not supported Temperature State feature not supported
acA1300-60gmNIR Temperature State feature not supported Temperature State feature not supported
acA1300-75gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1300-75gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1300-200uc 75 °C (167 °F) 81 °C (177.8 °F)
acA1300-200um 75 °C (167 °F) 81 °C (177.8 °F)
acA1440-73gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1440-73gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1440-220uc 75 °C (167 °F) 81 °C (177.8 °F)
acA1440-220um 75 °C (167 °F) 81 °C (177.8 °F)
acA1600-20gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1600-20gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1600-20uc Temperature State feature not supported Temperature State feature not supported
acA1600-20um Temperature State feature not supported Temperature State feature not supported
acA1600-60gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1600-60gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1920-25gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1920-25gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1920-25uc Temperature State feature not supported Temperature State feature not supported
acA1920-25um Temperature State feature not supported Temperature State feature not supported
acA1920-40gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1920-40gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1920-40uc 75 °C (167 °F) 81 °C (177.8 °F)
acA1920-40ucMED 75 °C (167 °F) 81 °C (177.8 °F)
acA1920-40um 75 °C (167.0 °F) 81 °C (177.8 °F)
acA1920-40umMED 75 °C (167 °F) 81 °C (177.8 °F)
acA1920-48gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1920-48gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1920-50gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1920-50gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA1920-150uc 75 °C (167 °F) 81 °C (177.8 °F)
acA1920-150um 75 °C (167 °F) 81 °C (177.8 °F)
acA1920-155uc 75 °C (167 °F) 81 °C (177.8 °F)
acA1920-155ucMED 75 °C (167 °F) 81 °C (177.8 °F)
acA1920-155um 75 °C (167 °F) 81 °C (177.8 °F)
acA1920-155umMED 75 °C (167 °F) 81 °C (177.8 °F)
acA2000-50gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2000-50gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2000-50gmNIR 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2000-165uc Temperature State feature not supported Temperature State feature not supported
acA2000-165um Temperature State feature not supported Temperature State feature not supported
acA2000-165umNIR Temperature State feature not supported Temperature State feature not supported
acA2040-25gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2040-25gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2040-25gmNIR 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2040-35gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2040-35gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2040-55uc 75 °C (167 °F) 81 °C (177.8 °F)
acA2040-55um 75 °C (167 °F) 81 °C (177.8 °F)
acA2040-90uc Temperature State feature not supported Temperature State feature not supported
acA2040-90um Temperature State feature not supported Temperature State feature not supported
acA2040-90umNIR Temperature State feature not supported Temperature State feature not supported
acA2040-120uc 75 °C (167 °F) 81 °C (177.8 °F)
acA2040-120um 75 °C (167 °F) 81 °C (177.8 °F)
acA2440-20gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2440-20gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2440-35uc 75 °C (167 °F) 81 °C (177.8 °F)
acA2440-35ucMED 75 °C (167 °F) 81 °C (177.8 °F)
acA2440-35um 75 °C (167 °F) 81 °C (177.8 °F)
acA2440-35umMED 75 °C (167 °F) 81 °C (177.8 °F)
acA2440-75uc 75 °C (167 °F) 81 °C (177.8 °F)
acA2440-75ucMED 75 °C (167 °F) 81 °C (177.8 °F)
acA2440-75um 75 °C (167 °F) 81 °C (177.8 °F)
acA2440-75umMED 75 °C (167 °F) 81 °C (177.8 °F)
acA2500-14gc Temperature State feature not supported Temperature State feature not supported
acA2500-14gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2500-14uc Temperature State feature not supported Temperature State feature not supported
acA2500-14um Temperature State feature not supported Temperature State feature not supported
acA2500-20gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2500-20gcMED 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2500-20gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2500-20gmMED 72 °C (161.6 °F) 78 °C (172.4 °F)
acA2500-60uc 75 °C (167 °F) 81 °C (177.8 °F)
acA2500-60um 75 °C (167 °F) 81 °C (177.8 °F)
acA3088-16gc Temperature State feature not supported Temperature State feature not supported
acA3088-16gm Temperature State feature not supported Temperature State feature not supported
acA3088-57uc Temperature State feature not supported Temperature State feature not supported
acA3088-57um Temperature State feature not supported Temperature State feature not supported
acA3800-10gc Temperature State feature not supported Temperature State feature not supported
acA3800-10gm Temperature State feature not supported Temperature State feature not supported
acA3800-14uc Temperature State feature not supported Temperature State feature not supported
acA3800-14um Temperature State feature not supported Temperature State feature not supported
acA4024-8gc Temperature State feature not supported Temperature State feature not supported
acA4024-8gm Temperature State feature not supported Temperature State feature not supported
acA4024-29uc Temperature State feature not supported Temperature State feature not supported
acA4024-29um Temperature State feature not supported Temperature State feature not supported
acA4096-11gc Temperature State feature not supported Temperature State feature not supported
acA4096-11gm Temperature State feature not supported Temperature State feature not supported
acA4096-30uc 75 °C (167 °F) 81 °C (177.8 °F)
acA4096-30ucMED 75 °C (167 °F) 81 °C (177.8 °F)
acA4096-30um 75 °C (167 °F) 81 °C (177.8 °F)
acA4096-30umMED 75 °C (167 °F) 81 °C (177.8 °F)
acA4096-40uc 75 °C (167 °F) 81 °C (177.8 °F)
acA4096-40ucMED 75 °C (167 °F) 81 °C (177.8 °F)
acA4096-40um 75 °C (167 °F) 81 °C (177.8 °F)
acA4096-40umMED 75 °C (167 °F) 81 °C (177.8 °F)
acA4112-8gc Temperature State feature not supported Temperature State feature not supported
acA4112-8gm Temperature State feature not supported Temperature State feature not supported
acA4112-20uc 75 °C (167 °F) 81 °C (177.8 °F)
acA4112-20ucMED 75 °C (167 °F) 81 °C (177.8 °F)
acA4112-20um 75 °C (167 °F) 81 °C (177.8 °F)
acA4112-20umMED 75 °C (167 °F) 81 °C (177.8 °F)
acA4112-30uc 75 °C (167 °F) 81 °C (177.8 °F)
acA4112-30ucMED 75 °C (167 °F) 81 °C (177.8 °F)
acA4112-30um 75 °C (167 °F) 81 °C (177.8 °F)
acA4112-30umMED 75 °C (167 °F) 81 °C (177.8 °F)
acA4600-7gc Temperature State feature not supported Temperature State feature not supported
acA4600-10uc Temperature State feature not supported Temperature State feature not supported
acA5472-5gc 72 °C (161.6 °F) 78 °C (172.4 °F)
acA5472-5gm 72 °C (161.6 °F) 78 °C (172.4 °F)
acA5472-17uc 75 °C (167 °F) 81 °C (177.8 °F)
acA5472-17um 75 °C (167 °F) 81 °C (177.8 °F)
boA4096-93cc Temperature State feature not supported Temperature State feature not supported
boA4096-93cm Temperature State feature not supported Temperature State feature not supported
boA4112-68cc Temperature State feature not supported Temperature State feature not supported
boA4112-68cm Temperature State feature not supported Temperature State feature not supported
daA1280-54lc Temperature State feature not supported Temperature State feature not supported
daA1280-54lm Temperature State feature not supported Temperature State feature not supported
daA1280-54uc Temperature State feature not supported Temperature State feature not supported
daA1280-54um Temperature State feature not supported Temperature State feature not supported
daA1600-60lc Temperature State feature not supported Temperature State feature not supported
daA1600-60lm Temperature State feature not supported Temperature State feature not supported
daA1600-60uc Temperature State feature not supported Temperature State feature not supported
daA1600-60um Temperature State feature not supported Temperature State feature not supported
daA1920-15um Temperature State feature not supported Temperature State feature not supported
daA1920-30uc Temperature State feature not supported Temperature State feature not supported
daA1920-30um Temperature State feature not supported Temperature State feature not supported
daA2500-14lc Temperature State feature not supported Temperature State feature not supported
daA2500-14lm Temperature State feature not supported Temperature State feature not supported
daA2500-14uc Temperature State feature not supported Temperature State feature not supported
daA2500-14um Temperature State feature not supported Temperature State feature not supported
daA2500-60mc Temperature State feature not supported Temperature State feature not supported
puA1280-54uc Temperature State feature not supported Temperature State feature not supported
puA1280-54um Temperature State feature not supported Temperature State feature not supported
puA1600-60uc Temperature State feature not supported Temperature State feature not supported
puA1600-60um Temperature State feature not supported Temperature State feature not supported
puA1920-30uc Temperature State feature not supported Temperature State feature not supported
puA1920-30um Temperature State feature not supported Temperature State feature not supported
puA2500-14uc Temperature State feature not supported Temperature State feature not supported
puA2500-14um Temperature State feature not supported Temperature State feature not supported

Sample Code#

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