From 7bf22ca4a082158cdb29c36d8e5b387d303c5e2a Mon Sep 17 00:00:00 2001
From: PX4BuildBot <bot@px4.io>
Date: Mon, 13 Jul 2026 09:06:44 +0000
Subject: [PATCH] docs: auto-sync metadata [skip ci]

  Co-Authored-By: PX4 BuildBot <bot@px4.io>
---
 .../en/advanced_config/parameter_reference.md | 48 +++++++++++++++++++
 docs/en/msg_docs/HeaterStatus.md              | 38 ++++++++-------
 2 files changed, 68 insertions(+), 18 deletions(-)

diff --git a/docs/en/advanced_config/parameter_reference.md b/docs/en/advanced_config/parameter_reference.md
index 6e259443db2..52ad87769b3 100644
--- a/docs/en/advanced_config/parameter_reference.md
+++ b/docs/en/advanced_config/parameter_reference.md
@@ -39086,6 +39086,22 @@ which must be higher than the maximum ambient temperature.
 | ------- | -------- | -------- | --------- | ------- | ------- | --------- |
 | &check; | 0        | 85.0     |           | 55.0    | celcius | &nbsp;    |
 
+### HEATER1_TEMP_ACT (`FLOAT`) {#HEATER1_TEMP_ACT}
+
+If temperature drops below Activation_Threshold, it starts heating.
+
+The heater starts heating once the temperature drops below this activation threshold, and keeps
+heating until reset.
+
+The default (200): Since ambient temperature never reaches that high, on heater-start the temperature
+is always below the activation threshold and thus turn on the heater immediately.
+Lower this for heaters that should only run when actually needed (e.g. a pitot-tube heater to save power)
+e.g. 5 to only start heating once the temperature drops below 5°C.
+
+| Reboot  | minValue | maxValue | increment | default | unit    | Read-Only |
+| ------- | -------- | -------- | --------- | ------- | ------- | --------- |
+| &check; | -100.0   | 200.0    |           | 200.0   | celcius | &nbsp;    |
+
 ### HEATER1_TEMP_FF (`FLOAT`) {#HEATER1_TEMP_FF}
 
 Heater 1 controller feedforward value.
@@ -39176,6 +39192,22 @@ which must be higher than the maximum ambient temperature.
 | ------- | -------- | -------- | --------- | ------- | ------- | --------- |
 | &check; | 0        | 85.0     |           | 55.0    | celcius | &nbsp;    |
 
+### HEATER2_TEMP_ACT (`FLOAT`) {#HEATER2_TEMP_ACT}
+
+If temperature drops below Activation_Threshold, it starts heating.
+
+The heater starts heating once the temperature drops below this activation threshold, and keeps
+heating until reset.
+
+The default (200): Since ambient temperature never reaches that high, on heater-start the temperature
+is always below the activation threshold and thus turn on the heater immediately.
+Lower this for heaters that should only run when actually needed (e.g. a pitot-tube heater to save power)
+e.g. 5 to only start heating once the temperature drops below 5°C.
+
+| Reboot  | minValue | maxValue | increment | default | unit    | Read-Only |
+| ------- | -------- | -------- | --------- | ------- | ------- | --------- |
+| &check; | -100.0   | 200.0    |           | 200.0   | celcius | &nbsp;    |
+
 ### HEATER2_TEMP_FF (`FLOAT`) {#HEATER2_TEMP_FF}
 
 Heater 2 controller feedforward value.
@@ -39266,6 +39298,22 @@ which must be higher than the maximum ambient temperature.
 | ------- | -------- | -------- | --------- | ------- | ------- | --------- |
 | &check; | 0        | 85.0     |           | 55.0    | celcius | &nbsp;    |
 
+### HEATER3_TEMP_ACT (`FLOAT`) {#HEATER3_TEMP_ACT}
+
+If temperature drops below Activation_Threshold, it starts heating.
+
+The heater starts heating once the temperature drops below this activation threshold, and keeps
+heating until reset.
+
+The default (200): Since ambient temperature never reaches that high, on heater-start the temperature
+is always below the activation threshold and thus turn on the heater immediately.
+Lower this for heaters that should only run when actually needed (e.g. a pitot-tube heater to save power)
+e.g. 5 to only start heating once the temperature drops below 5°C.
+
+| Reboot  | minValue | maxValue | increment | default | unit    | Read-Only |
+| ------- | -------- | -------- | --------- | ------- | ------- | --------- |
+| &check; | -100.0   | 200.0    |           | 200.0   | celcius | &nbsp;    |
+
 ### HEATER3_TEMP_FF (`FLOAT`) {#HEATER3_TEMP_FF}
 
 Heater 3 controller feedforward value.
