mirror of
https://github.com/alexhopeoconnor/SunGather.git
synced 2026-10-22 18:47:49 +10:00
Update README with HA, Improved docker support
This commit is contained in:
@@ -31,7 +31,7 @@ Register information based on official documentation: <a href="https://github.co
|
|||||||
|
|
||||||
Has muliple export locations out of the box:
|
Has muliple export locations out of the box:
|
||||||
* Console - Log directly to screen
|
* Console - Log directly to screen
|
||||||
* MQQT - Load into MQTT, and optionally Home Assistance Discovery
|
* MQTT - Load into MQTT, and optionally Home Assistance Discovery
|
||||||
* PVOutput - Load into PVOutput.org
|
* PVOutput - Load into PVOutput.org
|
||||||
* and more coming....
|
* and more coming....
|
||||||
|
|
||||||
@@ -42,9 +42,8 @@ I have borrowed HEAVILY from the following projects, THANK YOU
|
|||||||
|
|
||||||
<p align="right">(<a href="#top">back to top</a>)</p>
|
<p align="right">(<a href="#top">back to top</a>)</p>
|
||||||
|
|
||||||
### TO BO
|
### TO DO
|
||||||
* Commandline Arguments
|
* Commandline Arguments
|
||||||
* Docker
|
|
||||||
* Better Home Assistant Support
|
* Better Home Assistant Support
|
||||||
|
|
||||||
|
|
||||||
@@ -66,7 +65,7 @@ I have borrowed HEAVILY from the following projects, THANK YOU
|
|||||||
```sh
|
```sh
|
||||||
git clone https://github.com/bohdan-s/SunGather.git
|
git clone https://github.com/bohdan-s/SunGather.git
|
||||||
cd SunGather
|
cd SunGather
|
||||||
pip3 install requirements.txt
|
pip3 install --upgrade -r requirements.txt
|
||||||
```
|
```
|
||||||
Copy config-example.py to config.py, change values as required (see comments in file)
|
Copy config-example.py to config.py, change values as required (see comments in file)
|
||||||
```sh
|
```sh
|
||||||
@@ -80,19 +79,39 @@ python3 sungather.py
|
|||||||
# Docker
|
# Docker
|
||||||
```sh
|
```sh
|
||||||
docker pull bohdans/sungather
|
docker pull bohdans/sungather
|
||||||
docker run -v {path to}/config.yaml:/usr/src/sungather/config.yaml -e TZ=Australia/Sydney --name sungather bohdans/sungather
|
docker run -v {path to}/config.yaml:/config/config.yaml -e TZ=Australia/Sydney --name sungather bohdans/sungather
|
||||||
```
|
```
|
||||||
Note: replace Australia/Sydney with relevent timezone
|
Note: replace Australia/Sydney with relevent timezone
|
||||||
<p align="right">(<a href="#top">back to top</a>)</p>
|
<p align="right">(<a href="#top">back to top</a>)</p>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<!-- USAGE EXAMPLES -->
|
<!-- USAGE EXAMPLES -->
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
See config-exmaple.py it contains default options and comments.
|
See config-exmaple.py it contains default options and comments.
|
||||||
|
|
||||||
If you want to use the new Energy section in Home Assistant, add the following sensors to convert from Power to Energy:
|
If you want to use the new Energy section in Home Assistant, follow the Home Assitant setup below.
|
||||||
|
<p align="right">(<a href="#top">back to top</a>)</p>
|
||||||
|
|
||||||
|
## Home Assistant setup
|
||||||
|
|
||||||
|
In the SunGather config.yaml you need to set the smart_meter if you have one;
|
||||||
|
|
||||||
|
```
|
||||||
|
smart_meter: True
|
||||||
|
```
|
||||||
|
|
||||||
|
HA sensors created by the MQTT auto-discovery;
|
||||||
|
```
|
||||||
|
sensor.inverter_active_power
|
||||||
|
sensor.inverter_daily_generation
|
||||||
|
sensor.inverter_export_to_grid
|
||||||
|
sensor.inverter_import_from_grid
|
||||||
|
sensor.inverter_load_power
|
||||||
|
sensor.inverter_meter_power
|
||||||
|
```
|
||||||
|
|
||||||
|
Put the following into your sensors.yaml
|
||||||
```
|
```
|
||||||
sensor:
|
sensor:
|
||||||
- platform: integration
|
- platform: integration
|
||||||
@@ -103,11 +122,39 @@ sensor:
|
|||||||
source: sensor.inverter_import_from_grid
|
source: sensor.inverter_import_from_grid
|
||||||
```
|
```
|
||||||
|
|
||||||
<p align="right">(<a href="#top">back to top</a>)</p>
|
The additional sensors then setup in HA are the following with Wh unit of measurement for the Energy platform.
|
||||||
|
|
||||||
|
```
|
||||||
|
sensor.sensor_inverter_active_power_integral
|
||||||
|
sensor.sensor_inverter_export_to_grid_integral
|
||||||
|
sensor.sensor_inverter_import_from_grid_integral
|
||||||
|
```
|
||||||
|
|
||||||
|
You need to utilise the customize.yaml manual method to get some friendly names and icons. Add the following;
|
||||||
|
```
|
||||||
|
sensor.sensor_inverter_active_power_integral:
|
||||||
|
icon: mdi:solar-power
|
||||||
|
friendly_name: Solar Generation
|
||||||
|
sensor.sensor_inverter_export_to_grid_integral:
|
||||||
|
icon: mdi:transmission-tower-export
|
||||||
|
friendly_name: Grid Export
|
||||||
|
sensor.sensor_inverter_import_from_grid_integral:
|
||||||
|
icon: mdi:transmission-tower-import
|
||||||
|
friendly_name: Grid Import
|
||||||
|
```
|
||||||
|
Restart Home Assistant for the sensors.yaml and customize.yaml to be loaded.
|
||||||
|
Make sure SunGather is running, wait 5 minutes for inital data to populate.
|
||||||
|
Navigate to the Energy platform (Configuration > Energy). Add these sensors to the following areas:
|
||||||
|
|
||||||
|
Electricity Grid > Grid Import - sensor.sensor_inverter_import_from_grid_integral
|
||||||
|
Electricity Grid > Grid Export - sensor.sensor_inverter_export_to_grid_integral
|
||||||
|
Solar Panels > Solar Production - sensor.sensor_inverter_active_power_integral
|
||||||
|
|
||||||
|
<p align="right">(<a href="#top">back to top</a>)</p>
|
||||||
|
|
||||||
## Tested
|
## Tested
|
||||||
* SG7.0RT with WiNet-S Dongle
|
* SG7.0RT with WiNet-S Dongle
|
||||||
|
* SG10RT with WiNet-S Dongle and Ethernet (Credit: @rark-ha)
|
||||||
|
|
||||||
<p align="right">(<a href="#top">back to top</a>)</p>
|
<p align="right">(<a href="#top">back to top</a>)</p>
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user