Is there a description of what exactly drives each bit of the Energy display?

I wrote the app for the Franklin Whole Home Energy system ([APP][Pro] Franky - FranklinWH integration) and I’m struggling to understand how to adapt it to correctly drive the nice Energy Home animation. There are basically 4 feeds - Grid, Solar, Battery, House - and apart from House, each will provide or consume energy at some point every day (even Solar which can consume some power during the night to run it’s internal monitoring). Looking at the API docs it is unclear to me how to connect up various power meters and measures to make things work, and I definitely don’t have it right as my current app claims to be sending power to the grid from the house and it absolutely isn’t doing that right now.

Is there a reference design or something additional to the API I can read to help me work this out?

Thanks
Tim

1 Like

A common issue is to have a all-in-one device.

To geh all into the energy view you need:

  • main power meter (grid in/out) with subcapabilities for in/out and energy settings for both capabilities. Check energy settings in developer documentation.
  • solar device with device class ‘solarpanel’
  • home battery with energy settings as ‘home battery’
  • house usage itself is just a device with measure_power and meter_power. If you have energy measuring on most devices, it could make senso to exclude it from Homey Energy to not show duplicated usage amounts.
1 Like

It would be nice if you could define which properties are used for which purpose in these complex devices. For example, there are definitions such as meterPowerExportedCapability to let you define battery monitoring properties rather than expecting something specifically named. Failing that, a well documented list of suggested properties names and purposes for these all-in-one (and increasingly common) devices would go a long way. I did of course read the energy setting documentation and found what was written ambiguous for a device such as this.

It’s not designed for all-in-one devices. It’s designed for most common cases where you have a meter, a battery and a charger as single devices.

Ask Athom, why they did it this way. I would say to show up devices in HomeyEnergy without user interaction and without technical settings like it’s done in HomeAssist.
This simplifies things, but only for ‘simple’ devices

I would also like to see a Energy settings where you can define optionally some devices and capabilities for every HomeyEnergy part.