cactus-test-definitions 1.8.0__py3-none-any.whl

cactus_test_definitions/server/procedures/S-ALL-03.yaml

@@ -0,0 +1,65 @@
+Description: Discovery with In-Band Registration for Aggregator Clients
+Category: Registration
+Classes:
+ - A
+
+TargetVersions:
+ - v1.2
+
+Preconditions:
+  required_clients:
+    - id: client
+      client_type: aggregator
+  
+Steps:
+  - id: PRECONDITION
+    repeat_until_pass: true
+    instructions:
+      - Remove any existing EndDevice registrations for client.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - DeviceCapability
+          - Time
+          - MirrorUsagePointList
+          - EndDevice
+          - DER
+    checks:
+      - type: discovered
+        parameters:
+          resources:
+            - DeviceCapability
+            - Time
+            - MirrorUsagePointList
+            - EndDeviceList
+      - type: end-device # This will be the check that will block if there is an existing EndDevice registration
+        parameters:
+          matches_client: false 
+      - type: time-synced
+
+  - id: REGISTER
+    action: 
+      type: insert-end-device
+    checks:
+      - type: end-device
+        parameters:
+          matches_client: true 
+
+  - id: FETCHING DER INFO
+    repeat_until_pass: true
+    instructions:
+      - Populate DERList with an entry that has a DERCapabilityLink, DERSettingsLink and DERStatusLink.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - DER
+    checks:
+      - type: discovered
+        parameters:
+          links:
+            - DERCapability
+            - DERSettings
+            - DERStatus
+    

cactus_test_definitions/server/procedures/S-ALL-04.yaml

@@ -0,0 +1,137 @@
+Description: Support for Multiple End Clients
+Category: Registration
+Classes:
+ - A
+
+TargetVersions:
+ - v1.2
+
+Preconditions:
+  required_clients:
+    - id: CLIENT-A
+    - id: CLIENT-B
+  
+Steps:
+  - id: CLIENT-A PRECONDITION
+    repeat_until_pass: true
+    client: CLIENT-A
+    instructions:
+      - Create at least 5 DERControls for CLIENT-A
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - DERControl
+    checks:
+      - type: end-device 
+        parameters:
+          matches_client: true 
+      - type: der-control
+        parameters:
+          minimum_count: 5
+
+  - id: CLIENT-B PRECONDITION 
+    repeat_until_pass: true
+    client: CLIENT-B
+    instructions:
+      - Create at least 5 DERControls for CLIENT-B
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - DERControl
+    checks:
+      - type: end-device 
+        parameters:
+          matches_client: true 
+      - type: der-control
+        parameters:
+          minimum_count: 5
+
+  - id: CLIENT-A DISCOVER MUPS
+    repeat_until_pass: true
+    client: CLIENT-A
+    instructions:
+      - MirrorUsagePoints for CLIENT-A must be initially empty.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - MirrorUsagePoint
+    checks:
+      - type: mirror-usage-point
+        parameters:
+          matches: false # This will only match an empty list
+
+  - id: CLIENT-B DISCOVER MUPS
+    repeat_until_pass: true
+    client: CLIENT-B
+    instructions:
+      - MirrorUsagePoints for CLIENT-B must be initially empty.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - MirrorUsagePoint
+    checks:
+      - type: mirror-usage-point
+        parameters:
+          matches: false # This will only match an empty list
+
+  - id: CLIENT-A CREATE MUPS
+    client: CLIENT-A
+    action: 
+      type: upsert-mup
+      parameters:
+        mup_id: mupa
+        location: Device
+        reading_types: 
+          - ActivePowerAverage
+          - VoltageSinglePhaseAverage
+    checks:
+      - type: mirror-usage-point
+        parameters:
+          matches: true
+          location: Device
+          reading_types: 
+            - ActivePowerAverage
+            - VoltageSinglePhaseAverage  
+
+  - id: CLIENT-B CREATE MUPS
+    client: CLIENT-B
+    action: 
+      type: upsert-mup
+      parameters:
+        mup_id: mupb
+        location: Device
+        reading_types: 
+          - ActivePowerAverage
+          - VoltageSinglePhaseAverage
+    checks:
+      - type: mirror-usage-point
+        parameters:
+          matches: true
+          location: Device
+          reading_types: 
+            - ActivePowerAverage
+            - VoltageSinglePhaseAverage  
+
+  - id: CLIENT-A SEND READINGS
+    client: CLIENT-A
+    action: 
+      type: insert-readings
+      parameters:
+        mup_id: mupa
+        values:
+          ActivePowerAverage: [1000, 1234, 0, -4567]
+          VoltageSinglePhaseAverage: [241.1, 232.2, 233.9, 244.1]
+    
+  - id: CLIENT-B SEND READINGS
+    client: CLIENT-B
+    action: 
+      type: insert-readings
+      parameters:
+        mup_id: mupb
+        values:
+          ActivePowerAverage: [2000, 2234, 0, -8567]
+          VoltageSinglePhaseAverage: [243.1, 233.2, 234.9, 240]

