README.md

ioBroker adapter for Wiffi-wz, Weatherman, Wiffi-pump, Pulsecounter, Rainyman and maybe others

This is an ioBroker Adapter to retrieve sensor data from Wiffi devices see Stall.biz for more info.

Typical examples for devices from Stall.biz are the Wiffi-wz, the Weatherman and the Rainyman. Multiple Wiffis are supported at the same time.

Due to the very low latency of the adapter (typically < 3s) it is possible to use the IR motion sensors to trigger an action like switching the lights on or off.

In the following some devices from Stall.biz are described in more detail: The Wiffi-wz is a device that combines eight sensors in a single unit. Currently the following sensors are available:

• two orthogonally aligned IR motion sensors
• temperature sensor (can be DHT22, or BME280)
• air humidity sensor (can be DHT22, or BME280)
• atmospheric pressure (can be BMP180, BMP280 or BME280)
• noise sensor with adjustable sensitivity
• luxmeter (BH1750)
• air quality sensor (MQ135)
• beeper

The Weatherman can be equipped with many sensors, see homepage for more details.

The Rainyman is a somehow reduced version of the Weatherman, see homepage for more details.

How it works

Usually the Wiffi-wz sends sensors data to a Homematic CCU. The Homematic CCU receives homematic script (or better JSON) on port 8181. The admin page of this adapter reconfigures the Wiffi-wz to send sensor data directly to ioBroker. The sensor data is encoded in JSON format. Therefore a local socket on port 8181 is opened on the ioBroker machine. Note that the socket must not be exposed to the internet due to security reasons.

Setup

1. Set ioBroker as the recipient for the sensor data by retrieving the url

   http://[wiffi ip]/?ccu:[io-broker's ip]:

2. and set the port to 8181 by

   http://[wiffi ip]/?param:12:8181

3. Tell wiffi-wz that it has to send data in JSON format without HTML header (Note that the weatherman may use a different parameter number)

   http://[wiffi ip]/?param:27:1

If any error occurs, please set the adapter loglevel to debug and send me the data telegram via email.

Donation

If this project helped you to reduce developing time, you can give me a cup of coffee or a bottle of beer via PayPal([email protected]) :-)

Changelog

2.2.1 (27-Jun-2021)

• clode cleanup (linting etc. very many thanks to all contributors)
• some bugfixes

2.2.0 (08-Feb-2020)

• compact mode successfully tested

2.1.5 (08-Feb-2020)

• fixed an error with numeric state names

2.1.4 (29-Aug-2019)

• fixed "could not create a state null" error

2.1.3 (27-Jun-2019)

• compatibility for boolean values and old Wiffi versions

2.1.2 (21-Jun-2019)

• changed behaviour: if states are missing in the datagram, but present in the database, they are not removed from the database
• boolean and numeric values are correctly stored

2.1.0 (14-Apr-2019)

• support for compact mode

2.0.1 (08-Jan-2019)

• fixed "could not find ip" bug

2.0.0 (03-Oct-2018)

• wiffi type does not need to be specified in the config anymore
• states are created and deleted by examining the received datagram
• some minor changes concerning the logging
• the buzzer of the wiffi can be activated (it may work for other actors as well, but it is untested at the moment)

1.3.1 (01-Sep-2018)

• fixed npm installation problems

1.3.0 (31-Aug-2018)

• support for Wiffi-pump

1.2.6 (31-Aug-2018)

• fixed "adapter already running error"

1.2.5 (31-Aug-2018)

• solved error when the adapter shuts down

1.2.4 (16-Aug-2018)

• hotfix for wiffi-wz

1.2.3 (15-Aug-2018)

• necessary modifications for publishing the adapter (fixing package.json, etc ...)

1.2.2 (14-Aug-2018)

• necessary modifications for publishing the adapter (fixing roles, etc ...)

1.2.1 (14-Aug-2018)

• fixed datagram evaluation

1.2.0 (10-Aug-2018)

• added support for Rainyman (many thanks to Strobelix from ioBroker forum for testing)

1.1.0 (26-Jul-2018)

• added support for Weatherman (many thanks to smartboart from ioBroker forum for testing)

1.0.0 (17-Jul-2018)

• added support for Admin3

0.3.3 (13-Dec-2017)

• corrected typos
• cleaner code

0.3.2 (13-Dec-2017)

• added license file

0.3.1 (10-Dec-2017)

• support for wiffi-wz, WEATHERMAN, and Rainymans, firmware should be greater or equal to _83
• some bugfixes

0.2.1 (5-Dec-2017)

Bugfixes:

• JSON format sent by the Wiffi had been changed since Wiffi firmware wiffi_software_53. JSON data interpretation fixed.

0.2.0 (10-Feb-2017)

Features:

• Added support for multiple Wiffis.

Changes:

• Removed expert functions from the admin interface.

0.1.0 (12-Jan-2017)

Features:

• Mandatory settings can be done on the admin page.
• The wiffi-wz can be configured from the admin page (there are some problems, see known issues of this release).

0.0.1 (12-Jan-2017)

Features:

• The sensor data is send to the ioBroker and saved as corresponding states.

License

The MIT License (MIT)

Copyright (c) 2014-2019 Christian Vorholt [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.

Copyright (c) 2014-2020 Christian Vorholt [email protected]