[miele] Document known programs and phases (#11377)

* Document known programs and phases.
* Clarify description for superfreeze.

Signed-off-by: Jacob Laursen <jacob-github@vindvejr.dk>
This commit is contained in:
jlaur 2021-10-15 21:45:21 +02:00 committed by GitHub
parent 42c830bfda
commit 406f9c1364
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 157 additions and 14 deletions

View File

@ -55,8 +55,14 @@ Thing coffeemachine coffeemachine [uid="001d63fffe020505#190"]
## Channels ## Channels
See below which channels are available for each appliance type. Raw program and phase values are individual for each appliance type, ### Raw values
while these raw state values are unique across all appliance types:
Some channels represent raw/numeric values for state, program and phase, namely rawState, rawProgram and rawPhase.
These channels are more reliable as rule triggers/logic than using their text-based counterparts. Raw values are
always available from the gateway even when texts are missing. Only a subset of available raw values are documented
here since no official documentation exists.
#### State
| State | Description | Appliances | | State | Description | Appliances |
|-------|------------------------------|-----------------------------------------------------------------| |-------|------------------------------|-----------------------------------------------------------------|
@ -81,7 +87,11 @@ while these raw state values are unique across all appliance types:
| 146 | Super Cooling/Super Freezing | Fridge/Freezer combination | | 146 | Super Cooling/Super Freezing | Fridge/Freezer combination |
| 255 | Not Connected | All | | 255 | Not Connected | All |
### Coffee Machine ### Appliances
Channels available for each appliance type are listed below.
#### Coffee Machine
| Channel | Type | Read/write | Description | | Channel | Type | Read/write | Description |
|---------------------|----------------------|------------|---------------------------------------------------------------------| |---------------------|----------------------|------------|---------------------------------------------------------------------|
@ -95,7 +105,7 @@ while these raw state values are unique across all appliance types:
| door | Contact | Read | Current state of the door of the appliance | | door | Contact | Read | Current state of the door of the appliance |
| switch | Switch | Write | Switch the appliance on or off | | switch | Switch | Write | Switch the appliance on or off |
### Dishwasher #### Dishwasher
| Channel | Type | Read/write | Description | | Channel | Type | Read/write | Description |
|---------------------|----------------------|------------|---------------------------------------------------------------------| |---------------------|----------------------|------------|---------------------------------------------------------------------|
@ -114,7 +124,35 @@ while these raw state values are unique across all appliance types:
| powerConsumption | Number:Power | Read | Power consumption by the currently running program on the appliance | | powerConsumption | Number:Power | Read | Power consumption by the currently running program on the appliance |
| waterConsumption | Number:Volume | Read | Water consumption by the currently running program on the appliance | | waterConsumption | Number:Volume | Read | Water consumption by the currently running program on the appliance |
### Fridge ##### Programs
| Program | Description |
|---------|-------------------------------------|
| 26 | Pots & Pans |
| 27 | Clean Machine |
| 28 | Economy |
| 30 | Normal |
| 32 | Sensor Wash |
| 34 | Energy Saver |
| 35 | China & Crystal |
| 36 | Extra Quiet |
| 37 | SaniWash |
| 38 | QuickPowerWash |
| 42 | Tall items |
##### Phases
| Phase | Legacy | Description |
|-------|--------|------------------------------|
| 1792 | 0 | None (appliance off) |
| 1794 | 2 | Pre-Wash |
| 1795 | 3 | Main Wash |
| 1796 | 4 | Rinses |
| 1798 | 6 | Final rinse |
| 1799 | 7 | Drying |
| 1800 | 8 | Finished |
#### Fridge
| Channel | Type | Read/write | Description | | Channel | Type | Read/write | Description |
|---------------------|----------------------|------------|---------------------------------------------------------------------| |---------------------|----------------------|------------|---------------------------------------------------------------------|
@ -126,7 +164,7 @@ while these raw state values are unique across all appliance types:
| door | Contact | Read | Current state of the door of the appliance | | door | Contact | Read | Current state of the door of the appliance |
| switch | Switch | Write | Switch the appliance on or off | | switch | Switch | Write | Switch the appliance on or off |
### Fridge/Freezer combination #### Fridge/Freezer combination
| Channel | Type | Read/write | Description | | Channel | Type | Read/write | Description |
|---------------------|----------------------|------------|---------------------------------------------------------------------| |---------------------|----------------------|------------|---------------------------------------------------------------------|
@ -143,7 +181,7 @@ while these raw state values are unique across all appliance types:
| door | Contact | Read | Current state of the door of the appliance | | door | Contact | Read | Current state of the door of the appliance |
| start | Switch | Write | Switch the appliance on or off | | start | Switch | Write | Switch the appliance on or off |
### Hob #### Hob
| Channel | Type | Read/write | Description | | Channel | Type | Read/write | Description |
|---------------------|----------------------|------------|---------------------------------------------------------------------| |---------------------|----------------------|------------|---------------------------------------------------------------------|
@ -168,7 +206,7 @@ while these raw state values are unique across all appliance types:
| plate6heat | Number | Read | Remaining heat level of heating zone/plate 6 | | plate6heat | Number | Read | Remaining heat level of heating zone/plate 6 |
| plate6time | String | Read | Remaining time of heating zone/plate 6 | | plate6time | String | Read | Remaining time of heating zone/plate 6 |
### Hood #### Hood
| Channel | Type | Read/write | Description | | Channel | Type | Read/write | Description |
|---------------------|----------------------|------------|---------------------------------------------------------------------| |---------------------|----------------------|------------|---------------------------------------------------------------------|
@ -178,7 +216,7 @@ while these raw state values are unique across all appliance types:
| ventilation | Number | Read | Current ventilation power | | ventilation | Number | Read | Current ventilation power |
| stop | Switch | Write | Stop the appliance | | stop | Switch | Write | Stop the appliance |
### Oven #### Oven
| Channel | Type | Read/write | Description | | Channel | Type | Read/write | Description |
|---------------------|----------------------|------------|---------------------------------------------------------------------| |---------------------|----------------------|------------|---------------------------------------------------------------------|
@ -201,11 +239,26 @@ while these raw state values are unique across all appliance types:
| switch | Switch | Write | Switch the appliance on or off | | switch | Switch | Write | Switch the appliance on or off |
| stop | Switch | Write | Stop the appliance | | stop | Switch | Write | Stop the appliance |
### Microwave/Oven combination ##### Phases
| Phase | Legacy | Description |
|-------|--------|------------------------------|
| 3072 | 0 | None (appliance off) |
| 3073 | 1 | Heating |
| 3074 | 2 | Temp. hold |
| 3075 | 3 | Door Open |
| 3076 | 4 | Pyrolysis |
| 3079 | 7 | Lighting |
| 3080 | 8 | Searing phase |
| 3082 | 10 | Defrost |
| 3083 | 11 | Cooling down |
| 3084 | 12 | Energy save phase |
#### Microwave/Oven combination
See oven. See oven.
### Tumble Dryer #### Tumble Dryer
| Channel | Type | Read/write | Description | | Channel | Type | Read/write | Description |
|---------------------|----------------------|------------|---------------------------------------------------------------------| |---------------------|----------------------|------------|---------------------------------------------------------------------|
@ -224,7 +277,51 @@ See oven.
| switch | Switch | Write | Switch the appliance on or off | | switch | Switch | Write | Switch the appliance on or off |
| step | Number | Read | Current step in the program running on the appliance | | step | Number | Read | Current step in the program running on the appliance |
### Washing Machine ##### Programs
| Program | Description |
|---------|-------------------------------------|
| 10 | Automatic Plus |
| 23 | Cottons hygiene |
| 30 | Minimum iron |
| 31 | Gentle minimum iron |
| 40 | Woollens handcare |
| 50 | Delicates |
| 60 | Warm Air |
| 70 | Cool air |
| 80 | Express |
| 90 | Cottons |
| 100 | Gentle smoothing |
| 120 | Proofing |
| 130 | Denim |
| 131 | Gentle denim |
| 140 | Shirts |
| 141 | Gentle shirts |
| 150 | Sportswear |
| 160 | Outerwear |
| 170 | Silks handcare |
| 190 | Standard pillows |
| 220 | Basket programme |
| 240 | Smoothing |
| 65000 | Cottons (auto load control) |
| 65001 | Minimum iron (auto load control) |
##### Phases
| Phase | Legacy | Description |
|-------|--------|------------------------------|
| 512 | 0 | None (appliance off) |
| 513 | 1 | Programme running |
| 514 | 2 | Drying |
| 515 | 3 | Drying Machine iron |
| 516 | 4 | Drying Hand iron (1) |
| 517 | 5 | Drying Normal |
| 518 | 6 | Drying Normal+ |
| 519 | 7 | Cooling down |
| 520 | 8 | Drying Hand iron (2) |
| 522 | 10 | Finished |
#### Washing Machine
| Channel | Type | Read/write | Description | | Channel | Type | Read/write | Description |
|---------------------|----------------------|------------|---------------------------------------------------------------------| |---------------------|----------------------|------------|---------------------------------------------------------------------|
@ -246,6 +343,52 @@ See oven.
| powerConsumption | Number:Power | Read | Power consumption by the currently running program on the appliance | | powerConsumption | Number:Power | Read | Power consumption by the currently running program on the appliance |
| waterConsumption | Number:Volume | Read | Water consumption by the currently running program on the appliance | | waterConsumption | Number:Volume | Read | Water consumption by the currently running program on the appliance |
##### Programs
| Program | Description |
|---------|-------------------------------------|
| 1 | Cottons |
| 3 | Minimum iron |
| 4 | Delicates |
| 8 | Woollens |
| 9 | Silks |
| 17 | Starch |
| 18 | Rinse |
| 21 | Drain/Spin |
| 22 | Curtains |
| 23 | Shirts |
| 24 | Denim |
| 27 | Proofing |
| 29 | Sportswear |
| 31 | Automatic Plus |
| 37 | Outerwear |
| 39 | Pillows |
| 50 | Dark Garments |
| 53 | First wash |
| 75 | Steam care |
| 76 | Freshen up |
| 91 | Maintenance wash |
| 95 | Down duvets |
| 122 | Express 20 |
| 129 | Down filled items |
| 133 | Cottons Eco |
| 146 | QuickPowerWash |
| 65532 | Mix |
##### Phases
| Phase | Legacy | Description |
|-------|--------|------------------------------|
| 256 | 0 | None (appliance off) |
| 257 | 1 | Pre-wash |
| 260 | 4 | Washing |
| 261 | 5 | Rinses |
| 263 | 7 | Clean |
| 265 | 9 | Drain |
| 266 | 10 | Spin |
| 267 | 11 | Anti-crease |
| 268 | 12 | Finished |
# Configuration Examples # Configuration Examples
## things/miele.things ## things/miele.things

View File

@ -158,7 +158,7 @@ public enum DishwasherChannelSelector implements ApplianceChannelSelector {
entry("37", "SaniWash"), entry("38", "QuickPowerWash"), entry("42", "Tall items")); entry("37", "SaniWash"), entry("38", "QuickPowerWash"), entry("42", "Tall items"));
private final static Map<String, String> phases = Map.ofEntries(entry("2", "Pre-Wash"), entry("3", "Main Wash"), private final static Map<String, String> phases = Map.ofEntries(entry("2", "Pre-Wash"), entry("3", "Main Wash"),
entry("4", "Rinses"), entry("6", "Final rinse"), entry("7", "Drying")); entry("4", "Rinses"), entry("6", "Final rinse"), entry("7", "Drying"), entry("8", "Finished"));
private final String mieleID; private final String mieleID;
private final String channelID; private final String channelID;

View File

@ -159,7 +159,7 @@
<channel-type id="superfreeze"> <channel-type id="superfreeze">
<item-type>Switch</item-type> <item-type>Switch</item-type>
<label>Super Freeze</label> <label>Super Freeze</label>
<description>Start Super Freezing</description> <description>Start or stop Super Freezing</description>
<state readOnly="false"></state> <state readOnly="false"></state>
</channel-type> </channel-type>