cactus_test_definitions/server/procedures/S-ALL-05.yaml

@@ -0,0 +1,111 @@
+Description: Authorisation
+Category: Registration
+Classes:
+ - A
+
+TargetVersions:
+ - v1.2
+
+Preconditions:
+  required_clients:
+    - id: CLIENT-A
+      client_type: device
+    - id: CLIENT-B
+      client_type: device
+  
+Steps:
+  - id: (A) PRECONDITION
+    repeat_until_pass: true
+    client: CLIENT-A
+    instructions:
+      - Create an EndDevice registration for CLIENT-A (or rerun S-ALL-02 / S-ALL-03).
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - EndDevice
+          - DERControlList
+          - DER
+    checks:
+      - type: end-device 
+        parameters:
+          matches_client: true 
+
+  - id: (B) PRECONDITION
+    repeat_until_pass: true
+    client: CLIENT-B
+    instructions:
+      - Create an EndDevice registration for CLIENT-B (or rerun S-ALL-02 / S-ALL-03).
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - EndDevice
+          - DERControlList
+          - DER
+    checks:
+      - type: end-device 
+        parameters:
+          matches_client: true 
+
+  - id: (A-B) AUTH EndDeviceList
+    client: CLIENT-A
+    use_client_context: CLIENT-B 
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: EndDeviceList
+        expect_rejection: true
+
+  - id: (A-B) AUTH DerControlList
+    client: CLIENT-A
+    use_client_context: CLIENT-B 
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DERControlList
+        expect_rejection: true
+
+  - id: (A-B) AUTH DERStatus
+    client: CLIENT-A
+    use_client_context: CLIENT-B 
+    action: 
+      type: upsert-der-status
+      parameters:
+        genConnectStatus: 1
+        expect_rejection: true
+
+  - id: (A-B) AUTH MirrorUsagePoint
+    client: CLIENT-A
+    use_client_context: CLIENT-B 
+    action: 
+      type: upsert-mup
+      parameters:
+        expect_rejection: true
+        mup_id: mupa
+        location: Device
+        reading_types: 
+          - ActivePowerAverage
+          - VoltageSinglePhaseAverage
+
+  - id: (A) OK EndDeviceList
+    client: CLIENT-A
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: EndDeviceList
+    checks:
+      - type: end-device 
+        parameters:
+          matches_client: true 
+
+  - id: (A) DISALLOW ACCESS
+    repeat_until_pass: true
+    instructions:
+      - Remove EndDevice entry for ClientA (or disallow access).
+    client: CLIENT-A
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: EndDeviceList
+        expect_rejection_or_empty: true

cactus_test_definitions/server/procedures/S-ALL-06.yaml

