HomeAssistant HACS integration for the LG ESS inverter. Built with the Python library https://github.com/gluap/pyess (thanks!).

This integration is using a local-only API of LG, no cloud needed. All devices that can be used with the LG EnerVu Plus should be compatible. This includes many LG Home inverters.

Add dkarv/ha-lg-ess as custom repository in HACS (click the three dots on the top right).

Then search for the integration or use the button below to install it:

The integration can be configured easily through the UI after getting the password. It should be auto discovered, and only the password has to be entered.

You need the local device password, which is not the account password. Instead there are a few ways to get it:

1. Get the mac address of the LAN interface of the lg ess device. Password is the lowercase address without colons. Example: AA:BB:CC:DD:11:22 -> password aabbccdd1122
2. Extract it using the pyess library (it has a cli) while connected to the devices WiFi.
3. Do a post request, e.g. with curl while connected to the devices WiFi:

curl --insecure -H "Charset:UTF-8" -H "Content-Type:application/json" https://192.168.23.1/v1/user/setting/read/password -d '{"key": "lgepmsuser!@#}'

All entities from the API are implemented.

Additionally, there is batt_directional and grid_directional (positive and negative value depending on the direction). This allows configuring various custom cards, e.g. https://github.com/flixlix/power-flow-card-plus

type: custom:power-flow-card-plus
entities:
  battery:
    entity: sensor.lg_ess_batt_directional
    state_of_charge: sensor.lg_ess_statistics_bat_user_soc
  grid:
    entity: sensor.lg_ess_grid_directional
  solar:
    entity: sensor.lg_ess_statistics_pcs_pv_total_power
  home:
    entity: sensor.lg_ess_statistics_load_power