🎉 Release of add-on Grott stable branch (2.7) 0.1.5
This commit is contained in:
Etienne G
+7
-1
@@ -1,2 +1,8 @@
|
||||
## What’s changed
|
||||
Updated deployment system.
|
||||
## 🚀 Enhancements
|
||||
|
||||
- Changed the name of the addon @egguy (#11)
|
||||
|
||||
## 📚 Documentation
|
||||
|
||||
- Update of the documentation @egguy (#10)
|
||||
|
||||
+90
-17
@@ -1,17 +1,89 @@
|
||||
# Grott - Home Assistant native MQTT integration
|
||||
|
||||
## Installation
|
||||
## Requirements
|
||||
|
||||
- A MQTT broker (e.g. the Mosquitto broker add-on)
|
||||
- If you don't have an MQTT broker yet; in Home Assistant go to **Settings → Add-ons → Add-on store** and install the **Mosquitto broker** add-on.
|
||||
- A Growatt inverter with a Wi-Fi module
|
||||
|
||||
## Configuration of the Wi-Fi logger
|
||||
|
||||
The IP to use is the IPv4 of home assistant. You can't use the DNS of home assistant. You need to use the IPv4.
|
||||
|
||||
You can find this information in: **settings → system → network**, on **Configure network interfaces** click on the three dots and choose **IP Information**. You will see the IPv4 address.
|
||||
|
||||
The IP address to use is the field **IP Address**. You need to remove the /XX at the end of the IP address. e.g.: **IP Address: 192.168.20.2/24** -> IP address to use: **192.168.20.2**
|
||||
|
||||
Here some resources to configure your Wi-Fi logger:
|
||||
|
||||
- [Rerouting Growatt Wi-Fi TCPIP data via your Grott Server](https://github.com/johanmeijer/grott/wiki/Rerouting-Growatt-Wifi-TCPIP-data-via-your-Grott-Server)
|
||||
- [Muppet3000 guide to reconfigure the stick](https://github.com/muppet3000/homeassistant-grott/blob/main/docs/setup/datalogger.md)
|
||||
|
||||
## Configuration
|
||||
|
||||
If you do a change of configuration. It is important to save and then restart the add-on.
|
||||
|
||||
### Specific inverter configuration
|
||||
|
||||
If you have multiple inverters, please refer on how to configure them on this documentation: [Multiple inverters configuration](#multiple-inverters-configuration)
|
||||
|
||||
In the case you have one of the listed inverter type, you need a special configuration:
|
||||
|
||||
- SPH
|
||||
- SPH6000, SPH3000...
|
||||
- SPF
|
||||
- SPF5000, SPF3000...
|
||||
- TL3
|
||||
- TL3-X...
|
||||
- MAX
|
||||
- MAX 100-150KTL3-X...
|
||||
|
||||
The support for these inverters is available in grott 2.8
|
||||
|
||||
- SPA
|
||||
- SPA 4000-10000TL3
|
||||
- MIN
|
||||
- MIN 2500-6000TL
|
||||
|
||||
The setting to change is inverter type. You need to put the 3 letters of the inverter type in the configuration.
|
||||
|
||||
e.g:
|
||||
|
||||
- SPH6000 -> SPH
|
||||
- SPF5000 -> SPF
|
||||
- TL3-X -> TL3
|
||||
- MAX 100-150KTL3-X -> MAX
|
||||
- SPA 4000-10000TL3 -> SPA
|
||||
- MIN 2500-6000TL -> MIN
|
||||
|
||||
### Multiple inverters configuration
|
||||
|
||||
In the case of multiple inverters, you need to configure the inverter details in the add-on configuration. If you have only one inverter, you can leave the inverter details empty. Use the inverter type as described in the [Specific inverter configuration](#specific-inverter-configuration) section.
|
||||
|
||||
You will have to get the serial number of the inverter. To achieve this, you can run grott in verbose mode and check the logs. You will see the serial number of the inverter in the logs.
|
||||
|
||||
You can keep the default value for invertype, it will override it.
|
||||
|
||||
The format is e.g.:
|
||||
|
||||
```json
|
||||
{ "SERIAL": "TYPE", "SERIAL": "TYPE" }
|
||||
```
|
||||
|
||||
It is important to respect the quotes and the comma to separate the inverters.
|
||||
|
||||
e.g.:
|
||||
|
||||
```json
|
||||
{ "NWO00415E3": "SPH", "DFO1231952": "MAX" }
|
||||
```
|
||||
|
||||
### External MQTT broker
|
||||
|
||||
If you are using an external MQTT broker, you need to configure the MQTT broker details in the add-on configuration. If you are using the Mosquitto broker add-onn, you can leave the MQTT broker details empty.
|
||||
|
||||
1. If you don't have an MQTT broker yet; in Home Assistant go to **Settings → Add-ons → Add-on store** and install the **Mosquitto broker** addon.
|
||||
1. Go back to the **Add-on store**, click **⋮ → Repositories**, fill in</br> `https://github.com/egguy/grott-home-assistant-add-on` and click **Add → Close** or click the **Add repository** button below, click **Add → Close** (You might need to enter the **internal IP address** of your Home Assistant instance first).
|
||||
[](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fegguy%2Fgrott-home-assistant-add-on)
|
||||
1. The repository includes two add-ons:
|
||||
- **grott** is the stable release that tracks the released versions of grott HA plugin.
|
||||
- **grott Edge** tracks the `dev` branch of grott HA plugin such that you can install the edge version if there are features or fixes in the grott HA dev branch that are not yet released. (**recommended for most users**)
|
||||
1. Click on the addon and press **Install** and wait till the addon is installed.
|
||||
1. Click on **Configuration**
|
||||
|
||||
- If you are **not** using the Mosquitto broker addon fill in your MQTT details (leave empty when using the Mosquitto broker addon). Format is e.g.: <br>
|
||||
**If you are not using the Mosquitto broker add-on** fill in your MQTT details (leave empty when using the Mosquitto broker add-on). The format is e.g.: <br>
|
||||
|
||||
```yaml
|
||||
host: <IP>
|
||||
@@ -20,11 +92,12 @@
|
||||
password: my_password
|
||||
```
|
||||
|
||||
- Click **Save**
|
||||
- **Tip:** it is possible to refer to variables in the Home Assistant `secrets.yaml` file by using e.g. `password: '!secret mqtt_pass'`
|
||||
### Compatibility with homeassistant-grott
|
||||
|
||||
1. If multiple inverters, please refer on how to configure them on this documentation: <https://github.com/johanmeijer/grott/wiki/Multi-Inverter-support>
|
||||
1. Start the addon by going to **Info** and click **Start**
|
||||
1. Configure your data logger using the information contained here: [Rerouting Growatt Wifi TCPIP data via your Grott Server](https://github.com/johanmeijer/grott/wiki/Rerouting-Growatt-Wifi-TCPIP-data-via-your-Grott-Server)
|
||||
- Use the local IP of your home assistant
|
||||
- Don't use a DNS, the datalogger can't resolve `homeassistant.local`
|
||||
Muppet3000 has created a custom component for Home Assistant. This component is called [homeassistant-grott](https://github.com/muppet3000/homeassistant-grott). It is compatible with this add-on.
|
||||
|
||||
You can use the add-on and the component at the same time. This will make the deployment of grott and configuration a bit easier.
|
||||
|
||||
You can activate the compatibility mode by checking: **Enable grott MQTT** in the configuration, and then follow the instruction to install and activate the extension.
|
||||
|
||||
It is recommended to deactivate the **Home Assistant plugin** in the configuration. This can lead to duplicate sensors.
|
||||
|
||||
+2
-2
@@ -16,5 +16,5 @@ and current grott_ha extension.
|
||||
|
||||
|
||||
[project-stage-shield]: https://img.shields.io/badge/project%20stage-production%20ready-brightgreen.svg
|
||||
[release-shield]: https://img.shields.io/badge/version-v0.1.4-blue.svg
|
||||
[release]: https://github.com/egguy/addon-grott/tree/v0.1.4
|
||||
[release-shield]: https://img.shields.io/badge/version-v0.1.5-blue.svg
|
||||
[release]: https://github.com/egguy/addon-grott/tree/v0.1.5
|
||||
+2
-3
@@ -1,6 +1,5 @@
|
||||
name: Grott stable branch (2.7) - An addon for Home Assistant to monitor Growatt inverters
|
||||
with MQTT
|
||||
version: 0.1.4
|
||||
name: Grott stable branch (2.7)
|
||||
version: 0.1.5
|
||||
slug: grott
|
||||
description: The Growatt inverter monitor with current HA plugin integrated
|
||||
url: https://github.com/egguy/addon-grott
|
||||
|
||||
Reference in New Issue
Block a user