Skip to content

Added ListGridpoolEnergySchedules and ListMicrogridSensors RPCs#99

Merged
thomas-nicolai-frequenz merged 14 commits into
frequenz-floss:v0.x.xfrom
thomas-nicolai-frequenz:v0.x.x
Jun 16, 2026
Merged

Added ListGridpoolEnergySchedules and ListMicrogridSensors RPCs#99
thomas-nicolai-frequenz merged 14 commits into
frequenz-floss:v0.x.xfrom
thomas-nicolai-frequenz:v0.x.x

Conversation

@thomas-nicolai-frequenz

@thomas-nicolai-frequenz thomas-nicolai-frequenz commented May 28, 2026

Copy link
Copy Markdown
Contributor

Summary

This PR extends the Platform Assets API with market-topology and Gridpool-related metadata needed by trading, forecasting, reporting, and operational tooling. The PR also adds Gridpool energy schedules and microgrid sensor listing support.

Changes

  • Added ListMarketTopologyRelations for querying market-topology relations within the current enterprise scope.
  • Added MarketTopologyRelation as the canonical relation model between Gridpools, Microgrids, and Market Locations.
  • Added MarketParticipation and MarketParticipationType to describe use-case-specific participation of a market-topology relation.
  • Added ListGridpoolEnergySchedules for retrieving static Gridpool energy schedules.
  • Added GridpoolEnergySchedule, including counterparty balancing group, Gridpool and counterparty delivery areas, direction, validity period, cancellation timestamp, delivery duration, and scheduled active-power time series.
  • Added GridpoolEnergyScheduleDirection to describe import/export direction from the perspective of the Frequenz balancing group.
  • Added ListMicrogridSensors for listing sensors belonging to a specific microgrid.
  • Updated service-level documentation to describe both platform asset metadata and market-topology metadata.
  • Aligned request filters with the existing nested filter-message pattern used by the API.

Notes

MarketTopologyRelation intentionally supports relations without a Gridpool. These represent Microgrid-to-Market-Location links used for deployment, metering validation, reporting comparison, or local optimization, and do not imply market participation.

If gridpool_id is set on a MarketTopologyRelation, the relation represents participation in a Gridpool context. In that case, delivery_area is required and participations may describe use-case-specific validity.

Gridpool energy schedules use a schedule-level delivery_duration. Each time-series entry contains only a start timestamp and applies until start_time + delivery_duration.

The API does not expose derived active/inactive schedule status. Clients can derive effective status from validity_period, cancel_time, and their own evaluation time.

@github-actions github-actions Bot added the part:docs Affects the documentation label May 28, 2026
Signed-off-by: tomni <thomas.nicolai@frequenz.com>
Signed-off-by: tomni <thomas.nicolai@frequenz.com>
Signed-off-by: tomni <thomas.nicolai@frequenz.com>
@thomas-nicolai-frequenz thomas-nicolai-frequenz force-pushed the v0.x.x branch 2 times, most recently from f39f614 to 9e73a5f Compare May 28, 2026 19:40
Comment thread proto/frequenz/api/platformassets/v1alpha1/platformassets.proto Outdated
Comment thread proto/frequenz/api/platformassets/v1alpha1/platformassets.proto
Comment thread proto/frequenz/api/platformassets/v1alpha1/platformassets.proto Outdated
Comment thread proto/frequenz/api/platformassets/v1alpha1/platformassets.proto Outdated
…area split and cancel_time

Signed-off-by: tomni <thomas.nicolai@frequenz.com>
Signed-off-by: tomni <thomas.nicolai@frequenz.com>
…eriod filtering

Signed-off-by: tomni <thomas.nicolai@frequenz.com>
Signed-off-by: tomni <thomas.nicolai@frequenz.com>
Signed-off-by: tomni <thomas.nicolai@frequenz.com>
Signed-off-by: tomni <thomas.nicolai@frequenz.com>
Comment thread proto/frequenz/api/platformassets/v1alpha1/platformassets.proto Outdated
Comment thread proto/frequenz/api/platformassets/v1alpha1/platformassets.proto

@cwasicki cwasicki left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Comment thread proto/frequenz/api/platformassets/v1alpha1/platformassets.proto Outdated
Comment thread proto/frequenz/api/platformassets/v1alpha1/platformassets.proto Outdated
Comment thread proto/frequenz/api/platformassets/v1alpha1/platformassets.proto Outdated
Comment thread proto/frequenz/api/platformassets/v1alpha1/platformassets.proto Outdated
Comment thread proto/frequenz/api/platformassets/v1alpha1/platformassets.proto
Comment thread proto/frequenz/api/platformassets/v1alpha1/platformassets.proto Outdated
Comment thread proto/frequenz/api/platformassets/v1alpha1/platformassets.proto
thomas-nicolai-frequenz and others added 3 commits June 4, 2026 18:23
Signed-off-by: tomni <thomas.nicolai@frequenz.com>
…tionSelector rename

Signed-off-by: tomni <thomas.nicolai@frequenz.com>
@github-actions github-actions Bot added the part:tooling Affects the development tooling (CI, deployment, dependency management, etc.) label Jun 4, 2026
Signed-off-by: tomni <thomas.nicolai@frequenz.com>

@cwasicki cwasicki left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Signed-off-by: tomni <thomas.nicolai@frequenz.com>
Comment thread proto/frequenz/api/platformassets/v1alpha1/platformassets.proto
@thomas-nicolai-frequenz thomas-nicolai-frequenz added this pull request to the merge queue Jun 16, 2026
Merged via the queue into frequenz-floss:v0.x.x with commit 954c3c5 Jun 16, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

part:docs Affects the documentation part:tooling Affects the development tooling (CI, deployment, dependency management, etc.)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants