WeatherLink Live - Revision history

Freddie: Changed occurrences of WL.com to weatherlink.com

2024-11-09T22:05:38Z

Changed occurrences of WL.com to weatherlink.com

Mcrossley: /* Davis WeatherLink Live */

2020-03-11T18:48:47Z

Davis WeatherLink Live

← Older revision		Revision as of 18:48, 11 March 2020
Line 27:		Line 27:
	# Note the ID you want to use. Go back into the Station setup and enter the ID there. You do not need to restart Cumulus after that.		# Note the ID you want to use. Go back into the Station setup and enter the ID there. You do not need to restart Cumulus after that.
	# Enjoy! Cumulus should now download missing data for periods it is stopped.		# Enjoy! Cumulus should now download missing data for periods it is stopped.


	Eventually once the APIv2 is out of testing, then you should be able to retrieve your APIv2 key and secret via the normal WL.com page along with the existing APIv1 (until it is retired).


Line 35:		Line 32:


	~~Once APIv2 goes live~~ Davis ~~will~~ impose rate and data limits - currently they are ~~proposing~~...		Davis impose rate and data limits on the APIv usage- currently they are...
	* 300 API calls per hour, or 2 API calls per second		* 300 API calls per hour, or 2 API calls per second
	* 24 hours of data in any one call		* 24 hours of data in any one call

Mcrossley: /* Davis WeatherLink Live */

2020-03-11T18:47:43Z

Davis WeatherLink Live

