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 15 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
56 changes: 56 additions & 0 deletions source/_integrations/nasweb.markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
title: NASweb
description: Integrate NASweb devices
ha_category:
- Switch
ha_release: '2024.11'
ha_codeowners:
- '@nasWebio'
ha_iot_class: Local Push
ha_domain: nasweb
featured: true
frenck marked this conversation as resolved.
Show resolved Hide resolved
ha_config_flow: true
ha_platforms:
- switch
ha_integration_type: hub
---
frenck marked this conversation as resolved.
Show resolved Hide resolved


The **NASweb** {% term integration %} brings 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 %}.

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 INFO](https://www.chomtech.pl/produkt/naswebio-multisystemowy-sterownik-automatyki-budynkowej/)
frenck marked this conversation as resolved.
Show resolved Hide resolved

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:
frenck marked this conversation as resolved.
Show resolved Hide resolved
- `https://` + `Device IP` + `/nasweb` (for example: `https://192.168.117.230/nasweb`)
frenck marked this conversation as resolved.
Show resolved Hide resolved
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
frenck marked this conversation as resolved.
Show resolved Hide resolved

Password:
description: Password of user with enabled `API` module
frenck marked this conversation as resolved.
Show resolved Hide resolved

{% 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.