Update Smappee doc (#13764)

Co-authored-by: Franck Nijhof <git@frenck.dev>
This commit is contained in:
bsmappee 2020-06-19 20:15:03 +02:00 committed by GitHub
parent 65b711bf9e
commit 8ce8476eec
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -1,81 +1,41 @@
--- ---
title: Smappee title: Smappee
description: Instructions on how to setup Smappee within Home Assistant. description: Instructions on how to setup Smappee within Home Assistant.
ha_release: 0.64
ha_category: ha_category:
- Hub - Hub
- Energy - Energy
- Sensor - Sensor
- Switch - Switch
ha_iot_class: Local Push ha_iot_class: Cloud polling
ha_release: 0.64
ha_config_flow: true
ha_codeowners:
- '@bsmappee'
ha_domain: smappee ha_domain: smappee
--- ---
The `smappee` integration adds support for the [Smappee](https://www.smappee.com/) controller for energy monitoring and Comport plug switches. The Smappee integration will allow users to integrate their Smappee monitors, plugs and switches into Home Assistant using the [official API](https://smappee.atlassian.net/wiki/spaces/DEVAPI/overview).
There is currently support for the following device types within Home Assistant:
- Sensor
- Switch
Will be automatically added when you connect to the Smappee controller.
The smappee integration gets information from [Smappee API](https://smappee.atlassian.net/wiki/spaces/DEVAPI/overview). Note: their cloud API now requires a subscription fee of €2.50 per month for Smappee Energy/Solar or €3 per month for Smappee Plus.
## Configuration ## Configuration
Info on how to get API access is described in the [smappy wiki](https://github.com/EnergieID/smappy/wiki). To use the Smappee integration you need a personal `client_id` and `client_secret` and add these to your `configuration.yaml` file. The `client_id` and `client_secret` can be obtained by contacting [support@smappee.com](mailto:support@smappee.com).
To use the `smappee` integration in your installation, add the following to your `configuration.yaml` file:
```yaml ```yaml
# Example configuration.yaml entry # Example configuration.yaml entry
smappee: smappee:
host: 10.0.0.5
client_id: YOUR_CLIENT_ID client_id: YOUR_CLIENT_ID
client_secret: YOUR_CLIENT_SECRET client_secret: YOUR_CLIENT_SECRET
username: YOUR_MYSMAPPEE_USERNAME
password: YOUR_MYSMAPPEE_PASSWORD
``` ```
```yaml Once Home Assistant restarted, go to Configuration > Integrations and select the Smappee integration. You will be redirected to a login page and be able to select the locations you would like to use within Home Assistant.
# Minimal example configuration.yaml entry
smappee:
host: 10.0.0.5
```
```yaml
# Cloud only example configuration.yaml entry
smappee:
client_id: YOUR_CLIENT_ID
client_secret: YOUR_CLIENT_SECRET
username: YOUR_MYSMAPPEE_USERNAME
password: YOUR_MYSMAPPEE_PASSWORD
```
{% configuration %} {% configuration %}
host:
description: Your Local Smappee unit IP.
required: false
type: string
host_password:
description: Your Local Smappee password.
required: false
type: string
client_id: client_id:
description: Your Smappee API client ID. description: Your Smappee API client ID.
required: false required: true
type: string type: string
client_secret: client_secret:
description: Your Smappee API client secret. description: Your Smappee API client secret.
required: false required: true
type: string
username:
description: Your My Smappee username.
required: false
type: string
password:
description: Your My Smappee password.
required: false
type: string type: string
{% endconfiguration %} {% endconfiguration %}