Docs menu

Native Components

Trend Chart

A lightweight semantic time-series history component. PROVEN on the current ESP32-P4 evidence ledger.

#5 — Trend Chart

Trend Chart in the implemented ForgeUI Native Component library.

A lightweight semantic time-series history component.

  • SCADA history
  • Machine telemetry
  • Environmental trends
  • Energy monitoring

Inspector capabilities and presentation

  • Bounded history with no runtime allocation
  • Automatic or fixed scaling
  • Warning and alarm thresholds
  • Deterministic preview and native chart output

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
void FG_Add_<TrendChart>_Point(float value);
void FG_Clear_<TrendChart>(void);
void FG_Set_<TrendChart>_WarningThreshold(float value);
void FG_Set_<TrendChart>_AlarmThreshold(float value);

Interaction and UserEvents

c
void FG_On_<TrendChart>_Point_Added(float value);
void FG_On_<TrendChart>_Warning(void);
void FG_On_<TrendChart>_Alarm(void);
void FG_On_<TrendChart>_Recovered(void);

When enabled, threshold callbacks report semantic state transitions; they do not fire for every sample.

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-P4PROVEN