jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-04-25 13:57:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add basic battery/gas docs (#19049)

Browse Source
This commit is contained in:
Paulus Schoutsen 2021-08-23 02:43:16 -07:00 committed by GitHub
parent d16598b797
commit 8f54d8b677
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 56 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
source/_docs/energy.markdown
View File

@ -13,6 +13,8 @@ Home Assistant is an open platform and so home energy management is not restrict
- [Integrate your energy use from the electricity grid](/docs/energy/electricity-grid/)
- [Integrate your solar panels](/docs/energy/solar-panels/)
- [Integrate your home batteries](/docs/energy/battery/)
- [Integrate your gas consumption](/docs/energy/gas/)
- [Integrate individual devices](/docs/energy/individual-devices/)
<img src='/images/docs/energy/energy-overview.png' alt='Visual representation of how all different energy forms relate.' style='border: 0;box-shadow: none;'>

28
source/_docs/energy/battery.markdown Normal file
View File

@ -0,0 +1,28 @@
---
title: "Integrating your home batteries"
description: "Learn how to add information about your home batteries to Home Assistant home energy management."
---
A home battery allows homes to store energy when you are either producing more solar power than you're using, or store energy from the grid if the current price is low.
Home Assistant allows you to track how much energy flows from/to your battery.
## Hardware
Home Assistant will need to know the amount of energy flowing from/to your batteries. This data can be tracked in various ways.
### Provided by the battery
Some battery vendors have an API to integrate the data into your Home Assistant instance. An example is [Tesla Powerwall](/integrations/powerwall/).
### Using a CT clamp sensor
CT clamp sensors measure your energy usage by looking at the current passing through an electrical wire. This makes it possible to calculate the energy usage. In Home Assistant we have support for off-the-shelf CT clamp sensors and you can build your own.
The off-the-shelf solution that we advise is the [Shelly EM](https://shop.shelly.cloud/shelly-em-2-x-120a-clamp-wifi-smart-home-automation?tracking=A7FsiPIfUWsFpnfKHa8SRyUYLXjr2hPq). The device has a local API, updates are pushed to Home Assistant and it has a high quality integration.
You can build your own using ESPHome's [CT Clamp Current sensor](https://esphome.io/components/sensor/ct_clamp.html) or energy meter sensors like the [ATM90E32](https://esphome.io/components/sensor/atm90e32.html). For the DIY route, check out [this video by digiblur](https://www.youtube.com/watch?v=n2XZzciz0s4) to get started.
_Attention! Installing CT clamp sensor devices requires opening your electrical cabinet. This work should be done by someone familiar with electrical wiring. Your qualified installer will know how to do this._
_Disclaimer: Some links on this page are affiliate links._

25
source/_docs/energy/gas.markdown Normal file
View File

@ -0,0 +1,25 @@
---
title: "Integrating your gas usage"
description: "Learn how to add information about your gas usage to Home Assistant home energy management."
---
Some homes are connected to gas. Gas is being used to heat water, cook and heat up the home.
Home Assistant allows you to track your gas usage and easily compare it against your energy usage for the same period of time.
## Hardware
Home Assistant will need to know the amount of gas that is being consumed.
### Connect to your meter
The best way to get this data is directly from your gas meter that sits between your house and the grid. In certain countries these meters contain standardized ways of reading out the information locally or provide this information via the electricity meter.
#### Connect using a P1 port
The P1 port is a standardized port on electricity meters in the Netherlands, Belgium and Luxembourg which also provides gas consumption information. A P1 reader can connect to this port and receive real-time information.
We have worked with creator [Marcel Zuidwijk](https://www.zuidwijk.com) to develop [SlimmeLezer](https://www.slimmelezer.nl). It's an affordable P1 reader powered by [ESPHome](https://esphome.io) that will seamlessly integrate this information in Home Assistant. It is being sold on [his website](https://www.slimmelezer.nl) and the firmware is open source [on GitHub](https://github.com/zuidwijk/dsmr).
![Photo of SlimmeLezer attached to a smart electricity meter](/images/docs/energy/slimmelezer.jpg)

1
source/_integrations/powerwall.markdown
View File

@ -3,6 +3,7 @@ title: Tesla Powerwall
description: Instructions on how to integrate Tesla Power Walls into Home Assistant.
ha_category:
- Binary Sensor
- Energy
- Sensor
ha_release: 0.108
ha_iot_class: Local Polling