home-assistant.io/source/_components/streamlabswater.markdown
cpopp a0a235f089 Add documentation for streamlabswater component (#8733)
* Add documentation for streamlabswater component

* Bump ha_release for component to 0.90

* Quote version to maintain trailing zero

* Remove unnecessary redirects from streamlabswater

* Update streamlabswater.markdown
2019-06-06 13:55:59 -07:00

1.9 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, ha_iot_class
layout title description date sidebar comments sharing footer logo ha_category ha_release ha_iot_class
page Streamlabs Water Instructions on how to integrate Streamlabs Water devices with Home Assistant. 2019-02-25 12:00 true false true true streamlabswater.png
Binary Sensor
Sensor
0.95 Cloud Polling

The Streamlabs Water component platform is used to interact with Streamlabs water monitoring devices in order to retrieve usage information and manage the away mode of the device. The Streamlabs Water API is used to retrieve daily, monthly, and yearly water usage along with the current away mode.

There is currently support for the following device types within Home Assistant:

  • Binary Sensor
  • Sensor

In preparation for using this component you will need to request an API key following the instructions in the Streamlabs API Getting Started Section. Be sure to request an API key and not an OAuth token.

{% linkable_title Configuration %}

Add the following to your configuration.yaml file:

# Example configuration.yaml entry
streamlabswater:
  api_key: YOUR_API_KEY

{% configuration %} api_key: description: Your api_key for the Streamlabs API. required: true type: string location_id: description: A specific monitor to use if you have multiple. By default the first found will be used. required: false type: string {% endconfiguration %}

{% linkable_title Service set_away_mode %}

You can use the service streamlabswater.set_away_mode to set the mode to home or away. The away mode will only be changed for the configured location.

Service data attribute Optional Description
away_mode no String, must be away or home.