This binding is meant to retrieve data of the LG Ess Powerrouter/Battery bundle. It is designed to retrieve data either from the lg cloud (https://enervu.lg-ess.com) or via WLAN directly from the local device. Note that some data(e.g separate information for the strings) may not be retrieved from the lg cloud.
The following thing types are supported:
Thing | ID | Description |
---|---|---|
Powerrouter | powerrouter | Represents the physical powerrouter & battery device |
Once the binding is initialized it will look for devices on the local network. If a scan is started manually and a device could not be found just try again. From time to time the device does not respond on the first try.
In order to get the device password you need to be within the wifi provided by the box.
Once you are connected to the wifi of your device send a json request to
https://192.168.23.1/v1/user/setting/read/password
with the following payload
{"key": "lgepmsuser!@#"}
Parameter | Type | Required/Optional | Group | Description |
---|---|---|---|---|
dataSourceCloud | boolean | required | general | Select the datasource where to retrieve data from |
timeout | integer | optional | general | The timeout in seconds |
kwhPrice | decimal | optional | general | Price of the kWh paid to local provider |
kwhPriceSell | decimal | optional | general | Price local provider pays for selling power |
co2Factor | decimal | optional | general | Factor of the powermix (e.g. 0.71% of bought power is from green energy |
lowbatterythreshold | integer | optional | general | Battery SOC is considered low when equal or below this value |
triggergeneratedpowerthreshold | integer | optional | comforttrigger | Threshold of generated power[W] by PV to trigger event |
triggergeneratedpowerthresholdtime | integer | optional | comforttrigger | Time generated power needs to be above threshold until trigger is set (0 = instant) |
triggergeneratedpowerthresholdresettime | integer | optional | comforttrigger | Time generated power needs to be below threshold until a new trigger may start |
refreshInterval | integer | optional | local | How often shall data be polled (in seconds) |
hostName | text | required if source is lan | local | hostname/ip of local device |
passwordLocal | text | required if source is lan | local | password of the local device |
user | text | required if source is cloud | cloud | username / email used for login at https://enervu.lg-ess.com |
passwordCloud | text | required if source is cloud | cloud | password used for login at https://enervu.lg-ess.com |
refreshIntervalCloud | integer | optional | cloud | How often shall data be polled (in seconds) |
channel | type | description |
---|---|---|
currentPowerFromGrid | Number:Power | Current power taken from grid |
dailyPowerFromGrid | Number:Power | Daily power taken from grid |
monthlyPowerFromGrid | Number:Power | Monthly power taken from grid |
currentPowerToGrid | Number:Power | Current power provided to grid |
dailyPowerToGrid | Number:Power | Daily power provided to grid |
monthlyPowerToGrid | Number:Power | Monthly power provided to grid |
currentPowerFromPV | Number:Power | Current power produced by PV |
dailyPowerFromPV | Number:Power | Daily power produced by PV |
monthlyPowerFromPV | Number:Power | Monthly power produced by PV |
batterySoc | Number | Current battery SOC state |
batterySafetySoc | Number | Current battery SOC state |
batteryStatus | String | Current battery operating mode (idle, charging,discharging) |
batteryWintermode | Switch | Status of wintermode |
currentPowerChargingToBattery | Number:Power | Current power used to charge the battery |
dailyBatteryCharge | Number:Energy | Daily energy used to charge the battery |
monthlyBatteryCharge | Number:Energy | Monthly energy used to charge the battery |
currentPowerDischargingFromBattery | Number:Power | Current power used to discharge the battery |
dailyPowerDischargingFromBattery | Number:Energy | Daily energy used to discharge the battery |
monthlyPowerDischargingFromBattery | Number:Energy | Monthly energy used to discharge the battery |
lowbattery | Switch | Lowbattery indicator set when soc is below configured threshold |
trigger_battery_status | Event | Triggered once if battery is depleted,low or fully charged |
currentTotalPowerConsumption | Number:Power | Current total power consumption (grid+battery+pv) |
dailyTotalPowerConsumption | Number:Energy | Daily total energy consumption (grid+battery+pv) |
monthlyTotalPowerConsumption | Number:Energy | Monthly total energy consumption (grid+battery+pv) |
currentDirectPowerConsumption | Number:Power | Current direct power consumption from PV |
dailyDirectPowerConsumption | Number:Energy | Daily direct energy consumption from PV |
monthlyDirectPowerConsumption | Number:Energy | Monthly direct energy consumption from PV |
selfConsumption | Number | Percentage of self consumption for the current day |
string1CurrentPotential | Number:ElectricPotential | Current DC Voltage of string 1 (only for LAN mode) |
string2CurrentPotential | Number:ElectricPotential | Current DC Voltage of string 2 (only for LAN mode) |
string3CurrentPotential | Number:ElectricPotential | Current DC Voltage of string 3 (only for LAN mode) |
string4CurrentPotential | Number:ElectricPotential | Current DC Voltage of string 4 (only for LAN mode) |
string5CurrentPotential | Number:ElectricPotential | Current DC Voltage of string 5 (only for LAN mode) |
currentCurrentString1 | Number:ElectricCurrent | Current DC Current of string 1 (only for LAN mode) |
currentCurrentString2 | Number:ElectricCurrent | Current DC Current of string 2 (only for LAN mode) |
currentCurrentString3 | Number:ElectricCurrent | Current DC Current of string 3 (only for LAN mode) |
currentCurrentString4 | Number:ElectricCurrent | Current DC Current of string 4 (only for LAN mode) |
currentCurrentString5 | Number:ElectricCurrent | Current DC Current of string 5 (only for LAN mode) |
currentPowerString1 | Number:Power | Current DC power of string 1 |
currentPowerString2 | Number:Power | Current DC power of string 2 |
currentPowerString3 | Number:Power | Current DC power of string 3 |
currentPowerString4 | Number:Power | Current DC power of string 4 |
currentPowerString5 | Number:Power | Current DC power of string 5 |
isDirectConsuming | Switch | Is PV power currently directly consumed? |
isBatteryCharging | Switch | Is the battery currently charging? |
isBatteryDischarging | Switch | Is the battery currently discharging? |
isGridSelling | Switch | Currently selling power to grid? |
isGridBuying | Switch | Currently buying power from grid? |
isChargingFromGrid | Switch | Is battery currently charging from grid? |
monthlyCO2Savings | Number | Saved CO2 by consuming power from PV/Battery rather than from grid |
monthlyEarnings | Number | Money earned by selling power to local energy provider in current month |
monthlyPaid | Number | Money paid to local energy provider in current month |
monthlyMoneySavings | Number | Saved money by selling power rather than buying in current month |
trigger_powergen_status | Event | Triggered once pv produces power above a configurable threshold for a configured time |