## Summary
The **Home** tile at the top of the Energy dashboard never populates
(shows “— kWh”) despite all backend data being correctly calculated and
returned by `/api/manager/energy/report/day`. All other tiles (Grid, Solar,
Battery, EV Charger) populate correctly. The issue is persistent across
firmware restarts, energy-report resets, and device reconfiguration.
Per the KB (*Understanding the Homey Energy tab*):
"The ‘Home’ tile represents your household’s total energy consumption,
calculated by Homey using data from your smart meter and connected devices."
Homey appears to compute that value correctly (verified via API scalars)
but fails to render it in the UI.
## Device schema
13 MQTT-Hub-backed devices:
| Device | Class | Energy object |
|—|—|—|
| Rete Elettrica (grid) | sensor | `cumulative:true`, `cumulativeImportedCapability:“meter_power.total_import”`, `cumulativeExportedCapability:“meter_power.total_export”` |
| Pannelli Fotovoltaici (solar) | solarpanel | `generator:true`, `meterPowerExportedCapability:“meter_power”` |
| Batteria (battery) | battery | `homeBattery:true`, `meterPowerImportedCapability:“meter_power”`, `meterPowerExportedCapability:“meter_power.exported”` |
| Wallbox (evcharger) | evcharger | `evCharger:true`, `meterPowerImportedCapability:“meter_power”` |
| Tesla Model Y EV | car | `electricCar:true` |
| Consumo Casa (summary) | other | — |
| 5× Battery modules | battery | — |
| Previsione Solare | other | — |
| Diagnostica Inverter | other | — |
## Backend data IS available (verified via API)
`GET /api/manager/energy/report/day?date=2026-04-14` (today):
```json
{
"electricity": {
"importedPeriod": 2.9,
"exportedPeriod": 0,
"generatedPeriod": 2.1,
"batteryChargedPeriod": 0,
"batteryDischargedPeriod": 0,
"evChargerChargedPeriod": 0,
"consumedPeriod": 0
}
}
Computed household consumption today = importedPeriod − exportedPeriod + generatedPeriod + batteryDischargedPeriod − batteryChargedPeriod − evChargerChargedPeriod = 5.0 kWh. This is the value the Home tile
SHOULD display.
GET /api/manager/energy/live also works correctly:
totalConsumed: 450W, totalGenerated: 470W, totalCumulative: 430W.
Insight anomaly
GET /api/manager/insights/log returns only per-device logs
(homey:device::energy_power, homey:device::meter_power).
There is no homey:manager:energy:* aggregate insight log. If the Home
tile relies on a manager-level aggregate insight, it is never being created
for this setup.
Things tested — none fix it
1. Restart Homey Pro (cold reboot via settings)
2. DELETE /api/manager/energy/reports to wipe history and let it rebuild
3. Toggle cumulative flag OFF → save → ON → save
4. Remove cumulativeImportedCapability / cumulativeExportedCapability
and rely only on cumulative:true
5. Switch capability naming between meter_power base and split sub-ids
(meter_power.total_import / .total_export) — matching AdyRock’s
schema exactly
6. Delete and recreate every energy device from scratch
7. Install the ady.sofar app (AdyRock) and add its full driver set
(grid + battery + solar_panel + summary). On this same Homey, the Home
tile was populated in the past with this app; after all the resets, it
is not repopulating even with this app active.
8. Check for ghost devices in historical reports (some appeared pre-2026-04-13
from deleted devices; today’s report is clean)
9. Confirm all devices have flags: [“energyDevicePropsMigration”]
(appears normal, present on every energy device)
10. Verified with both iOS Homey app and the Apple iPad app — same empty tile
Hypothesis
The Home tile requires an aggregate source (a homey:manager:energy
insight log, or a specific driver flag/metadata) that is not being
produced for virtual devices using the v12.3+ energy schema
(cumulativeImportedCapability / cumulativeExportedCapability). The
backend calculates the right value on demand, but the aggregate persistence
required by the tile renderer is missing.
Attached
Full API dump with device list, energy report, live data, insight log
summary, and anomaly summary (homey_bug_dump.json, 62 KB).
Questions for Athom
1. What specific condition/source does the Home tile renderer consume?
Is it a homey:manager:energy:* insight? A specific capability?
2. Are virtual devices (MQTT Hub / community drivers) supposed to populate
the Home tile when correctly configured as cumulative:true? If so,
what is missing in this setup?
3. Is there a user-visible setting (e.g. "Tracks total home energy
consumption") referenced in the Developer docs that must be toggled,
and is it surfaced in the mobile app UI for virtual devices?
