Skip to content

Latest commit

 

History

History
308 lines (232 loc) · 15.1 KB

README.md

File metadata and controls

308 lines (232 loc) · 15.1 KB
Raw

Logo

ioBroker.wiserbyfeller

NPM version Downloads Number of Installations Current version in stable repository

NPM

Test and Release

Donate

Wiser by Feller adapter for ioBroker

This Adapter enables you to manage the supported Wiser by Feller system devices via a WebSocket connection.

Disclaimer

All product and company names or logos are trademarks™ or registered® trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them or any associated subsidiaries! This personal project is maintained in spare time and has no business goal. Wiser by Feller is a trademark of Feller AG, CH-8810 Horgen.

Installation requirements

  • node.js >= v18 is required
  • js-controller >= v5.0.19 is required
  • admin >= v6.3.5 is required
  • Installed Wiser by Feller devices are required. More information can be found here: Wiser by Feller.

Supported Devices

  • Wiser by Feller Druckschalter 1-Kanal 3401...
  • Wiser by Feller Druckschalter 2-Kanal 3402...
  • Wiser by Feller Storenschalter 1-Kanal 3404...
  • Wiser by Feller Storenschalter 2-Kabal 3405...
  • Wiser by Feller LED-Universaldimmer 1-Kanal 3406...
  • Wiser by Feller LED-Universaldimmer 2-Kanal 3407...
  • Wiser by Feller DALI-Dimmer 1-Kanal 3411...

Usage

Connect the Embedded Web Interface from Wiser by Feller WLAN device without cloud connection

Еven without the mobile app, Wiser by Feller WLAN device can be set and controlled through a browser and WiFi connection of a mobile phone, tablet or PC (please make sure, that the device is not connetced to the cloud service -> see reset guideline in the manual of the device).

Installation procedure:

  1. Install Wiser by Feller WLAN device
  2. After first connection to power, Wiser by Feller WLAN device has created an own WiFi network, with name (SSID) such as wiser-000xxxxx. Connect to it with your phone, tablet or PC and enter passwort, provided together with the device (sticker).
  3. Type http://192.168.0.1 in your browser
  4. Fill in New Registration and press the button on the device to continue
  5. Log in
  6. Go to settings -> Network settings -> Add new WLAN
  7. Enter your credentials and press button Add WLAN
  8. Press button Reboot Now!
  9. Log out and discconnect your phone, tablet or PC from the Wiser by Feller WLAN device
  10. Get IP-Address of Wiser by Feller WLAN device in your router
  11. Enter IP-Address of Wiser by Feller WLAN device in settings of ioBroker.wiserbyfeller adapter instance Gateway-IP
  12. Enter username of Wiser by Feller WLAN device in settings of ioBroker.wiserbyfeller adapter instance username
  13. Click save button
  14. Click Get authentification token button and follow the shown procedure
  15. Click close button

Connect the Embedded Web Interface from Wiser by Feller WLAN device with cloud connection

Installation procedure:

  1. Install Wiser by Feller WLAN device and connect it via the guideline from Wiser by Feller via the normal installation guide.
  2. Get IP-Address of Wiser by Feller WLAN device in your router
  3. Enter IP-Address of Wiser by Feller WLAN device in settings of ioBroker.wiserbyfeller adapter instance Gateway-IP
  4. Enter username of Wiser by Feller WLAN device in settings of ioBroker.wiserbyfeller adapter instance username
  5. Click save button
  6. Click Get authentification token button and follow the shown procedure
  7. Click close button

Controls

Wiser by Feller Druckschalter 1-Kanal/2-Kanal

To turn on or off a load set the attribute BRI (brightness) to the following values:

  • Turn off set the .ACTIONS.BRI attribute to off
  • Turn on set the .ACTIONS.BRI attribute to on

Wiser by Feller Storenschalter 1-Kanal/2-Kanal

On a motor e.g. shutter/blind you can set the target level between 0% and 100% (0 - 10000) and a tilt value.

  • To set the shutter in open position set the .ACTIONS.LEVEL attribute to 0
  • To set the shutter in close position set the .ACTIONS.LEVEL attribute to 10000
  • To control the shutter set the .ACTIONS.LEVEL attribute between 1 and 10000 (e.g. set .ACTIONS.LEVEL to 5000, means set the shutter/blind to position 50%)
  • To control slats of a shutter (number of tilt) set the .ACTIONS.TILT attribute to a value 0 - 9. Finally it's the motor running time, because we don't know the slat position in degrees.
  • To control the position and the tilt attribute together, set the .ACTIONS.leveltilt.SET attribute to value true. The shutter/blind will move to the position of the two values .ACTIONS.leveltilt.level and .ACTIONS.leveltilt.tilt

Wiser by Feller LED-Universaldimmer 1-Kanal/2-Kanal

On a dimmable light you can set the target brightness between 0% and 100% (0 - 10000).

  • Turn off set the .ACTIONS.BRI attribute to 0
  • To dim set the .ACTIONS.BRI attribute between 1 and 10000 (e.g. set .ACTIONS.BRI to 5000, means 50% of brightness)

Wiser by Feller DALI-Dimmer 1-Kanal configured default (normal mode)

