supported_hardware:darksky
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revisionNext revisionBoth sides next revision | ||
supported_hardware:darksky [2019/08/17 19:50] – created James Sentman | supported_hardware:darksky [2020/07/17 11:18] – James Sentman | ||
---|---|---|---|
Line 1: | Line 1: | ||
=====Darksky Weather===== | =====Darksky Weather===== | ||
- | The DarkSky | + | **NOTE:** Darksky was purchased by Apple recently and the API that drives this plugin appears to be going away. I would not advise going to the trouble to set this up at the moment as you only have some short months left to use it until they shut it down.\\ |
+ | \\ | ||
+ | \\ | ||
+ | |||
+ | The Darksky Weather plugin connects to their excellent and very complete API. Since this is not a commercial product it follows in the tradition of other similar home automation | ||
+ | |||
+ | You can register for a developer key here: [[https:// | ||
+ | |||
+ | Each instance of the plugin | ||
+ | |||
+ | The DarkSky plugin creates many reports that can be dragged into an XTension View or placed on a Web Interface page. It also creates many unit types for getting specific information into XTension so you can plan actions or irrigation schedules and such based on upcoming chance of rain or other items of information. | ||
+ | |||
+ | ---- | ||
+ | ====Plugin Settings==== | ||
+ | {{: | ||
+ | **Update Settings:** Enter the interval in minutes that you want the forecast to update. The minimum settings | ||
+ | \\ | ||
+ | **Location: | ||
+ | \\ | ||
+ | **Language: | ||
+ | \\ | ||
+ | **Units:** Select | ||
+ | \\ | ||
+ | **Dark Sky API Settings:** Enter your API key into this field. This is required as Dark Sky will not process any queries without it | ||
+ | |||
+ | ---- | ||
+ | ====Forecast Display==== | ||
+ | To display a text forecast display create a new Unit and assign it’s interface to your DarkSky plugin instance. Select “Forecast Display” from the Device or Unit Type popup. Once the Unit is configured drag it into a View or create a new control in a View or a Web Interface of type “Unit Description as HTML." \\ | ||
+ | \\ | ||
+ | **You must assign the unit an address** All Units that are not Pseudos in XTension must have an address. In this case the address doesn’t actually matter. Start by placing just a “0” into the address field. If you create more forecast units assigned to this interface you can just increment the address number so that each one assigned to the same interface is unique. If you have multiple plugin instances then each one is a separate address space.\\ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | \\ | ||
+ | {{: | ||
+ | **Format As:** The plugin can format the display either as human readable text or in a table layout. See the examples below. **Note:** there is a bug in the current alpha of the plugin and these 2 selections seem to be reversed. So select “Text” to create a table display and vice versa. This will be fixed in a future update.\\ | ||
+ | \\ | ||
+ | **Font Size:** Since there are so many options for display and so many options for how you might wish to display this information you can set a font size here to make it readable or fit properly in whatever interface you put it. \\ | ||
+ | \\ | ||
+ | **Days to include:** Forecast data is available up to 8 days in the future. You can choose how many days to include in this output.\\ | ||
+ | \\ | ||
+ | **Data To Include:** There is a lot of data available in the darksky forecast output. You can choose which data points you’re interested in for this particular display.\\ | ||
+ | \\ | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ---- | ||
+ | ====Precipitation Graph By The Minute==== | ||
+ | Darksky provides estimates for Chance Of Precipitation and Precipitation Intensity in every minute for the next hour. **Note:** Every non-pseudo Unit in XTension must have an address. Though the address is not used for this report unit it must still be present and must be unique. Just entering a “0” in the Address field is enough. If you wish to create multiple Next Hour Data Displays then just increment the number for each new one you create.\\ | ||
+ | \\ | ||
+ | |||
+ | {{: | ||
+ | To display a graph of any time up to the next hour create a new Unit and assign it to the Darksky Interface. Select “Next Hour Data Display” from the Device/Unit type popup. Once the Unit is configured either drag it onto a View or create a new View or Web Interface control with the type set to “Unit Description As HTML.” Apologies that this screen shot example is not very interesting as there is no chance of rain here in the next hour. I will update that as soon as there is.\\ | ||
+ | < | ||
+ | \\ | ||
+ | {{: | ||
+ | **Data To Show:** A minutely report can display either “Chance Of Precipitation” or “Precipitation Intensity”\\ | ||
+ | \\ | ||
+ | **How many datapoints to include** Enter the number of minutes to include in the report. Data is available for up to 61 minutes.\\ | ||
+ | \\ | ||
+ | **Draw Timestamp: | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ---- | ||
+ | ====Hourly Graphs==== | ||
+ | {{: | ||
+ | |||
+ | < | ||
+ | \\ | ||
+ | {{: | ||
+ | To create an hourly report Unit select “Next 24 Hours Data Display” from the Device type popup after creating a new Unit.\\ | ||
+ | \\ | ||
+ | **Data To Show:** For hourly reports you can choose to display from the following: “Chance Of Precipitation”, | ||
+ | \\ | ||
+ | **How many datapoints to include (1-49):** Hourly forecast data is available up to 49 hours from now. The best accuracy is in the next 24 hours.\\ | ||
+ | \\ | ||
+ | **Draw Timestamp: | ||
+ | |||
+ | |||
+ | ---- | ||
+ | This entry is a work in progress. The above is only a tiny portion of the available data types, reports and units. More will be added as soon as the current hurricane has passed over me... |
supported_hardware/darksky.txt · Last modified: 2023/02/13 14:52 by 127.0.0.1