From 0cd611b1aacf4095b8d61f3ddfdabb2091c19376 Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Fri, 10 Jan 2025 13:58:56 +0800 Subject: [PATCH 01/26] 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 02/26] 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 03/26] 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 04/26] 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 05/26] 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 06/26] 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 07/26] 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. From b62f8d6a5980bcb9cef47aa6ed52cf4175d1f5a8 Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Thu, 6 Feb 2025 11:04:20 +0800 Subject: [PATCH 08/26] Modify the documentation to add instructions for device and app upgrades. --- source/_integrations/dreo.markdown | 60 +++++++++++++++++++++++++----- 1 file changed, 51 insertions(+), 9 deletions(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index 192efc8c9f44..e036fbfe9eb0 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -3,7 +3,7 @@ title: Dreo description: Instructions on how to set up Dreo fans within Home Assistant. ha_category: - Fan -ha_release: 2025.1 +ha_release: 2024.12 ha_domain: dreo ha_platforms: - fan @@ -24,14 +24,24 @@ This integration supports devices controllable by the Dreo App. The following de ### 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 +#### General Features + +- **Sleep Mode**: All models can adjust the fan speed smoothly in the "sleep" mode. However, some models (such as DR-HTF001S) perform better in terms of adjustment smoothness, providing a more stable and quiet environment for sleeping. +- **Wide-Angle Oscillation**: Fans generally offer a wide oscillation function. However, ensuring better and more even air circulation, especially in larger spaces. +- **Intelligent Auto Mode**: The "auto" mode of each model can adjust the fan speed based on temperature and humidity. For example, providing a more precise and personalized comfort experience. +- **Child Lock Function**: Many fans are equipped with a child lock. better preventing accidental setting changes and ensuring the safety of households with children. +- **Fast Speed Adjustment Response**: Most fans have a fast speed adjustment response time. allowing you to quickly change the fan speed as needed. +- **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants. facilitating a wider range of hands-free operations. +- **Energy-Efficient Motor**: Many fans are equipped with energy-efficient motors. saving more electricity costs while providing strong airflow. +- **Long Timer Setting**: Most fans offer a timer setting of up to 12 hours. giving you more flexibility in scheduling the fan's operation. + +The supported models include: DR-HTF001S、DR-HTF002S、DR-HTF005S、DR-HTF007S、DR-HTF008S、DR-HTF009S、DR-HTF010S. + +#### Different Features + +- **Wide-Angle Oscillation**: Generally, fans are equipped with a wide-angle oscillation function. However, the fan of model DR-HTF004S distinguishes itself with its remarkable performance. It offers an oscillation range of up to 120 degrees, and its oscillation mechanism is precisely engineered to ensure a more uniform and efficient air circulation. This feature is particularly advantageous in larger spaces, effectively spreading fresh air across the area. + +The supported models include: DR-HTF004S ## Prerequisite @@ -70,3 +80,35 @@ All attributes are supported by models: DR-HTF001S/002S/004S/005S/007S/008S/009S - **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. + +### Dreo App credentials are invalid or expired + +If your Dreo App credentials are invalid or expired, you can follow these steps: + +1. Open the Dreo App. Navigate to the account settings section. +2. Click on the "Log out" option if you are currently logged in. +3. Enter your correct username and password. If you have forgotten your password, use the "Forgot password" option in the app to reset it. +4. Once you have successfully logged in to the Dreo App, go back to Home Assistant. Navigate to the Dreo integration settings and re - enter your Dreo App credentials. Then save the settings. + +### Device becomes unresponsive + +If the device becomes unresponsive, try the following steps: + +1. **Power cycle the device**: Turn off the device using its power switch or unplug it from the power source. Wait for about 10 - 15 seconds and then turn it back on or plug it back in. +2. **Check the Wi - Fi connection**: Ensure that the device is connected to a stable Wi - Fi network. You can try moving the device closer to the router to improve the signal strength. +3. **Restart the Dreo App and Home Assistant**: Close the Dreo App completely on your mobile device and restart it. Also, restart your Home Assistant instance. Then try to control the device again. +4. **Reset the device**: If the above steps do not work, you may need to reset the device to its factory settings. Refer to the device's user manual for the specific reset procedure. After resetting, re - add the device to the Dreo App and then to Home Assistant. + +## Firmware update scenarios + +### Updating the device firmware + +1. **Check for updates in the Dreo App**: Open the Dreo App and navigate to the device management section. Select the device you want to update. If there is a firmware update available, the app will prompt you. +2. **Start the update**: Follow the on - screen instructions in the Dreo App to start the firmware update process. Make sure the device is connected to a stable power source and Wi - Fi network during the update. +3. **Wait for the update to complete**: The update process may take several minutes. Do not turn off the device or interrupt the update during this time. +4. **Verify the update**: Once the update is complete, check if the device's features are working as expected. You can also check the device information in the Dreo App to confirm the new firmware version. + +### Issues during firmware update + +- **Update fails**: If the firmware update fails, check your network connection. Try restarting the device, the Dreo App, and your Wi - Fi router. Then attempt the update again. +- **Device becomes unresponsive after update**: If the device becomes unresponsive after the firmware update, perform a power cycle on the device. If the problem persists, reset the device to its factory settings and re - add it to the Dreo App and Home Assistant. \ No newline at end of file From a5eadaa7d7ae04a597836c00f7db8faf290a758d Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Thu, 6 Feb 2025 11:16:03 +0800 Subject: [PATCH 09/26] Modify the documentation to add instructions for device and app upgrades. --- source/_integrations/dreo.markdown | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index e036fbfe9eb0..5623306aa127 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -88,16 +88,16 @@ If your Dreo App credentials are invalid or expired, you can follow these steps: 1. Open the Dreo App. Navigate to the account settings section. 2. Click on the "Log out" option if you are currently logged in. 3. Enter your correct username and password. If you have forgotten your password, use the "Forgot password" option in the app to reset it. -4. Once you have successfully logged in to the Dreo App, go back to Home Assistant. Navigate to the Dreo integration settings and re - enter your Dreo App credentials. Then save the settings. +4. Once you have successfully logged in to the Dreo App, go back to Home Assistant. Navigate to the Dreo integration settings and re-enter your Dreo App credentials. Then save the settings. ### Device becomes unresponsive If the device becomes unresponsive, try the following steps: -1. **Power cycle the device**: Turn off the device using its power switch or unplug it from the power source. Wait for about 10 - 15 seconds and then turn it back on or plug it back in. -2. **Check the Wi - Fi connection**: Ensure that the device is connected to a stable Wi - Fi network. You can try moving the device closer to the router to improve the signal strength. +1. **Power cycle the device**: Turn off the device using its power switch or unplug it from the power source. Wait for about 10-15 seconds and then turn it back on or plug it back in. +2. **Check the Wi-Fi connection**: Ensure that the device is connected to a stable Wi - Fi network. You can try moving the device closer to the router to improve the signal strength. 3. **Restart the Dreo App and Home Assistant**: Close the Dreo App completely on your mobile device and restart it. Also, restart your Home Assistant instance. Then try to control the device again. -4. **Reset the device**: If the above steps do not work, you may need to reset the device to its factory settings. Refer to the device's user manual for the specific reset procedure. After resetting, re - add the device to the Dreo App and then to Home Assistant. +4. **Reset the device**: If the above steps do not work, you may need to reset the device to its factory settings. Refer to the device's user manual for the specific reset procedure. After resetting, re-add the device to the Dreo App and then to Home Assistant. ## Firmware update scenarios @@ -110,5 +110,5 @@ If the device becomes unresponsive, try the following steps: ### Issues during firmware update -- **Update fails**: If the firmware update fails, check your network connection. Try restarting the device, the Dreo App, and your Wi - Fi router. Then attempt the update again. -- **Device becomes unresponsive after update**: If the device becomes unresponsive after the firmware update, perform a power cycle on the device. If the problem persists, reset the device to its factory settings and re - add it to the Dreo App and Home Assistant. \ No newline at end of file +- **Update fails**: If the firmware update fails, check your network connection. Try restarting the device, the Dreo App, and your Wi-Fi router. Then attempt the update again. +- **Device becomes unresponsive after update**: If the device becomes unresponsive after the firmware update, perform a power cycle on the device. If the problem persists, reset the device to its factory settings and re-add it to the Dreo App and Home Assistant. \ No newline at end of file From 5a59991748c22933e5e1a30df938233a939ba5c1 Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Thu, 6 Feb 2025 11:40:26 +0800 Subject: [PATCH 10/26] Optimize the document --- source/_integrations/dreo.markdown | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index 5623306aa127..8edff6a0a2b2 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -27,7 +27,7 @@ This integration supports devices controllable by the Dreo App. The following de #### General Features - **Sleep Mode**: All models can adjust the fan speed smoothly in the "sleep" mode. However, some models (such as DR-HTF001S) perform better in terms of adjustment smoothness, providing a more stable and quiet environment for sleeping. -- **Wide-Angle Oscillation**: Fans generally offer a wide oscillation function. However, ensuring better and more even air circulation, especially in larger spaces. +- **Wide-Angle Oscillation**: Fans are typically equipped with a wide oscillation function, which ensures more even air circulation—especially in larger spaces. - **Intelligent Auto Mode**: The "auto" mode of each model can adjust the fan speed based on temperature and humidity. For example, providing a more precise and personalized comfort experience. - **Child Lock Function**: Many fans are equipped with a child lock. better preventing accidental setting changes and ensuring the safety of households with children. - **Fast Speed Adjustment Response**: Most fans have a fast speed adjustment response time. allowing you to quickly change the fan speed as needed. @@ -35,7 +35,7 @@ This integration supports devices controllable by the Dreo App. The following de - **Energy-Efficient Motor**: Many fans are equipped with energy-efficient motors. saving more electricity costs while providing strong airflow. - **Long Timer Setting**: Most fans offer a timer setting of up to 12 hours. giving you more flexibility in scheduling the fan's operation. -The supported models include: DR-HTF001S、DR-HTF002S、DR-HTF005S、DR-HTF007S、DR-HTF008S、DR-HTF009S、DR-HTF010S. +The supported models include: DR-HTF001S, DR-HTF002S, DR-HTF005S, DR-HTF007S, DR-HTF008S, DR-HTF009S, DR-HTF010S. #### Different Features @@ -66,13 +66,13 @@ Dreo Tower Fan will expose the following details depending on the features suppo | `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 +All attributes are supported by models: DR-HTF001S, DR-HTF002S, DR-HTF004S, DR-HTF005S, DR-HTF007S, DR-HTF008S, DR-HTF009S, DR-HTF010S ## 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. +- **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. @@ -94,8 +94,8 @@ If your Dreo App credentials are invalid or expired, you can follow these steps: If the device becomes unresponsive, try the following steps: -1. **Power cycle the device**: Turn off the device using its power switch or unplug it from the power source. Wait for about 10-15 seconds and then turn it back on or plug it back in. -2. **Check the Wi-Fi connection**: Ensure that the device is connected to a stable Wi - Fi network. You can try moving the device closer to the router to improve the signal strength. +1. **Power cycle the device**: Turn off the device using its power switch or unplug it from the power source. Wait for about 10–15 seconds and then turn it back on or plug it back in. +2. **Check the Wi-Fi connection**: Ensure that the device is connected to a stable Wi-Fi network. You can try moving the device closer to the router to improve the signal strength. 3. **Restart the Dreo App and Home Assistant**: Close the Dreo App completely on your mobile device and restart it. Also, restart your Home Assistant instance. Then try to control the device again. 4. **Reset the device**: If the above steps do not work, you may need to reset the device to its factory settings. Refer to the device's user manual for the specific reset procedure. After resetting, re-add the device to the Dreo App and then to Home Assistant. From 4c2d831ccf71d18a9f30eaf43ca5f5afd61d118e Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Thu, 6 Feb 2025 13:48:21 +0800 Subject: [PATCH 11/26] modify fans general features descriptions --- source/_integrations/dreo.markdown | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index 8edff6a0a2b2..509bc90a8cb0 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -28,11 +28,11 @@ This integration supports devices controllable by the Dreo App. The following de - **Sleep Mode**: All models can adjust the fan speed smoothly in the "sleep" mode. However, some models (such as DR-HTF001S) perform better in terms of adjustment smoothness, providing a more stable and quiet environment for sleeping. - **Wide-Angle Oscillation**: Fans are typically equipped with a wide oscillation function, which ensures more even air circulation—especially in larger spaces. -- **Intelligent Auto Mode**: The "auto" mode of each model can adjust the fan speed based on temperature and humidity. For example, providing a more precise and personalized comfort experience. -- **Child Lock Function**: Many fans are equipped with a child lock. better preventing accidental setting changes and ensuring the safety of households with children. -- **Fast Speed Adjustment Response**: Most fans have a fast speed adjustment response time. allowing you to quickly change the fan speed as needed. -- **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants. facilitating a wider range of hands-free operations. -- **Energy-Efficient Motor**: Many fans are equipped with energy-efficient motors. saving more electricity costs while providing strong airflow. +- **Intelligent Auto Mode**: The "auto" mode of each model can adjust the fan speed based on temperature and humidity. For example, it provides a more precise and personalized comfort experience.. +- **Child Lock Function**: Many fans include a child lock that helps prevent accidental setting changes and enhances household safety. +- **Fast Speed Adjustment Response**: Most fans offer a rapid speed-adjustment response time, enabling you to swiftly alter the fan speed according to your requirements. +- **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants which facilitates a wider range of hands-free operations +- **Energy-Efficient Motor**: Many fans come with an energy-efficient motor that reduces electricity costs while delivering strong airflow. - **Long Timer Setting**: Most fans offer a timer setting of up to 12 hours. giving you more flexibility in scheduling the fan's operation. The supported models include: DR-HTF001S, DR-HTF002S, DR-HTF005S, DR-HTF007S, DR-HTF008S, DR-HTF009S, DR-HTF010S. @@ -72,7 +72,7 @@ All attributes are supported by models: DR-HTF001S, DR-HTF002S, DR-HTF004S, DR-H ### 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. @@ -104,11 +104,11 @@ If the device becomes unresponsive, try the following steps: ### Updating the device firmware 1. **Check for updates in the Dreo App**: Open the Dreo App and navigate to the device management section. Select the device you want to update. If there is a firmware update available, the app will prompt you. -2. **Start the update**: Follow the on - screen instructions in the Dreo App to start the firmware update process. Make sure the device is connected to a stable power source and Wi - Fi network during the update. +2. **Start the update**: Follow the on-screen instructions in the Dreo App to start the firmware update process. Make sure the device is connected to a stable power source and Wi-Fi network during the update. 3. **Wait for the update to complete**: The update process may take several minutes. Do not turn off the device or interrupt the update during this time. 4. **Verify the update**: Once the update is complete, check if the device's features are working as expected. You can also check the device information in the Dreo App to confirm the new firmware version. ### Issues during firmware update - **Update fails**: If the firmware update fails, check your network connection. Try restarting the device, the Dreo App, and your Wi-Fi router. Then attempt the update again. -- **Device becomes unresponsive after update**: If the device becomes unresponsive after the firmware update, perform a power cycle on the device. If the problem persists, reset the device to its factory settings and re-add it to the Dreo App and Home Assistant. \ No newline at end of file +- **Device becomes unresponsive after update**: If the device becomes unresponsive after the firmware update, perform a power cycle on the device. If the problem persists, reset the device to its factory settings and re-add it to the Dreo App and Home Assistant. From 08bb6b124ca6e61e7a511d851b5f06fab1ec6304 Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Thu, 6 Feb 2025 14:02:30 +0800 Subject: [PATCH 12/26] Modify fan general features Long Timer Setting description --- 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 509bc90a8cb0..e580689ec240 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -28,12 +28,12 @@ This integration supports devices controllable by the Dreo App. The following de - **Sleep Mode**: All models can adjust the fan speed smoothly in the "sleep" mode. However, some models (such as DR-HTF001S) perform better in terms of adjustment smoothness, providing a more stable and quiet environment for sleeping. - **Wide-Angle Oscillation**: Fans are typically equipped with a wide oscillation function, which ensures more even air circulation—especially in larger spaces. -- **Intelligent Auto Mode**: The "auto" mode of each model can adjust the fan speed based on temperature and humidity. For example, it provides a more precise and personalized comfort experience.. +- **Intelligent Auto Mode**: The "auto" mode of each model can adjust the fan speed based on temperature and humidity. For example, it provides a more precise and personalized comfort experience. - **Child Lock Function**: Many fans include a child lock that helps prevent accidental setting changes and enhances household safety. - **Fast Speed Adjustment Response**: Most fans offer a rapid speed-adjustment response time, enabling you to swiftly alter the fan speed according to your requirements. - **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants which facilitates a wider range of hands-free operations - **Energy-Efficient Motor**: Many fans come with an energy-efficient motor that reduces electricity costs while delivering strong airflow. -- **Long Timer Setting**: Most fans offer a timer setting of up to 12 hours. giving you more flexibility in scheduling the fan's operation. +- **Long Timer Setting**: Most fans offer a timer setting of up to 12 hours, which gives you more flexibility in scheduling the fan's operation. The supported models include: DR-HTF001S, DR-HTF002S, DR-HTF005S, DR-HTF007S, DR-HTF008S, DR-HTF009S, DR-HTF010S. From 2823c5c0a5c04d5f78dd4f448ac3630b135936ac Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Thu, 6 Feb 2025 14:11:08 +0800 Subject: [PATCH 13/26] Add comma to sentence --- 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 e580689ec240..2c8d9ec1a638 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -31,7 +31,7 @@ This integration supports devices controllable by the Dreo App. The following de - **Intelligent Auto Mode**: The "auto" mode of each model can adjust the fan speed based on temperature and humidity. For example, it provides a more precise and personalized comfort experience. - **Child Lock Function**: Many fans include a child lock that helps prevent accidental setting changes and enhances household safety. - **Fast Speed Adjustment Response**: Most fans offer a rapid speed-adjustment response time, enabling you to swiftly alter the fan speed according to your requirements. -- **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants which facilitates a wider range of hands-free operations +- **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants which facilitates a wider range of hands-free operations. - **Energy-Efficient Motor**: Many fans come with an energy-efficient motor that reduces electricity costs while delivering strong airflow. - **Long Timer Setting**: Most fans offer a timer setting of up to 12 hours, which gives you more flexibility in scheduling the fan's operation. @@ -72,7 +72,7 @@ All attributes are supported by models: DR-HTF001S, DR-HTF002S, DR-HTF004S, DR-H ### 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. From 1a8193f68d12a46d5a09fd34e141d51dfab9b1fd Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Thu, 6 Feb 2025 14:23:34 +0800 Subject: [PATCH 14/26] Modify device not discovered description --- package-lock.json | 7 +++++++ package.json | 3 +++ source/_integrations/dreo.markdown | 2 +- 3 files changed, 11 insertions(+), 1 deletion(-) diff --git a/package-lock.json b/package-lock.json index f3f4f98e859d..e0c8cdb0c72e 100644 --- a/package-lock.json +++ b/package-lock.json @@ -7,6 +7,9 @@ "": { "name": "home-assistant.io", "version": "1.0.0", + "dependencies": { + "home-assistant.io": "file:" + }, "devDependencies": { "remark-cli": "^12.0.1", "remark-frontmatter": "^5.0.0", @@ -1617,6 +1620,10 @@ "node": ">=8" } }, + "node_modules/home-assistant.io": { + "resolved": "", + "link": true + }, "node_modules/hosted-git-info": { "version": "2.8.9", "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.8.9.tgz", diff --git a/package.json b/package.json index f9746eb28535..c3cdb2df918d 100644 --- a/package.json +++ b/package.json @@ -27,5 +27,8 @@ "markdown:lint": "remark --quiet --frail .", "textlint:all": "textlint source", "textlint": "textlint source/_docs source/_faq source/_integrations source/_dashboards source/cloud source/getting-started source/hassio source/dashboards" + }, + "dependencies": { + "home-assistant.io": "file:" } } diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index 2c8d9ec1a638..e68e56c48d75 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -31,7 +31,7 @@ This integration supports devices controllable by the Dreo App. The following de - **Intelligent Auto Mode**: The "auto" mode of each model can adjust the fan speed based on temperature and humidity. For example, it provides a more precise and personalized comfort experience. - **Child Lock Function**: Many fans include a child lock that helps prevent accidental setting changes and enhances household safety. - **Fast Speed Adjustment Response**: Most fans offer a rapid speed-adjustment response time, enabling you to swiftly alter the fan speed according to your requirements. -- **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants which facilitates a wider range of hands-free operations. +- **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants, which facilitates a wider range of hands-free operations. - **Energy-Efficient Motor**: Many fans come with an energy-efficient motor that reduces electricity costs while delivering strong airflow. - **Long Timer Setting**: Most fans offer a timer setting of up to 12 hours, which gives you more flexibility in scheduling the fan's operation. From e655759550c3a66bef3166e51d2fe5823cfb4953 Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Thu, 6 Feb 2025 14:28:21 +0800 Subject: [PATCH 15/26] Modify device not discovered description --- 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 2c8d9ec1a638..e68e56c48d75 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -31,7 +31,7 @@ This integration supports devices controllable by the Dreo App. The following de - **Intelligent Auto Mode**: The "auto" mode of each model can adjust the fan speed based on temperature and humidity. For example, it provides a more precise and personalized comfort experience. - **Child Lock Function**: Many fans include a child lock that helps prevent accidental setting changes and enhances household safety. - **Fast Speed Adjustment Response**: Most fans offer a rapid speed-adjustment response time, enabling you to swiftly alter the fan speed according to your requirements. -- **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants which facilitates a wider range of hands-free operations. +- **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants, which facilitates a wider range of hands-free operations. - **Energy-Efficient Motor**: Many fans come with an energy-efficient motor that reduces electricity costs while delivering strong airflow. - **Long Timer Setting**: Most fans offer a timer setting of up to 12 hours, which gives you more flexibility in scheduling the fan's operation. From 145a23fa6ded3e62a48275a4e4e8d9d7fc99663e Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Thu, 6 Feb 2025 14:49:24 +0800 Subject: [PATCH 16/26] Optimization sentence --- 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 2c8d9ec1a638..e68e56c48d75 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -31,7 +31,7 @@ This integration supports devices controllable by the Dreo App. The following de - **Intelligent Auto Mode**: The "auto" mode of each model can adjust the fan speed based on temperature and humidity. For example, it provides a more precise and personalized comfort experience. - **Child Lock Function**: Many fans include a child lock that helps prevent accidental setting changes and enhances household safety. - **Fast Speed Adjustment Response**: Most fans offer a rapid speed-adjustment response time, enabling you to swiftly alter the fan speed according to your requirements. -- **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants which facilitates a wider range of hands-free operations. +- **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants, which facilitates a wider range of hands-free operations. - **Energy-Efficient Motor**: Many fans come with an energy-efficient motor that reduces electricity costs while delivering strong airflow. - **Long Timer Setting**: Most fans offer a timer setting of up to 12 hours, which gives you more flexibility in scheduling the fan's operation. From 0448e2ff13b7a475f6bcd3635fc63bd6a2448aca Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Thu, 6 Feb 2025 14:51:10 +0800 Subject: [PATCH 17/26] Add comma to sentence --- 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 e68e56c48d75..29b4deb8ca07 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -31,7 +31,7 @@ This integration supports devices controllable by the Dreo App. The following de - **Intelligent Auto Mode**: The "auto" mode of each model can adjust the fan speed based on temperature and humidity. For example, it provides a more precise and personalized comfort experience. - **Child Lock Function**: Many fans include a child lock that helps prevent accidental setting changes and enhances household safety. - **Fast Speed Adjustment Response**: Most fans offer a rapid speed-adjustment response time, enabling you to swiftly alter the fan speed according to your requirements. -- **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants, which facilitates a wider range of hands-free operations. +- **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants,which facilitates a wider range of hands-free operations. - **Energy-Efficient Motor**: Many fans come with an energy-efficient motor that reduces electricity costs while delivering strong airflow. - **Long Timer Setting**: Most fans offer a timer setting of up to 12 hours, which gives you more flexibility in scheduling the fan's operation. From 9fee07c56b425f508185d57c173e2ae7c7637414 Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Thu, 6 Feb 2025 15:01:58 +0800 Subject: [PATCH 18/26] Remove outlets description --- 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 e68e56c48d75..e996ca0c1a4f 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -10,7 +10,7 @@ ha_platforms: ha_integration_type: integration --- -The Dreo integration enables you to control smart switches and outlets connected to the Dreo App. +The Dreo integration enables you to control smart switches connected to the Dreo App. The devices must be added to the Dreo App before this integration can discover them. From a03d8a274a75c72774e62f8ee65600ee5159c655 Mon Sep 17 00:00:00 2001 From: "Brooke.Wang" Date: Thu, 6 Feb 2025 15:06:30 +0800 Subject: [PATCH 19/26] Model-Specific Features --- 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 e996ca0c1a4f..222ae59f8ff8 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -37,7 +37,7 @@ This integration supports devices controllable by the Dreo App. The following de The supported models include: DR-HTF001S, DR-HTF002S, DR-HTF005S, DR-HTF007S, DR-HTF008S, DR-HTF009S, DR-HTF010S. -#### Different Features +#### Model-Specific Features - **Wide-Angle Oscillation**: Generally, fans are equipped with a wide-angle oscillation function. However, the fan of model DR-HTF004S distinguishes itself with its remarkable performance. It offers an oscillation range of up to 120 degrees, and its oscillation mechanism is precisely engineered to ensure a more uniform and efficient air circulation. This feature is particularly advantageous in larger spaces, effectively spreading fresh air across the area. From d241f98d57b6071185fc4821098c712c76932979 Mon Sep 17 00:00:00 2001 From: wangdequan Date: Thu, 13 Mar 2025 13:43:03 +0800 Subject: [PATCH 20/26] Modify Dreo document --- source/_integrations/dreo.markdown | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index 222ae59f8ff8..3c7d44e42f36 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -1,6 +1,6 @@ --- title: Dreo -description: Instructions on how to set up Dreo fans within Home Assistant. +description: Instructions on how to set up Dreo products within Home Assistant. ha_category: - Fan ha_release: 2024.12 @@ -10,7 +10,7 @@ ha_platforms: ha_integration_type: integration --- -The Dreo integration enables you to control smart switches connected to the Dreo App. +The **Dreo** {% term integration %} enables you to control smart switches connected to the [Dreo App](https://m.dreo.com/en). The devices must be added to the Dreo App before this integration can discover them. @@ -48,13 +48,10 @@ The supported models include: DR-HTF004S 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 +{% include integrations/config_flow.md %} + +{% include integrations/remove_device_service.md %} -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 From b52cf2d813c7fc8ecc1d27b0e7e816a5fd496a90 Mon Sep 17 00:00:00 2001 From: wangdequan Date: Fri, 21 Mar 2025 13:58:42 +0800 Subject: [PATCH 21/26] Modify Dreo markdown "smart switches" description to "smart products" --- source/_integrations/dreo.markdown | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index 3c7d44e42f36..364bd583c970 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -10,7 +10,7 @@ ha_platforms: ha_integration_type: integration --- -The **Dreo** {% term integration %} enables you to control smart switches connected to the [Dreo App](https://m.dreo.com/en). +The **Dreo** {% term integration %} enables you to control smart products connected to the [Dreo App](https://m.dreo.com/en). The devices must be added to the Dreo App before this integration can discover them. @@ -52,7 +52,6 @@ Dreo App. Once registration is complete, you can add the Dreo integration in Hom {% include integrations/remove_device_service.md %} - ## Fan exposed attributes Dreo Tower Fan will expose the following details depending on the features supported by the model: From 187ea725181e0b7f55ff7da67cced471a34e5bb4 Mon Sep 17 00:00:00 2001 From: wangdequan <847566734@qq.com> Date: Sun, 20 Apr 2025 18:35:48 +0800 Subject: [PATCH 22/26] Modify document --- source/_integrations/dreo.markdown | 31 ++++++------------------------ 1 file changed, 6 insertions(+), 25 deletions(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index 364bd583c970..102f6605d151 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -10,7 +10,7 @@ ha_platforms: ha_integration_type: integration --- -The **Dreo** {% term integration %} enables you to control smart products connected to the [Dreo App](https://m.dreo.com/en). +The **Dreo** {% term integration %} enables you to control smart products connected to the [Dreo App](https://m.dreo.com/en) from [Dreo](https://www.dreo.com/). The devices must be added to the Dreo App before this integration can discover them. @@ -26,12 +26,10 @@ This integration supports devices controllable by the Dreo App. The following de #### General Features -- **Sleep Mode**: All models can adjust the fan speed smoothly in the "sleep" mode. However, some models (such as DR-HTF001S) perform better in terms of adjustment smoothness, providing a more stable and quiet environment for sleeping. -- **Wide-Angle Oscillation**: Fans are typically equipped with a wide oscillation function, which ensures more even air circulation—especially in larger spaces. +- **Sleep Mode**: All models support a "sleep" preset mode that adjusts the fan speed smoothly. However, some models (such as DR-HTF001S) perform better in terms of adjustment smoothness, providing a more stable and quiet environment for sleeping. +- **Wide-Angle Oscillation**: Fans are typically equipped with a wide oscillation function, which ensures more even air circulation — especially in larger spaces. - **Intelligent Auto Mode**: The "auto" mode of each model can adjust the fan speed based on temperature and humidity. For example, it provides a more precise and personalized comfort experience. -- **Child Lock Function**: Many fans include a child lock that helps prevent accidental setting changes and enhances household safety. - **Fast Speed Adjustment Response**: Most fans offer a rapid speed-adjustment response time, enabling you to swiftly alter the fan speed according to your requirements. -- **Multi-Voice Assistant Integration**: Many models support integration with a wider range of voice assistants, which facilitates a wider range of hands-free operations. - **Energy-Efficient Motor**: Many fans come with an energy-efficient motor that reduces electricity costs while delivering strong airflow. - **Long Timer Setting**: Most fans offer a timer setting of up to 12 hours, which gives you more flexibility in scheduling the fan's operation. @@ -69,13 +67,11 @@ All attributes are supported by models: DR-HTF001S, DR-HTF002S, DR-HTF004S, DR-H ### 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. +- **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 to see if the state updates. +- **App Version Mismatch**: Ensure that the Dreo App is running an up-to-date version. An outdated version could lead to compatibility issues and control problems. Update the Dreo App from the official app store for your device. ### Dreo App credentials are invalid or expired @@ -92,19 +88,4 @@ If the device becomes unresponsive, try the following steps: 1. **Power cycle the device**: Turn off the device using its power switch or unplug it from the power source. Wait for about 10–15 seconds and then turn it back on or plug it back in. 2. **Check the Wi-Fi connection**: Ensure that the device is connected to a stable Wi-Fi network. You can try moving the device closer to the router to improve the signal strength. -3. **Restart the Dreo App and Home Assistant**: Close the Dreo App completely on your mobile device and restart it. Also, restart your Home Assistant instance. Then try to control the device again. -4. **Reset the device**: If the above steps do not work, you may need to reset the device to its factory settings. Refer to the device's user manual for the specific reset procedure. After resetting, re-add the device to the Dreo App and then to Home Assistant. - -## Firmware update scenarios - -### Updating the device firmware - -1. **Check for updates in the Dreo App**: Open the Dreo App and navigate to the device management section. Select the device you want to update. If there is a firmware update available, the app will prompt you. -2. **Start the update**: Follow the on-screen instructions in the Dreo App to start the firmware update process. Make sure the device is connected to a stable power source and Wi-Fi network during the update. -3. **Wait for the update to complete**: The update process may take several minutes. Do not turn off the device or interrupt the update during this time. -4. **Verify the update**: Once the update is complete, check if the device's features are working as expected. You can also check the device information in the Dreo App to confirm the new firmware version. - -### Issues during firmware update - -- **Update fails**: If the firmware update fails, check your network connection. Try restarting the device, the Dreo App, and your Wi-Fi router. Then attempt the update again. -- **Device becomes unresponsive after update**: If the device becomes unresponsive after the firmware update, perform a power cycle on the device. If the problem persists, reset the device to its factory settings and re-add it to the Dreo App and Home Assistant. +3. **Reset the device**: If the above steps do not work, you may need to reset the device to its factory settings. Refer to the device's user manual for the specific reset procedure. After resetting, re-add the device to the Dreo App and then to Home Assistant. From 72202b4bcc78e4e96bf93bad82511f4f8abb27e7 Mon Sep 17 00:00:00 2001 From: wangdequan <847566734@qq.com> Date: Sun, 20 Apr 2025 21:04:23 +0800 Subject: [PATCH 23/26] Modify the document to describe the device functionality in the Home Assistant integration --- source/_integrations/dreo.markdown | 22 ++++++++-------------- 1 file changed, 8 insertions(+), 14 deletions(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index 102f6605d151..333b7e7b860b 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -24,22 +24,14 @@ This integration supports devices controllable by the Dreo App. The following de ### Fans -#### General Features +This integration supports controlling Dreo fan devices with the following functionality: -- **Sleep Mode**: All models support a "sleep" preset mode that adjusts the fan speed smoothly. However, some models (such as DR-HTF001S) perform better in terms of adjustment smoothness, providing a more stable and quiet environment for sleeping. -- **Wide-Angle Oscillation**: Fans are typically equipped with a wide oscillation function, which ensures more even air circulation — especially in larger spaces. -- **Intelligent Auto Mode**: The "auto" mode of each model can adjust the fan speed based on temperature and humidity. For example, it provides a more precise and personalized comfort experience. -- **Fast Speed Adjustment Response**: Most fans offer a rapid speed-adjustment response time, enabling you to swiftly alter the fan speed according to your requirements. -- **Energy-Efficient Motor**: Many fans come with an energy-efficient motor that reduces electricity costs while delivering strong airflow. -- **Long Timer Setting**: Most fans offer a timer setting of up to 12 hours, which gives you more flexibility in scheduling the fan's operation. +- **On/Off**: Turn the fan on or off. +- **Speed Levels**: Adjust fan speed. Range varies by model (typically 1-4, 1-6, 1-9, or 1-12 depending on the device). +- **Preset Modes**: Select between available preset modes including "manual", "auto", and "sleep". +- **Oscillation**: Enable or disable the oscillation feature. -The supported models include: DR-HTF001S, DR-HTF002S, DR-HTF005S, DR-HTF007S, DR-HTF008S, DR-HTF009S, DR-HTF010S. - -#### Model-Specific Features - -- **Wide-Angle Oscillation**: Generally, fans are equipped with a wide-angle oscillation function. However, the fan of model DR-HTF004S distinguishes itself with its remarkable performance. It offers an oscillation range of up to 120 degrees, and its oscillation mechanism is precisely engineered to ensure a more uniform and efficient air circulation. This feature is particularly advantageous in larger spaces, effectively spreading fresh air across the area. - -The supported models include: DR-HTF004S +The supported models include: DR-HTF001S, DR-HTF002S, DR-HTF004S, DR-HTF005S, DR-HTF007S, DR-HTF008S, DR-HTF009S, DR-HTF010S. ## Prerequisite @@ -48,6 +40,8 @@ Dreo App. Once registration is complete, you can add the Dreo integration in Hom {% include integrations/config_flow.md %} +## Removing the integration + {% include integrations/remove_device_service.md %} ## Fan exposed attributes From e960c47fb7f173c83eb49b964d9ae0f2ce0a37c2 Mon Sep 17 00:00:00 2001 From: wangdequan <847566734@qq.com> Date: Sun, 20 Apr 2025 21:10:41 +0800 Subject: [PATCH 24/26] Modify ducoment --- source/_integrations/dreo.markdown | 40 ++++++++++++------------------ 1 file changed, 16 insertions(+), 24 deletions(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index 333b7e7b860b..6d1b65cfbb1b 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -18,20 +18,26 @@ The following platforms are supported: - **fan** -## Supported devices +## Supported functionality -This integration supports devices controllable by the Dreo App. The following devices are supported by this integration: +### Entities -### Fans +The Dreo integration provides the following entities: -This integration supports controlling Dreo fan devices with the following functionality: +#### Fans -- **On/Off**: Turn the fan on or off. -- **Speed Levels**: Adjust fan speed. Range varies by model (typically 1-4, 1-6, 1-9, or 1-12 depending on the device). -- **Preset Modes**: Select between available preset modes including "manual", "auto", and "sleep". -- **Oscillation**: Enable or disable the oscillation feature. - -The supported models include: DR-HTF001S, DR-HTF002S, DR-HTF004S, DR-HTF005S, DR-HTF007S, DR-HTF008S, DR-HTF009S, DR-HTF010S. +- **Fan** + - **Description**: Control your Dreo fan device. + - **Functionality**: + - Turn the fan on/off + - Adjust fan speed (ranges vary by model: 1-4, 1-6, 1-9, or 1-12) + - Select preset modes ("manual", "auto", "sleep") + - Enable/disable oscillation + - **Available for models**: DR-HTF001S, DR-HTF002S, DR-HTF004S, DR-HTF005S, DR-HTF007S, DR-HTF008S, DR-HTF009S, DR-HTF010S + - **Attributes**: + - `mode` - The current mode the device is in ("manual", "auto", "sleep") + - `speed` - The current speed setting + - `oscillate` - Whether oscillation is enabled (true/false) ## Prerequisite @@ -40,22 +46,8 @@ Dreo App. Once registration is complete, you can add the Dreo integration in Hom {% include integrations/config_flow.md %} -## Removing the integration - {% include integrations/remove_device_service.md %} -## 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, DR-HTF002S, DR-HTF004S, DR-HTF005S, DR-HTF007S, DR-HTF008S, DR-HTF009S, DR-HTF010S - ## Troubleshooting ### Device not discovered From 7018b775832d71816d688653c0851c2cae9b857e Mon Sep 17 00:00:00 2001 From: wangdequan <847566734@qq.com> Date: Sun, 20 Apr 2025 21:25:17 +0800 Subject: [PATCH 25/26] Modify document --- source/_integrations/dreo.markdown | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index 6d1b65cfbb1b..ecbbb669c502 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -46,6 +46,8 @@ Dreo App. Once registration is complete, you can add the Dreo integration in Hom {% include integrations/config_flow.md %} +## Removing the integration + {% include integrations/remove_device_service.md %} ## Troubleshooting From 7128ed7dbefbfb23f2d2a10a6d42fe0e41e7057b Mon Sep 17 00:00:00 2001 From: wangdequan Date: Mon, 21 Apr 2025 09:55:41 +0800 Subject: [PATCH 26/26] Modify document --- source/_integrations/dreo.markdown | 18 +++++++----------- 1 file changed, 7 insertions(+), 11 deletions(-) diff --git a/source/_integrations/dreo.markdown b/source/_integrations/dreo.markdown index ecbbb669c502..3af0d43c8f7e 100644 --- a/source/_integrations/dreo.markdown +++ b/source/_integrations/dreo.markdown @@ -14,7 +14,7 @@ The **Dreo** {% term integration %} enables you to control smart products connec The devices must be added to the Dreo App before this integration can discover them. -The following platforms are supported: +Supported platforms: - **fan** @@ -29,33 +29,29 @@ The Dreo integration provides the following entities: - **Fan** - **Description**: Control your Dreo fan device. - **Functionality**: - - Turn the fan on/off - - Adjust fan speed (ranges vary by model: 1-4, 1-6, 1-9, or 1-12) - - Select preset modes ("manual", "auto", "sleep") - - Enable/disable oscillation + - Turn on/off + - Set fan speed + - Toggle oscillation + - Select preset modes - **Available for models**: DR-HTF001S, DR-HTF002S, DR-HTF004S, DR-HTF005S, DR-HTF007S, DR-HTF008S, DR-HTF009S, DR-HTF010S - **Attributes**: - `mode` - The current mode the device is in ("manual", "auto", "sleep") - `speed` - The current speed setting - `oscillate` - Whether oscillation is enabled (true/false) -## Prerequisite +## Prerequisites 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. {% include integrations/config_flow.md %} -## Removing the integration +## Remove the integration {% include integrations/remove_device_service.md %} ## 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. - ### 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 to see if the state updates.