@@ -0,0 +1,111 @@
+Description: Mirror Usage Point Creation and Individual Readings
+Category: Monitoring
+Classes:
+ - A
+
+TargetVersions:
+ - v1.2
+
+Preconditions:
+  required_clients:
+    - id: client
+
+Steps:
+  - id: PRECONDITION
+    repeat_until_pass: true
+    instructions:
+      - Create an EndDevice registration for client.
+    action:
+      type: discovery
+      parameters:
+        resources:
+          - EndDevice
+          - DeviceCapability
+          - MirrorUsagePointList
+          - DER
+    checks:
+      - type: end-device # This will be the check that will block UNTIL there is an existing EndDevice registration
+        parameters:
+          matches_client: true
+
+  - id: 1 - DISCOVER INITIAL MUPS
+    repeat_until_pass: true
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - MirrorUsagePoint
+    checks:
+      - type: mirror-usage-point
+        parameters:
+          matches: false # MirrorUsagePoints must be initially empty for client.
+
+  - id: 2,3A - CREATE MUP FOR SITE
+    action: 
+      type: upsert-mup
+      parameters:
+        mup_id: mup_site
+        location: Site
+        reading_types: 
+          - ActivePowerAverage
+          - ReactivePowerAverage
+          - FrequencyAverage
+          - VoltageSinglePhaseAverage
+    checks:
+      - type: mirror-usage-point
+        parameters:
+          location: Site
+          matches: true
+          reading_types: 
+          - ActivePowerAverage
+          - ReactivePowerAverage
+          - FrequencyAverage
+          - VoltageSinglePhaseAverage
+
+  - id: 2,3B - CREATE MUP FOR DEVICE
+    action: 
+      type: upsert-mup
+      parameters:
+        mup_id: mup_device
+        location: Device
+        reading_types: 
+          - ActivePowerAverage
+          - ReactivePowerAverage
+          - FrequencyAverage
+          - VoltageSinglePhaseAverage
+    checks:
+      - type: mirror-usage-point
+        parameters:
+          location: Device
+          matches: true
+          reading_types: 
+          - ActivePowerAverage
+          - ReactivePowerAverage
+          - FrequencyAverage
+          - VoltageSinglePhaseAverage
+
+  - id: 4A - POST READINGS TO SITE
+    action: 
+      type: insert-readings
+      parameters:
+        mup_id: mup_site
+        values:
+          ActivePowerAverage: [5000, 5100, 5200, 5300]
+          ReactivePowerAverage: [1000, 1100, 1200, 1300]
+          FrequencyAverage: [50.0, 50.1, 49.9, 50.0]
+          VoltageSinglePhaseAverage: [230.0, 231.0, 229.0, 230.5]
+
+  - id: 4B - POST READINGS TO DEVICE
+    action: 
+      type: insert-readings
+      parameters:
+        mup_id: mup_device
+        values:
+          ActivePowerAverage: [5000, 5100, 5200, 5300]
+          ReactivePowerAverage: [1000, 1100, 1200, 1300]
+          FrequencyAverage: [50.0, 50.1, 49.9, 50.0]
+          VoltageSinglePhaseAverage: [230.0, 231.0, 229.0, 230.5]
+
+  # NOTE: The final step of this test (5) is to verify that readings are retained correctly by the server.
+  # As href is optional, it is assumed many servers will not currently support this.
+  # While waiting for a discussion by the CIRG it has been decided to omit this step of testing for now.

cactus_test_definitions/server/procedures/S-ALL-07.yaml

@@ -0,0 +1,100 @@
+Description: S-ALL-07 Select Edge Cases for Telemetry Reporting
+Category: Monitoring
+Classes:
+ - A
+
+TargetVersions:
+ - v1.2
+
+Preconditions:
+  required_clients:
+    - id: client
+
+Steps:
+  - id: PRECONDITION
+    repeat_until_pass: true
+    instructions:
+      - Create an EndDevice registration for client.
+      - Configure utility server with client's Private Enterprise Number (PEN).
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - EndDevice
+          - DER
+          - MirrorUsagePoint
+    checks:
+      - type: end-device 
+        parameters:
+          matches_client: true
+
+  - id: Create MUP # Post an initial MirrorUsagePoint to be overwritten later.
+    action: 
+      type: upsert-mup
+      parameters:
+        mup_id: mup_mrid_1
+        reading_types: 
+          - ActivePowerAverage
+          - VoltageSinglePhaseAverage
+        location: Site  # Set the roleflage
+    checks:
+      - type: mirror-usage-point
+        parameters:
+          matches: true
+          reading_types: 
+            - ActivePowerAverage
+            - VoltageSinglePhaseAverage
+          location: Site
+
+  - id: STEP 1 - UPDATE MUP ROLEFLAGS # Post same MirrorUsagePoint mRID with different roleFlags
+    action: 
+      type: upsert-mup
+      parameters:
+        mup_id: mup_mrid_1
+        reading_types: 
+          - ActivePowerAverage
+          - VoltageSinglePhaseAverage
+        location: Device  # Update the roleflage
+    checks:
+      - type: mirror-usage-point
+        parameters:
+          matches: true
+          reading_types: 
+            - ActivePowerAverage
+            - VoltageSinglePhaseAverage
+          location: Device
+
+  - id: POST INITIAL READING
+    action: 
+      type: insert-readings
+      parameters:
+        mup_id: mup_mrid_1
+        values:
+          ActivePowerAverage: [5000]
+          VoltageSinglePhaseAverage: [240.0]
+
+  - id: STEP 2 - UPDATE READING # Post MirrorMeterReading with same mmr mRID but different value
+    action: 
+      type: insert-readings
+      parameters:
+        mup_id: mup_mrid_1
+        values:
+          ActivePowerAverage: [6000]  # The mmr mrid will automatically be the same as the initial reading
+        # NOTE: We do not have the option to request readings, so cannot verify the result of this upsert
+  
+  - id: STEP 3 - Update MUP type  # Post MirrorMeterReading with same mRID and no value (change the reading type)
+    action: 
+      type: upsert-mup
+      parameters:
+        mup_id: mup_mrid_1
+        reading_types: 
+          - ReactivePowerAverage
+        location: Device
+    checks:
+      - type: mirror-usage-point
+        parameters:
+          matches: true
+          reading_types:
+            - ReactivePowerAverage
+            - VoltageSinglePhaseAverage
+          location: Device

