Docs menu

Native Components

Tank Level Card

A semantic, read-only monitor for tanks, vessels, reservoirs and process storage. HARDWARE VALIDATED on the current ESP32-P4 evidence ledger.

#10 — Tank Level Card

Tank Level Card in the implemented ForgeUI Native Component library.

A semantic, read-only monitor for tanks, vessels, reservoirs and process storage.

  • Water and fuel tanks
  • Reservoirs
  • Industrial storage
  • Marine systems

Inspector capabilities and presentation

  • 240 × 145 default and 220 × 128 minimum stackable geometry
  • Level percentage, volume and capacity
  • Engineering units
  • Low and high thresholds
  • Theme-aware tank presentation

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_<TankLevelCard>_Level(float percent);
FG_Set_<TankLevelCard>_Volume(float value);
FG_Set_<TankLevelCard>_Capacity(float value);
FG_Set_<TankLevelCard>_Units(const char * units);
FG_Set_<TankLevelCard>_LowLevel(float value);
FG_Set_<TankLevelCard>_HighLevel(float value);

Interaction and UserEvents

c
No UserEvents are generated.

Tank Level Card is intentionally display-only. It has no operator controls or genuine touch interaction.

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