Imeon Inverter

The Imeon Energy Inverter integrationsIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] will poll an Imeon solar inverter in Home Assistant.

Prerequisites

  • The Imeon inverter must be connected to the local network.
  • OS One version must be 1.8.4 or higher.
  • ModuleAPI application must be activated on the OS One pannel of your Imeon inverter.
    • To do so, connect to OS One > Applications and by hovering over ModuleAPI, select Activate.

Configuration

To add the Imeon Inverter device to your Home Assistant instance, use this My button:

Imeon Inverter can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • 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 Imeon Inverter.

  • Follow the instructions on screen to complete the setup.

Supported functionality

This document provides an overview of the sensors available in the Imeon Inverter integration and details their functionality, units, and purpose.

Battery sensors

Sensor key Description Unit
battery_autonomy Indicates the battery autonomy. None
battery_charge_time Time required to fully charge the battery. None
battery_power Power currently being used or supplied by the battery. W
battery_soc State of charge of the battery. %
battery_stored Total energy stored in the battery. Wh

Grid sensors

Sensor key Description Unit
grid_current_l1 Current on grid line 1. A
grid_current_l2 Current on grid line 2. A
grid_current_l3 Current on grid line 3. A
grid_frequency Frequency of the grid supply. Hz
grid_voltage_l1 Voltage on grid line 1. V
grid_voltage_l2 Voltage on grid line 2. V
grid_voltage_l3 Voltage on grid line 3. V

AC input sensors

Sensor Key Description Unit
input_power_l1 Power input on line 1. W
input_power_l2 Power input on line 2. W
input_power_l3 Power input on line 3. W
input_power_total Total power input. W

Inverter settings sensors

Sensor key Description Unit
inverter_charging_current_limit Maximum charging current allowed. A
inverter_injection_power_limit Maximum power injected into the grid. W

Electric meter sensors

Sensor key Description Unit
meter_power Power measured by the meter. W
meter_power_protocol Power measurement protocol type. None

AC output sensors

Sensor key Description Unit
output_current_l1 Current output on line 1. A
output_current_l2 Current output on line 2. A
output_current_l3 Current output on line 3. A
output_frequency Output frequency. Hz
output_power_l1 Power output on line 1. W
output_power_l2 Power output on line 2. W
output_power_l3 Power output on line 3. W
output_power_total Total power output. W
output_voltage_l1 Voltage output on line 1. V
output_voltage_l2 Voltage output on line 2. V
output_voltage_l3 Voltage output on line 3. V

Solar panel sensors

Sensor Key Description Unit
pv_consumed Energy consumed from solar panels. Wh
pv_injected Energy injected into the grid. Wh
pv_power_1 Power from solar panel 1. W
pv_power_2 Power from solar panel 2. W
pv_power_total Total power from solar panels. W

Temperature sensors

Sensor key Description Unit
temp_air_temperature Ambient air temperature around the inverter. °C
temp_component_temperature Temperature of internal components. °C

Monitoring sensors (last 24 hours)

Sensor key Description Unit
monitoring_building_consumption Total energy consumed by the building. Wh
monitoring_economy_factor Economy factor for energy usage. None
monitoring_grid_consumption Energy consumed from the grid. Wh
monitoring_grid_injection Energy injected into the grid. Wh
monitoring_grid_power_flow Power flow through the grid. Wh
monitoring_self_consumption Self-consumed energy percentage. %
monitoring_self_production Self-produced energy percentage. %
monitoring_solar_production Total solar energy produced. Wh

Monitoring sensors (instant minute data)

Sensor key Description Unit
monitoring_minute_building_consumption Energy consumed by the building (minute). W
monitoring_minute_grid_consumption Energy consumed from the grid (minute). W
monitoring_minute_grid_injection Energy injected into the grid (minute). W
monitoring_minute_grid_power_flow Power flow through the grid (minute). W
monitoring_minute_solar_production Solar energy produced (minute). W

Imeon integration extras

Custom dashboard templates for the custom Imeon Integration. Uses APEXCharts-card for graphs and custom gauges.

Troubleshooting

What is my domain name?

The domain name is the internal name given to your inverter by Home Assistant. It’s based on the initial name you gave to your device, albeit formatted to avoid internal issues.

  • A name such as Imeon Inverter number 57 would give you a domain name of imeon_inverter_number_57.
  • If you’re still struggling to find the domain name, check the internal name of the entities under the device. The name of each variable is DOMAIN_variable-name, for example neo_110_inverter_software_version tells us the domain name is neo_110.

How to install APEXCharts-card?

APEXCharts-card’s README explains everything needed to install this custom resource on your installation.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three-dot menu. Then, select Delete.