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 documentation for NASweb integration #28516

Merged
merged 17 commits into from
Nov 15, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 54 additions & 0 deletions source/_integrations/nasweb.markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
---
title: NASweb
description: Integrate NASweb devices
ha_category:
- Switch
ha_release: '2024.11'
ha_codeowners:
- '@nasWebio'
ha_iot_class: Local Push
ha_domain: nasweb
ha_config_flow: true
ha_platforms:
- switch
ha_integration_type: hub
---


The **NASweb** {% term integration %} brings the device's smart home features into **Home Assistant**, converting them into {% term entities %} that users can monitor, control, and incorporate into {% term scripts %} and {% term automations %}.

c0ffeeca7 marked this conversation as resolved.
Show resolved Hide resolved
NASweb combines the functions of a control panel and the ability to manage building automation. The device monitors the flow of information from sensors and programmable switches and stores settings, definitions, and configured actions. [More information.](https://www.chomtech.pl/produkt/naswebio-multisystemowy-sterownik-automatyki-budynkowej/)

c0ffeeca7 marked this conversation as resolved.
Show resolved Hide resolved
![NASweb Smart Home Features Graph](/images/integrations/nasweb/nasweb_scheme.png)

## Prerequisites

Before you can add the NASweb integration to Home Assistant, you need to create a user that has access to the NASweb API.

To create a NASweb user with access to the NASweb API, follow these steps:

1. To log into device **NASweb** page, enter the device IP in your local network:
- `https://<Device IP address>/nasweb` (for example: `https://192.168.117.230/nasweb`)
2. In the top-right corner, select your user and in the pop-up, select **Administrators**.
![Device Dashboard](/images/integrations/nasweb/dashboard.png)
3. Find the user you want to have access to the NASweb API from Home Assistant. Select **Edit**.
- The `admin` user cannot be used for this. Select another user.
![Device Administrators](/images/integrations/nasweb/users.png)
4. In the left **Modules** column, find the **API** module.
5. Click the **API** module to move it into the right-hand column (`1`), which lists modules enabled for this user.
- To save changes, select **Apply** (`2`).
![Administrator User Details](/images/integrations/nasweb/modules.png)

{% include integrations/config_flow.md %}

{% configuration_basic %}
Host:
description: NASweb device address

User:
description: Login of user with enabled API module

Password:
description: Password of user with enabled API module

{% endconfiguration_basic %}
Binary file added source/images/integrations/nasweb/dashboard.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/nasweb/modules.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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/nasweb/users.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.