Detailed Description

Temperature driver implementation for the Low Power F3 family.

============================================================================

The temperature driver on Low Power F3 devices is a part of the battery monitoring system in AON (always on). It periodically takes measurements of the temperature of the chip and will issue interrupts if the configured upper limit or lower limit is crossed.

Standby Power Mode Behavior

The temperature measurement is active while in standby power mode as well. The interrupt used by the temperature module is capable of bringing the device out of standby and into active mode to handle it. That means that an application will not miss a change in temperature just because the device has transitioned to standby power mode. While in standby, the temperature will only be sampled during a VDDR recharge pulse. This means that the sampling frequency in standby will be determined by the temperature as leakage increases with temperature and requires more frequent recharging of VDDR.

#include <stdint.h>
#include <stdbool.h>
#include <ti/drivers/Temperature.h>

Include dependency graph for TemperatureLPF3.h:

Go to the source code of this file.

Data Structures
struct	TemperatureLPF3_Config
	Temperature driver configuration struct for Low Power F3 devices. More...

Functions
void	TemperatureLPF3_enableTSDMonitoring (int16_t shutdownThreshold)
	Enable thermal shutdown monitoring. More...

void	TemperatureLPF3_disableTSDMonitoring (void)
	Disable thermal shutdown monitoring. More...

void	TemperatureLPF3_triggerThermalShutdown (void)
	Trigger thermal shutdown. More...

Function Documentation

§ TemperatureLPF3_enableTSDMonitoring()

void TemperatureLPF3_enableTSDMonitoring ( int16_t shutdownThreshold )

Enable thermal shutdown monitoring.

Set threshold for thermal shutdown, in degrees Celsius, and enable thermal shutdown monitoring. Once the temperature of the device reaches or goes above shutdownThreshold, the driver will invoke an internal callback-function that will invoke TemperatureLPF3_triggerThermalShutdown. If a custom shutdown procedure is required, one would need to install their own callback using Temperature_registerNotifyHigh, and optionally call TemperatureLPF3_triggerThermalShutdown as the last thing in the custom callback.

Parameters

shutdownThreshold Thermal shutdown threshold in degrees Celsius

§ TemperatureLPF3_disableTSDMonitoring()

void TemperatureLPF3_disableTSDMonitoring ( void )

Disable thermal shutdown monitoring.

Disable thermal shutdown monitoring. To re-enable, TemperatureLPF3_enableTSDMonitoring must be called again with the desired temperature threshold.

§ TemperatureLPF3_triggerThermalShutdown()

void TemperatureLPF3_triggerThermalShutdown ( void )

Trigger thermal shutdown.

Immediately trigger thermal shutdown, and enable the thermal shutdown comparator. The device will remain in reset for as long as the comparator is high (i.e for as long as the temperature is above 95 degrees C. See technical reference manual for more details. This function is called if TSD monitoring is enabled through TemperatureLPF3_enableTSDMonitoring and the given threshold temperature is reached. The threshold should always be set to greater than 95, or the device will immediately come back out of reset. Typically, the threshold would be set near the maximum operating temperature of 125 degrees C.

Note: Calling this function will immediately bring the device into reset