Skip to content

Conversation

@tiyash-basu-frequenz
Copy link
Contributor

This commit adds a new enum CommunicationComponentStateCode to represent the high-level operational state of a communication component. It also introduces a new message CommunicationComponentStateSnapshot that captures a snapshot of the component's state, diagnostics, and timing. This is useful for monitoring and diagnosing the status of communication components in a microgrid system.

This commit updates the `CommunicationComponentDiagnosticCode` enum in
the `communication_components.proto` file to include additional
diagnostic codes for better error handling and reporting. The new codes
include `COMMUNICATION_COMPONENT_DIAGNOSTIC_CODE_UNKNOWN`,
`COMMUNICATION_COMPONENT_DIAGNOSTIC_CODE_AUTHENTICATION_ERR`,
`COMMUNICATION_COMPONENT_DIAGNOSTIC_CODE_OVER_TEMPERATURE`.

Signed-off-by: Tiyash Basu <[email protected]>
@tiyash-basu-frequenz tiyash-basu-frequenz added this to the v0.7.0 milestone May 13, 2025
@tiyash-basu-frequenz tiyash-basu-frequenz self-assigned this May 13, 2025
Copilot AI review requested due to automatic review settings May 13, 2025 13:34
@tiyash-basu-frequenz tiyash-basu-frequenz requested a review from a team as a code owner May 13, 2025 13:34
@github-actions github-actions bot added part:docs Affects the documentation part:protobuf Affects the protocol buffer definition files labels May 13, 2025
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR adds a new enum (CommunicationComponentStateCode) to represent the operational state of a communication component and introduces a snapshot message (CommunicationComponentStateSnapshot) for capturing component state, diagnostics, and timing.

  • Added CommunicationComponentStateCode enum with state codes such as ONLINE, OFFLINE, etc.
  • Introduced CommunicationComponentStateSnapshot, a new message capturing timing, state, and diagnostic details.
  • Updated the CommunicationComponentDiagnosticCode enum values and key names (e.g., renaming HARDWARE_FAULT to HARDWARE_GENERIC_FAULT) and corresponding release notes.

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
proto/frequenz/api/common/v1/microgrid/communication_components/communication_components.proto Added new state code enum and snapshot message; updated diagnostic enum values and key names.
RELEASE_NOTES.md Updated release notes to include the new message CommunicationComponentStateSnapshot.
Comments suppressed due to low confidence (1)

proto/frequenz/api/common/v1/microgrid/communication_components/communication_components.proto:72

  • [nitpick] The renaming from HARDWARE_FAULT to HARDWARE_GENERIC_FAULT may cause confusion among consumers expecting the old naming. Please update related documentation and ensure that corresponding handling logic is adjusted accordingly.
COMMUNICATION_COMPONENT_DIAGNOSTIC_CODE_HARDWARE_GENERIC_FAULT = 6;

This commit adds a new enum `CommunicationComponentStateCode` to
represent the high-level operational state of a communication component.
It also introduces a new message `CommunicationComponentStateSnapshot`
that captures a snapshot of the component's state, diagnostics, and
timing. This is useful for monitoring and diagnosing the status of
communication components in a microgrid system.

Signed-off-by: Tiyash Basu <[email protected]>
Copy link
Contributor

@thomas-nicolai-frequenz thomas-nicolai-frequenz left a comment

Choose a reason for hiding this comment

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

LGTM

@tiyash-basu-frequenz tiyash-basu-frequenz added this pull request to the merge queue May 14, 2025
Merged via the queue into frequenz-floss:v0.x.x with commit e7e72ae May 14, 2025
6 checks passed
@tiyash-basu-frequenz tiyash-basu-frequenz deleted the comm_components branch May 14, 2025 07:59
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:protobuf Affects the protocol buffer definition files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants