User Tools

Site Tools


supported_hardware:weatherflow

Weatherflow / Tempest Weather Stations

The Tempest weather stations from Weatherflow are very highly rated weather stations with fewer or no moving parts to break down or gum up while out in the weather. They also provide information to your local wifi network in an open and reliable way that makes getting that information into an XTension plugin fairly straight forward.

As of this writing I believe that all data sent by the available devices will be imported and saved to XTension units. I do not currently own one of these (yet) for testing and can only test by pushing scraped data from others into it. There may remain issues or data points that I haven’t seen yet and therefore am not processing properly or at all. If you find that it should be registering something that it is not or that something isn’t working the way that you expect please let me know and we can gather some further data to test with.

I believe that the packet received by XTension is the same one that is received by the Weatherflow hub. If that is correct then no other configuration to the Tempest device or hub themselves should be necessary. If not then it may be necessary to turn on these broadcasts in the configuration. If you know one way or the other please let me know and I will update the documentation.


XTension Setup:

Only a single plugin instance is necessary to support any number of Tempest or other Weatherflow devices.

UDP Port For Broadcasts: Unless you have changed the broadcast address in the Tempest device or hub the default setting is 50222.

Optional Broadcast Address: Almost everyone should leave this field blank. For those with more complex networks trying to isolate some devices from others it may be necessary to specify the UDP Broadcast address that should be listnened to. If you have multiple network interfaces active on the server at once for various purposes this may also be necessary. Some VPN systems may also make it necessary to set this specifically. If you’ve done any of that then hopefully you know the proper settings for the virtual networks. If this field is left blank then the plugin will attempt to bind to any available network interface which is what you would normally want.


XTension Units and Data:

XTension will create units from the device as the data is received. You may not see all the supported units show up at once, but only as the data begins to trickle in. This way units that are not supported by your device won’t be sitting in the lists but never updating.

At creation the Unit names will all be prefixed by the serial number of the station. Once the units are created you can edit them to either remove the serial number completely or to give them a more descriptive name. You do not have to leave the units with their default name. You should not change the unit address however, this is how the data gets routed to the unit in XTension.

As of this moment all measurement values are sent in the units that the device reports them in, degrees C as opposed to degrees F and so forth. No converting of units inside the plugin is available yet but that is something I could add in the future, please let me know. It may be possible to change the units being used in the settings of the Tempest or hub. Right now the default suffixes used in XTension are for the default units used by the device. If you change the units in the device the suffixes in XTension will not know to change and you should edit the XTension Units and visit the Display tab where you will find the Suffix field. Please update the suffix with the appropriate values for your configuration. The following table shows the data that is received and the default units, if any, that will be set when creating new Units in XTension.

Measurement Units:
Temperature °C The current temperature.
Humidity % The current humidity.
Pressure mb The current atmospheric pressure.
Light and UV Units:
Illuminance lux The measured visible light level. Not the UV level.
UV Index The UV light intensity index.
Solar Radiation W/m^2 The actual amount of energy being received, not just visible or UV.
Precipitation Units:
Precipitation Start This unit will receive an ON event whenever precipitation has begun. It will not ever receive an OFF event so cannot be used to know when the rain has stopped.
Rain Accumulated mmThe rain accumulated during the current rain event, or possibly forever let me know what this field actually holds if you know.
Daily Rain mm The rain accumulated so far today.
Precipitation Type The unit will hold a numerical value between 0 and 3. The value label for all displays will hold the one of the following labels: “None”, “Rain”, “Hail” or “Unknown” If there are other types that can be displayed please let me know and I will add them to the list.
Lightning Units:
Strike Energy The approximate “energy” of the strike. I don’t know if this is an RF strength or a calculated value based on that nor do I know the units that this data is presented in. If you know what this actually is please let me know and I will update the unit creation to add the proper unit suffix.
Strike Distance kmThe approximate distance of the lightning strike. This is a calculated value and will not be precise, but can be used to know if a storm is getting nearer or closer and when hits are happening directly overhead or very close as opposed to further away.
Strike Count The count of lightning hits in the current storm.
Average Strike Distance kmThe average distance of strikes in the current storm so far.
Average Strike Energy The average energy of the strikes in the current storm so far.
Wind Information Units:
Wind Speedm/sThe instantaneous wind speed. This unit may receive many rapid updates.
Wind Direction°The Unit will hold the numerical degrees measurement. The value display in any XTension interface will show that along with the compass direction similar to “154° (NNW)”
Wind Lullm/sPossibly the opposite of Wind Gust?
Wind Gustm/sThe highest wind speed within some amount of time as decided by the device.
Device Status Units:
Battery VoltsvThe voltage level of the solar charged battery inside the station.
RSSIdbmThe WiFi signal strength at the Tempest Device.
Hub RSSIdbmThe WiFi signal strength at the Weatherflow Hub.

Errors:

If any of the sensors are reporting failures they will be both logged to the XTension log and placed in the runstate display in the interface list window. The state of the interface will switch from green to yellow if any sensors are reporting errors. The currently known error bits that can be sent are as follows:

  • Lightning Failed
  • Lightning Noise
  • Lightning Disturber
  • Pressure Failed
  • Temperature Failed
  • RH Failed (humidity sensor)
  • Wind Failed
  • Precip Failed
  • Light/UV Failed

The standard interface script handlers for the error being set should be run and cleared if any errors are sent. You can trap these as events for alerts or other dispay or action from there.


History:

  • The Weather Flow plugin was first added in a beta version to XTension 9.3.34 in September of 2020
  • An update was made during the beta process before the first release that fixed a problem where it could receive the same updates more than once depending on network topology. Mutiple routers or extenders could forward the broadcast packets ending up as repeats on the same neetwork. Duplicate packets are now ignored.
  • The plugin was upgraded from beta to a 1.0 release in March of 2022. It will no longer startup in debug mode and do extra logging.
  • In 9.4.44 the plugin was updated to run with the embedded Python version of 3.10 and no longer require that the OS have a python 7 version as this will not be included in future OS versions.
supported_hardware/weatherflow.txt · Last modified: 2023/02/13 14:52 by 127.0.0.1