Last active
April 4, 2026 18:34
-
-
Save MatsA/da46f165b0d9269276f114f4bdc7e76d to your computer and use it in GitHub Desktop.
Formatting Davis Weatherlink data => Cumulus, "realtime.txt" => Weather template. Link to blogpost in the code !
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| <?php | |
| // Mats A 2017-01 metzallo@gmail.com | |
| // Present version is found at https://vader.domsten.nu/ | |
| // | |
| // This program uppdates the Cumulus realtime.txt after a call to Davis Weatherlink website with a JSON answer | |
| // Documentation is available at https://pysselilivet.blogspot.com/2026/04/dyi-weather-template-with-data-from.htm | |
| /* | |
| MIT License | |
| Copyright (c) 2026 | |
| 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. | |
| */ | |
| // File layout https://cumuluswiki.org/a/Realtime.txt | |
| // 2017-01-29 To get better trend values for temp and pressure the csv files in chartswudata is used as history info. | |
| // Now trend calculation is using the measures 2 hours ago ->sub(new DateInterval('PT2H')) | |
| // 2017-03-29 Changed filesuffix for files in folder "chartswudata" to .txt | |
| // added cumulus[34] wich is used in Barometer view | |
| // 2017-04-25 Due to a change in W34 it's impossible to use the history files in chartswudata as a base for trendata. | |
| // Extending the file realtime.txt so fields $cumulus[60-63] is used to store the history for press and temp | |
| // 2017-05-04 Added fields min barometer => cumulus[36] and windrun => cumulus[17]. Onlinefil realtime.txt is created if missing | |
| // 2017-05-20 Added fields uv-index => cumulus[43] and solar radiation => cumulus[45] wich will be updated if available, otherwise set to 0 | |
| // Change in validation of data from Davis Weatherlink due to that they allways returns an answer even if wrong credentials | |
| // 2017-05-26 Added fields temp high/low time => cumulus[27/29] and wind high/max time [31/33] | |
| // W34 changed use for cumulus[5/6/40] so updated app. | |
| // 2017-06-21 Added an extra temperature sensor, Davis 6372, which in our case mesures water temperature in the sea. | |
| // cumulus[22], inside temp is used if $water_temp is true and value is valid | |
| // 2018-03-19 Davis is updating Weatherlink to WL 2.0 with new host and user is Device ID | |
| // 2018-10-15 Rewrite cause WL data is pulled via Curl and JSON as response | |
| // 2018-11-05 Added field, yesterday's rainfall => $cumulus[21] | |
| // 2018-11-30 Ten minutes windgust, available via JSON => $cumulus[40] | |
| // 2018-12-03 Added calculation for rain last hour => $cumulus[47] | |
| // 2019-03-31 Don’t fetch data more often than every minute. Due to avoiding croon job. | |
| // 2020-01-23 Som links updated, no code change ! | |
| // 2021-03-21 Wind direction average, $cumulus[46], update => https://stackoverflow.com/questions/10832287/calculate-average-of-wind-direction-in-mysql | |
| // 2022-03-10 Added $cumulus[35/37] pressure times | |
| // 2022-11-12 Use case is when indoor device is ok but no outdoor data is available, don't update "realtime.txt". | |
| // 2026-04-04 Updated for the new WEB-app | |
| // ******* Weather Link credentials. Check documentation ! | |
| $wlink_user = "xxxx"; | |
| $wlink_pass = "yyyy"; | |
| $wlink_apiToken = "ZZZZ"; | |
| $water_temp = false; | |
| error_reporting(E_ALL); | |
| ini_set('display_errors', 1); | |
| // ob_start(); | |
| // error_reporting(4); | |
| // @ini_set('display_errors', 0); | |
| chdir(dirname(__FILE__)); | |
| date_default_timezone_set("Europe/Stockholm"); | |
| $file_templ = "../add_on/realtime.templ"; // Template file | |
| $file_realt = "../add_on/realtime.txt"; // Realtime/Online file | |
| $cumulus = array(); // Current observation data | |
| $cumulus_l = array(); // Last observation data | |
| if (file_exists($file_realt)) { // Create the online file if don't exist | |
| if(time() - filemtime($file_realt)>=60){ | |
| $getNewData = TRUE; // If file older than 60 seconds get new data | |
| } | |
| else { | |
| $getNewData = FALSE; | |
| } | |
| } | |
| else { | |
| copy($file_templ,$file_realt); | |
| $getNewData = TRUE; | |
| } | |
| if ($getNewData) { | |
| // Fetch template data | |
| $file_wrk = file_get_contents($file_templ); // echo readfile("../add_on/realtime.templ"); | |
| $cumulus = explode(" ", $file_wrk); | |
| // var_dump ($cumulus); | |
| $handle = fopen($file_realt, "r"); // Fetch last realtime data | |
| $file_wrk = fread($handle, 1024); | |
| fclose($handle); | |
| $cumulus_l = explode(" ", $file_wrk); | |
| // ******* Get the current "conditions" from Davis Weatherlink ******* // | |
| $service_url = "http://api.weatherlink.com/v1/NoaaExt.json?user=" . $wlink_user . "&pass=" . $wlink_pass . "&apiToken=" . $wlink_apiToken; | |
| $curl_handle = curl_init($service_url); | |
| curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, true); | |
| $curl_response = curl_exec($curl_handle); | |
| $wlJson = json_decode($curl_response); // var_dump ($wlJson); | |
| // If wrong "conditions" data no file update | |
| if (($wlJson->davis_current_observation->DID == $wlink_user) and (property_exists($wlJson, 'temp_f'))) { | |
| // Please note Field no in the Cumulus spec. -1 => array no | |
| $cumulus[0] = date_create($wlJson->observation_time_rfc822)->format('d/m/y'); | |
| $cumulus[1] = date_create($wlJson->observation_time_rfc822)->format('H:i:s'); // Observation time from Weatherlink | |
| // echo ("$cumulus[1] $cumulus_l[1] \n"); | |
| if ($cumulus[1] <> $cumulus_l[1]) { // Update file, not same time/observation as last | |
| // ******* Direct values ******* // | |
| $cumulus[2] = $wlJson->temp_f; | |
| $cumulus[3] = $wlJson->relative_humidity; | |
| $cumulus[4] = $wlJson->dewpoint_f; | |
| $cumulus[5] = $wlJson->wind_mph; // Used by W34 for trend calc. Wind this moment | |
| $cumulus[6] = $wlJson->davis_current_observation->wind_ten_min_avg_mph; | |
| $cumulus[7] = $wlJson->wind_degrees; | |
| $cumulus[8] = $wlJson->davis_current_observation->rain_rate_in_per_hr; // Rain rate in/h | |
| $cumulus[9] = $wlJson->davis_current_observation->rain_day_in; // Rain in inches(in) | |
| $cumulus[10] = $wlJson->pressure_in; // Pressure inches | |
| // $cumulus[11] = // Current wind direction, calculated by W34 from $cumulus[7] | |
| // $cumulus[12] = // Wind in Beaufort, not used by W34 | |
| $cumulus[13] = "mph"; // Windspeed unit | |
| $cumulus[14] = "F"; // Temp unit | |
| $cumulus[15] = "in"; // Pressure unit | |
| $cumulus[16] = "in"; // Rain unit | |
| $cumulus[19] = $wlJson->davis_current_observation->rain_month_in; // Rain acc. Month inches | |
| $cumulus[20] = $wlJson->davis_current_observation->rain_year_in; // Rain acc. Year | |
| $cumulus[22] = $wlJson->davis_current_observation->temp_in_f; // Inside temp | |
| $cumulus[23] = $wlJson->davis_current_observation->relative_humidity_in; // Inside humidity | |
| $cumulus[24] = $wlJson->windchill_f; | |
| $cumulus[26] = $wlJson->davis_current_observation->temp_day_high_f; | |
| $cumulus[27] = date_create($wlJson->davis_current_observation->temp_day_high_time)->format('H:i'); | |
| $cumulus[28] = $wlJson->davis_current_observation->temp_day_low_f; | |
| $cumulus[29] = date_create($wlJson->davis_current_observation->temp_day_low_time)->format('H:i'); | |
| $cumulus[32] = $wlJson->davis_current_observation->wind_day_high_mph; | |
| $cumulus[33] = date_create($wlJson->davis_current_observation->wind_day_high_time)->format('H:i'); | |
| $cumulus[34] = $wlJson->davis_current_observation->pressure_day_high_in; | |
| $cumulus[35] = date_create($wlJson->davis_current_observation->pressure_day_high_time)->format('H:i'); | |
| $cumulus[36] = $wlJson->davis_current_observation->pressure_day_low_in; | |
| $cumulus[37] = date_create($wlJson->davis_current_observation->pressure_day_low_time)->format('H:i'); | |
| $cumulus[40] = $wlJson->davis_current_observation->wind_ten_min_gust_mph; // Windgust avg. 10 min | |
| // ******* Calculated values ******* // | |
| $hour = date_create($cumulus[1])->format('H'); // Create an save, in realtime.txt, values for trend caculation every hour | |
| $hour_l = date_create($cumulus_l[1])->format('H'); | |
| // echo "\n $hour $hour_l \n"; | |
| if ($hour <> $hour_l) { // If new hour save data for trendvalues | |
| $cumulus[47] = round($cumulus_l[9] - $cumulus_l[59],4); // Rain last hour | |
| $cumulus[59] = $cumulus_l[9]; // Save rain acc today | |
| $cumulus[61] = $cumulus_l[60]; // Save the 1 hour old temp value | |
| $cumulus[60] = $cumulus[2]; // Save current temp F | |
| $cumulus[63] = $cumulus_l[62]; // Save the 1 hour old press value | |
| $cumulus[62] = $cumulus[10]; // Save current press | |
| } | |
| else { | |
| $cumulus[47] = $cumulus_l[47]; // Else, overwrite template data | |
| $cumulus[59] = $cumulus_l[59]; | |
| $cumulus[60] = $cumulus_l[60]; | |
| $cumulus[61] = $cumulus_l[61]; | |
| $cumulus[62] = $cumulus_l[62]; | |
| $cumulus[63] = $cumulus_l[63]; | |
| $cumulus[64] = $cumulus_l[64]; | |
| $cumulus[65] = $cumulus_l[65]; | |
| } | |
| $cumulus[18] = round((floatval($cumulus[10]) - $cumulus[63]),4); // Barometer trend, current - history | |
| $cumulus[25] = floatval($cumulus[2]) - $cumulus[61]; // Temp trend // echo "$cumulus[25] $cumulus[18] \n"; | |
| if ($cumulus[0] == $cumulus_l[0]) { // Same date "d/m/y" ?Current and last | |
| // Rain yesterday | |
| $cumulus[21] = $cumulus_l[21]; // Update with last data, overwrite template data | |
| // Windrun calculation https://cumuluswiki.wxforum.net/a/Windrun | |
| $diff = date_diff(date_create($cumulus[1]), date_create($cumulus_l[1])); // Observation time current - observation last | |
| $hours = ($diff->h) + ($diff->i)/60 + ($diff->s)/3600; // Diff, hours + minutes + seconds in hours. var_dump ($hours); | |
| $cumulus[17] = round($cumulus_l[17] + ($cumulus[6]*$hours),4); | |
| // Daily max wind calculation | |
| if ($cumulus[6] > $cumulus_l[30]) { // Same date and if current wind 10 min avg > daily max avg => update daily max wind avg. and time | |
| $cumulus[30] = floatval($cumulus[6]); | |
| $cumulus[31] = date_create($wlJson->observation_time_rfc822)->format('H:i'); | |
| } | |
| else { | |
| // else, update with last data, owerwrite template data | |
| $cumulus[30] = $cumulus_l[30]; | |
| $cumulus[31] = $cumulus_l[31]; | |
| } // End max wind calculation | |
| } | |
| else { // New day | |
| // Rain yesterday | |
| $cumulus[21] = $cumulus_l[9]; // Update value for yesterdays rainfall | |
| // Windrun calculation | |
| $hours = date_create($cumulus[1])->format('H') + | |
| date_create($cumulus[1])->format('i')/60; // Hours + minutes, since midnight in hours. var_dump ($cumulus[6]); | |
| $cumulus[17] = round($cumulus[6]*$hours,4); // Ten min avg wind * hours. var_dump ($cumulus[17]); | |
| $cumulus[30] = floatval($cumulus[6]); // Daily max wind calculation. Set daily max wind average and time to current observation | |
| $cumulus[31] = date_create($wlJson->observation_time_rfc822)->format('H:i'); | |
| } | |
| if (property_exists($wlJson->davis_current_observation, 'uv_index')) { // uv-index | |
| $cumulus[43] = $wlJson->davis_current_observation->uv_index; // uv-index OK | |
| } | |
| else { | |
| $cumulus[43] = 0; // If mesure not is available set to 0 | |
| } | |
| if (property_exists($wlJson->davis_current_observation, 'solar_radiation')) { // solar radiation | |
| $cumulus[45] = $wlJson->davis_current_observation->solar_radiation; // solar radiation OK | |
| } | |
| else { | |
| $cumulus[45] = 0; // If mesure not is available set to 0 | |
| } | |
| $cumulus[46] = round((($cumulus[7] + $cumulus_l[7])/2),0); // Wind direction average, no decimals | |
| if (abs($cumulus[7] - $cumulus_l[7]) > 180){ // Correction for near north | |
| $cumulus[46] = $cumulus[46] + 180; // For example input as 355 and 10 | |
| } | |
| if ($cumulus[46] >= 360){ | |
| $cumulus[46] = $cumulus[46] - 360; | |
| } | |
| if ($water_temp) { // Water temp. | |
| if (property_exists($wlJson->davis_current_observation, 'temp_extra_1')){ | |
| $cumulus[22] = $wlJson->davis_current_observation->temp_extra_1; // Inside temp. is used | |
| } | |
| } | |
| // ******* Update the realtime.txt file ******* // | |
| $file_live = implode(" ",$cumulus); | |
| $handle = fopen($file_realt, "w"); | |
| fwrite($handle, $file_live); | |
| fclose($handle); // echo readfile("../add_on/realtime.txt"); | |
| } // New date END | |
| } // Wrong "conditions" data END | |
| } // Get new data END | |
| ?> |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment