From 0cd611b1aacf4095b8d61f3ddfdabb2091c19376 Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Fri, 10 Jan 2025 13:58:56 +0800 Subject: [PATCH 1/7] Add dreo integration document --- source/_integrations/dreo.markdown | 64 ++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 source/_integrations/dreo.markdown diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown new file mode 100644 index 000000000000..13cdc29dcbce --- /dev/null +++ b/source/_integrations/dreo.markdown @@ -0,0 +1,64 @@ +--- +title: Dreo +description: Instructions on how to set up Dreo fans within Home Assistant. +ha_category: + - Fan +ha_release: 2025.1 +ha_config_flow: true +ha_domain: dreo +ha_platforms: + - fan +ha_integration_type: integration +--- + +The Dreo integration enables you to control smart switches and outlets connected to the Dreo App. + +The devices must be added to the Dreo App before this integration can discover them. + +The following platforms are supported: + +- **fan** + +## Supported devices +This integration supports devices controllable by the Dreo App. The following devices are supported by this integration: + +### Fans +- DR-HTF001S: Tower Fan +- DR-HTF002S: Tower Fan +- DR-HTF004S: Tower Fan +- DR-HTF005S: Tower Fan +- DR-HTF007S: Tower Fan +- DR-HTF008S: Tower Fan +- DR-HTF009S: Tower Fan +- DR-HTF010S: Tower Fan + +## Prerequisite +Before you can use this integration, all devices must be registered with the +Dreo App. Once registration is complete, you can add the Dreo integration in Home Assistant through the UI. + +## Configuration instructions +1. **Open Home Assistant UI**: Log in to your Home Assistant web interface. Navigate to the "Settings" section, usually found in the sidebar. +2. **Access Integrations**: In the "Settings" menu, click on "Integrations". This will take you to a page listing all the available integrations. +3. **Search for Dreo**: Use the search bar on the Integrations page to search for the "Dreo" integration. +4. **Initiate Setup**: Once you've located the Dreo integration, click on it. Since `ha_config_flow: true`, the setup wizard should automatically start. Follow the on-screen prompts, which will likely include authorizing Home Assistant to access your Dreo App account. This may involve logging into your Dreo App credentials within the Home Assistant setup flow. +5. **Complete Setup**: After providing the necessary information and authorizing the connection, the integration should be set up successfully. You should then be able to control your Dreo devices from within Home Assistant. + +## Fan exposed attributes +Dreo Tower Fan will expose the following details depending on the features supported by the model: + +| Attribute | Description | Example | +| --------- | ------------------------------------------------------------ | ------- | +| `mode` | The current mode the device is in. | "manual", "auto", "sleep" | +| `speed` | The current speed setting (1-4). | 1 | +| `oscillate` | Whether oscillation is enabled. | true/false | +All attributes are supported by models: DR-HTF001S/002S/004S/005S/007S/008S/009S/010S + +## Troubleshooting +### Device not discovered +- **Check Dreo App Connection**: Ensure that your devices are properly connected to the Dreo App. Try restarting the Dreo App and checking if the devices are still visible and controllable within it. If not, re-pair the devices with the Dreo App following the app's official pairing instructions. +- **Home Assistant Network Issues**: Make sure that your Home Assistant instance has network access. You can test this by trying to access other online services from within Home Assistant (for example, checking the weather integration if it's set up). If there are network problems, troubleshoot your Home Assistant's network connection, which may involve checking your router settings, Wi-Fi passwords, or Ethernet connections. +- **Permissions**: Double-check that you've granted all the necessary permissions during the integration setup process. Incorrect permissions can prevent Home Assistant from discovering your Dreo devices. + +### Inability to control devices +- **Device State Sync**: Sometimes, the device state may not sync correctly between the Dreo App and Home Assistant. Try toggling the device on/off, changing the mode, or adjusting the speed from within the Dreo App, and then refreshing the device page in Home Assistant to see if the state updates. +- **App Version Mismatch**: Ensure that both the Dreo App and Home Assistant are running up-to-date versions. An outdated version of either software could lead to compatibility issues and control problems. Update the Dreo App from the official app store for your device, and check for Home Assistant updates in the Home Assistant UI's update section. \ No newline at end of file From 8bdbb047deebbd71a22f3b43d82e772463e2dd90 Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Fri, 10 Jan 2025 14:05:13 +0800 Subject: [PATCH 2/7] Modify dreo markdown --- source/_integrations/dreo.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index 13cdc29dcbce..770f74380e31 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -51,6 +51,7 @@ Dreo Tower Fan will expose the following details depending on the features suppo | `mode` | The current mode the device is in. | "manual", "auto", "sleep" | | `speed` | The current speed setting (1-4). | 1 | | `oscillate` | Whether oscillation is enabled. | true/false | + All attributes are supported by models: DR-HTF001S/002S/004S/005S/007S/008S/009S/010S ## Troubleshooting From 9894b76ca8f1cf6d4d64549398c6256b52bd473e Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Fri, 10 Jan 2025 16:27:29 +0800 Subject: [PATCH 3/7] Modify dreo.markdown file --- source/_integrations/dreo.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index 770f74380e31..b223b969b0b7 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -40,7 +40,7 @@ Dreo App. Once registration is complete, you can add the Dreo integration in Hom 1. **Open Home Assistant UI**: Log in to your Home Assistant web interface. Navigate to the "Settings" section, usually found in the sidebar. 2. **Access Integrations**: In the "Settings" menu, click on "Integrations". This will take you to a page listing all the available integrations. 3. **Search for Dreo**: Use the search bar on the Integrations page to search for the "Dreo" integration. -4. **Initiate Setup**: Once you've located the Dreo integration, click on it. Since `ha_config_flow: true`, the setup wizard should automatically start. Follow the on-screen prompts, which will likely include authorizing Home Assistant to access your Dreo App account. This may involve logging into your Dreo App credentials within the Home Assistant setup flow. +4. **Initiate Setup**: Once you've located the Dreo integration, click on it to start the setup wizard. Follow the on-screen prompts to authorize Home Assistant to access your Dreo App account. This will involve logging into your Dreo App credentials within the Home Assistant setup flow. 5. **Complete Setup**: After providing the necessary information and authorizing the connection, the integration should be set up successfully. You should then be able to control your Dreo devices from within Home Assistant. ## Fan exposed attributes From 271bd3e06532346f1a97281ff2f319e614c556f7 Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Fri, 10 Jan 2025 18:39:54 +0800 Subject: [PATCH 4/7] Remove ha_config_flow parameter and add blank line --- source/_integrations/dreo.markdown | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index b223b969b0b7..d20ce24e0422 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -4,7 +4,6 @@ description: Instructions on how to set up Dreo fans within Home Assistant. ha_category: - Fan ha_release: 2025.1 -ha_config_flow: true ha_domain: dreo ha_platforms: - fan @@ -23,6 +22,7 @@ The following platforms are supported: This integration supports devices controllable by the Dreo App. The following devices are supported by this integration: ### Fans + - DR-HTF001S: Tower Fan - DR-HTF002S: Tower Fan - DR-HTF004S: Tower Fan @@ -37,12 +37,14 @@ Before you can use this integration, all devices must be registered with the Dreo App. Once registration is complete, you can add the Dreo integration in Home Assistant through the UI. ## Configuration instructions + 1. **Open Home Assistant UI**: Log in to your Home Assistant web interface. Navigate to the "Settings" section, usually found in the sidebar. 2. **Access Integrations**: In the "Settings" menu, click on "Integrations". This will take you to a page listing all the available integrations. 3. **Search for Dreo**: Use the search bar on the Integrations page to search for the "Dreo" integration. 4. **Initiate Setup**: Once you've located the Dreo integration, click on it to start the setup wizard. Follow the on-screen prompts to authorize Home Assistant to access your Dreo App account. This will involve logging into your Dreo App credentials within the Home Assistant setup flow. 5. **Complete Setup**: After providing the necessary information and authorizing the connection, the integration should be set up successfully. You should then be able to control your Dreo devices from within Home Assistant. + ## Fan exposed attributes Dreo Tower Fan will expose the following details depending on the features supported by the model: From c42a5b77dc046f6c778bc6b0af115524d5cd888d Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Fri, 10 Jan 2025 20:48:00 +0800 Subject: [PATCH 5/7] Add blank lines --- source/_integrations/dreo.markdown | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index d20ce24e0422..2f4dd11d980c 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -19,6 +19,7 @@ The following platforms are supported: - **fan** ## Supported devices + This integration supports devices controllable by the Dreo App. The following devices are supported by this integration: ### Fans @@ -33,6 +34,7 @@ This integration supports devices controllable by the Dreo App. The following d - DR-HTF010S: Tower Fan ## Prerequisite + Before you can use this integration, all devices must be registered with the Dreo App. Once registration is complete, you can add the Dreo integration in Home Assistant through the UI. @@ -44,8 +46,8 @@ Dreo App. Once registration is complete, you can add the Dreo integration in Hom 4. **Initiate Setup**: Once you've located the Dreo integration, click on it to start the setup wizard. Follow the on-screen prompts to authorize Home Assistant to access your Dreo App account. This will involve logging into your Dreo App credentials within the Home Assistant setup flow. 5. **Complete Setup**: After providing the necessary information and authorizing the connection, the integration should be set up successfully. You should then be able to control your Dreo devices from within Home Assistant. - ## Fan exposed attributes + Dreo Tower Fan will expose the following details depending on the features supported by the model: | Attribute | Description | Example | @@ -57,11 +59,14 @@ Dreo Tower Fan will expose the following details depending on the features suppo All attributes are supported by models: DR-HTF001S/002S/004S/005S/007S/008S/009S/010S ## Troubleshooting + ### Device not discovered + - **Check Dreo App Connection**: Ensure that your devices are properly connected to the Dreo App. Try restarting the Dreo App and checking if the devices are still visible and controllable within it. If not, re-pair the devices with the Dreo App following the app's official pairing instructions. - **Home Assistant Network Issues**: Make sure that your Home Assistant instance has network access. You can test this by trying to access other online services from within Home Assistant (for example, checking the weather integration if it's set up). If there are network problems, troubleshoot your Home Assistant's network connection, which may involve checking your router settings, Wi-Fi passwords, or Ethernet connections. - **Permissions**: Double-check that you've granted all the necessary permissions during the integration setup process. Incorrect permissions can prevent Home Assistant from discovering your Dreo devices. ### Inability to control devices + - **Device State Sync**: Sometimes, the device state may not sync correctly between the Dreo App and Home Assistant. Try toggling the device on/off, changing the mode, or adjusting the speed from within the Dreo App, and then refreshing the device page in Home Assistant to see if the state updates. - **App Version Mismatch**: Ensure that both the Dreo App and Home Assistant are running up-to-date versions. An outdated version of either software could lead to compatibility issues and control problems. Update the Dreo App from the official app store for your device, and check for Home Assistant updates in the Home Assistant UI's update section. \ No newline at end of file From e238bda3b6f6dc64eb2d73bcdd4ef85bdc260268 Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Fri, 10 Jan 2025 21:14:27 +0800 Subject: [PATCH 6/7] Add comma with sentence last --- source/_integrations/dreo.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index 2f4dd11d980c..6c4d87848ff6 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -62,11 +62,11 @@ All attributes are supported by models: DR-HTF001S/002S/004S/005S/007S/008S/009S ### Device not discovered -- **Check Dreo App Connection**: Ensure that your devices are properly connected to the Dreo App. Try restarting the Dreo App and checking if the devices are still visible and controllable within it. If not, re-pair the devices with the Dreo App following the app's official pairing instructions. +- **Check Dreo App Connection**: Ensure that your devices are properly connected to the Dreo App. Try restarting the Dreo App and checking if the devices are still visible and controllable within it. If not, re-pair the devices with the Dreo App following the app's. official pairing instructions. - **Home Assistant Network Issues**: Make sure that your Home Assistant instance has network access. You can test this by trying to access other online services from within Home Assistant (for example, checking the weather integration if it's set up). If there are network problems, troubleshoot your Home Assistant's network connection, which may involve checking your router settings, Wi-Fi passwords, or Ethernet connections. - **Permissions**: Double-check that you've granted all the necessary permissions during the integration setup process. Incorrect permissions can prevent Home Assistant from discovering your Dreo devices. ### Inability to control devices - **Device State Sync**: Sometimes, the device state may not sync correctly between the Dreo App and Home Assistant. Try toggling the device on/off, changing the mode, or adjusting the speed from within the Dreo App, and then refreshing the device page in Home Assistant to see if the state updates. -- **App Version Mismatch**: Ensure that both the Dreo App and Home Assistant are running up-to-date versions. An outdated version of either software could lead to compatibility issues and control problems. Update the Dreo App from the official app store for your device, and check for Home Assistant updates in the Home Assistant UI's update section. \ No newline at end of file +- **App Version Mismatch**: Ensure that both the Dreo App and Home Assistant are running up-to-date versions. An outdated version of either software could lead to compatibility issues and control problems. Update the Dreo App from the official app store for your device, and check for Home Assistant updates in the Home Assistant UI's update section. From f3731a0efcab8da6fbc65be20a5107192a72def3 Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Tue, 14 Jan 2025 16:49:52 +0800 Subject: [PATCH 7/7] Modify Dreo document --- source/_integrations/dreo.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index 6c4d87848ff6..192efc8c9f44 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -20,7 +20,7 @@ The following platforms are supported: ## Supported devices -This integration supports devices controllable by the Dreo App. The following devices are supported by this integration: +This integration supports devices controllable by the Dreo App. The following devices are supported by this integration: ### Fans @@ -62,7 +62,7 @@ All attributes are supported by models: DR-HTF001S/002S/004S/005S/007S/008S/009S ### Device not discovered -- **Check Dreo App Connection**: Ensure that your devices are properly connected to the Dreo App. Try restarting the Dreo App and checking if the devices are still visible and controllable within it. If not, re-pair the devices with the Dreo App following the app's. official pairing instructions. +- **Check Dreo App Connection**: Ensure that your devices are properly connected to the Dreo App. Try restarting the Dreo App and checking if the devices are still visible and controllable within it. If not, re-pair the devices with the Dreo App following the app's official pairing instructions. - **Home Assistant Network Issues**: Make sure that your Home Assistant instance has network access. You can test this by trying to access other online services from within Home Assistant (for example, checking the weather integration if it's set up). If there are network problems, troubleshoot your Home Assistant's network connection, which may involve checking your router settings, Wi-Fi passwords, or Ethernet connections. - **Permissions**: Double-check that you've granted all the necessary permissions during the integration setup process. Incorrect permissions can prevent Home Assistant from discovering your Dreo devices.