Temperature Monitoring Constraints

See Temperature Monitoring API

AR758x, AR759x platform restrictions:

The temperature monitoring feature using Legato APIs is partially applicable for AR758X and AR759X platforms. Only the below functions are available:

le_temp_Request()

le_temp_GetSensorName()

le_temp_GetTemperature()

The other APIs managing the thresholds concept are not operational. Please contact Sierra Wireless support for a fully monitoring of the temperature another way.

For other platforms the temperature monitoring feature is available.

Two main sensors are supported. The dedicated string to request a sensor with le_temp_Request() function are "POWER_CONTROLLER" and "POWER_AMPLIFIER".

"POWER_AMPLIFIER" sensor

Two Thresholds can be set to notify the "POWER_AMPLIFIER" sensor state:

  • "HI_CRITICAL_THRESHOLD"
  • "HI_NORMAL_THRESHOLD"

These are the strings to use with the le_temp_SetThreshold() and le_temp_GetThreshold() functions.

Then, the "POWER_AMPLIFIER" sensor state will be notified with the following events (always a string format):

  • "HI_CRITICAL_EVENT"
  • "HI_WARNING_EVENT"
  • "NORMAL_EVENT"

if the "POWER_AMPLIFIER" sensor temperature reaches the:

  • "HI_CRITICAL_THRESHOLD" threshold, a "HI_CRITICAL_EVENT" event occurs.
  • "HI_NORMAL_THRESHOLD" threshold but still lower than "HI_CRITICAL_THRESHOLD" threshold, a "HI_WARNING_EVENT" event occurs.
      ^
      |           --> "HI_CRITICAL_EVENT"
      |
 "HI_CRITICAL_THRESHOLD"
      |
      ^           --> "HI_WARNING_EVENT"
      |
 "HI_NORMAL_THRESHOLD"
      |
      ^
      |

if the "POWER_AMPLIFIER" sensor temperature decreases below the:

  • "HI_CRITICAL_THRESHOLD" - 3°C threshold but still higher than "HI_NORMAL_THRESHOLD" threshold, a "HI_WARNING_EVENT" event occurs.
  • "HI_NORMAL_THRESHOLD" - 3°C threshold, a "NORMAL_EVENT" event occurs.
      |
      v
      |
 "HI_CRITICAL_THRESHOLD" - 3°C
      |
      v           --> "HI_WARNING_EVENT"
      |
 "HI_NORMAL_THRESHOLD" - 3°C
      |
      |           --> "NORMAL_EVENT"
      v
Warning
  • A minimum gap of 2°C must be set between the thresholds.

"POWER_CONTROLLER" sensor

Four Thresholds can be set to notify the "POWER_CONTROLLER" sensor state:

  • "HI_CRITICAL_THRESHOLD"
  • "HI_NORMAL_THRESHOLD"
  • "LO_NORMAL_THRESHOLD"
  • "LO_CRITICAL_THRESHOLD"

These are the strings to use with the le_temp_SetThreshold() and le_temp_GetThreshold() functions.

Then, the "POWER_CONTROLLER" sensor state will be notified with the following events (always a string format):

  • "HI_CRITICAL_EVENT"
  • "HI_WARNING_EVENT"
  • "NORMAL_EVENT"
  • "LO_WARNING_EVENT"
  • "LO_CRITICAL_EVENT"

if the "POWER_CONTROLLER" sensor temperature reaches the:

  • "LO_CRITICAL_THRESHOLD" threshold, a "LO_WARNING_EVENT" event occurs.
  • "LO_NORMAL_THRESHOLD" + 3°C threshold but still lower than "HI_NORMAL_THRESHOLD" threshold, a "NORMAL_EVENT" event occurs.
  • "HI_NORMAL_THRESHOLD" threshold but still lower than "HI_CRITICAL_THRESHOLD" threshold, a "HI_WARNING_EVENT" event occurs
  • "HI_CRITICAL_THRESHOLD" threshold, a "HI_CRITICAL_EVENT" event occurs.
      ^
      |           --> "HI_CRITICAL_EVENT"
      |
 "HI_CRITICAL_THRESHOLD"
      |
      ^           --> "HI_WARNING_EVENT"
      |
 "HI_NORMAL_THRESHOLD"
      |
      ^           --> "NORMAL_EVENT"
      |
 "LO_NORMAL_THRESHOLD" + 3°C
      |
      ^           --> "LO_WARNING_EVENT"
      |
 "LO_CRITICAL_THRESHOLD"
      |
      ^
      |

if the "POWER_CONTROLLER" sensor temperature decreases below the:

  • "HI_CRITICAL_THRESHOLD" threshold, a "HI_WARNING_EVENT" event occurs.
  • "HI_NORMAL_THRESHOLD" - 3°C threshold but still higher than "LO_NORMAL_THRESHOLD" threshold, a "NORMAL_EVENT" event occurs.
  • "LO_NORMAL_THRESHOLD" threshold but still higher than "LO_CRITICAL_THRESHOLD" threshold, a "LO_WARNING_EVENT" event occurs.
  • "LO_CRITICAL_THRESHOLD" threshold, a "LO_CRITICAL_EVENT" event occurs.
      |
      v
      |
 "HI_CRITICAL_THRESHOLD"
      |
      v           --> "HI_WARNING_EVENT"
      |
 "HI_NORMAL_THRESHOLD" - 3°C
      |
      v           --> "NORMAL_EVENT"
      |
 "LO_NORMAL_THRESHOLD"
      |
      v           --> "LO_WARNING_EVENT"
      |
 "LO_CRITICAL_THRESHOLD"
      |
      |           --> "LO_CRITICAL_EVENT"
      v
Warning
  • A minimum gap of 4°C must be set between "LO_NORMAL_THRESHOLD" and "HI_NORMAL_THRESHOLD".
  • A minimum gap of 2°C must be set between other thresholds.
Note
Please refer to the Product Technical specification document of your platform for further details.