Native Components
KPI Card
A generic runtime-driven card for one important metric and its context. HARDWARE VALIDATED on the current ESP32-P4 evidence ledger.
#13 — KPI Card
A generic runtime-driven card for one important metric and its context.
- —Efficiency
- —Temperature
- —Alarm counts
- —Operational targets
Inspector capabilities and presentation
- —240 × 145 default and 220 × 128 minimum stackable geometry
- —Title, primary value, unit and secondary context
- —Target or reference and trend text
- —Flat, Up or Down trend
- —Neutral, Good, Warning or Critical status
The component remains one serialized Canvas object. Browser Preview, Live Studio and Standalone Export consume its normalized semantic model while internal LVGL composition stays private.
Generated Runtime SDK family
void FG_Set_<KPICard>_Value(const char * value);
void FG_Set_<KPICard>_Unit(const char * unit);
void FG_Set_<KPICard>_Secondary_Text(const char * text);
void FG_Set_<KPICard>_Target_Text(const char * text);
void FG_Set_<KPICard>_Trend_Text(const char * text);
void FG_Set_<KPICard>_Trend_State(int32_t state);
void FG_Set_<KPICard>_Status(int32_t status);Interaction and UserEvents
No UserEvents are generated.KPI Card is generic, monitoring-only and generates zero UserEvents. All seven Runtime SDK setters are silent.
Where hooks exist, implement the exact declarations in 95_UserEvents.c. Runtime SDK calls never simulate user input.
Ownership boundary
ForgeUI owns semantic presentation, private LVGL composition, generated contracts, persisted identity, fixed storage and Browser/Live/Standalone alignment.
Browser, Live, Standalone and ESP32-P4 status
| Surface | Status |
|---|---|
| Browser Preview | Implemented |
| Live Studio | Implemented |
| Standalone Export | Implemented |
| Persisted identity and duplicate isolation | Implemented |
| ESP32-P4 | HARDWARE VALIDATED |