From 3776b2d78b7610c5f83564d12d8e07ad35a18475 Mon Sep 17 00:00:00 2001 From: Bot Date: Sat, 7 Oct 2023 13:49:29 +0000 Subject: [PATCH] Automated markdown-lint fixes --- docs/conf2.proto.md | 75 ++++++++++---------- docs/data.proto.md | 117 +++++++++++++++---------------- docs/fault.proto.md | 163 ++++++++++++++++++++++---------------------- docs/task.proto.md | 38 +++++------ 4 files changed, 188 insertions(+), 205 deletions(-) diff --git a/docs/conf2.proto.md b/docs/conf2.proto.md index b8bf3e9..89ef2d5 100644 --- a/docs/conf2.proto.md +++ b/docs/conf2.proto.md @@ -5,19 +5,14 @@ ## Imports | Import | Description | -|--------|-------------| - - +| ------ | ----------- | ## Options | Name | Value | Description | -|------------|-----------|-------------| +| ---------- | --------- | ----------- | | go_package | ./conf/v1 | | - - - ### Conf2Frame Diagram ```mermaid @@ -35,6 +30,7 @@ Conf2Frame --> `Config` Conf2Frame --> `Conf2Header` ``` + ### Conf2Header Diagram ```mermaid @@ -54,6 +50,7 @@ class Conf2Header { } ``` + ### Config Diagram ```mermaid @@ -80,55 +77,53 @@ class Config { ``` ## Message: Conf2Frame +
FQN: conf.v1.Conf2Frame
Configuration frame 2
-| Field | Ordinal | Type | Label | Description | -|-----------|---------|-------------|----------|-------------------------------| -| DATA_RATE | 3 | uint32 | | Rate of data transmission | -| configs | 2 | Config | Repeated | Set of PMU configurations | -| header | 1 | Conf2Header | | Configuration frame 2 header | - +| Field | Ordinal | Type | Label | Description | +| --------- | ------- | ----------- | -------- | ---------------------------- | +| DATA_RATE | 3 | uint32 | | Rate of data transmission | +| configs | 2 | Config | Repeated | Set of PMU configurations | +| header | 1 | Conf2Header | | Configuration frame 2 header | ## Message: Conf2Header +
FQN: conf.v1.Conf2Header
Configuration frame 2 header
-| Field | Ordinal | Type | Label | Description | -|-----------|---------|--------|-------|------------------------------------------------------| -| FRACSEC | 5 | uint32 | | Fraction of Second and Message Time Quality | -| FRAMESIZE | 2 | uint32 | | Number of bytes in the frame | -| IDCODE | 3 | uint32 | | Stream source ID number | -| NUM_PMU | 7 | uint32 | | The number of PMUs included in the data frame | -| SOC | 4 | uint32 | | SOC time stamp | -| SYNC | 1 | uint32 | | Sync byte followed by frame type and version number | -| TIME_BASE | 6 | uint32 | | Resolution of FRACSEC time stamp | - +| Field | Ordinal | Type | Label | Description | +| --------- | ------- | ------ | ----- | --------------------------------------------------- | +| FRACSEC | 5 | uint32 | | Fraction of Second and Message Time Quality | +| FRAMESIZE | 2 | uint32 | | Number of bytes in the frame | +| IDCODE | 3 | uint32 | | Stream source ID number | +| NUM_PMU | 7 | uint32 | | The number of PMUs included in the data frame | +| SOC | 4 | uint32 | | SOC time stamp | +| SYNC | 1 | uint32 | | Sync byte followed by frame type and version number | +| TIME_BASE | 6 | uint32 | | Resolution of FRACSEC time stamp | ## Message: Config +
FQN: conf.v1.Config
Single PMU configuration according to Configuration frame 2
-| Field | Ordinal | Type | Label | Description | -|---------|---------|--------|----------|----------------------------------------| -| ANNMR | 5 | uint32 | | Number of analog values | -| ANUNIT | 9 | uint32 | Repeated | Conversion factor for analog channels | -| CFGCNT | 12 | uint32 | | Configuration change count | -| CHNAM | 7 | string | | Phasor and channel names | -| DGNMR | 6 | uint32 | | Number of digital status words | -| DIGUNIT | 10 | uint32 | Repeated | Mask words for digital status words | -| FNOM | 11 | uint32 | | Nominal line frequency code and flags | -| FORMAT | 3 | uint32 | | Data format within data frame | -| IDCODE | 2 | uint32 | | Data source ID number | -| PHNMR | 4 | uint32 | | Number of phasors | -| PHUNIT | 8 | uint32 | Repeated | Conversion factor for phasor channels | -| STN | 1 | string | | Station name | - - - +| Field | Ordinal | Type | Label | Description | +| ------- | ------- | ------ | -------- | ------------------------------------- | +| ANNMR | 5 | uint32 | | Number of analog values | +| ANUNIT | 9 | uint32 | Repeated | Conversion factor for analog channels | +| CFGCNT | 12 | uint32 | | Configuration change count | +| CHNAM | 7 | string | | Phasor and channel names | +| DGNMR | 6 | uint32 | | Number of digital status words | +| DIGUNIT | 10 | uint32 | Repeated | Mask words for digital status words | +| FNOM | 11 | uint32 | | Nominal line frequency code and flags | +| FORMAT | 3 | uint32 | | Data format within data frame | +| IDCODE | 2 | uint32 | | Data source ID number | +| PHNMR | 4 | uint32 | | Number of phasors | +| PHUNIT | 8 | uint32 | Repeated | Conversion factor for phasor channels | +| STN | 1 | string | | Station name | diff --git a/docs/data.proto.md b/docs/data.proto.md index 55684f4..6a92e30 100644 --- a/docs/data.proto.md +++ b/docs/data.proto.md @@ -5,72 +5,67 @@ ## Imports | Import | Description | -|--------|-------------| - - +| ------ | ----------- | ## Options | Name | Value | Description | -|------------|-----------|-------------| +| ---------- | --------- | ----------- | | go_package | ./data/v1 | | - - ## Enum: DataType +
FQN: data.v1.DataType
The collection of Data Types defined so far. They are useful to map
measurements to their rappresentation. This is important since all measurements
are any how cast to UINT64 in the real time platform
-| Name | Ordinal | Description | -|---------------------------------------|---------|-------------------------------------------------------------| -| DATA_TYPE_UNSPECIFIED | 0 | No type define | -| DATA_TYPE_ACTIVE_POWER | 1 | Active Power. It maps to an Analog. | -| DATA_TYPE_ANGLE | 2 | Angle. It maps to an Analog. | -| DATA_TYPE_AUTOMATIC | 3 | Auomatic. It maps to Discrete (True or False). | -| DATA_TYPE_BOOLEAN | 4 | Booleam. It maps to Discrete (True or False). | -| DATA_TYPE_CONFIG_CHANGE | 5 | Configuration change. It maps to Discrete (True or False). | -| DATA_TYPE_CURRENT_SEQUENCE_NEGATIVE | 6 | PHASOR | -| DATA_TYPE_CURRENT_SEQUENCE_POSITIVE | 7 | PHASOR | -| DATA_TYPE_CURRENT_SEQUENCE_ZERO | 8 | PHASOR | -| DATA_TYPE_DATA_ERROR | 9 | DISCRETE (True or False) | -| DATA_TYPE_DATA_MODIFIED | 10 | DISCRETE (True or False) | -| DATA_TYPE_DATA_SORTING | 11 | DISCRETE | -| DATA_TYPE_ENERGY | 12 | ANALOG | -| DATA_TYPE_FREQUENCY | 13 | ANALOG | -| DATA_TYPE_LINE_CURRENT | 14 | ANALOG | -| DATA_TYPE_LINE_TO_LINE_VOLTAGE | 15 | ANALOG | -| DATA_TYPE_LOCAL_OPERATION | 16 | DISCRETE | -| DATA_TYPE_OPERATION_COUNT | 17 | DISCRETE | -| DATA_TYPE_PACKET_LATENCY | 18 | ANALOG | -| DATA_TYPE_PHASE_VOLTAGE | 19 | ANALOG | -| DATA_TYPE_PHASOR_CURRENT | 20 | PHASOR | -| DATA_TYPE_PHASOR_VOLTAGE | 21 | PHASOR | -| DATA_TYPE_PMU_SYNC | 22 | DISCRETE (True or False) | -| DATA_TYPE_PMU_TIME_QUALITY | 23 | DISCRETE | -| DATA_TYPE_PMU_TRIGGER_DETECTED | 24 | DISCRETE (True or False) | -| DATA_TYPE_POWER | 25 | ANALOG | -| DATA_TYPE_POWER_FACTOR | 26 | ANALOG | -| DATA_TYPE_PRESSURE | 27 | ANALOG | -| DATA_TYPE_RATE_OF_CHANGE_OF_FREQUENCY | 28 | ANALOG | -| DATA_TYPE_REACTIVE_POWER | 29 | ANALOG | -| DATA_TYPE_SWITCH_POSITION | 30 | DISCRETE (True or False) | -| DATA_TYPE_TAP_POSITION | 31 | DISCRETE | -| DATA_TYPE_TEMPERATURE | 32 | ANALOG | -| DATA_TYPE_THREE_PHASE_ACTIVE_POWER | 33 | ANALOG | -| DATA_TYPE_THREE_PHASE_CURRENT | 34 | ANALOG | -| DATA_TYPE_THREE_PHASE_POWER | 35 | ANALOG | -| DATA_TYPE_THREE_PHASE_POWER_FACTOR | 36 | ANALOG | -| DATA_TYPE_THREE_PHASE_REACTIVE_POWER | 37 | ANALOG | -| DATA_TYPE_TRIGGER_REASON | 38 | DISCRETE | -| DATA_TYPE_UNLOCKED_TIME | 39 | DISCRETE | -| DATA_TYPE_VOLTAGE_SEQUENCE_NEGATIVE | 40 | PHASOR | -| DATA_TYPE_VOLTAGE_SEQUENCE_POSITIVE | 41 | PHASOR | -| DATA_TYPE_VOLTAGE_SEQUENCE_ZERO | 42 | PHASOR | -| DATA_TYPE_DISCRETE | 43 | DISCRETE | -| DATA_TYPE_ANALOG | 44 | ANALOG | - - +| Name | Ordinal | Description | +| ------------------------------------- | ------- | ---------------------------------------------------------- | +| DATA_TYPE_UNSPECIFIED | 0 | No type define | +| DATA_TYPE_ACTIVE_POWER | 1 | Active Power. It maps to an Analog. | +| DATA_TYPE_ANGLE | 2 | Angle. It maps to an Analog. | +| DATA_TYPE_AUTOMATIC | 3 | Auomatic. It maps to Discrete (True or False). | +| DATA_TYPE_BOOLEAN | 4 | Booleam. It maps to Discrete (True or False). | +| DATA_TYPE_CONFIG_CHANGE | 5 | Configuration change. It maps to Discrete (True or False). | +| DATA_TYPE_CURRENT_SEQUENCE_NEGATIVE | 6 | PHASOR | +| DATA_TYPE_CURRENT_SEQUENCE_POSITIVE | 7 | PHASOR | +| DATA_TYPE_CURRENT_SEQUENCE_ZERO | 8 | PHASOR | +| DATA_TYPE_DATA_ERROR | 9 | DISCRETE (True or False) | +| DATA_TYPE_DATA_MODIFIED | 10 | DISCRETE (True or False) | +| DATA_TYPE_DATA_SORTING | 11 | DISCRETE | +| DATA_TYPE_ENERGY | 12 | ANALOG | +| DATA_TYPE_FREQUENCY | 13 | ANALOG | +| DATA_TYPE_LINE_CURRENT | 14 | ANALOG | +| DATA_TYPE_LINE_TO_LINE_VOLTAGE | 15 | ANALOG | +| DATA_TYPE_LOCAL_OPERATION | 16 | DISCRETE | +| DATA_TYPE_OPERATION_COUNT | 17 | DISCRETE | +| DATA_TYPE_PACKET_LATENCY | 18 | ANALOG | +| DATA_TYPE_PHASE_VOLTAGE | 19 | ANALOG | +| DATA_TYPE_PHASOR_CURRENT | 20 | PHASOR | +| DATA_TYPE_PHASOR_VOLTAGE | 21 | PHASOR | +| DATA_TYPE_PMU_SYNC | 22 | DISCRETE (True or False) | +| DATA_TYPE_PMU_TIME_QUALITY | 23 | DISCRETE | +| DATA_TYPE_PMU_TRIGGER_DETECTED | 24 | DISCRETE (True or False) | +| DATA_TYPE_POWER | 25 | ANALOG | +| DATA_TYPE_POWER_FACTOR | 26 | ANALOG | +| DATA_TYPE_PRESSURE | 27 | ANALOG | +| DATA_TYPE_RATE_OF_CHANGE_OF_FREQUENCY | 28 | ANALOG | +| DATA_TYPE_REACTIVE_POWER | 29 | ANALOG | +| DATA_TYPE_SWITCH_POSITION | 30 | DISCRETE (True or False) | +| DATA_TYPE_TAP_POSITION | 31 | DISCRETE | +| DATA_TYPE_TEMPERATURE | 32 | ANALOG | +| DATA_TYPE_THREE_PHASE_ACTIVE_POWER | 33 | ANALOG | +| DATA_TYPE_THREE_PHASE_CURRENT | 34 | ANALOG | +| DATA_TYPE_THREE_PHASE_POWER | 35 | ANALOG | +| DATA_TYPE_THREE_PHASE_POWER_FACTOR | 36 | ANALOG | +| DATA_TYPE_THREE_PHASE_REACTIVE_POWER | 37 | ANALOG | +| DATA_TYPE_TRIGGER_REASON | 38 | DISCRETE | +| DATA_TYPE_UNLOCKED_TIME | 39 | DISCRETE | +| DATA_TYPE_VOLTAGE_SEQUENCE_NEGATIVE | 40 | PHASOR | +| DATA_TYPE_VOLTAGE_SEQUENCE_POSITIVE | 41 | PHASOR | +| DATA_TYPE_VOLTAGE_SEQUENCE_ZERO | 42 | PHASOR | +| DATA_TYPE_DISCRETE | 43 | DISCRETE | +| DATA_TYPE_ANALOG | 44 | ANALOG | ### DataType Diagram @@ -130,6 +125,7 @@ class DataType{ DATA_TYPE_ANALOG } ``` + ### Data Diagram ```mermaid @@ -149,6 +145,7 @@ class Data { Data --> `DataType` ``` + ### DataSet Diagram ```mermaid @@ -168,29 +165,27 @@ DataSet .. ` Data` ``` ## Message: Data +
FQN: data.v1.Data
A single data. It has:
- a given data type,
- a point in time of measurement (encoded as int64 using Unix Epoc),
- a value (encoded as uint64)
| Field | Ordinal | Type | Label | Description | -|------------|---------|----------|----------|-------------| +| ---------- | ------- | -------- | -------- | ----------- | | dataType | 1 | DataType | | | | measuredAt | 2 | int64 | | | | value | 3 | uint64 | Optional | | - ## Message: DataSet +
FQN: data.v1.DataSet
A set of data:
- the id of the procuder of the data
- the map containing data
| Field | Ordinal | Type | Label | Description | -|------------|---------|--------------|-------|-------------| +| ---------- | ------- | ------------ | ----- | ----------- | | data | 2 | string, Data | Map | | | producerId | 1 | string | | | - - - diff --git a/docs/fault.proto.md b/docs/fault.proto.md index 30cf44f..1bfa7ea 100644 --- a/docs/fault.proto.md +++ b/docs/fault.proto.md @@ -5,78 +5,73 @@ ## Imports | Import | Description | -|--------|-------------| - - +| ------ | ----------- | ## Options | Name | Value | Description | -|------------|------------|-------------| +| ---------- | ---------- | ----------- | | go_package | ./fault/v1 | | - - ## Enum: PhaseConnectedFaultKind +
FQN: fault.v1.PhaseConnectedFaultKind

