wmswebcontrol adapter for ioBroker

Adapter for Warema WMS Webcontrol

Setup

The adapter supports two connection paths and prefers the local one:

Local (recommended): the adapter finds the WMS controller on the local network automatically (Auto-discovery, on by default). The scan runs in the background and does not delay startup. A discovered IP is written back to Local IP so later starts skip the scan. You can also enter the controller's IP directly under Local IP. Local status is polled every Local polling interval seconds (default 15). The controller's local API needs no login, and this path keeps working even when the Warema cloud or its IoT hub is unavailable.
Cloud: enter your Warema username and password. Used as a fallback when the controller cannot be reached on the LAN, and to look up the controller when the local path is not configured.

You can configure both: the adapter drives the controller locally when it is reachable and falls back to the cloud otherwise. The cloud fallback is only used for a single-controller account (the local controller cannot be matched to a specific one otherwise).

Usage

Local mode (commonCommand)

When the controller is reachable, the adapter builds a local.* tree from its configuration. Every controllable action of a device is exposed as its own state:

local.<device>.position - target position 0..100 % (writable; awning/roller/slat drives).
local.<device>.valance - target position of a separate valance drive, if present (writable).
local.<device>.slatAngle - target slat angle, range per device (writable, blinds only).
local.<device>.dimming - brightness 0..100 % for dimmable lights (writable).
local.<device>.light / .load / .switch - on/off switch (writable).
local.<device>.stop - button, stops the current movement (writable).
local.<device>.identify - button, identifies the device (writable).
local.<device>.drivingCause / .heartbeatError / .blocking - status (read-only).
local.<device>.connected - reachability (read-only): false on a heartbeat error, while blocking, or when the device returns no status (asleep or out of radio range).
local.scenes.<scene> - button, runs the scene (writable).

The exact set of states per device depends on the actions the controller reports for it.

Cloud mode (legacy)

When only the cloud path is available, the adapter exposes the controller's devices, scenes and channels. To control a channel change the *Convert values, e.g.:

wmswebcontrol.0.Markise+XXXX.setting0Convert

wmswebcontrol.0.LED+XXXXXXX.setting1Convert

wmswebcontrol.0.Markise.setting2Convert

Changelog

1.0.1 (2026-10-07)

retry transient local status errors (0x50005/0x50004) up to three times so intermittently reachable devices (e.g. awnings) report their state far more reliably
add a per-device local.<device>.connected state (false on a heartbeat error, while blocking, or when the device returns no status)
log local command sends, confirmations and ignored writes; retry idempotent commands
log the local discovery retry cadence

1.0.0 (2026-09-23)

add local commonCommand control (IP or auto-discovery), preferred over the cloud with a cloud fallback
expose every controllable action per device in the local.* tree (position, valance, slat angle, dimming, switch, stop, identify) plus scenes
use axios for all HTTP calls, drop @esm2cjs/got
resolve service endpoints from the discovery service

0.1.4 (2025-01-27)

ignore certificate errors

0.1.3 (2024-10-26)

fix login

0.1.2

Bugfixes

0.0.3

(TA2k) initial release

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Warema WMS Webcontrol Pro