Create Component page for mysensors based HVAC (#943)

* Create Component page for mysensors based HVAC * Update climate.mysensors.markdown * Update climate.mysensors.markdown * Update climate.mysensors.markdown * Update climate.mysensors.markdown
2025-07-25 10:17:23 +00:00 · 2016-09-23 18:56:42 +05:30 · 2016-09-23 18:56:42 +05:30 · d5db0dc326
commit d5db0dc326
parent 2efe5a9421
1 changed files with 112 additions and 0 deletions
--- a/source/_components/climate.mysensors.markdown
+++ b/source/_components/climate.mysensors.markdown
@ -0,0 +1,112 @@
+---
+layout: page
+title: "MySensors HVAC"
+description: "Instructions how to integrate MySensors climate into Home Assistant."
+date: 2016-09-14 18:20 +0100
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: mysensors.png
+ha_category: Climate
+featured: false
+ha_release: 0.29
+---
+
+Integrates MySensors HVAC into Home Assistant. See the [main component] for configuration instructions.
+
+The following actuator types are supported:
+
+##### MySensors version 1.5 and higher
+
+S_TYPE      | V_TYPE
+------------|-------------
+S_HVAC      | V_HVAC_FLOW_STATE*, V_HVAC_SETPOINT_HEAT, V_HVAC_SETPOINT_COOL, V_HVAC_SPEED
+
+V_HVAC_FLOW_STATE is mapped to the state of the Climate component in HA as follows:
+
+Home Assistant State   | MySensors State
+-----------------------|----------------------
+STATE_COOL             | CoolOn
+STATE_HEAT             | HeatOn
+STATE_AUTO             | Off 
+STATE_OFF              | AutoChangeOver
+
+Currently humidity, away_mode, aux_heat, swing_mode is not supported. This will be included in later versions as feasible.
+
+Set the target temperature using V_HVAC_SETPOINT_HEAT in Heat mode, and V_HVAC_SETPOINT_COOL in Cool Mode. In case of any Auto Change Over mode you can use V_HVAC_SETPOINT_HEAT as well as V_HVAC_SETPOINT_COOL to set the both the low bound and the high bound temperature of the device.
+
+You can use V_HVAC_SPEED to control the Speed setting of the Fan in the HVAC.
+
+For more information, visit the [serial api] of MySensors.
+
+### {% linkable_title Example sketch %}
+
+```cpp
+/*
+ * Documentation: http://www.mysensors.org
+ * Support Forum: http://forum.mysensors.org
+ *
+ */
+
+#include <MySensor.h>
+/* Include all the other Necessary code here. The example code is limited to message exchange for mysensors with the controller (ha)*/
+
+#define CHILD_ID_HVAC  0  // childId
+MyMessage msgHVACSetPointC(CHILD_ID_HVAC, V_HVAC_SETPOINT_COOL);
+MyMessage msgHVACSpeed(CHILD_ID_HVAC, V_HVAC_SPEED);
+MyMessage msgHVACFlowState(CHILD_ID_HVAC, V_HVAC_FLOW_STATE);
+
+/* Include all the other Necessary code here. The example code is limited to message exchange for mysensors with the controller (ha)*/
+
+void setup()
+{
+
+        // Startup and initialize MySensors library. Set callback for incoming messages.
+        gw.begin(incomingMessage);
+
+        // Send the sketch version information to the gateway and Controller
+        gw.sendSketchInfo("HVAC", "0.1");
+
+        gw.present(CHILD_ID_HVAC, S_HVAC, "Thermostat");
+        gw.send(msgHVACFlowState.set("Off"));
+        gw.send(msgHVACSetPointC.set(target_temp));
+        gw.send(msgHVACSpeed.set("Max"));
+}
+
+void incomingMessage(const MyMessage &message) {
+        String recvData = message.data;
+        recvData.trim();
+        switch (message.type) {
+        case V_HVAC_SPEED:
+                if(recvData.equalsIgnoreCase("auto")) fan_speed = 0;
+                else if(recvData.equalsIgnoreCase("min")) fan_speed = 1;
+                else if(recvData.equalsIgnoreCase("normal")) fan_speed = 2;
+                else if(recvData.equalsIgnoreCase("max")) fan_speed = 3;
+                processHVAC();
+                break;
+        case V_HVAC_SETPOINT_COOL:
+                target_temp = message.getFloat();
+                processHVAC();
+                break;
+        case V_HVAC_FLOW_STATE:
+                if(recvData.equalsIgnoreCase("coolon") && (!Present_Power_On )){
+                  togglePower();
+                }
+                else if(recvData.equalsIgnoreCase("off") && Present_Power_On ){
+                  togglePower();
+                }
+                break;
+        }
+}
+
+void loop() {
+
+        // Process incoming messages (like config from server)
+        gw.process();
+
+}
+```
+
+[main component]: /components/mysensors/
+[serial api]: https://www.mysensors.org/download/serial_api_15