mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-17 06:16:50 +00:00
Update Smappee doc (#13764)
Co-authored-by: Franck Nijhof <git@frenck.dev>
This commit is contained in:
parent
65b711bf9e
commit
8ce8476eec
@ -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 %}
|
||||||
|
Loading…
x
Reference in New Issue
Block a user