← Older revision		Revision as of 18:47, 11 March 2020
Line 7:		Line 7:
	There are a few caveats around this though...		There are a few caveats around this though...
	* You must have at least a Pro subscription for your device on WL.com to grant access to the historic data.		* You must have at least a Pro subscription for your device on WL.com to grant access to the historic data.
	* The new APIv2 used to access the data ~~is still in testing and development by Davis. Though it seems pretty stable, and I have discovered no bugs in the calls Cumulus uses~~.		* The new APIv2 used to access the data.
	* The APIv2 keys are ~~not yet~~ available via WL.com~~, you must request them on the [https://gitter.im/WeatherLink/weatherlink-live-local-api developer forum] - see below for details~~.		* The APIv2 keys are now available via WL.com.

	If you meet the criteria ~~and are willing to accept that the API is not yet "production" ready~~, then these are the steps you need to follow...		If you meet the criteria, then these are the steps you need to follow...
	# Sign on to the Davis ~~APIv2~~ ~~developer~~ ~~forum:~~ ~~https://gitter.im/WeatherLink~~/~~v2-api~~		# Sign on to the Davis weatherlink.com web site with your normal username/password
			# On wl.com open your user profile, you will see a section titled API Key v2
	# Post a message copying @jeremywall-davis, and request an API key. Jeremy should reply privately within a day or two giving you your API key and secret.
			# If you do not already have a key and secret displayed, click "Generate v2 key" to create them. Copy these strings somewhere safe so you can later paste them into Cumulus
	# Ensure you are running Cumulus MX v3.4.0 or later		# Ensure you are running Cumulus MX v3.4.0 or later
	# If this your first run of CumulusMX.		# If this your first run of CumulusMX.
Line 19:		Line 20:
	## In the WLL section enter your API key and secret. LEAVE THE STATION ID BLANK		## In the WLL section enter your API key and secret. LEAVE THE STATION ID BLANK
	## Set up your sensor to transmitter ID mappings if different from the defaults		## Set up your sensor to transmitter ID mappings if different from the defaults
	## It is not necessary to enter the WLL IP address, Cumulus should just find it on your network. But if you know it it does not harm to enter it, Cumulus will change it anyway if your WLL ever changes address.		## It is not necessary to enter the WLL IP address if you only have one device, Cumulus should just find it on your network. But if you know it it does not harm to enter it, Cumulus will change it anyway if your WLL ever changes address.
	## Save the setup		## Save the setup
	## Stop/Restart Cumulus		## Stop/Restart Cumulus

Mcrossley: Created page with "== Davis WeatherLink Live == The [https://www.weatherstations.co.uk/weatherlink-live.htm Davis WeatherLink Live] device is fully supported by Cumulus MX. Cumulus MX also sup..."

2020-03-06T09:54:01Z

Created page with "== Davis WeatherLink Live == The [https://www.weatherstations.co.uk/weatherlink-live.htm Davis WeatherLink Live] device is fully supported by Cumulus MX. Cumulus MX also sup..."

New page

== Davis WeatherLink Live ==

The [https://www.weatherstations.co.uk/weatherlink-live.htm Davis WeatherLink Live] device is fully supported by Cumulus MX.

Cumulus MX also supports historic data catch-up by using the Davis WeatherLink.com cloud data source - though this does require you to have a Pro licence to enable the feature.

There are a few caveats around this though...
* You must have at least a Pro subscription for your device on WL.com to grant access to the historic data.
* The new APIv2 used to access the data is still in testing and development by Davis. Though it seems pretty stable, and I have discovered no bugs in the calls Cumulus uses.
* The APIv2 keys are not yet available via WL.com, you must request them on the [https://gitter.im/WeatherLink/weatherlink-live-local-api developer forum] - see below for details.

If you meet the criteria and are willing to accept that the API is not yet "production" ready, then these are the steps you need to follow...
# Sign on to the Davis APIv2 developer forum: https://gitter.im/WeatherLink/v2-api
# Post a message copying @jeremywall-davis, and request an API key. Jeremy should reply privately within a day or two giving you your API key and secret.
# Ensure you are running Cumulus MX v3.4.0 or later
# If this your first run of CumulusMX.
## Add a local firewall rule on your server to enable UDP port 22222 inbound
## Go into the Station setup and select Davis WLL as the station type
## In the WLL section enter your API key and secret. LEAVE THE STATION ID BLANK
## Set up your sensor to transmitter ID mappings if different from the defaults
## It is not necessary to enter the WLL IP address, Cumulus should just find it on your network. But if you know it it does not harm to enter it, Cumulus will change it anyway if your WLL ever changes address.
## Save the setup
## Stop/Restart Cumulus
# If you only have a single station registered with WL.com, then Cumulus should discover its ID automatically and start using it
# But if you have more than one, the Cumulus will list their API IDs and names in the console window.
# Note the ID you want to use. Go back into the Station setup and enter the ID there. You do not need to restart Cumulus after that.
# Enjoy! Cumulus should now download missing data for periods it is stopped.

Eventually once the APIv2 is out of testing, then you should be able to retrieve your APIv2 key and secret via the normal WL.com page along with the existing APIv1 (until it is retired).

There is effectively no limit on how much historic data you can download++, I have tested using a four day catch-up without issues.

Once APIv2 goes live Davis will impose rate and data limits - currently they are proposing...
* 300 API calls per hour, or 2 API calls per second
* 24 hours of data in any one call
Cumulus honours these restrictions.

The APIv2 uses both a key and a secret that encrypts part of the URL making playback or emulating the API calls by another user impossible. A nice feature other web APIs could emulate.

''++Cumulus MX will get the max 24 hours data per call if required, which will give a limit of 300 days of historic data catch-up.''

← Older revision		Revision as of 22:05, 9 November 2024
Line 6:		Line 6:

	There are a few caveats around this though...		There are a few caveats around this though...
	* You must have at least a Pro subscription for your device on WL.com to grant access to the historic data.		* You must have at least a Pro subscription for your device on weatherlink.com to grant access to the historic data.
	* The new APIv2 used to access the data.		* The new APIv2 used to access the data.
	* The APIv2 keys are now available via WL.com.		* The APIv2 keys are now available via weatherlink.com.

	If you meet the criteria, then these are the steps you need to follow...		If you meet the criteria, then these are the steps you need to follow...
	# Sign on to the Davis weatherlink.com web site with your normal username/password		# Sign on to the Davis weatherlink.com web site with your normal username/password
	# On wl.com open your user profile, you will see a section titled API Key v2		# On weatherlink.com open your user profile, you will see a section titled API Key v2
	# If you do not already have a key and secret displayed, click "Generate v2 key" to create them. Copy these strings somewhere safe so you can later paste them into Cumulus		# If you do not already have a key and secret displayed, click "Generate v2 key" to create them. Copy these strings somewhere safe so you can later paste them into Cumulus
	# Ensure you are running Cumulus MX v3.4.0 or later		# Ensure you are running Cumulus MX v3.4.0 or later
Line 20:		Line 20:
	## In the WLL section enter your API key and secret. LEAVE THE STATION ID BLANK		## In the WLL section enter your API key and secret. LEAVE THE STATION ID BLANK
	## Set up your sensor to transmitter ID mappings if different from the defaults		## Set up your sensor to transmitter ID mappings if different from the defaults
	## It is not necessary to enter the WLL IP address if you only have one device, Cumulus should just find it on your network. But if you know it it does not harm to enter it, Cumulus will change it anyway if your WLL ever changes address.		## It is not necessary to enter the WLL IP address if you only have one device, Cumulus should just find it on your network. But if you know it, it does not harm to enter it, Cumulus will change it anyway if your WLL ever changes address.
	## Save the setup		## Save the setup
	## ~~Stop/~~Restart Cumulus		## Restart Cumulus
	# If you only have a single station registered with WL.com, then Cumulus should discover its ID automatically and start using it		# If you only have a single station registered with weatherlink.com, then Cumulus should discover its ID automatically and start using it
	# But if you have more than one, the Cumulus will list their API IDs and names in the console window.		# But if you have more than one, the Cumulus will list their API IDs and names in the console window.
	# Note the ID you want to use. Go back into the Station setup and enter the ID there. You do not need to restart Cumulus after that.		# Note the ID you want to use. Go back into the Station setup and enter the ID there. You do not need to restart Cumulus after that.