Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updates to documentation #217

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 10 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -167,7 +167,7 @@ climate:
name: "${friendly_name}"
icon: mdi:heat-pump
visual:
min_temperature: 15
min_temperature: 10 # Adjust to your unit's min temp. SmartSet units can go to 10C for heating
max_temperature: 31
temperature_step:
target_temperature: 1
Expand Down Expand Up @@ -522,7 +522,7 @@ climate:
name: "${friendly_name}"
icon: mdi:heat-pump
visual:
min_temperature: 15
min_temperature: 10 # Adjust to your unit's min temp. SmartSet units can go to 10C for heating
max_temperature: 31
temperature_step:
target_temperature: 1
Expand Down Expand Up @@ -692,13 +692,17 @@ The below sensors were added recently based on the work of others in sorting out
auto_sub_mode_sensor:
name: Auto Sub Mode Sensor
```
- `stage_sensor` is the actual fan speed of the indoor unit. This is called stage in some of the documentation, even though the name isnt clear. This sensor is important because of how units act when they are in AUTO mode. AUTO mode is standard mode where the unit will acept a single setpoint and keep with in +/- 2 degrees C of that set point.
- `stage_sensor` is the actual fan speed of the indoor unit. This is called stage in some documentation. Reported speeds include `IDLE`, `LOW`, `GENTLE`, `MEDIUM`, `MODERATE`, `HIGH` and `DIFFUSE`, named using Mitsubishi documentation conventions.

- `auto_sub_mode_sensor` is that indicates what actual mode the unit is in when in AUTO; AUTO OFF means AUTO is not enabled, otherwise AUTO COOL means the unit is in AUTO and currently cooling to say within the +/- 2C from the setpoint.
- `auto_sub_mode_sensor` indicates what actual mode the unit is in when in AUTO. Modes are `AUTO_OFF`, meaning AUTO is disabled, `AUTO_COOL`, meaning AUTO and cooling, `AUTO_HEAT`, meaning AUTO and heating and `AUTO_LEADER`, meaning this unit is the leader in a multi-head unit and selects the heat/cool mode that the others follow.

- `sub_mode_sensor` indicates if the unit is in `PREHEAT`, `DEFROST`, `STANDBY` or `LEADER` submode. These are usful in knowing the day by day life of your unit. If it is in one of these modes too much this is an indication of a problem. NORMAL is just the NORMAL running sub mode. LEADER is the odd ball and it is not completely clear if this is the right name. What this indicates is that in a multi-head unit one id the leader and gets to pick the HEAT/COOL mode that the other must follow.
- `sub_mode_sensor` indicates additional detail on the current behavior of the unit. The Sub Modes are:
- `NORMAL` - the unit is in an active mode (heat, cool, dry, etc.) and is either running, or waiting to run
- `PREHEAT` - a cold-climate feature that electrically preheats the compressor windings prior to start of operation
- `DEFROST` - a cold climate behavior that runs a short AC cycle during heating mode to melt ice from the coils
- `STANDBY` - unit is off, or has been put into a "sleep" state through AUTO operation on another indoor unit

Some examples of how these all fit together: Unit 1 is in AUTO set to 20C and Unit 2 is in AUTO and set to 20C. Unit 1 senses that the room is 24C and tries to enter AUTO COOL. If Unit 2 wants to heat the room it is in, it will enter STANDBY (and in the case of a few units tested, this mean it will go to "sleep" as if it is off, but not really be off) making Unit 1 enter LEADER sub mode. In future releases, it is planned to make the ACTION in HA match these modes. But at this time this is not implemented.
Some examples of how these all fit together: Unit 1 is in AUTO set to 20C and Unit 2 is in AUTO and set to 20C. Unit 1 senses that the room is 24C and tries to enter `AUTO_COOL`. If Unit 2 wants to heat the room it is in, it will enter `STANDBY` (and in the case of a few units tested, this mean it will go to "sleep" as if it is off, but not really be off) making Unit 1 enter `AUTO_LEADER` sub mode. In future releases, it is planned to make the ACTION in HA match these modes. But at this time this is not implemented.

It is also important to note that the Kumo adapter has many more settings that impact the behaviour above (such as thermal fan behaviour) and if you have set these the exact actions the untis take in these modes/submodes/stages is determined by those. Some of these can also be set by remotes and other devices. The setup you have will dictate the exact actions you see. If you have permutations, please share!

Expand Down