The type of fault connection among phases.

This message is modeled after [CIM PhaseConnectedFaultKind](https://zepben.github.io/evolve/docs/cim/cim100/TC57CIM/IEC61970/Base/Faults/PhaseConnectedFaultKind).

-| Name | Ordinal | Description | -|---------------------------------------------------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| PHASE_CONNECTED_FAULT_KIND_UNSPECIFIED | 0 | | -| PHASE_CONNECTED_FAULT_KIND_LINE_TO_GROUND | 1 | The fault connects the indicated phases to ground. The line to line fault impedance is not used and assumed infinite. The full ground impedance is connected between each phase specified in the fault and ground, but not between the phases. | -| PHASE_CONNECTED_FAULT_KIND_LINE_TO_LINE | 2 | The fault connects the specified phases together without a connection to ground. The ground impedance of this fault is ignored. The line to line impedance is connected between each of the phases specified in the fault. For example three times for a three phase fault, one time for a two phase fault. A single phase fault should not be specified. | -| PHASE_CONNECTED_FAULT_KIND_LINE_TO_LINE_TO_GROUND | 3 | The fault connects the indicated phases to ground and to each other. The line to line impedance is connected between each of the phases specified in the fault in a full mesh. For example three times for a three phase fault, one time for a two phase fault. A single phase fault should not be specified. The full ground impedance is connected between each phase specified in the fault and ground. | -| PHASE_CONNECTED_FAULT_KIND_LINE_OPEN | 4 | The fault is when the conductor path is broken between two terminals. Additional coexisting faults may be required if the broken conductor also causes connections to grounds or other lines or phases. | - +| Name | Ordinal | Description | +| ------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| PHASE_CONNECTED_FAULT_KIND_UNSPECIFIED | 0 | | +| PHASE_CONNECTED_FAULT_KIND_LINE_TO_GROUND | 1 | The fault connects the indicated phases to ground. The line to line fault impedance is not used and assumed infinite. The full ground impedance is connected between each phase specified in the fault and ground, but not between the phases. | +| PHASE_CONNECTED_FAULT_KIND_LINE_TO_LINE | 2 | The fault connects the specified phases together without a connection to ground. The ground impedance of this fault is ignored. The line to line impedance is connected between each of the phases specified in the fault. For example three times for a three phase fault, one time for a two phase fault. A single phase fault should not be specified. | +| PHASE_CONNECTED_FAULT_KIND_LINE_TO_LINE_TO_GROUND | 3 | The fault connects the indicated phases to ground and to each other. The line to line impedance is connected between each of the phases specified in the fault in a full mesh. For example three times for a three phase fault, one time for a two phase fault. A single phase fault should not be specified. The full ground impedance is connected between each phase specified in the fault and ground. | +| PHASE_CONNECTED_FAULT_KIND_LINE_OPEN | 4 | The fault is when the conductor path is broken between two terminals. Additional coexisting faults may be required if the broken conductor also causes connections to grounds or other lines or phases. | ## Enum: PhaseCode +
FQN: fault.v1.PhaseCode

An unordered enumeration of phase identifiers. Allows designation of phases for both transmission and distribution equipment, circuits and loads. The enumeration, by itself, does not describe how the phases are connected together or connected to ground. Ground is not explicitly denoted as a phase.
Residential and small commercial loads are often served from single-phase, or split-phase, secondary circuits. For the example of s12N, phases 1 and 2 refer to hot wires that are 180 degrees out of phase, while N refers to the neutral wire. Through single-phase transformer connections, these secondary circuits may be served from one or two of the primary phases A, B, and C. For three-phase loads, use the A, B, C phase codes instead of s12N.
The integer values are from IEC 61968-9 to support revenue metering applications.

This message is modeled after [CIM PhaseCode](https://zepben.github.io/evolve/docs/cim/evolve/IEC61970/Base/Core/PhaseCode/).

-| Name | Ordinal | Description | -|------------------------|---------|-----------------------------------------------| -| PHASE_CODE_UNSPECIFIED | 0 | No phases specified. | -| PHASE_CODE_A | 1 | Phase A. | -| PHASE_CODE_B | 2 | Phase B. | -| PHASE_CODE_C | 3 | Phase C. | -| PHASE_CODE_N | 4 | Neutral phase. | -| PHASE_CODE_AB | 5 | Phases A and B. | -| PHASE_CODE_AC | 6 | Phases A and C. | -| PHASE_CODE_BC | 7 | Phases B and C. | -| PHASE_CODE_AN | 8 | Phases A and neutral. | -| PHASE_CODE_BN | 9 | Phases B and neutral. | -| PHASE_CODE_CN | 10 | Phases C and neutral. | -| PHASE_CODE_ABC | 11 | Phases A, B, and C. | -| PHASE_CODE_ABN | 12 | Phases A, B, and neutral. | -| PHASE_CODE_ACN | 13 | Phases A, C and neutral. | -| PHASE_CODE_BCN | 14 | Phases B, C, and neutral. | -| PHASE_CODE_ABCN | 15 | Phases A, B, C, and N. | -| PHASE_CODE_S1N | 16 | Secondary phase 1 and neutral. | -| PHASE_CODE_S2N | 17 | Secondary phase 2 and neutral. | -| PHASE_CODE_S12N | 18 | Secondary phases 1, 2, and neutral. | -| PHASE_CODE_S1 | 19 | Secondary phase 1. | -| PHASE_CODE_S2 | 20 | Secondary phase 2. | -| PHASE_CODE_S12 | 21 | Secondary phase 1 and 2. | -| PHASE_CODE_X | 22 | Unknown non-neutral phase. | -| PHASE_CODE_XY | 23 | Two unknown non-neutral phases. | -| PHASE_CODE_XN | 24 | Unknown non-neutral phase plus neutral. | -| PHASE_CODE_XYN | 25 | Two unknown non-neutral phases plus neutral. | - - +| Name | Ordinal | Description | +| ---------------------- | ------- | -------------------------------------------- | +| PHASE_CODE_UNSPECIFIED | 0 | No phases specified. | +| PHASE_CODE_A | 1 | Phase A. | +| PHASE_CODE_B | 2 | Phase B. | +| PHASE_CODE_C | 3 | Phase C. | +| PHASE_CODE_N | 4 | Neutral phase. | +| PHASE_CODE_AB | 5 | Phases A and B. | +| PHASE_CODE_AC | 6 | Phases A and C. | +| PHASE_CODE_BC | 7 | Phases B and C. | +| PHASE_CODE_AN | 8 | Phases A and neutral. | +| PHASE_CODE_BN | 9 | Phases B and neutral. | +| PHASE_CODE_CN | 10 | Phases C and neutral. | +| PHASE_CODE_ABC | 11 | Phases A, B, and C. | +| PHASE_CODE_ABN | 12 | Phases A, B, and neutral. | +| PHASE_CODE_ACN | 13 | Phases A, C and neutral. | +| PHASE_CODE_BCN | 14 | Phases B, C, and neutral. | +| PHASE_CODE_ABCN | 15 | Phases A, B, C, and N. | +| PHASE_CODE_S1N | 16 | Secondary phase 1 and neutral. | +| PHASE_CODE_S2N | 17 | Secondary phase 2 and neutral. | +| PHASE_CODE_S12N | 18 | Secondary phases 1, 2, and neutral. | +| PHASE_CODE_S1 | 19 | Secondary phase 1. | +| PHASE_CODE_S2 | 20 | Secondary phase 2. | +| PHASE_CODE_S12 | 21 | Secondary phase 1 and 2. | +| PHASE_CODE_X | 22 | Unknown non-neutral phase. | +| PHASE_CODE_XY | 23 | Two unknown non-neutral phases. | +| PHASE_CODE_XN | 24 | Unknown non-neutral phase plus neutral. | +| PHASE_CODE_XYN | 25 | Two unknown non-neutral phases plus neutral. | ### PhaseConnectedFaultKind Diagram ```mermaid classDiagram direction LR -%% +%% %% The type of fault connection among phases. -%% +%% %% This message is modeled after [CIM PhaseConnectedFaultKind](https://zepben.github.io/evolve/docs/cim/cim100/TC57CIM/IEC61970/Base/Faults/PhaseConnectedFaultKind). -%% +%% class PhaseConnectedFaultKind{ <> @@ -87,18 +82,19 @@ class PhaseConnectedFaultKind{ PHASE_CONNECTED_FAULT_KIND_LINE_OPEN } ``` + ### PhaseCode Diagram ```mermaid classDiagram direction LR -%% +%% %% An unordered enumeration of phase identifiers. Allows designation of phases for both transmission and distribution equipment, circuits and loads. The enumeration, by itself, does not describe how the phases are connected together or connected to ground. Ground is not explicitly denoted as a phase. %% Residential and small commercial loads are often served from single-phase, or split-phase, secondary circuits. For the example of s12N, phases 1 and 2 refer to hot wires that are 180 degrees out of phase, while N refers to the neutral wire. Through single-phase transformer connections, these secondary circuits may be served from one or two of the primary phases A, B, and C. For three-phase loads, use the A, B, C phase codes instead of s12N. %% The integer values are from IEC 61968-9 to support revenue metering applications. -%% +%% %% This message is modeled after [CIM PhaseCode](https://zepben.github.io/evolve/docs/cim/evolve/IEC61970/Base/Core/PhaseCode/). -%% +%% class PhaseCode{ <> @@ -130,6 +126,7 @@ class PhaseCode{ PHASE_CODE_XYN } ``` + ### Fault Diagram ```mermaid @@ -137,9 +134,9 @@ classDiagram direction LR %% Abnormal condition causing current flow through conducting equipment, such as caused by equipment failure or short circuits from objects not typically modelled (for example, a tree falling on a line). -%% +%% %% This message is modeled after [CIM Fault](https://zepben.github.io/evolve/docs/cim/cim100/TC57CIM/IEC61970/Base/Faults/Fault) according to the extensions defined in the [fault-data-storage](https://github.com/zaphiro-technologies/architecture/blob/main/features/31-fault-data-storage.md#data-structures) feature. -%% +%% class Fault { + string ID @@ -157,6 +154,7 @@ Fault --> `PhaseConnectedFaultKind` Fault --> `PhaseCode` ``` + ### LineFault Diagram ```mermaid @@ -164,9 +162,9 @@ classDiagram direction LR %% A fault that occurs on an AC line segment at some point along the length. -%% +%% %% This message is modeled after [CIM LineFault](https://zepben.github.io/evolve/docs/cim/cim100/TC57CIM/IEC61970/Base/Faults/LineFault) according to the extensions defined in the [fault-data-storage](https://github.com/zaphiro-technologies/architecture/blob/main/features/31-fault-data-storage.md#data-structures) feature. -%% +%% class LineFault { + Optional~string~ acLineSegmentID @@ -176,17 +174,18 @@ class LineFault { LineFault --> `Fault` ``` + ### EquipmentFault Diagram ```mermaid classDiagram direction LR -%% +%% %% A fault applied at the terminal, external to the equipment. This class is not used to specify faults internal to the equipment. -%% +%% %% This message is modeled after [CIM EquipmentFault](https://zepben.github.io/evolve/docs/cim/cim100/TC57CIM/IEC61970/Base/Faults/EquipmentFault) according to the extensions defined in the [fault-data-storage](https://github.com/zaphiro-technologies/architecture/blob/main/features/31-fault-data-storage.md#data-structures) feature. -%% +%% class EquipmentFault { + Fault fault @@ -197,48 +196,46 @@ EquipmentFault --> `Fault` ``` ## Message: Fault +
FQN: fault.v1.Fault
Abnormal condition causing current flow through conducting equipment, such as caused by equipment failure or short circuits from objects not typically modelled (for example, a tree falling on a line).

This message is modeled after [CIM Fault](https://zepben.github.io/evolve/docs/cim/cim100/TC57CIM/IEC61970/Base/Faults/Fault) according to the extensions defined in the [fault-data-storage](https://github.com/zaphiro-technologies/architecture/blob/main/features/31-fault-data-storage.md#data-structures) feature.

-| Field | Ordinal | Type | Label | Description | -|----------------------|---------|-------------------------|----------|-----------------------------------------------------------------------------------------------------------------------------| -| ID | 1 | string | | The uuid of the fault. | -| description | 2 | string | Optional | The textual description of the fault. | -| faulCurrent | 8 | float | Optional | The current associated to the fault. | -| faultyEquipmentId | 6 | string | Optional | The equipment with the fault. | -| impactedEquipmentIds | 10 | string | Repeated | The set of IDs of equipments impacted by the fault. | -| kind | 3 | PhaseConnectedFaultKind | | The kind of phase fault. | -| located | 9 | bool | Optional | Was the fault located. | -| locationTime | 7 | int64 | Optional | The time when the fault was located. | -| occurredDateTime | 5 | int64 | | The date and time at which the fault occurred. | -| phases | 4 | PhaseCode | | The phases participating in the fault. The fault connections into these phases are further specified by the type of fault. | - +| Field | Ordinal | Type | Label | Description | +| -------------------- | ------- | ----------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------- | +| ID | 1 | string | | The uuid of the fault. | +| description | 2 | string | Optional | The textual description of the fault. | +| faulCurrent | 8 | float | Optional | The current associated to the fault. | +| faultyEquipmentId | 6 | string | Optional | The equipment with the fault. | +| impactedEquipmentIds | 10 | string | Repeated | The set of IDs of equipments impacted by the fault. | +| kind | 3 | PhaseConnectedFaultKind | | The kind of phase fault. | +| located | 9 | bool | Optional | Was the fault located. | +| locationTime | 7 | int64 | Optional | The time when the fault was located. | +| occurredDateTime | 5 | int64 | | The date and time at which the fault occurred. | +| phases | 4 | PhaseCode | | The phases participating in the fault. The fault connections into these phases are further specified by the type of fault. | ## Message: LineFault +
FQN: fault.v1.LineFault
A fault that occurs on an AC line segment at some point along the length.

This message is modeled after [CIM LineFault](https://zepben.github.io/evolve/docs/cim/cim100/TC57CIM/IEC61970/Base/Faults/LineFault) according to the extensions defined in the [fault-data-storage](https://github.com/zaphiro-technologies/architecture/blob/main/features/31-fault-data-storage.md#data-structures) feature.

-| Field | Ordinal | Type | Label | Description | -|---------------------|---------|--------|----------|--------------------------------------------------------------------------------------------------------------------------------| -| acLineSegmentID | 3 | string | Optional | The line segment of this line fault. | -| fault | 1 | Fault | | The base fault message. | -| lengthFromTerminal1 | 2 | float | Optional | The length to the place where the fault is located starting from terminal with sequence number 1 of the faulted line segment. | - +| Field | Ordinal | Type | Label | Description | +| ------------------- | ------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------- | +| acLineSegmentID | 3 | string | Optional | The line segment of this line fault. | +| fault | 1 | Fault | | The base fault message. | +| lengthFromTerminal1 | 2 | float | Optional | The length to the place where the fault is located starting from terminal with sequence number 1 of the faulted line segment. | ## Message: EquipmentFault +
FQN: fault.v1.EquipmentFault

A fault applied at the terminal, external to the equipment. This class is not used to specify faults internal to the equipment.

This message is modeled after [CIM EquipmentFault](https://zepben.github.io/evolve/docs/cim/cim100/TC57CIM/IEC61970/Base/Faults/EquipmentFault) according to the extensions defined in the [fault-data-storage](https://github.com/zaphiro-technologies/architecture/blob/main/features/31-fault-data-storage.md#data-structures) feature.

-| Field | Ordinal | Type | Label | Description | -|------------|---------|--------|----------|--------------------------------------------------------------------| -| fault | 1 | Fault | | The base fault message. | -| terminalID | 2 | string | Optional | The terminal connecting to the bus to which the fault is applied. | - - - +| Field | Ordinal | Type | Label | Description | +| ---------- | ------- | ------ | -------- | ----------------------------------------------------------------- | +| fault | 1 | Fault | | The base fault message. | +| terminalID | 2 | string | Optional | The terminal connecting to the bus to which the fault is applied. | diff --git a/docs/task.proto.md b/docs/task.proto.md index 479c0f2..f04f413 100644 --- a/docs/task.proto.md +++ b/docs/task.proto.md @@ -5,52 +5,47 @@ ## Imports | Import | Description | -|--------|-------------| - - +| ------ | ----------- | ## Options | Name | Value | Description | -|------------|-----------|-------------| +| ---------- | --------- | ----------- | | go_package | ./task/v1 | | - - ## Enum: TaskType +
FQN: task.v1.TaskType

| Name | Ordinal | Description | -|-----------------------|---------|-------------| +| --------------------- | ------- | ----------- | | TASK_TYPE_UNSPECIFIED | 0 | | | TASK_TYPE_COLLECTION | 1 | | | TASK_TYPE_TOPOLOGY | 2 | | | TASK_TYPE_STATE | 3 | | | TASK_TYPE_FAULT | 4 | | - ## Enum: NotificationType +
FQN: task.v1.NotificationType

| Name | Ordinal | Description | -|----------------------------------|---------|-------------| +| -------------------------------- | ------- | ----------- | | NOTIFICATION_TYPE_UNSPECIFIED | 0 | | | NOTIFICATION_TYPE_DATA_COMPLETE | 1 | | | NOTIFICATION_TYPE_DATA_TIMEOUT_1 | 2 | | | NOTIFICATION_TYPE_DATA_TIMEOUT_2 | 3 | | - - ### TaskType Diagram ```mermaid classDiagram direction LR -%% +%% class TaskType{ <> @@ -61,12 +56,13 @@ class TaskType{ TASK_TYPE_FAULT } ``` + ### NotificationType Diagram ```mermaid classDiagram direction LR -%% +%% class NotificationType{ <> @@ -76,13 +72,14 @@ class NotificationType{ NOTIFICATION_TYPE_DATA_TIMEOUT_2 } ``` + ### Task Diagram ```mermaid classDiagram direction LR -%% +%% class Task { + int64 createdAt @@ -94,13 +91,14 @@ class Task { Task --> `TaskType` ``` + ### Notification Diagram ```mermaid classDiagram direction LR -%% +%% class Notification { + int64 createdAt @@ -115,26 +113,27 @@ Notification --> `NotificationType` ``` ## Message: Task +
FQN: task.v1.Task

| Field | Ordinal | Type | Label | Description | -|---------------|---------|----------|----------|-------------| +| ------------- | ------- | -------- | -------- | ----------- | | createdAt | 3 | int64 | | | | id | 1 | string | | | | measurementID | 4 | string | Optional | | | taskType | 2 | TaskType | | | | timestampID | 5 | int64 | Optional | | - ## Message: Notification +
FQN: task.v1.Notification

| Field | Ordinal | Type | Label | Description | -|------------------|---------|------------------|----------|-------------| +| ---------------- | ------- | ---------------- | -------- | ----------- | | createdAt | 3 | int64 | | | | id | 1 | string | | | | measurementID | 5 | string | Optional | | @@ -142,8 +141,5 @@ Notification --> `NotificationType` | notificationType | 2 | NotificationType | | | | timestampID | 6 | int64 | Optional | | - - -