mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-17 23:56:49 +00:00
54 lines
1.6 KiB
Markdown
54 lines
1.6 KiB
Markdown
---
|
|
title: Tank Utility
|
|
description: How to integrate Tank Utility sensors within Home Assistant.
|
|
logo: tank_utility.png
|
|
ha_category:
|
|
- Energy
|
|
ha_release: 0.53
|
|
ha_domain: tank_utility
|
|
---
|
|
|
|
Add [Tank Utility](https://www.tankutility.com/) propane tank monitors to Home Assistant.
|
|
|
|
## Setup
|
|
|
|
### Authentication
|
|
|
|
Authentication for the Tank Utility API is performed with the same email and password credentials used at [https://app.tankutility.com](https://app.tankutility.com).
|
|
|
|
### Devices
|
|
|
|
Each item in the list of devices is a 24 character string. These values can be found by clicking on the **Usage Reports** link at the bottom of the graph on the [Tank Utility devices page](https://app.tankutility.com/#/devices).
|
|
|
|
The device item value is the last segment of the URL path, e.g., the URL
|
|
[https://app.tankutility.com/#/reports/000000000000000000000000](https://app.tankutility.com/#/reports/000000000000000000000000) would indicate `000000000000000000000000` as a device value.
|
|
|
|
## Configuration
|
|
|
|
To enable the component, add the following lines to your `configuration.yaml` file:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
sensor:
|
|
- platform: tank_utility
|
|
email: YOUR_EMAIL_ADDRESS
|
|
password: YOUR_PASSWORD
|
|
devices:
|
|
- 000000000000000000000000
|
|
```
|
|
|
|
{% configuration %}
|
|
email:
|
|
description: "Your [https://app.tankutility.com](https://app.tankutility.com) email address."
|
|
required: true
|
|
type: string
|
|
password:
|
|
description: "Your [https://app.tankutility.com](https://app.tankutility.com) password."
|
|
required: true
|
|
type: string
|
|
unit_of_measurement:
|
|
description: All devices to monitor.
|
|
required: true
|
|
type: map
|
|
{% endconfiguration %}
|