Add documentation for NASweb integration (#28516)

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: lsum <lsum@chomtech.pl>
Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
nasWebio 2024-11-15 15:59:06 +01:00 committed by GitHub
parent 931a1caafe
commit 1624c84b80
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
5 changed files with 54 additions and 0 deletions

View File

@ -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 %}.
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/)
![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 not shown.

After

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 55 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 54 KiB