home-assistant.io/source/_integrations/solarlog.markdown

title	description	ha_category	ha_release	ha_iot_class	ha_config_flow	ha_codeowners	ha_domain
Solar-Log	Instructions on how to integrate Solar-Log sensors within Home Assistant.	Sensor	0.101	Local Polling	true	@Ernst79	solarlog

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.

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

There are 2 options in configuring the solarlog integration:

• Via the Home Assistant user interface where it will let you enter the name and host to connect to your Solar-Log device.
• Via the Home Assistant configuration.yaml file.

# Example configuration.yaml entry
sensor:
  platform: solarlog

{% configuration %} host: description: The IP Address or host address of your Solar-Log device. required: false default: http://solar-log type: string name: description: Let you overwrite the name of the device in the frontend. required: false default: solarlog type: string {% endconfiguration %}

Full configuration sample

A full configuration entry would look like the sample below.

# Example configuration.yaml entry
sensor:
  - platform: solarlog
    name: solarlog
    host: 192.168.1.123

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

{% raw %}

# Example configuration.yaml entry for sensor template platform
sensor:
  - platform: template
    sensors:
      solarlog_yield_day_template:
        value_template: "{{ (states('sensor.solarlog_yield_day') | float * 1000) | round(0) }}"

{% endraw %}

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.
total_power	Wp	Installed generator power.
alternator_loss	W	Altenator loss (equals to power_dc - power_ac)
capacity	%	Capacity (equals to power_dc / total power)
efficiency	% W/Wp	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)

The solarlog integration is using the sunwatcher 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 sunwatcher package.