Skip to content

Latest commit

 

History

History
99 lines (67 loc) · 5.41 KB

README.md

File metadata and controls

99 lines (67 loc) · 5.41 KB
Raw

Wireless Weather Sensors

Homey app to read information from wireless weather sensors on 433 MHz.

Currently the following protocols are supported on 433 MHz.

  • Alecto v1 & v3 (WS-1050/WS-1100/WS-1200)
  • Auriol Z31130
  • Cresta: used in numerous brands 433 MHz sensors, like Cresta & TFA
  • La Crosse: only TX3 decoding fully implemented, WS7000 partially (untested)
  • Oregon Scientific: version 2 and 3 of the protocol are supported
  • UPM/Esic: only tested with WT440H
  • Ambient Weather: only tested with OneConcept 10029372 by ElectronicStar

These types of devices are supported:

  • Temperature sensors
  • Temperature/humidity sensors
  • Anemometers
  • Rain gauges
  • UV sensors
  • Barometers
  • Brightness sensor

Installation

Install the app and go to the app Settings page in Homey. As soon as a sensor signal is picked up, it will show in the list of 'Available sensors'.

Once you see the sensor in the list, you can add it in Homey by pairing it. Select the type of sensor that you want to add (e.g. 'Temperature/Humidity') and a list of available sensors should appear.

Below are some examples of different weather sensor devices in Homey.

A battery alarm will only be shown when the sensor and the protocol support this.

Each sensor also has a settings page. This will show some (read-only) information about the sensor and e.g. the last date/time data was received from the sensor.

For a number of types (temperature, humidity, pressure and luminance) you can also define an 'offset' for a sensor value. If e.g. a sensor a reports a value that is always too high, you can define an offset that is added to the read value. Use e.g. and offset of '-1.4' to reduce the sensor value on the mobile card by 1.4. Or use '0.3' to increase the value.

Settings

On the application settings page a number of selections can be made.

Protocols

The first setting determines which protocols need to be enabled. By default they are all enabled, but when some are not needed they can be disabled by the user. Hover over the information button next to the protocol to get some more information on it.

Activity

Under the activity settings one can select when a sensor is marked as 'Inactive' in Homey. When no signal is received for the given amount of time, it will be displayed as inactive. As soon as data is received again, the sensor will be marked active and the timer will be reset.

If you want, you can get a notification in the Homey notification sensor when a sensor becomes inactive, active, both or neither.

Debug

Some debug tools are available for use in special cases. Don't use them unless instructed.

Discussion and issues

Please report issues via GitHub. For other remarks and/or questions visit the topic on the Athom Forum.

Version info

  • 2.5.0 Changed driver model, updated app settings UI; Added support for Auriol HG05124A-DCF-TX (Auriol v2); Stricter timing to improve reception; Removed Oregon Scientific v2.2 (sensors need re-pairing); Removed Labs, moved into Alecto v1
  • 2.0.3 Further fixes for UPM/Esic - old devices will need to be removed
  • 2.0.2 Fix issue with UPM/Esic pairing in mobile app
  • 2.0.1 Bug fixes
  • 2.0.0 Rewritten app for Homey SDK v2
  • 1.2.3 Add support for Labs BL999
  • 1.2.2 Add Fine Offset support, fixes
  • 1.2.1 Bug fixes
  • 1.2.0 Adds support for Oregon Scientific v2.2 (BTHGN129), adds offset support, adds forecast, removes 868, removes heapdump
  • 1.1.2 Fix Oregon Scientific BTHR918N & add support for BTHR918
  • 1.1.1 Fix UV/brightness value not being displayed
  • 1.1.0 Adds support for Auriol Z31130, adds Brightness device, sensor capabilities based on received values
  • 1.0.2 Fix a bug in Oregon v2 decoding
  • 1.0.1 Definition fixes for Homey FW 1.3, implement LaCrosse WS, bug fixes
  • 1.0.0 First Athom App Store release

Copyright (c) 2020 Ramón Baas

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.