hass-smarwi

KO | EN

gitlite — search

#python #hacktoberfest #ai #golang #rust #deep-learning #linux #nodejs #java #cli #awesome-list #security #openai #open-source

(★ 11)

Home Assistant integration for Vektiva SMARWI window opener

hass-smarwi 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SMARWI Integration
<img src="https://raw.githubusercontent.com/jirutka/hass-smarwi/master/custom_components/smarwi/brand/logo.png" width="250px" align="right">

[![GitHub Release][releases-shield]][releases]

Home Assistant integration for Vektiva [SMARWI][smarwi-website] window opener (actuator).

It uses a local MQTT broker, no “cloud” service is required.

## Installation

### Using Home Assistant Community Store (HACS)

1. Ensure that [HACS] is installed.
1. Go to **HACS > Integrations**.
1. Search for and select **SMARWI**.
1. Click on the **Download** button in the bottom right corner.
1. Restart Home Assistant.

**TIP:** You can skip steps 2–3 by opening:

[![Add jirutka/hass-smarwi repository to your Home Assistant instance][my-hacs-repo-img]][my-hacs-repo]

### Manually

1. Download `smarwi.zip` from the [latest release][latest-release].
1. Unpack `smarwi.zip` and copy the `custom_components/smarwi` directory into the `custom_components` directory of your Home Assistant installation.
1. Restart Home Assistant.

## Configuration

### 1. Set up MQTT broker

1. Install the Mosquitto broker app and set up the [MQTT integration][mqtt-integration], if you don’t have it already (see [documentation][mosquitto-addon]).
1. Create a new (MQTT) user for SMARWI. You have two options:
   * Go to **[Settings > Apps > Mosquitto broker][my-hass-mosquitto] > Configuration** and click **Add** below **Logins** to create a local MQTT user,
   * _or_ go to **[Settings > People > Users][my-hass-users]** and click **Add user** to create a Home Assistant user that can be used to connect to MQTT.

> [!IMPORTANT]
> Don’t set a password longer than 18 characters (limitation of SMARWI)!

> [!NOTE]
> You may also use an external Mosquitto broker (or any other MQTT broker), for example, if you are _not_ running Home Assistant Operating System (HAOS).

### 2. Prepare SMARWI devices

For each SMARWI device:

1. Connect to your SMARWI device and open its web interface in the browser (see section 6.1.2 in the [SMARWI manual][smarwi-manual]).
1. Go to **Settings > Advanced**, fill domain name or IP address of your local MQTT broker (i.e. your Home Assistant, if you use the Mosquitto broker app on HAOS), and click **Save**.
1. Go to **Basic** and fill in the following:
   - **Device name** – this will be used in Home Assistant to identify each SMARWI device;
   - **Remote ID** – the MQTT username (use the same for all your SMARWI devices), it will also be used as a prefix for MQTT topics (`ion/<remote-id>/%<device-id>/+`);
   - **Remote Key** – the MQTT password (max 18 characters) or leave empty if you connect to the MQTT broker anonymously;
   - **Wifi Mode** – change to `Client`;
   - **Select Wifi network** – select SSID of your Wi-Fi network;
   - **Wifi Password** – password for your Wi-Fi network (max 32 characters).
1. Click on **Save**.

SMARWI should be connected to your Wi-Fi network and MQTT broker now.

### 3. Add integration

1. Browse to your Home Assistant instance.
1. Go to **Settings > Devices & Services**.
1. In the bottom right corner, select the **⊕ Add Integration** button.
1. From the list, select **SMARWI**.
1. Fill in the **Remote ID** that you choose for your SMARWI devices (see above).

The integration should now automatically detect all your SMARWI devices.

**TIP:** You can skip steps 1–4 by opening:

[![Add SMARWI integration to your Home Assistant instance][my-hass-config-start-img]][my-hass-smarwi]

## Entities

The integration will create the following entities for each discovered SMARWI device.

| Name                | Platform      | Category   | Description
| ------------------- | ------------- | ---------- | --------------------------------------------------------------------------|
| cover               | cover         |            | Control the window tilt position (open, close, stop, set position). |
| ridge_fix           | switch        |            | Fix or release the ridge. |
| ridge_inside        | binary_sensor | diagnostic | Shows if the ridge is inside the device (i.e. it’s operational). |
| rssi                | sensor        | diagnostic | Monitor WiFi signal strength (disabled by default). |
| calibrated_distance | number        | config     | Set calibrated distance (finetune setting, disabled by default). |
| closed_hold_power   | number        | config     | Set closed holding power (finetune setting). |
| closed_position     | number        | config     | Set window closed position finetune (finetune setting). |
| frame_power         | number        | config     | Set near frame power (finetune setting). |
| frame_speed         | number        | config     | Set near frame speed (finetune setting). |
| lock_err_trigger    | number        | config     | Set window locked error trigger (finetune setting). |
| max_open_position   | number        | config     | Set maximum open position (finetune setting). |
| move_power          | number        | config     | Set movement power (finetune setting). |
| move_speed          | number        | config     | Set movement speed (finetune setting). |
| opened_hold_power   | number        | config     | Set opened holding power (finetune setting). |

## Screenshots

## Resources

- [SMARWI product website][smarwi-website]
- [SMARWI user manual][smarwi-manual]
- [SMARWI API documentation][smarwi-api-doc]

## License

This project is licensed under the [MIT License].

[releases]: https://github.com/jirutka/hass-smarwi/releases
[latest-release]: https://github.com/jirutka/hass-smarwi/releases/latest
[releases-shield]: https://img.shields.io/github/release/jirutka/hass-smarwi.svg?style=flat-square
[HACS]: https://hacs.xyz/
[smarwi-website]: https://vektiva.com/index.php/en/
[smarwi-manual]: https://vektiva.com/downloads/SMARWI_manual_EN.pdf
[smarwi-api-doc]: https://vektiva.gitlab.io/vektivadocs/en/api/index.html
[my-hass-smarwi]: https://my.home-assistant.io/redirect/config_flow_start/?domain=smarwi
[my-hass-config-start-img]: https://my.home-assistant.io/badges/config_flow_start.svg
[my-hass-mosquitto]: https://my.home-assistant.io/redirect/supervisor_addon/?addon=core_mosquitto
[my-hass-users]: https://my.home-assistant.io/redirect/users/
[my-hacs-repo]: https://my.home-assistant.io/redirect/hacs_repository/?owner=jirutka&repository=hass-smarwi&category=Integration
[my-hacs-repo-img]: https://my.home-assistant.io/badges/hacs_repository.svg
[mosquitto-addon]: https://github.com/home-assistant/addons/blob/master/mosquitto/DOCS.md
[mqtt-integration]: https://www.home-assistant.io/integrations/mqtt/
[MIT License]: https://opensource.org/license/MIT

hass-smarwi

hass-smarwi 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

hass-smarwi

hass-smarwi 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README