Skip to content

Update tellduslive.markdown #3955

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

Merged
merged 5 commits into from
Dec 1, 2017
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 5 additions & 12 deletions source/_components/tellduslive.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -13,25 +13,18 @@ featured: false
ha_release: 0.11
---

The `tellduslive` component let you connect to [Telldus Live](https://live.telldus.com). It's cloud platform that connects to your Tellstick connected gear at home.
The `tellduslive` component let you connect to [Telldus Live](https://live.telldus.com). It's cloud platform that connects to your Tellstick Net or Tellstick ZNet connected gear at home.

To get started using Telldus Live, you will have to obtain developer keys from the [developer page](https://api.telldus.com/keys/index).

To integrate your Telldus Live with Home Assistant, add the following section to your `configuration.yaml` file:
Home Assistant will automatically discover the presence of a Tellstick Net or Tellstick ZNet on your local network if the [discovery]({{site_root}}/components/discovery/) component is enabled. To manually integrate your Telldus Live with Home Assistant, e.g. if your device is on another network or in another location, add the following section to your `configuration.yaml` file:

```yaml
# Example configuration.yaml entry
tellduslive:
public_key: ABCDEFGHJKLMNOPQRSTUVXYZ
private_key: ABCDEFGHJKLMNOPQRSTUVXYZ
token: ABCDEFGHJKLMNOPQRSTUVXYZ
token_secret: ABCDEFGHJKLMNOPQRSTUVXYZ
```

Configuration variables:

- **public_key** (*Required*): The public key for the Telldus Live service.
- **private_key** (*Required*): The private key for the Telldus Live service.
- **token** (*Required*): The token for the Telldus Live service.
- **token_secret** (*Required*): The token secret for the Telldus Live service.
- **host** (*Optional*): Host address to Tellstick Net or Tellstick ZNet for Local API, only useful when automatic discovery is not enabled.
- **update_interval** (*Optional*): Interval (in seconds) for polling the Telldus Live server (or the local server).

The component will offer configuration through the Home Assistant user interface where it will let you associate it with your Telldus Live account.