| Line 1: |
Line 1: |
| − | <pre class="header-style> | + | <pre class="header-style">The Battery Temperature trigger fires when the battery temperature increases or decreases to a specified level, or on any temperature change. This is useful for monitoring device thermals and taking protective actions when the device gets too hot or cold.</pre> |
| − | This trigger will fire when the battery temperature changes. It can be configured to trigger on any change or when the temperature increases or decreases to a specific value.
| |
| − | </pre> | |
| − | </br>
| |
| − | '''Example Usage'''<br/><br/>
| |
| − | Log every change in battery temperature (to the user log) to maintain a history of battery temperature over time.
| |
| − | <pre class="trigger-style">
| |
| − | Triggers
| |
| | | | |
| − | Battery temperature changed (Any)
| + | ''' Options ''' |
| − | </pre>
| |
| − | <pre class="action-style">
| |
| − | Actions
| |
| | | | |
| − | Log Event: {battery_temp} | + | * '''Increase/Decrease''' - Trigger fires when temperature reaches a specific threshold |
| − | </pre> | + | ** '''Increases to''' - Fires when battery temperature rises to or above the specified value |
| | + | ** '''Decreases to''' - Fires when battery temperature falls to or below the specified value |
| | + | * '''Any Change''' - Trigger fires whenever the battery temperature changes |
| | + | |
| | + | ''' Configuration ''' |
| | + | |
| | + | When selecting "Increase/Decrease" mode, you can specify the threshold: |
| | + | |
| | + | * Use the slider to set a temperature value in degrees Celsius (default is 30 degrees C) |
| | + | * Alternatively, select a variable to dynamically determine the threshold temperature |
| | + | * Choose whether to trigger on increases or decreases |
| | + | |
| | + | ''' Variable Support ''' |
| | + | |
| | + | You can use an integer variable to specify the temperature threshold instead of a fixed value. This allows for dynamic thresholds that can be changed at runtime. |
| | + | |
| | + | ''' Examples ''' |
| | + | |
| | + | ''Example 1: Overheat Protection'' |
| | + | <pre class="trigger-style">Triggers |
| | + | |
| | + | Battery Temperature >= 45 degrees C</pre> |
| | + | <pre class="action-style">Actions |
| | + | |
| | + | Notification: Warning - Battery temperature high! |
| | + | Disable Wi-Fi |
| | + | Set Screen Brightness: 10%</pre> |
| | + | |
| | + | ''Example 2: Log Temperature Changes'' |
| | + | <pre class="trigger-style">Triggers |
| | + | |
| | + | Battery Temperature (Any Change)</pre> |
| | + | <pre class="action-style">Actions |
| | + | |
| | + | Write to File: Battery temp: [battery_temp] at [date_time]</pre> |
| | + | |
| | + | ''' Notes ''' |
| | + | |
| | + | * The trigger listens for the system broadcast ACTION_BATTERY_CHANGED to monitor temperature |
| | + | * Temperature is measured in degrees Celsius |
| | + | * The trigger only fires once when the temperature transitions to the new state (for increase/decrease mode), not on every subsequent change where the condition remains true |
| | + | * The "Any Change" option is useful for logging or monitoring temperature patterns over time |
| | + | * Not all devices report precise temperature readings - some may report in larger increments |
| | + | |
| | + | ''' See Also ''' |
| | + | |
| | + | * [[Constraint:_Battery_Temperature|Battery Temperature Constraint]] |
| | + | * [[Trigger:_Battery_Level|Battery Level Trigger]] |