Docs menu

Native Components

Battery Card

A semantic, read-only battery monitoring component. HARDWARE VALIDATED on the current ESP32-P4 evidence ledger.

#9 — Battery Card

Battery Card in the implemented ForgeUI Native Component library.

A semantic, read-only battery monitoring component.

  • Portable devices
  • UPS systems
  • Industrial equipment
  • Energy storage

Inspector capabilities and presentation

  • 240 × 145 default and 220 × 128 minimum stackable geometry
  • Percentage, voltage and current
  • Runtime, temperature and health
  • Charging state, icon and progress
  • Low and critical thresholds with compact mode

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

c
FG_Set_<BatteryCard>_Percentage(float value);
FG_Set_<BatteryCard>_Voltage(float value);
FG_Set_<BatteryCard>_Current(float value);
FG_Set_<BatteryCard>_Charging(bool enabled);
FG_Set_<BatteryCard>_Health(int32_t value);
FG_Set_<BatteryCard>_Runtime(int32_t value);
FG_Set_<BatteryCard>_Temperature(float value);

Interaction and UserEvents

c
No UserEvents are generated.

Battery Card is intentionally read-only. It has no selection, acknowledgement, editing, operator controls or touch callbacks.

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

SurfaceStatus
Browser PreviewImplemented
Live StudioImplemented
Standalone ExportImplemented
Persisted identity and duplicate isolationImplemented
ESP32-P4HARDWARE VALIDATED