From 3a4cfd61ad42bcd8eea89f455b390c62fbfe520c Mon Sep 17 00:00:00 2001
From: Sebastian Muszynski <basti@linkt.de>
Date: Sat, 19 Jan 2019 18:45:39 +0100
Subject: [PATCH] Add Xiaomi Airpurifier Pro V7 support and a missing Airfresh
 paragraph (#8169)

* Add Xiaomi Airpurifier Pro V7 support and a missing Airfresh paragraph

* Add table of supported devices

* Use official product names

* Remove redundancy
---
 source/_components/fan.xiaomi_miio.markdown | 82 ++++++++++++++++++++-
 1 file changed, 80 insertions(+), 2 deletions(-)

diff --git a/source/_components/fan.xiaomi_miio.markdown b/source/_components/fan.xiaomi_miio.markdown
index 56b29b2e085..6c071047a67 100644
--- a/source/_components/fan.xiaomi_miio.markdown
+++ b/source/_components/fan.xiaomi_miio.markdown
@@ -13,7 +13,29 @@ ha_iot_class: "Local Polling"
 ha_release: 0.57
 ---
 
-The `xiaomi_miio` fan platform allows you to control the Xiaomi Air Purifier and Xiaomi Air Humidifier.
+The `xiaomi_miio` fan platform allows you to control the Xiaomi Air Purifier, Air Humidifier and Air Fresh.
+
+Supported devices:
+
+| Name                | Model                  | Model no. |
+| ------------------- | ---------------------- | --------- |
+Air Purifier          | zhimi.airpurifier.v1   | |
+Air Purifier 2        | zhimi.airpurifier.v2   | FJY4006CN |
+Air Purifier V3       | zhimi.airpurifier.v3   | |
+Air Purifier V5       | zhimi.airpurifier.v5   | |
+Air Purifier Pro      | zhimi.airpurifier.v6   | |
+Air Purifier Pro V7   | zhimi.airpurifier.v7   | |
+Air Purifier 2 (mini) | zhimi.airpurifier.m1   | |
+Air Purifier (mini)   | zhimi.airpurifier.m2   | |
+Air Purifier MA1      | zhimi.airpurifier.ma1  | |
+Air Purifier 2S       | zhimi.airpurifier.ma2  | |
+Air Purifier 2S       | zhimi.airpurifier.mc1  | |
+Air Purifier Super    | zhimi.airpurifier.sa1  | |
+Air Purifier Super 2  | zhimi.airpurifier.sa2  | |
+Air Humidifier        | zhimi.humidifier.v1    | |
+Air Humidifier CA1    | zhimi.humidifier.ca1   | |
+Air Fresh VA2         | zhimi.airfresh.va2     | |
+
 
 ## Features
 
@@ -87,6 +109,37 @@ The `xiaomi_miio` fan platform allows you to control the Xiaomi Air Purifier and
   - motor2_speed
   - volume
 
+### Air Purifier Pro V7 (zhimi.airpurifier.v7)
+
+- Power (on, off)
+- Operation modes (auto, silent, favorite)
+- Child lock (on, off)
+- LED (on, off)
+- Favorite Level (0...16)
+- Attributes
+  - model
+  - temperature
+  - humidity
+  - aqi
+  - mode
+  - filter_hours_used
+  - filter_life_remaining
+  - favorite_level
+  - child_lock
+  - led
+  - motor_speed
+  - average_aqi
+  - learn_mode
+  - extra_features
+  - turbo_mode_supported
+  - button_pressed
+  - filter_rfid_product_id
+  - filter_rfid_tag
+  - filter_type
+  - illuminance
+  - motor2_speed
+  - volume
+
 ### Air Purifier V3 (zhimi.airpurifier.v3)
 
 - Power (on, off)
@@ -167,6 +220,31 @@ The `xiaomi_miio` fan platform allows you to control the Xiaomi Air Purifier and
   - depth
   - dry
 
+### Air Fresh VA2
+
+* Power (on, off)
+* Operation modes (auto, silent, interval, low, middle, strong)
+* Buzzer (on, off)
+* Child lock (on, off)
+* LED (on, off), LED brightness (bright, dim, off)
+* Attributes
+  - model
+  - aqi
+  - average_aqi
+  - temperature
+  - humidity
+  - co2
+  - mode
+  - led
+  - led_brightness
+  - buzzer
+  - child_lock
+  - filter_life_remaining
+  - filter_hours_used
+  - use_time
+  - motor_speed
+  - extra_features
+
 Please follow the instructions on [Retrieving the Access Token](/components/vacuum.xiaomi_miio/#retrieving-the-access-token) to get the API token to use in the `configuration.yaml` file.
 
 To add a Xiaomi Air Purifier to your installation, add the following to your `configuration.yaml` file:
@@ -194,7 +272,7 @@ name:
   type: string
   default: Xiaomi Air Purifier
 model:
-  description: The model of your miio fan. Valid values are `zhimi.airpurifier.v6`, `zhimi.airpurifier.v3`, `zhimi.humidifier.v1` and `zhimi.humidifier.ca1`. This setting can be used to bypass the device model detection and is recommended if your device isn't always available.
+  description: The model of your miio fan. See the table above for valid values (f.e. `zhimi.airpurifier.v2`). This setting can be used to bypass the device model detection and is recommended if your device isn't always available.
   required: false
   type: string
 {% endconfiguration %}