Sprinkler

Project

OsProject
id
state
owner
title	software for sprinkler / water irrigation system based on weather and other parameters
url	https://github.com/BITPlan/com.bitplan.sprinkler
version	0.0.1
description
date
since
until

Requirements

See also

• https://gardening.stackexchange.com/questions/41255/calculating-amount-of-water-needed-per-day-based-on-weather-and-other-parameters
• https://github.com/BITPlan/com.bitplan.sprinkler/issues

1. The System shall sprinkle if the lawn needs water
2. The System shall sprinkle in the morning no earlier than configured
3. The System shall sprinkle in the evening no later than configured
4. The System shall sprinkle as often per day as configured
5. The System shall collect rain data from a weather service
6. The System shall operate by simply switching on and off a garden pump at appropriate times
7. The System shall determine the amount of irrigation needed based on the weather and the configuration data
8. An Administrator shall be able to configure the system by setting
   1. coordinates of the location where the system is operated lon/lat
   2. l/minute the sprinkler deploys when switched on
   3. earliest time in the morning the system may sprinkle
   4. latest time in the evening the system may sprinkle
   5. number of times per day the system shall sprinkle if needed
   6. size of area to being sprinkled
   7. average l/day beeing evaporated per day by non lawn plants (e.g. trees)
9. A user shall be able to arm/disarm the system
10. A user shell be able to see the system operation log
11. The system operation log shall show the amount of water that has been irrigated as an equivalent mm rain / day and the total liters for the area
12. The system shall read a list of weather locations from the openweather api

Use cases

configure system

As an administrator I'd like to configure the system.

System context

Sprinkler component

Weather API alternatives

• http://www.programmieren-optimieren.de/php/google-wetter-api-eingestellt-die-alternativen/
• https://stackoverflow.com/questions/12461730/find-weather-using-java

Open Weather Api

City list: http://bulk.openweathermap.org/sample/city.list.json.gz

Example city Willich

{
    "id": 2808559,
    "name": "Willich",
    "country": "DE",
    "coord": {
      "lon": 6.55,
      "lat": 51.26667
    }
  },

Example weather

https://api.openweathermap.org/data/2.5/weather?q=Willich,DE&appid=0123456789abcdef...&units=metric

{
 "coord":{"lon":6.54,"lat":51.26},
 "weather":[{"id":800,"main":"Clear","description":"clear sky","icon":"01d"}],"base":"stations",
 "main":{"temp":28.84,"pressure":1020,"humidity":37,"temp_min":27,"temp_max":30},"visibility":10000,
 "wind":{"speed":1.5},
 "clouds":{"all":0},"dt":1533138900,
 "sys":{"type":1,"id":4909,"message":0.0046,"country":"DE","sunrise":1533095958,"sunset":1533151198},
 "id":2808559,
 "name":"Willich",
 "cod":200
}

Java Code

• https://stackoverflow.com/questions/50388823/java-get-specific-json-information-from-weather-api/50389193#50389193

DWD Data

Precipitation data:

• https://www.dwd.de/DE/leistungen/radolan/radolan.html
• Adjusted 1h total precipitation [mm/h] (Radolan), 1km x 1km, Runlength format raa01-rw_10000-[yyMMddhhmm]-dwd---bin
• https://www.dwd.de/EN/ourservices/surface_weather_observations/surface_weather_observations.html

How to read Radolan data

1. https://www.hs-rm.de/de/fachbereiche/architektur-und-bauingenieurwesen/forschungsprofil/arbeitsgruppe-starkregen-und-sturzfluten/projekt-klimprax-ap1/radar-software/

Wetter Online

• https://wo.wetteronline.de/media/api/Schnittstellendokumentation_Wetter-API_v1_ges.pdf

METAR

https://en.wikipedia.org/wiki/METAR Example: Mönchengladbach

• http://tgftp.nws.noaa.gov/data/observations/metar/decoded/EDLN.TXT