Skip to content
New issue

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

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

Already on GitHub? Sign in to your account

Add new integrated Duwi documentation and three descriptive images #33089

Open
wants to merge 12 commits into
base: next
Choose a base branch
from
Open
71 changes: 71 additions & 0 deletions source/_integrations/duwi.markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
---
title: Duwi
description: The Duwi Integration allows users to easily connect and manage their Duwi Smart devices directly from Home Assistant. Control, monitor, and automate your Duwi Smart-enabled devices like lights, switches, and covers. Simplify your home automation tasks with the Duwi Integration.
ha_category:
- Switch
ha_iot_class: Cloud Push
ha_release: 2024.7
ha_config_flow: true
ha_domain: duwi
ha_codeowners:
- '@duwi2024'
- '@Ledgerbiggg'
ha_platforms:
- switch
ha_integration_type: hub
---

### Prerequisite

To integrate with the Duwi Smart application, please follow these steps:

1. **Obtain Application Key**: You can apply to become a developer for Duwi Smart Home by logging into your account on
the Duwi Smart app and navigating to the "Developer Authentication" section under personal settings. After submitting
your application, you should receive the necessary App Key and App Secret within approximately 1-2 business days.
These credentials will be required on the first page of the configuration flow.
2. **Install the Duwi Smart Application**:
- Download and install the Duwi Smart app.
- Create a new account.
- Add at least one house to your account, making sure it is equipped with available devices.

<p class='img'>
<img src='/images/integrations/duwi/image001.png' alt="Duwi Integration Setup Step 1"/>
<img src='/images/integrations/duwi/image002.png' alt="Duwi Integration Setup Step 2"/>
</p>

{% include integrations/config_flow.md %}

### Obtaining the Login User Code

To synchronize device information from the Duwi Smart system to Home Assistant, obtain a login user code by:

1. Using the App Key and Secret with your phone number and password from the application during the login process.
2. Once logged in successfully, the application will display your house information and device details.
3. Synchronize this information to the Home Assistant system, allowing you to control devices in the Duwi Smart
application directly through Home Assistant.

<p class='img'>
<img src='/images/integrations/duwi/image003.png' alt="Duwi Integration Final Step"/>
</p>

Remember to follow security best practices by not storing or sharing your login information, including your phone
number, password, App Key, and Secret, in any insecure locations.

{% configuration %}
api_key:
description: "Your Duwi Application Key."
required: true
type: string
secret:
description: "Your Application Secret provided by Duwi."
required: true
type: string
phone:
description: "Your phone number used for the Duwi Smart application."
required: true
type: string
password:
description: "Your Duwi Smart application password."
required: true
type: string
{% endconfiguration %}
Binary file added source/images/integrations/duwi/image001.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/images/integrations/duwi/image002.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/images/integrations/duwi/image003.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.