From 4cebb59611904cfad14c8ac9650e894e7823d8c5 Mon Sep 17 00:00:00 2001
From: Simon Knopp <s.j.knopp@gmail.com>
Date: Fri, 28 May 2021 10:53:19 +1200
Subject: [PATCH] Add support for set_remote_temperature()

---
 README.md                                 | 54 +++++++++++++++++++++++
 components/mitsubishi_heatpump/espmhp.cpp |  5 +++
 components/mitsubishi_heatpump/espmhp.h   |  4 ++
 3 files changed, 63 insertions(+)

diff --git a/README.md b/README.md
index 3b3d49c..55e681f 100644
--- a/README.md
+++ b/README.md
@@ -272,6 +272,60 @@ climate:
   Component](https://esphome.io/components/climate/index.html) documentation for
   details.
 
+## Remote temperature
+
+It is possible to use an external temperature sensor to tell the heat pump what
+the room temperature is, rather than relying on its internal temperature
+sensor. You can do this by calling `set_remote_temperature(float temp)` on the
+`mitsubishi_heatpump` object in a lambda. Note that you can call
+`set_remote_temperature(0)` to switch back to the internal temperature sensor.
+
+There are several ways you could make use of this functionality. One is to use
+a sensor automation:
+
+```yaml
+climate:
+  - platform: mitsubishi_heatpump
+    name: "Lounge heat pump"
+    id: hp
+
+sensor:
+  # You could use a Bluetooth temperature sensor
+  - platform: atc_mithermometer
+    mac_address: "XX:XX:XX:XX:XX:XX"
+    temperature:
+      name: "Lounge temperature"
+      on_value:
+        then:
+          - lambda: 'id(hp).set_remote_temperature(x);'
+
+  # Or you could use a HomeAssistant sensor
+  - platform: homeassistant
+    name: "Temperature Sensor From Home Assistant"
+    entity_id: sensor.temperature_sensor
+    on_value:
+      then:
+        - lambda: 'id(hp).set_remote_temperature(x);'
+```
+
+Alternatively you could define a
+[service](https://www.esphome.io/components/api.html#user-defined-services)
+that HomeAssistant can call:
+
+```yaml
+api:
+  services:
+    - service: set_remote_temperature
+      variables:
+        temperature: float
+      then:
+        - lambda: 'id(hp).set_remote_temperature(temperature);'
+
+    - service: use_internal_temperature
+      then:
+        - lambda: 'id(hp).set_remote_temperature(0);'
+```
+
 # See Also
 
 ## Other Implementations
diff --git a/components/mitsubishi_heatpump/espmhp.cpp b/components/mitsubishi_heatpump/espmhp.cpp
index bd9bb3b..e1cb942 100644
--- a/components/mitsubishi_heatpump/espmhp.cpp
+++ b/components/mitsubishi_heatpump/espmhp.cpp
@@ -406,6 +406,11 @@ void MitsubishiHeatPump::hpStatusChanged(heatpumpStatus currentStatus) {
     this->publish_state();
 }
 
+void MitsubishiHeatPump::set_remote_temperature(float temp) {
+    ESP_LOGD(TAG, "Setting remote temp: %.1f", temp);
+    this->hp->setRemoteTemperature(temp);
+}
+
 void MitsubishiHeatPump::setup() {
     // This will be called by App.setup()
     this->banner();
diff --git a/components/mitsubishi_heatpump/espmhp.h b/components/mitsubishi_heatpump/espmhp.h
index 0a686fe..37dcd9f 100644
--- a/components/mitsubishi_heatpump/espmhp.h
+++ b/components/mitsubishi_heatpump/espmhp.h
@@ -92,6 +92,10 @@ class MitsubishiHeatPump : public PollingComponent, public climate::Climate {
 
         // Handle a request from the user to change settings.
         void control(const climate::ClimateCall &call) override;
+  
+        // Use the temperature from an external sensor. Use 
+        // set_remote_temp(0) to switch back to the internal sensor.
+        void set_remote_temperature(float);
 
     protected:
         // HeatPump object using the underlying Arduino library.