Update solarlog documentation based on new quality scale (#35909)

Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
dontinelli 2024-11-22 20:11:05 +01:00 committed by GitHub
parent de7c6aff01
commit f69f1d7687
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -17,7 +17,11 @@ ha_platforms:
ha_integration_type: integration
---
The **Solarlog** {% term integration %} uses the open JSON interface on [Solar-Log PV monitoring systems](https://www.solar-log.com/) to get details from your Solar-Log device and integrate these into your Home Assistant installation.
The **Solarlog** {% term integration %} uses the open JSON interface on [Solar-Log PV monitoring systems](https://www.solar-log.com/) to get details from your Solar-Log device and integrate these into your Home Assistant installation. With the integration you may monitor the solar power production and power consumption as tracked with your Solar-Log device.
## Supported devices
The integration should work with all Solar-Log devices.
## Prerequisites
@ -34,25 +38,33 @@ Please note that the open JSON interface only exposes a limited amount of data.
{% include integrations/config_flow.md %}
## Additional template sensor
To setup the integration you need the following information:
In case you would like to get additional calculated sensors such as the amount of excess solar power available, you can use the [template platform](/integrations/template/).
{% configuration_basic %}
Name:
description: "The name for your Solar-Log device in Home Assistant. This will also be uses as prefix for the entity names."
Host:
description: "The URL or IP address of your Solar-Log."
User password available:
description: "Check the box, if you have the password for the Solar-Log user to securely access [all data](#additional-data)."
Password:
description: "Password for the Solar-Log user. Will only be asked for in a second step, if in the first step the checkbox has been selected."
{% endconfiguration_basic %}
{% raw %}
## Configuration options
```yaml
# Example configuration.yaml entry for sensor template platform
template:
- sensor:
- name: "Solarlog yield day"
state: "{{ (states('sensor.solarlog_yield_day') | float(default=0) * 1000) | round(0,default=0) }}"
```
The integration has no additional configuration options.
{% endraw %}
## Remove integration
## Sensors
This integration can be removed by following these steps:
The following sensors are available via the open JSON intervace:
{% include integrations/remove_device_service.md %}
## Supported functionality
### Sensors
The following sensors are available via the open JSON interface:
| name | Unit | Description |
|-----------------------|--------|:-------------------------------------------|
@ -79,7 +91,11 @@ The following sensors are available via the open JSON intervace:
| power_available | W | Available power (equals to power_ac - consumption_ac) |
| usage | % | Usage (equals to consumption_ac / power_ac) |
## Additional data
{% note %}
The solarlog integration is using the solarlog_cli pypi package to get the data from your Solar-Log device. The last five sensors are not reported by your Solar-Log device directly, but are computed by the library.
{% endnote %}
### Additional data
{% important %}
The additional data is only accessible if the user's password is available (or password protection is deactivated). Obviously, deactivating password protection is a security risk and should only be done in specific circumstances. In any event, you do this at your own risk.
@ -98,6 +114,30 @@ In addition, information from devices connected to the Solar-Log device becomes
| current_power | W | Current power provided/used by the device. |
| consumption_year | kWh | Total energy provided/used by the device. |
{% note %}
The solarlog integration is using the solarlog_cli pypi package to get the data from your Solar-Log device. The last five sensors are not reported by your Solar-Log device directly, but are computed by the library.
{% endnote %}
### Additional template sensor
In case you would like to get additional calculated sensors such as the amount of excess solar power available or the energy returned to the grid, you can use the [template platform](/integrations/template/).
{% raw %}
```yaml
# Example configuration.yaml entry for sensor template platform
template:
- sensor:
- name: "Solarlog return to grid"
state: "{{ states('sensor.solarlog_consumption_year') | float(0) - states('sensor.self_consumption_year') | float(0) }}"
```
{% endraw %}
## Data updates
The integration fetches data from the device every minute.
## Actions
The integration provides no additional actions.
## Known limitations
The integration only provides the (limited) data exposed by means of the JSON interface. This also entails that the values for the self-consumption are rounded to full kWh.