On a dimmable light you can set the target brightness between 0% and 100% (0 - 10000).

  • Turn off set the .ACTIONS.BRI attribute to 0
  • To dim set the .ACTIONS.BRI attribute between 1 and 10000 (e.g. set .ACTIONS.BRI to 5000, means 50% of brightness)

Wiser by Feller DALI-Dimmer 1-Kanal configured tw (Tunable-White)

On a dimmable light you can set the target brightness between 0% and 100% (0 - 10000).

  • Turn off set the .ACTIONS.BRI attribute to 0
  • To dim set the .ACTIONS.BRI attribute between 1 and 10000 (e.g. set .ACTIONS.BRI to 5000, means 50% of brightness)
  • To change the color set the .ACTIONS.CT attribute between 1000 and 20000

Wiser by Feller DALI-Dimmer 1-Kanal configured rgb (RGBW red-green-blue-white)

On a dimmable light you can set the target brightness between 0% and 100% (0 - 10000).

  • Turn off set the .ACTIONS.BRI attribute to 0
  • To dim set the .ACTIONS.BRI attribute between 1 and 10000 (e.g. set .ACTIONS.BRI to 5000, means 50% of brightness)
  • To change the color set the .ACTIONS.RED, .ACTIONS.GREEN, .ACTIONS.BLUE and/or .ACTIONS.WHITE attribute between 0 and 255

Smartbuttons

Create a job on the μGateway and connect them to a smartbuttons with true respectively false or toggle value:

  1. Open [IP-Adress of Wiser by Feller WLAN device]/debug/apiui.html

  2. Click Authorize button

  3. Enter value SecretAuth (http, Bearer)

  4. Click Authorize button

  5. Click Close button

  6. Open scripts tab on your μGateway (url: [IP-Adress of Wiser by Feller WLAN device]/scripts.html), click button Create File

  7. Enter a program name (f. ex. smartbutton_1.py), click button Save

  8. Open programm by clicking on the pencil right in the above created program

  9. First Option: Add the following code if you want to get true and false you need two buttons

    First Button:

    import websockets
async def onButtonEvent(*argv):
    await websockets.Connection.push_event('/api', {'smb': {'id': argv[2], 'value': True}})

    Second Button:

    import websockets
async def onButtonEvent(*argv):
    await websockets.Connection.push_event('/api', {'smb': {'id': argv[2], 'value': False}})

    Second Option: Add the following code if you want to toggle the value true -> false -> true ...

    import websockets
value = True
async def onButtonEvent(*argv):
global value
await websockets.Connection.push_event('/api', {'smb': {'id': argv[2], 'value': value}})
    value = False if value else True

  10. Click on button ✓ (save)

  11. Open [IP-Adress of Wiser by Feller WLAN device]/debug/apiui.html

  12. Go to POST /api/smartbuttons/program, click Try it out button

  13. Enter {"on": true, "timeout": 60, "button_type": "scene", "owner": "user"}, click Execute button

  14. Go to GET api/smartbutton/notify, click Try it out button

  15. Click Execute button

  16. Press a blinking Scene Button on your Wiser by Feller Device

  17. Write down the button id

  18. Go to POST api/jobs, click Try it out button

  19. Enter {"scripts": ["smartbutton_1.py"]} (smartbutton_1.py must match the above choosen program name), click Execute button

  20. Write down the job id

  21. Go to PATCH /api/smartbuttons/{id}, click Try it out button

  22. Enter the button id in id field

  23. Enter following code in the request body: {"job": 102, "name": "Smartbutton_1"} (job must match the job id from above, name can be choosen), click Execute button

How to report issues and feature requests

  • For issues please use GitHub issues -> "Bug report" and fill in the form.

    Set the adapter to debug log mode (Instances -> Expert mode -> Column Log level). Get the logfile from disk (subdirectory "log" in ioBroker installation directory and not from Admin because Admin cuts the lines). Check that there are no personal information before you publish your log.

  • For feature requests Please use GitHub issues -> "Feature request" and fill in the form.

Changelog

0.1.0-beta.12

  • (ice987987) BREAKING: js-controller >= v5.0.19, admin >= v6.3.5 and node.js >= v18 is required
  • (ice987987) dependencies updated
  • (ice987987) section "disclaimer" in readme added
  • (ice987987) ukrainian language added
  • (ice987987) support for DALI-Dimmer added
  • (ice987987) additional device info added (folder: .info.device.[...])
  • (ice987987) smartbuttons added (folder: .smartbuttons.[...])
  • (ice987987) watchdog for WebSocket-Connection added
  • (ice987987) device icons fixed
  • (ice987987) websocket connection fixed

0.0.4 (12.03.2022)

  • (ice987987) cleartimeout added

0.0.3 (11.03.2022)

  • (ice987987) WebSocket connection to get values of the devices implemented
  • (ice987987) all subscribed states are now capitalized
  • (ice987987) new way to set leveltilt values added
  • (ice987987) readme updated

0.0.2 (27.02.2022)

  • (ice987987) description of several datapoints updated
  • (ice987987) icons for main datapoints added
  • (ice987987) license year updated
  • (ice987987) DP rssi into info-folder moved
  • (ice987987) readme.md updated
  • (ice987987) dependencies updated

0.0.1 (28.12.2021)

  • (ice987987) initial release

License

MIT License

Copyright (c) 2024 ice987987 [email protected]

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.