SMARWI Integration

Home Assistant integration for Vektiva SMARWI 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.
2. Go to HACS > Integrations.
3. Click on the hamburger menu in the top right corner, select Custom repositories, and fill in:
   • Repository: https://github.com/jirutka/hass-smarwi/
   • Category: Integration
4. Click on the ⊕ Explore & download repositories button in the bottom right corner, then search for and select SMARWI.
5. Click on the Download button in the bottom right corner.
6. Restart Home Assistant.

TIP: You can skip steps 2–4 by opening:

Manually

1. Download smarwi.zip from the latest release.
2. Unpack smarwi.zip and copy the custom_components/smarwi directory into the custom_components directory of your Home Assistant installation.
3. Restart Home Assistant.

Configuration

1. Set up MQTT broker

1. Set up your MQTT broker, if you don’t already have one (see Choose an MQTT broker if you’re unsure).
2. Add the MQTT integration to your Home Assistant instance (see [mqtt-integration][documentation]).

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).
2. Go to Settings > Advanced, fill domain name or IP address of your local MQTT broker (see above), and click Save.
3. Go to Basic and fill in the following:
   • Device name – this will be used in Home Assistant to identify each SMARWI device;
   • Remote ID – choose any name (no registration needed), but the same for all your SMARWI devices, it will be used as a prefix for MQTT topics (ion/<remote-id>/%<device-id>/+);
   • Remote Key – leave empty;
   • 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).
4. Click on Save.

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

It may be possible that your device will not connect to the MQTT broker anonymously. If that is the case, a user needs to be created in the MQTT broker and the credentials need to be put into the device configuration. The Remote ID acts as the username and the Remote Key acts as the password to the MQTT broker.

3. Add integration

1. Browse to your Home Assistant instance.
2. Go to Settings > Devices & Services.
3. In the bottom right corner, select the ⊕ Add Integration button.
4. From the list, select SMARWI.
5. 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:

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 user manual
• SMARWI API documentation

License

This project is licensed under the MIT License.