2024.9.1
Home ▸ Integrations ▸

Solar-Log

The solarlog integration uses the open JSON interface on Solar-Log PV monitoring systems to allow you to get details from your Solar-Log device and integrate these into your Home Assistant installation.

Before being able to use the integration, you have to activate the open JSON interface on your Solar-Log device. This can be activated from the Configuration | System | Access control menu of your Solar-Log device. When activating the interface, a red warning triangle with security information and risks is displayed.

The solarlog integration uses the default host address “http://solar-log” if you don’t specify a host. If your device isn’t accessible on this address, use its IP Address instead.

Important

The open JSON interface is deactivated by default. To activate the open JSON interface, a user password must first be set. The password isn’t needed for accessing the open JSON interface.

Configuration

To add the Solar-Log integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Solar-Log.

  • Follow the instructions on screen to complete the setup.

Additional template sensor

In case you would like to convert the values, for example, to Wh instead of the default kWh, you can use the template platform.

# 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) }}"

Sensors

The following sensors are available in the library:

name Unit Description
last_update Time of latest data update.
power_ac W Total output PAC from all of the inverters and meters in inverter mode.
power_dc W Total output PAC from all of the inverters.
voltage_ac V Average voltage AC from the inverter.
voltage_dc V Average voltage DC from the inverter
yield_day kWh Total yield for the day from all of the inverters
yield_yesterday kWh Total yield for the previous day from all of the inverters.
yield_month kWh Total yield for the month from all of the inverters.
yield_year kWh Total yield for the year from all of the inverters.
yield_total kWh Total yield from all of the inverters.
consumption_ac kWh Current total consumption AC from all of the consumption meters.
consumption_day kWh Total consumption for the day from all of the consumption meters.
consumption_yesterday kWh Total consumption for the previous day from all of the consumption meters.
consumption_month kWh Total consumption for the month from all of the consumption meters.
consumption_year kWh Total consumption for the year from all of the consumption meters.
consumption_total kWh Accumulated total consumption from all consumption meters.
self_consumption_year kWh Accumulated total self-consumption.
installed_peak_power W Installed solar peak power.
alternator_loss W Altenator loss (equals to power_dc - power_ac)
capacity % Capacity (equals to power_dc / total power)
efficiency % Efficiency (equals to power_ac / power_dc)
power_available W Available power (equals to power_ac - consumption_ac)
usage % Usage (equals to consumption_ac / power_ac)

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.