15. Application Programming Interface (API)ΒΆ

GEISA Application Programming Interface

For GEISA applications to be interoperable across multiple hardware/device platforms, the GEISA specification establishes a well-defined set of APIs between the application and the device-specific portions of platform implementation. API Architecture discusses the mechanics of the API.

API Catalog Reference provides a simple catalog of all current APIs.

The GEISA API defines APIs for the following purposes:

  • Platform Discovery

    Provides platform capabilities, including device type and available features (e.g., sensors, actuators, interfaces), etc.

  • Platform and App Status

    Provides the current status of the platform, including runtime mode (e.g. Manufacturing, Unprovisioned, Normal, Test), communications status, power status (powered, outage), and resource availability.

  • Instantaneous Data

    Provides streaming metrology data at one-second intervals or better for applications that need to continuously monitor conditions, without consuming and analyzing waveform data directly.

  • Billing Data

    Common instantaneous billing/metrology quantities currently appear in Instantaneous Data. A dedicated billing/metered quantities transaction set is reserved for a future version of the specification.

    Note

    Reserved for expansion and definition in a future version of the specification.

  • Off-Device Communication

    Allows applications to communicate off-device via messaging or direct IP sockets.

  • Waveform Data

    Allows applications to obtain waveform frame metadata and to subscribe or unsubscribe to waveform data streams.

  • Other Metering Data

    This includes specialized metering quantities that meters may record and that applications may request, but that are not so widely used as to be included in the Instantaneous Data transaction definition.

    Note

    Reserved for expansion and definition in a future version of the specification.

  • Actuator Status & Control

    Allows authorized applications to query actuator status and request actuator control for platform-exposed actuators such as service switches, DER switches, and load-control relays.

  • Sensors

    Exposes sensor data such as temperature, humidity, location, seismic data, vibration, acceleration, and light / solar radiation. These are examples only; sensors are device/platform specific and other sensors may exist on a particular platform.

  • Event Data

    Note

    Reserved for expansion and definition in a future version of the specification.

  • System Messaging

    Note

    Reserved for expansion and definition in a future version of the specification.

Note

Additional transaction sets may be added in future versions of the GEISA specification.

GEISA Pyramid