AKWeather NOAA, Metoffice UK.. - 41 providers! PWS local Davis, Ecowitt, AW, Tempest

[alexbk66]

AK NetCam	AK Weather	AK Web I/O	AK Bond	NeoSmart Blinds	Arylic Linkplay	AK SwichBot
EnphaseEnvoy	AK IKEA	ControlByWeb	AK Shelly	AK Remootio	AK Traccar	AK AndroidTV
AK PumpFuse	AK GoogleCast	GoogleCalendar	AK Sonoff	AK SmartDevice	HeatmiserNeo	HomeAssistant

NOTE: I have to start this new tread - as the forum doesn't let me edit the original post anymore.

Currently implemented 44 different providers, including many PWS support and weather Alerts (provider specific). GDACS - Global Disaster Alert and Coordination System Multiple Air Quality providers. Note: for Air Quality try WAQI (World Air Quality Index Project) Minimal user configuration - after plugin is installed it creates new location, user just needs to select provider and enter provider API key. Supports multiple locations, multiple languages and multiple providers. One useful feature - you can switch provider without re-creating the Location devices, meaning no need for modifying HS Events (Triggers) and HSTouch screens.
I try to display details common for all providers, but if anything is missing - please let me know.	Any requests: https://forums.homeseer.com/forum/hs...tures-requests
Fully customisable Weather Overview (HTML/PNG) https://forums.homeseer.com/forum/hs...ew-html-png

[alexbk66]

Currently implemented 44 different providers, including many PWS and AQI support and weather Alerts (provider specific). Marine weather (Tomorrow.IO, Open-Meteo, NOAA - Marine, NDBC, TidesAndCurrents) NOTE 1: Ecowitt and AmbientWeater protocols may work with other brands (list may not be complete) : Froggit, Aercus, ChiliTec, DNT, ELV, GARNI, Misol, PanTech, Renkforce, Sainlogic, Steinberg Systems, Ventus, Waldbeck, Watson ...etc. - please check Fine Offset (FOSHK) Weather Stations i.e. consoles, sensors and clone NOTE 2: AK Weather creates the HS devices only for data available from provider, please note that for example rain / snow devices will be created only when provider reports rain / snow.

Countries: Alerts Hourly Forecast Yr.no (met.no) 66 hrs NOAA (USA) (Incl. Alerts) (NOAA1 - Limited Alerts) 155 hrs NOAA - Marine NOAA - NDBC (National Data Buoy Center) NOAA - Tides And Currents (tidesandcurrents.noaa.gov) MetOffice (UK) - two providers: Global Spot Data, and MetOffice DataPoint (MeteoAlarm EU Alerts) BOM (AU) (Incl. Alerts) 72 hrs Koninklijk Nederlands Meteorologisch Instituut Buienradar (Nederlands) Environment Canada (Limited Alerts) Other providers: Open-Meteo (new) 7x24 h VisualCrossing (new) 14x24h Tomorrow.IO (New) Incl. Air Quality 15x24h Meteosource (new) Great for Europe 15x24h WeatherUnderground DarkSky (Incl. Alerts) Accuweather (Including Daily Health Indices) 12 hrs Openweathermap (Incl. Alerts) 48 hrs Weatherbit weatherUSA (Incl. Alerts) WeatherUnlocked (UK) WeatherApi.com (Incl. Alerts) 5x24 hrs

PWS and Air Quality (AQI): Global Disaster Alert and Coordination System PWS Forecast Cloud Local (Remote) (WiFi) ControlByWeb X-320M WeatherUnderground Netatmo Meteobridge AerisWeather (PWSweather.com) (Incl. Alerts) WeatherLink (Davis Instruments) AirLink WeatherFlow Tempest (AIR, SKY) 99 hrs Cumulus (via Realtime.txt) AmbientWeather Ecowitt Fine Offset (FOSHK) clones - see Note above SensorPush sensors Air Quality (AQI) Cloud Local (Remote) (WiFi) Aqicn (Air Quality Open Data Platform) World Air Quality Index Project Tomorrow.IO IQAir uRADMonitor PurpleAir

[alexbk66]

Screenshots

[alexbk66]

Configuration

When plugin starts - it creates first location device.

If necessary, more locations can be added on the main Settings page ("Add new location"). Please locate the new Location in the list of locations on the top menu bar in Settings screen.

1. By default the location is named based on the current coordinates (from HS settings) - assuming "Use location address for new Location" is enabled. But you can always rename the location (i.e. Home)

2. By default the coordinates are used from HS settings, but you can change them.

3. Select the provider from the list

4. If required by provider, enter the API key. The provider specific request "Link for API key" is shown below the key input field.

5, 6. Maximum number of forecast days (default 2) and forecast hours (6) (default 0) depends on the provider and location, so it will become available after the settings are saved and data is successfully received from the provider.

7. It's possible to provide alternative icon sets - just create a new folder next to "C:\Program Files (x86)\HomeSeer HS4\html\images\AKWeather\CanWeather" and duplicate all icons with same names. Icon names are provider specific, please ask if have any questions.

	To add new Location - switch "Add new Location" and click "SAVE"

Notes

Note 1. Provider API keys are stored per-provider, so if you select different provider - its key will be also restored.

Note 2. Units are automatically selected based on HS setting. Units may work differently per provider. Please let me know of any issues.

Note 3. Renaming/Deleting Location Root device (either via HS GUI, or Location settings) will also Rename/Delete all Forecast Day devices (roots and children)

Note 4. For some providers additional config options may appear, i.e. Language selection, or for NOAA, Weather Underground, Ambient Weather, etc. you can select a weather station from the list. The list is automatically populated based on the location, and closest station is automatically selected.