cactus_test_definitions/server/procedures/S-ALL-08.yaml

@@ -0,0 +1,77 @@
+Description: S-ALL-08 Connection Status 
+Category: Monitoring
+Classes:
+ - A
+
+TargetVersions:
+ - v1.2
+
+Preconditions:
+  required_clients:
+    - id: client
+
+Steps:
+  - id: PRECONDITION
+    repeat_until_pass: true
+    instructions:
+      - Create an EndDevice registration for client.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - EndDevice
+          - DER
+    checks:
+      - type: end-device 
+        parameters:
+          matches_client: true
+      - type: discovered
+        parameters:
+          links:
+            - DERStatus
+
+  - id: INITIALISE DER STATUS
+    action: 
+      type: upsert-der-status
+      parameters:
+        genConnectStatus: 7  # 0111 - connected
+
+  - id: STEP 1 - DISCONNECT # bit 0 = 0
+    action: 
+      type: upsert-der-status
+      parameters:
+        genConnectStatus: 6  # 0110
+
+  - id: STEP 2 - RECONNECT
+    action: 
+      type: upsert-der-status
+      parameters:
+        genConnectStatus: 7
+
+  - id: STEP 3 - UNAVAILABLE  # bit 1 = 0
+    action: 
+      type: upsert-der-status
+      parameters:
+        genConnectStatus: 5  # 0101
+
+  - id: STEP 4 - RECONNECT
+    instructions:
+      - Reconnect DER
+    action: 
+      type: upsert-der-status
+      parameters:
+        genConnectStatus: 7  # 0111
+
+  - id: STEP 5 - NON-OPERATING # bit 2 = 0
+    action: 
+      type: upsert-der-status
+      parameters:
+        genConnectStatus: 3  # 0011
+
+  - id: STEP 6 - RECONNECT
+    instructions:
+      - Reconnect DER
+    action: 
+      type: upsert-der-status
+      parameters:
+        genConnectStatus: 7

cactus_test_definitions/server/procedures/S-ALL-09.yaml

@@ -0,0 +1,43 @@
+Description: S-ALL-09 Operational Mode Status 
+Category: Monitoring
+Classes:
+ - A
+
+TargetVersions:
+ - v1.2
+
+Preconditions:
+  required_clients:
+    - id: client
+
+Steps:
+  - id: PRECONDITION
+    repeat_until_pass: true
+    instructions:
+      - Create an EndDevice registration for client.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - EndDevice
+          - DER
+    checks:
+      - type: end-device 
+        parameters:
+          matches_client: true
+      - type: discovered
+        parameters:
+          links:
+            - DERStatus
+
+  - id: STEP 1 - Set Online
+    action: 
+      type: upsert-der-status
+      parameters:
+        operationalModeStatus: 1
+
+  - id: STEP 2 - Set Offline
+    action: 
+      type: upsert-der-status
+      parameters:
+        operationalModeStatus: 2

cactus_test_definitions/server/procedures/S-ALL-10.yaml

@@ -0,0 +1,68 @@
+Description: S-ALL-10 Capabilities and Settings
+Category: Monitoring
+Classes:
+ - A
+
+TargetVersions:
+ - v1.2
+
+Preconditions:
+  required_clients:
+    - id: client
+
+Steps:
+  - id: PRECONDITION
+    repeat_until_pass: true
+    instructions:
+      - Create an EndDevice registration for client.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - EndDevice
+          - DER
+    checks:
+      - type: end-device 
+        parameters:
+          matches_client: true
+      - type: discovered
+        parameters:
+          links:
+            - DERCapability
+            - DERSettings
+
+  - id: STEP 1A - Put DERCapability
+    action: 
+      type: upsert-der-capability
+      parameters:
+        type: 4
+        rtgMaxW: 10000
+        modesSupported: 3
+        doeModesSupported: 3
+
+  - id: STEP 1B - Put DERSettings
+    action: 
+      type: upsert-der-settings
+      parameters:
+        setMaxW: 10000
+        setGradW: 1000
+        modesEnabled: 3
+        doeModesEnabled: 3
+
+  - id: STEP 2A - UPSERT DERCapability
+    action: 
+      type: upsert-der-capability
+      parameters:
+        type: 5
+        rtgMaxW: 11000
+        modesSupported: 4
+        doeModesSupported: 4
+
+  - id: STEP 2B - UPSERT DERSettings
+    action: 
+      type: upsert-der-settings
+      parameters:
+        setMaxW: 11000
+        setGradW: 1100
+        modesEnabled: 4
+        doeModesEnabled: 4