Skip to content

HomeAssistant HACS integration for the LG ESS inverter

License

Notifications You must be signed in to change notification settings

dkarv/hacs-lg-ess

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hacs-lg-ess

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

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Setup

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 lg ess and convert it. Mac address 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://10.10.1.98/v1/user/setting/read/password -d '{"key": "lgepmsuser!@#}'

Entities

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