Differences

This shows you the differences between two versions of the page.

--- weather_station:start [2022/04/12 17:32] – jan001
+++ weather_station:start [2023/01/05 14:38] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+~~NOTOC~~
 ====== HSRW Weather Station at Campus Kamp-Lintfort ======
@@ Line 6: / Line 7: @@
-===== Dashboard for Real-Time Data =====
+===== Interactive Grafana Dashboard of Real-Time Weather Data =====
 | [[https://weather.eolab.de/grafana/d/Eb_lKrGMk/weather?orgId=1&refresh=15m&from=now-14d&to=now|{{ :weather_station:eolab_weatherstation_grafana.png?direct&600 |}}]] |
@@ Line 22: / Line 23: @@
-===== Sensors =====
+===== The Sensors of the Weather Station =====
@@ Line 36: / Line 37: @@
 | Solar Radiation                      | Pyranometer, Kipp & Zonen SMP10               | {{ :weather_station:smp10.pdf |SMP10}}              |
-====== Access Real-Time Online Data ======
+====== Accessing the Real-Time Online Data ======
-The data of our weather station is available for free to everyone!
-All data is made available in a JSON-format:
+The data of our weather station is **freely available**! \\ We provide two main channels to access the data:
-^ Key              ^ Unit      | Comment              |
+  - MQTT (trough our own broker),
+  - RESTful API
+The accessible variables:
+^ Key              ^ Unit      ^ Comment              ^
 | wind_speed       | km/h      |                      |
 | wind_direction   | degrees   |                      |
@@ Line 53: / Line 60: @@
 | precipitation    | mm        |                      |
 | created_at       | ISO8601   | UTC                  |
+===== MQTT Broker and Topic for Subscribing to Real-Time Online Data =====
+We also publish our data on our own MQTT Server which doesn't need any authentication for receiving that kind of data.
+^  MQTT Broker and Topic                      ||
+^ URL                     | eolab.de           |
+^ PORT                    | 1883               |
+^ TOPIC                   | weather/hsrw-kali  |
 ===== RESTful API to Request Real-Time Online Data =====
-The RESTful Application Programming Interface (API) is used to download data or retrieve data in its own programs.
+The RESTful Application Programming Interface (API) is used to download data or retrieve data e.g. in own programs or scripts. \\ The data is provided in a JSON-format.
-==== Examples =====
+==== Examples (response takes some time) =====
+Get the recent 20 measurements: \\
+''[[https://weather.eolab.de/api/weather]]''
 Retrieve the last 20 sensor data from all sensors since 12th Nov. 2021, 14:55:32, Central European Time (CET, Germany): \\ ''[[https://weather.eolab.de/api/weather/2021-11-12T14:55:32.000+0100|]]''
@@ Line 100: / Line 122: @@
 Example to retrieve every 5th data set between 627650252438 ms and 1627650855553 ms since 1970-01-01, i.e. from the Fri Jul 30 2021 15:04:12 GMT+0200 to Fri Jul 30 2021 15:14:15 GMT+0200:
 ''[[https://weather.eolab.de/api/weather/1627650252438/1627650855553/5]]''
-===== MQTT to subscribe to Real-Time Online Data =====