Note 5. To create Alert devices without alerts available (i.e. to create triggers) - please read https://forums.homeseer.com/forum/hs...48#post1586248

PWS Support

Personal weather stations are supported by Weather Underground, Ambient Weather, Netatmo, Ecowitt, WeatherFlow Tempest, Davis Weather Link, etc. providers.

For most PWS providers both Local (WiFi) and Server (Cloud) APIs are supported.

When the provider is selected - it will find a list of nearby weather stations (or user PWS depending on provider) - then you can select from the list, or enter desired Station ID manually.

[alexbk66]

World Air Quality Index

Note: Ver 4.0.5.30 I converted the AQICN (WAQI) provider to standard standalone WAQI provider for consistency: https://forums.homeseer.com/forum/hs...ider-important - so it's now configured as any other provider, so rest of this post is deprecated.

---

To enable World Air Quality Index data request token aqicn.org/data-platform/token/ and enter in the plugin Settings page.

Note 1: Also "Show Air Quality Index (AQI)" should be enabled for each location separately.

Note 2: Number of AQI HS devices is affected by "Minimal details level" toggle (per location) and the data available.

Note 3: Since there's no info about the measurement units, please verify the readings - there's HS Air Quality Link device which provides link to the EPA station webpage. Let me know of any readings mismatch.

Note 4: AQI station is selected based on the Location coordinates, but you can also set Optional station ID (may need 'A' or '@' prefix)

[alexbk66]

Selecting devices to display

For selecting child devices you want to display I choose opposite(to other plugins) approach.

All children are created by default (provider dependant). Then you can go to the list of children and disable unwanted devices.

Please note that child devices are created only when data is available, so to be able to disable devices - they need to be created first.

On Location config at the bottom click "Enable to display list of child devices selector" (and Save)

Then list of all child devices will appear - for following groups (provider dependant)

- Current Conditions
- Day Forecast
- Hour Forecast
- Air Quality (WAQI)
- Alerts
- Health Indices

The unselected devices will be marked "Not used" - I don't delete them. Then you may delete the unwanted devices manually, they won't be re-created after plugin restart.

The selection applies only to the particular Location, when you create another location - you will need to disable unwanted devices again.

But I will also add a button to save the current selection for the selected provider as default (when you create a new Location with the same provider.

[alexbk66]

Using Alert Trigger

Note 1: "Select Location" list includes only Locations which Provider supports Alerts.

Note 2: The way Alerts are implemented in AKWeather - without any current alerts the only Alert child device is created in the main Location root. When Alerts become available - additional root devices are created for each Alert (up to 3).

If you want to pre-create the Alert roots - you can select "Test Alerts" in the Location settings. For GDACS you can increase the max distance to alert (to the "Distance to first three alerts"). After the Alert roots are created - you can decrease the setting back to desired distance.

To test Alert - Location settings have "Test Alerts" select list - 1 to 3 test Alerts - for each Alert the new Root device will be created (0 to disable test). Every time manually POLL the Location - the test Alert text will change.


In addition to separate Alert roots (group of devices) I also add Alert device to the main Location root, and this is used for $$GLOBALVAR:alert: variable.

This Alert device uses the first Alert from the list of alerts, which is usually sorted by severity, but this really depends on the provider.

I set the following $$GLOBALVAR when the trigger fires:

"loc_name" - Name of the Location which triggers the alert

"alert", "alert_url" - Alert headline (short description) and the URL to the provider website if available (the first Alert from the list of alerts)

"alert0", "alert1", "alert2", "alert_descr0", "alert_descr1", "alert_descr2" - headline and long description for each Alert.

Some considerations:

1. These variables are set when the trigger fires, so if you have multiple Locations with Alerts - these variables will be overwritten by each trigger. Not sure how to improve this.

2. Since the "alert" variable is set for the first Alert (sorted by severity) - the "alert1" will be usually the same as "alert".

3. Many providers (incl. NOAA) may have multiple alert entries with the same Alert text, but different status, i.e. "Issued", "Updated", etc. I try to filter the alerts (i.e. use only "Updated" alert), but it's not trivial. So sometimes you may get same text for "alert1", "alert2", etc.

[alexbk66]

Ver 4.0.5.5 - Added Tomorrow.IO provider

Up to 15 Days and 360 Hours Forecast. Adding Weather Alerts also.

[alexbk66]

Ver 4.0.5.6 - Tomorrow.IO - Added Air Quality

[alexbk66]

Ver 4.0.5.8 - Added Meteosource provider

[alexbk66]

Ver 4.0.5.9 - Tomorrow.IO - Added Fire Danger Index; Added Marine conditions and forecast (wave height and direction, wave period, water temperature, current speed and direction, tide height)

[alexbk66]

Ver 4.0.5.12 - Added NOAA TidesAndCurrents provider.

https://forums.homeseer.com/forum/hs...rents-provider

[alexbk66]

Ver 4.0.5.23 - AmbientWeather and Ecowitt - workaround don't show "batt_co2" if no CO2 reading.

You can delete the mystery "batt_co2" device.

[alexbk66]

Ver 4.0.5.30 - converted the AQICN (WAQI) provider to standard standalone WAQI provider for consistency.

This allows to have separate forecast devices (up-to 8 days) for Pm10, Pm25, O3 and UV (depending on location).

For those using "Show World Air Quality Index (WAQI)" please read: https://forums.homeseer.com/forum/hs...ider-important

[alexbk66]

Ver 4.0.5.33 - Added speed units selection per provider (please test)