diff --git a/CODEOWNERS b/CODEOWNERS index 48d5b69c26f92..d3bb641be4e53 100644 --- a/CODEOWNERS +++ b/CODEOWNERS @@ -61,7 +61,6 @@ /bundles/org.openhab.binding.daikin/ @caffineehacker /bundles/org.openhab.binding.dali/ @rs22 /bundles/org.openhab.binding.danfossairunit/ @pravussum -/bundles/org.openhab.binding.darksky/ @cweitkamp /bundles/org.openhab.binding.dbquery/ @lujop /bundles/org.openhab.binding.deconz/ @openhab/add-ons-maintainers /bundles/org.openhab.binding.denonmarantz/ @jwveldhuis diff --git a/bom/openhab-addons/pom.xml b/bom/openhab-addons/pom.xml index a6f031b92009f..c09d399701ca0 100644 --- a/bom/openhab-addons/pom.xml +++ b/bom/openhab-addons/pom.xml @@ -296,11 +296,6 @@ org.openhab.binding.danfossairunit ${project.version} - - org.openhab.addons.bundles - org.openhab.binding.darksky - ${project.version} - org.openhab.addons.bundles org.openhab.binding.dbquery diff --git a/bundles/org.openhab.binding.darksky/NOTICE b/bundles/org.openhab.binding.darksky/NOTICE deleted file mode 100644 index 38d625e349232..0000000000000 --- a/bundles/org.openhab.binding.darksky/NOTICE +++ /dev/null @@ -1,13 +0,0 @@ -This content is produced and maintained by the openHAB project. - -* Project home: https://www.openhab.org - -== Declared Project Licenses - -This program and the accompanying materials are made available under the terms -of the Eclipse Public License 2.0 which is available at -https://www.eclipse.org/legal/epl-2.0/. - -== Source Code - -https://github.com/openhab/openhab-addons diff --git a/bundles/org.openhab.binding.darksky/README.md b/bundles/org.openhab.binding.darksky/README.md deleted file mode 100644 index 94519ae5470f6..0000000000000 --- a/bundles/org.openhab.binding.darksky/README.md +++ /dev/null @@ -1,368 +0,0 @@ -# Dark Sky Binding - -This binding integrates the [Dark Sky API](https://darksky.net/dev/docs). - -::: tip Note -The Dark Sky API service for existing customers will continue until the end of 2022. -They do no longer accept new signups. -::: - -## Supported Things - -There are two supported things. - -### Dark Sky Account - -First one is a bridge `weather-api` which represents the Dark Sky account. -The bridge holds the mandatory API key to access the Dark Sky API and several global configuration parameters. -If your system language is supported by the Dark Sky API it will be used as default language for the requested data. - -### Current Weather And Forecast - -The second thing `weather-and-forecast` supports the [current weather](https://darksky.net/dev/docs#forecast-request), hour-by-hour forecast for the next 48 hours and day-by-day forecast for the next week for a specific location. -It requires coordinates of the location of your interest. -You can add as many `weather-and-forecast` things for different locations to your setup as you like to observe. -Severe [weather alerts](https://darksky.net/dev/docs/sources) are available in the USA, Canada, Iceland, European Union member nations, and Israel. - -## Discovery - -If a system location is set, a "Local Weather And Forecast" (`weather-and-forecast`) thing will be automatically discovered for this location. -Once the system location will be changed, the background discovery updates the configuration of "Local Weather And Forecast" accordingly. - -## Thing Configuration - -### Dark Sky Account - -| Parameter | Description | -|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| apikey | API key to access the Dark Sky API. **Mandatory** | -| refreshInterval | Specifies the refresh interval (in minutes). Optional, the default value is 60, the minimum value is 1. Note: when using a free API key (1000 calls/day), do not use an interval less than 2. | -| language | Language to be used by the Dark Sky API. Optional, valid values are: `ar`, `az`, `be`, `bg`, `bn`, `bs`, `ca`, `cs`, `da`, `de`, `el`, `en`, `eo`, `es`, `et`, `fi`, `fr`, `he`, `hi`, `hr`, `hu`, `id`, `is`, `it`, `ja`, `ka`, `ko`, `kn`, `kw`, `lv`, `mr`, `nb`, `nl`, `no`, `pa`, `pl`, `pt`, `ro`, `ru`, `sk`, `sl`, `sr`, `sv`, `ta`, `te`, `tet`, `tr`, `uk`, `x-pig-latin`, `zh`, `zh-tw`. | - -### Current Weather And Forecast - -| Parameter | Description | -|----------------|-------------------------------------------------------------------------------------------------------------------------------| -| location | Location of weather in geographical coordinates (latitude/longitude/altitude). **Mandatory** | -| forecastHours | Number of hours for hourly forecast. Optional, the default value is 24 (min="0", max="48", step="1"). | -| forecastDays | Number of days for daily forecast (including todays forecast). Optional, the default value is 8 (min="0", max="8", step="1"). | -| numberOfAlerts | Number of alerts to be shown. Optional, the default value is 0 (min="0", step="1"). | - -Once one of the parameters `forecastHours`, `forecastDays` or `numberOfAlerts` will be changed, the available channel groups on the thing will be created or removed accordingly. - -## Channels - -### Current Weather - -| Channel Group ID | Channel ID | Item Type | Description | -|------------------|----------------------|----------------------|-------------------------------------------------------------------------| -| current | time-stamp | DateTime | Time of data observation. | -| current | condition | String | Current weather condition. | -| current | icon | Image | Icon representing the current weather condition. | -| current | icon-id | String | Id of the icon representing the current weather condition. **Advanced** | -| current | temperature | Number:Temperature | Current temperature. | -| current | apparent-temperature | Number:Temperature | Current apparent temperature. | -| current | pressure | Number:Pressure | Current barometric pressure. | -| current | humidity | Number:Dimensionless | Current atmospheric humidity. | -| current | wind-speed | Number:Speed | Current wind speed. | -| current | wind-direction | Number:Angle | Current wind direction. | -| current | gust-speed | Number:Speed | Current gust speed. **Advanced** | -| current | cloudiness | Number:Dimensionless | Current cloudiness. | -| current | visibility | Number:Length | Current visibility. | -| current | rain | Number:Speed | Current rain intensity. | -| current | snow | Number:Speed | Current snow intensity. | -| current | precip-intensity | Number:Speed | Current precipitation intensity. | -| current | precip-probability | Number:Dimensionless | Current precipitation probability. | -| current | precip-type | String | Current precipitation type (Rain, Snow or Sleet). | -| current | uvindex | Number | Current UV index. | -| current | ozone | Number:ArealDensity | Current ozone. | - -### Hourly Forecast - -| Channel Group ID | Channel ID | Item Type | Description | -|-------------------------------------------------------|----------------------|----------------------|------------------------------------------------------| -| forecastHours01, forecastHours02, ... forecastHours48 | time-stamp | DateTime | Time of data forecasted. | -| forecastHours01, forecastHours02, ... forecastHours48 | condition | String | Forecast weather condition. | -| forecastHours01, forecastHours02, ... forecastHours48 | icon | Image | Icon representing the forecasted weather condition. | -| forecastHours01, forecastHours02, ... forecastHours48 | icon-id | String | Id of the forecasted weather condition. **Advanced** | -| forecastHours01, forecastHours02, ... forecastHours48 | temperature | Number:Temperature | Forecasted temperature. | -| forecastHours01, forecastHours02, ... forecastHours48 | apparent-temperature | Number:Temperature | Forecasted apparent temperature. | -| forecastHours01, forecastHours02, ... forecastHours48 | pressure | Number:Pressure | Forecasted barometric pressure. | -| forecastHours01, forecastHours02, ... forecastHours48 | humidity | Number:Dimensionless | Forecasted atmospheric humidity. | -| forecastHours01, forecastHours02, ... forecastHours48 | wind-speed | Number:Speed | Forecasted wind speed. | -| forecastHours01, forecastHours02, ... forecastHours48 | wind-direction | Number:Angle | Forecasted wind direction. | -| forecastHours01, forecastHours02, ... forecastHours48 | gust-speed | Number:Speed | Forecasted gust speed. **Advanced** | -| forecastHours01, forecastHours02, ... forecastHours48 | cloudiness | Number:Dimensionless | Forecasted cloudiness. | -| forecastHours01, forecastHours02, ... forecastHours48 | visibility | Number:Length | Forecasted visibility. | -| forecastHours01, forecastHours02, ... forecastHours48 | rain | Number:Speed | Forecasted rain intensity. | -| forecastHours01, forecastHours02, ... forecastHours48 | snow | Number:Speed | Forecasted snow intensity. | -| forecastHours01, forecastHours02, ... forecastHours48 | precip-intensity | Number:Speed | Forecasted precipitation intensity. | -| forecastHours01, forecastHours02, ... forecastHours48 | precip-probability | Number:Dimensionless | Forecasted precipitation probability. | -| forecastHours01, forecastHours02, ... forecastHours48 | precip-type | String | Forecasted precipitation type (Rain, Snow or Sleet). | -| forecastHours01, forecastHours02, ... forecastHours48 | uvindex | Number | Forecasted UV index. | -| forecastHours01, forecastHours02, ... forecastHours48 | ozone | Number:ArealDensity | Forecasted ozone. | - -### Daily Forecast - -| Channel Group ID | Channel ID | Item Type | Description | -|-----------------------------------------------------------------|--------------------------|----------------------|------------------------------------------------------| -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | time-stamp | DateTime | Time of data forecasted. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | condition | String | Forecast weather condition. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | icon | Image | Icon representing the forecasted weather condition. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | icon-id | String | Id of the forecasted weather condition. **Advanced** | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | min-temperature | Number:Temperature | Minimum forecasted temperature of a day. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | max-temperature | Number:Temperature | Maximum forecasted temperature of a day. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | min-apparent-temperature | Number:Temperature | Minimum forecasted apparent temperature of a day. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | max-apparent-temperature | Number:Temperature | Maximum forecasted apparent temperature of a day. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | pressure | Number:Pressure | Forecasted barometric pressure. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | humidity | Number:Dimensionless | Forecasted atmospheric humidity. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | wind-speed | Number:Speed | Forecasted wind speed. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | wind-direction | Number:Angle | Forecasted wind direction. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | gust-speed | Number:Speed | Forecasted gust speed. **Advanced** | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | cloudiness | Number:Dimensionless | Forecasted cloudiness. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | visibility | Number:Length | Forecasted visibility. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | rain | Number:Speed | Forecasted rain intensity. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | snow | Number:Speed | Forecasted snow intensity. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | precip-intensity | Number:Speed | Forecasted precipitation intensity. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | precip-probability | Number:Dimensionless | Forecasted precipitation probability. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | precip-type | String | Forecasted precipitation type (Rain, Snow or Sleet). | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | uvindex | Number | Forecasted UV index. | -| forecastToday, forecastTomorrow, forecastDay2, ... forecastDay7 | ozone | Number:ArealDensity | Forecasted ozone. | - -### Severe Weather Alerts - -| Channel Group ID | Channel ID | Item Type | Description | -|-----------------------|-------------|-----------|----------------------------------------------------------------------------------------------| -| alerts1, alerts2, ... | title | String | A brief description of the alert. | -| alerts1, alerts2, ... | description | String | A detailed description of the alert. | -| alerts1, alerts2, ... | severity | String | The severity of the alert. | -| alerts1, alerts2, ... | issued | DateTime | The time at which the alert was issued. | -| alerts1, alerts2, ... | expires | DateTime | The time at which the alert will expire. | -| alerts1, alerts2, ... | uri | String | An external URI that one may refer to for detailed information about the alert. **Advanced** | - -## Trigger Channels - -### Current Weather - -| Channel Group ID | Channel ID | Description | -|------------------|---------------|-----------------------------------------| -| current | sunrise-event | Event for sunrise. Can trigger `START`. | -| current | sunset-event | Event for sunset. Can trigger `START`. | - -### Configuration - -**Offset:** For each trigger channel you can optionally configure an `offset` in minutes. -The `offset` must be configured in the channel properties for the corresponding thing. -The minimum allowed `offset` is -1440 and the maximum allowed `offset` is 1440. - -If an `offset` is set, the event is moved forward or backward accordingly. - -**Earliest / Latest:** For each trigger channel you can optionally configure the `earliest` and `latest` time of the day. - -If sunset is at 17:40 but `earliest` is set to 18:00, the event is moved to 18:00. - -OR - -If sunset at is 22:10 but `latest` is set to 21:00, the event is moved to 21:00. - -## Full Example - -### Things - -demo.things - -```java -Bridge darksky:weather-api:api "Dark Sky Account" [apikey="AAA", refreshInterval=30, language="de"] { - Thing weather-and-forecast local "Local Weather And Forecast" [location="XXX,YYY", forecastHours=0, forecastDays=8, numberOfAlerts=1] { - Channels: - Type sunset-event : current#sunset-event [ - earliest="18:00", - latest="21:00" - ] - } - Thing weather-and-forecast miami "Weather And Forecast In Miami" [location="25.782403,-80.264563", forecastHours=24, forecastDays=0] -} -``` - -### Items - -demo.items - -```java -DateTime localLastMeasurement "Timestamp of last measurement [%1$tY-%1$tm-%1$tdT%1$tH:%1$tM:%1$tS]"