diff --git a/docs/en/msg_docs/HeaterStatus.md b/docs/en/msg_docs/HeaterStatus.md
index 7989726181b..98a3bc39308 100644
--- a/docs/en/msg_docs/HeaterStatus.md
+++ b/docs/en/msg_docs/HeaterStatus.md
@@ -8,24 +8,25 @@ pageClass: is-wide-page
 
 ## Fields
 
-| Name                                                            | Type      | Unit [Frame] | Range/Enum | Description                            |
-| --------------------------------------------------------------- | --------- | ------------ | ---------- | -------------------------------------- |
-| <a id="fld_timestamp"></a>timestamp                             | `uint64`  |              |            | time since system start (microseconds) |
-| <a id="fld_device_id"></a>device_id                             | `uint32`  |              |            |
-| <a id="fld_heater_on"></a>heater_on                             | `bool`    |              |            |
-| <a id="fld_temperature_target_met"></a>temperature_target_met   | `bool`    |              |            |
-| <a id="fld_temperature_sensor"></a>temperature_sensor           | `float32` |              |            |
-| <a id="fld_temperature_target"></a>temperature_target           | `float32` |              |            |
-| <a id="fld_controller_period_usec"></a>controller_period_usec   | `uint32`  |              |            |
-| <a id="fld_controller_time_on_usec"></a>controller_time_on_usec | `uint32`  |              |            |
-| <a id="fld_proportional_value"></a>proportional_value           | `float32` |              |            |
-| <a id="fld_integrator_value"></a>integrator_value               | `float32` |              |            |
-| <a id="fld_feed_forward_value"></a>feed_forward_value           | `float32` |              |            |
-| <a id="fld_supply_voltage"></a>supply_voltage                   | `float32` |              |            | Supply voltage (V)                     |
-| <a id="fld_heater_current"></a>heater_current                   | `float32` |              |            | Heater current (A)                     |
-| <a id="fld_nominal_multiplier"></a>nominal_multiplier           | `float32` |              |            |
-| <a id="fld_mode"></a>mode                                       | `uint8`   |              |            |
-| <a id="fld_temperature_source"></a>temperature_source           | `uint8`   |              |            |
+| Name                                                                                      | Type      | Unit [Frame] | Range/Enum | Description                            |
+| ----------------------------------------------------------------------------------------- | --------- | ------------ | ---------- | -------------------------------------- |
+| <a id="fld_timestamp"></a>timestamp                                                       | `uint64`  |              |            | time since system start (microseconds) |
+| <a id="fld_device_id"></a>device_id                                                       | `uint32`  |              |            |
+| <a id="fld_heater_on"></a>heater_on                                                       | `bool`    |              |            |
+| <a id="fld_temperature_target_met"></a>temperature_target_met                             | `bool`    |              |            |
+| <a id="fld_temperature_activation_threshold_met"></a>temperature_activation_threshold_met | `bool`    |              |            |
+| <a id="fld_temperature_sensor"></a>temperature_sensor                                     | `float32` |              |            |
+| <a id="fld_temperature_target"></a>temperature_target                                     | `float32` |              |            |
+| <a id="fld_controller_period_usec"></a>controller_period_usec                             | `uint32`  |              |            |
+| <a id="fld_controller_time_on_usec"></a>controller_time_on_usec                           | `uint32`  |              |            |
+| <a id="fld_proportional_value"></a>proportional_value                                     | `float32` |              |            |
+| <a id="fld_integrator_value"></a>integrator_value                                         | `float32` |              |            |
+| <a id="fld_feed_forward_value"></a>feed_forward_value                                     | `float32` |              |            |
+| <a id="fld_supply_voltage"></a>supply_voltage                                             | `float32` |              |            | Supply voltage (V)                     |
+| <a id="fld_heater_current"></a>heater_current                                             | `float32` |              |            | Heater current (A)                     |
+| <a id="fld_nominal_multiplier"></a>nominal_multiplier                                     | `float32` |              |            |
+| <a id="fld_mode"></a>mode                                                                 | `uint8`   |              |            |
+| <a id="fld_temperature_source"></a>temperature_source                                     | `uint8`   |              |            |
 
 ## Constants
 
@@ -49,6 +50,7 @@ uint32 device_id
 
 bool heater_on
 bool temperature_target_met
+bool temperature_activation_threshold_met
 
 float32 temperature_sensor
 float32 temperature_target