From e1a7277828af31d74f5d8de623b771dd5d135fe1 Mon Sep 17 00:00:00 2001 From: Illia Piskurov Date: Mon, 8 Sep 2025 13:39:20 +0300 Subject: [PATCH 1/4] Docs for current and target temp scale/offset. --- source/_integrations/modbus.markdown | 32 ++++++++++++++++++++++------ 1 file changed, 26 insertions(+), 6 deletions(-) diff --git a/source/_integrations/modbus.markdown b/source/_integrations/modbus.markdown index 7780962f1666..5a7c54cb67e0 100644 --- a/source/_integrations/modbus.markdown +++ b/source/_integrations/modbus.markdown @@ -614,11 +614,36 @@ climates: description: "Holding register." input: description: "Input register." + scale: + description: "Scale factor (output = scale * value + offset) for setting target and current temperature. Cannot be used together with *current_temp_scale* or *target_temp_scale*." + required: false + type: float + default: 1 offset: - description: "Final offset for current temperature (output = scale * value + offset)." + description: "Final offset for target and current temperature (output = scale * value + offset). Cannot be used together with *current_temp_offset* or *target_temp_offset*." required: false type: float default: 0 + current_temp_scale: + description: "Scale factor for current temperature (output = current_temp_scale * value + current_temp_offset). Cannot be used together with *scale*." + required: false + type: float + default: 1.0 + current_temp_offset: + description: "Offset for current temperature (output = current_temp_scale * value + current_temp_offset). Cannot be used together with *offset*." + required: false + type: float + default: 0.0 + target_temp_scale: + description: "Scale factor for target temperature (output = target_temp_scale * value + target_temp_offset). Cannot be used together with *scale*." + required: false + type: float + default: 1.0 + target_temp_offset: + description: "Offset for target temperature (output = target_temp_scale * value + target_temp_offset). Cannot be used together with *offset*." + required: false + type: float + default: 0.0 target_temp_register: description: "Register address for target temperature (Setpoint). Using a list, it is possible to define one register for each of the available HVAC Modes. The list has to have a fixed size of 7 registers corresponding to the 7 available HVAC Modes, as follows: Register **1: HVAC AUTO mode**; Register **2: HVAC Cool mode**; Register **3: HVAC Dry mode**; Register **4: HVAC Fan only mode**; Register **5: HVAC Heat mode**; Register **6: HVAC Heat Cool mode**; Register **7: HVAC OFF mode**. It is possible to set duplicated values for the modes where the devices don't have a related register." required: true @@ -628,11 +653,6 @@ climates: required: false type: boolean default: false - scale: - description: "Scale factor (output = scale * value + offset) for setting target temperature." - required: false - type: float - default: 1 structure: description: "If `data_type: custom` is specified a double-quoted Python struct is expected, to format the string to unpack the value. See Python documentation for details. From f36f585fcfc8b12be4aabc7e1609f48c7bf3d657 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Mon, 3 Nov 2025 17:05:43 +0100 Subject: [PATCH 2/4] Update source/_integrations/modbus.markdown --- source/_integrations/modbus.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/modbus.markdown b/source/_integrations/modbus.markdown index 5a7c54cb67e0..2c0a9b978a49 100644 --- a/source/_integrations/modbus.markdown +++ b/source/_integrations/modbus.markdown @@ -625,7 +625,7 @@ climates: type: float default: 0 current_temp_scale: - description: "Scale factor for current temperature (output = current_temp_scale * value + current_temp_offset). Cannot be used together with *scale*." + description: "Scale factor for current temperature (output = `current_temp_scale` * `value` + `current_temp_offset`). Cannot be used together with `scale`" required: false type: float default: 1.0 From 0735c0d71994ab76993d1c3e264c46ae36b12e11 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Fri, 7 Nov 2025 05:38:55 +0100 Subject: [PATCH 3/4] tiny style tweak --- source/_integrations/modbus.markdown | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/_integrations/modbus.markdown b/source/_integrations/modbus.markdown index 2c0a9b978a49..ff84c102ec6c 100644 --- a/source/_integrations/modbus.markdown +++ b/source/_integrations/modbus.markdown @@ -615,12 +615,12 @@ climates: input: description: "Input register." scale: - description: "Scale factor (output = scale * value + offset) for setting target and current temperature. Cannot be used together with *current_temp_scale* or *target_temp_scale*." + description: "Scale factor (`output` = `scale` * `value` + offset) for setting target and current temperature. Cannot be used together with `current_temp_scale` or `target_temp_scale." required: false type: float default: 1 offset: - description: "Final offset for target and current temperature (output = scale * value + offset). Cannot be used together with *current_temp_offset* or *target_temp_offset*." + description: "Final offset for target and current temperature (`output` = `scale` * `value` + `offset). Cannot be used together with current_temp_offset or target_temp_offset`." required: false type: float default: 0 @@ -635,12 +635,12 @@ climates: type: float default: 0.0 target_temp_scale: - description: "Scale factor for target temperature (output = target_temp_scale * value + target_temp_offset). Cannot be used together with *scale*." + description: "Scale factor for target temperature (`output` = `target_temp_scale` * `value` + `target_temp_offset`). Cannot be used together with scale`." required: false type: float default: 1.0 target_temp_offset: - description: "Offset for target temperature (output = target_temp_scale * value + target_temp_offset). Cannot be used together with *offset*." + description: "Offset for target temperature (`output` = `target_temp_scale` * `value` + `target_temp_offset`). Cannot be used together with offset`." required: false type: float default: 0.0 From d42b84ec047b8b7ea72f6dadfac9679ed7771eed Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Fri, 7 Nov 2025 05:40:19 +0100 Subject: [PATCH 4/4] Update source/_integrations/modbus.markdown --- source/_integrations/modbus.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/modbus.markdown b/source/_integrations/modbus.markdown index ff84c102ec6c..fc8eaa910b04 100644 --- a/source/_integrations/modbus.markdown +++ b/source/_integrations/modbus.markdown @@ -630,7 +630,7 @@ climates: type: float default: 1.0 current_temp_offset: - description: "Offset for current temperature (output = current_temp_scale * value + current_temp_offset). Cannot be used together with *offset*." + description: "Offset for current temperature (output` = current_temp_scale` * `value` + `current_temp_offset`). Cannot be used together with *offset*." required: false type: float default: 0.0