-
Notifications
You must be signed in to change notification settings - Fork 7.1k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Magicseaweed sensor documentation #5598
Merged
Merged
Changes from all commits
Commits
Show all changes
9 commits
Select commit
Hold shift + click to select a range
2287616
Magicseaweed sensor documentation
jcconnell 1bbad17
Making @frenck requested changes.
jcconnell 8e1bcdd
Add Magicseaweed logo
jcconnell f10bf70
Changed logo name.
jcconnell b118834
Remove incorrectly named logo.
jcconnell 22e16cb
Correct mapping error line 9 column 25 of YAML
jcconnell c6d78d2
HA Release Update & removed irrelevant config
jcconnell e191863
Attempting to fix Jekyll errors
jcconnell 46bee9b
Add @MartinHjelmare requested changes.
jcconnell File filter
Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,95 @@ | ||
--- | ||
layout: page | ||
title: "Magicseaweed Sensor" | ||
description: "How to integrate Magicseaweed within Home Assistant." | ||
date: 2018-06-24 21:00 | ||
sidebar: true | ||
comments: false | ||
sharing: true | ||
footer: true | ||
logo: magicseaweed.png | ||
ha_category: Sensor | ||
featured: false | ||
ha_release: "0.75" | ||
ha_iot_class: "Cloud Polling" | ||
--- | ||
|
||
The 'magicseaweed' platform uses the [Magicseaweed Forecast API](https://magicseaweed.com/developer/forecast-api) as a source for surf forecasting data for the surf spots of your choice. | ||
|
||
You need an API key which is free but requires [registration](https://magicseaweed.com/developer/sign-up). Magicseaweed is limiting users of the API to 2 spots for the free plan. | ||
|
||
To add Magicseaweed forecasts to your installation, add the following to your `configuration.yaml` file: | ||
|
||
```yaml | ||
# Example configuration.yaml entry | ||
sensor: | ||
- platform: magicseaweed | ||
api_key: YOUR_API_KEY | ||
spot_id: 1092 | ||
monitored_conditions: | ||
- max_breaking_swell | ||
``` | ||
|
||
{% configuration %} | ||
api_key: | ||
description: The API key to access the service. | ||
required: true | ||
type: string | ||
name: | ||
description: Spot nickname for the sensors. | ||
required: false | ||
default: MSW. | ||
type: string | ||
hour: | ||
description: List of hours you would like to receive data for. | ||
required: false | ||
default: Defaults to current forecast. | ||
type: list | ||
keys: | ||
3AM: | ||
description: Display forecast for 3AM. | ||
6AM: | ||
description: Display forecast for 6AM. | ||
9AM: | ||
description: Display forecast for 9AM. | ||
12PM: | ||
description: Display forecast for 12PM. | ||
3PM: | ||
description: Display forecast for 3PM. | ||
6PM: | ||
description: Display forecast for 6PM. | ||
9PM: | ||
description: Display forecast for 9PM. | ||
12AM: | ||
description: Display forecast for 12AM. | ||
spot_id: | ||
description: ID of the surf spot. Details for getting spot id available at [Magicseaweed](https://magicseaweed.com/developer/forecast-api) | ||
required: true | ||
type: string | ||
monitored_conditions: | ||
description: Type of data to display. | ||
required: true | ||
type: list | ||
keys: | ||
swell_forecast: | ||
description: List of forecast summaries as attributes with current summary as state. | ||
min_breaking_swell: | ||
description: The minimum wave height as the state with a detailed list of forecast attributes. | ||
max_breaking_swell: | ||
description: The maximum wave height as the state with a detailed list of forecast attributes. | ||
units: | ||
description: Specify the unit system. | ||
required: false | ||
default: Default to `uk` or `us` based on the temperature preference in Home Assistant. | ||
type: string | ||
keys: | ||
uk: | ||
description: Use UK units. | ||
eu: | ||
description: Use EU units. | ||
us: | ||
description: Use US units. | ||
{% endconfiguration %} | ||
|
||
|
||
Details about the API are available in the [Magicseaweed documentation](https://magicseaweed.com/developer/forecast-api). |
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This comment was marked as resolved.
Sorry, something went wrong.
This comment was marked as resolved.
Sorry, something went wrong.
This comment was marked as resolved.
Sorry, something went wrong.