Technical Specifications
Weather Station is a very complete plugin that involves many components. You will find here the technical details of some components to allow you to better understand its operation and its technical possibilities.
Stations and services compatibility
Weather Station can collect meteorological data from stations published on:
- Ambient Weather Network
- Davis WeatherLink Network
- OpenWeatherMap
- WeatherFlow public map
By direct access to the stations of the following brands:
- BloomSky (Sky1, Sky2 and Storm)
- Netatmo (weather station and Healthy Home Coach)
- Pioupiou wind station (V1 and V2)
- WeatherFlow (Sky and Air modules)
From stations sharing data via clientraw.txt, realtime.txt or stickertags files:
- Cumulus
- MeteoBridge
- WeatherCat
- WeatherDisplay
- WeatherLink
- WeeWX
- WsWin32
- …
Measurements
Depending on the capacities of the collected station, Weather Station allows you to grab and display the following measurements:
Temperatures
Indoor and outdoor. Current, min of the day, max of the day, trend.
Rain
Rain rate and 1 hour, 3 hour, daily (today and yesterday), monthly, seasonly and yearly cumulative.
Clouds
Cloudiness, base altitude and station visibility.
Indexes
Dew point and frost point, wind chill, heat index and humidex. Indoor health index. Chandler burning index.
Thunderstorms
Number of strikes over a minute and for the last three hours. Distance and bearing of last strike.
Soil
Soil temperature. Moisture. Soil moisture content and tension. Leafs wetness.
Pressures
Local and sea-level. Current, min of the day, max of the day, trend.
Snow
Snow rate, 1 hour and 3 hours cumulative.
Pollution
Level for CO (carbon monoxide), CO₂ (carbon dioxide) and O₃ (ozone) layer thickness. Probe distances.
Noise
Level of noise.
Geolocation
Altitude, coordinates and timezone.
Station
Battery and signal quality. Firmware revision and timestamps.
Sun
UV index, illuminance, irradiance and sunshine duration.
Humidity
Indoor and outdoor. Relative. Current, min of the day and max of the day.
Wind
Direction, source and strength for current, gust, max on 10 minutes, 1 hour and today.
Astronomical
Sun: rise, set, distance and angular size. Moon: rise, set, age, phase, illumination, distance and angular size. Standard, civil, nautical and astronomical day duration, dawn and dusk times, and twilight for dawn and dusk.
Psychrometry
Wet-bulb temperature. Equivalent, potential and equivalent potential temperature. Absolute humidity (full, partial and at saturation). Vapor pressure (full, partial and at saturation). Air density, specific enthalpy and equilibrium moisture content (EMC).
Scheduled tasks
Weather Station uses the scheduling system built into WordPress to regularly run some necessary tasks. These tasks and their execution frequencies are as follows:
Stations polling
For WeatherFlow and Pioupiou stations, stations attached to WeatherLink Network and stations based on clientraw.txt, realtime.txt and stickertags files, the polling is done every 5 minutes (or 2 minutes in fast mode). For Netatmo the polling is done every 5 minutes. For located stations (via OpenWeatherMap), the polling is done every 10 or 15 minutes. For current observations (via OpenWeatherMap) added to all stations, the polling is done every 15 minutes. For pollution data (via OpenWeatherMap) added to all stations, the polling is done every 30 minutes. Computations of indexes, psychrometric and astronomical values are done each time new data is polled (on a station by station basis).
Stations pushing
Stations pushing (when sharing data with PWS, MET Office, etc.) is done every 2, 5, 10 or 20 minutes.
System tasks
Logs rotation, statistics cleaning, cache purge and internal translations updates are done once or twice per day.
Watchdog
The scheduler watchdog runs every 3 minutes.
You can get details on the execution of these tasks via the Scheduled Tasks interface.
Generated files URLs
In order to communicate with systems that require file operations, Weather Station creates some specific URLs. The details of these different URLs are as follows:
Stickertags files
Stickertags files are generated and published following the /get-weather/[ID]/stickertags
scheme, where [ID]
is the internal identifier of the station. So if your site URL is www.example.com and the station identifier is 70:ee:50:01:22:be
the stickertags file will be accessible via the main URL http://www.example.com/get-weather/70:ee:50:01:22:be/stickertags/
.
Actually, it is published under many secondary URLs too – to match some requirements from stickertags files consumers – following the /get-weather/[ID]/[subformat]_stickertags.txt
, where [subformat]
is a string composed of uppercase letters. So, the previously mentioned file will also be accessible via URLs likehttp://www.example.com/get-weather/70:ee:50:01:22:be/DB_stickertags.txt
orhttp://www.example.com/get-weather/70:ee:50:01:22:be/WHATYOUWANT_stickertags.txt
and so on…
YoWindow files
YoWindow files are generated and published following the /get-weather/[ID]/yowindow/
scheme, where [ID]
is the internal identifier of the station. So if your site URL is www.example.com and the station identifier is 70:ee:50:01:22:be
the YoWindow file will be accessible via the main URL http://www.example.com/get-weather/70:ee:50:01:22:be/yowindow/
.
This file is also published under a secondary URL – to meet the requirements of some YoWindow file consumers – following the schema /get-weather/[ID]/YoWindow.xml
. So, the previously mentioned file will also be accessible via this URLhttp://www.example.com/get-weather/70:ee:50:01:22:be/YoWindow.xml
.
There is currently a known WordPress bug that prevents proper URLs operation for multisite installations. Until this bug is fixed, you can use the following URL scheme: /wp-content/plugins/live-weather-station/generator.php?type=[FORMAT]&station=[ID]
where [FORMAT]
is the desired format (stickertags, yowindow, etc.) and [ID]
is the internal identifier of the station. So, to take the previous examples on a WordPress multisite, the files can be accessed at http://www.example.com/wp-content/plugins/live-weather-station/generator.php?type=stickertags&station=70:ee:50:01:22:be
andhttp://www.example.com/wp-content/plugins/live-weather-station/generator.php?type=yowindow&station=70:ee:50:01:22:be
.