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

cactus_test_definitions/client/procedures/ALL-20.yaml

@@ -0,0 +1,136 @@
+Description: Update DER Program Poll Rate
+Category: Control
+Classes:
+  - A
+  - DR-A
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+
+Preconditions:
+  init_actions:
+    - type: set-comms-rate
+      parameters:
+        dcap_poll_seconds: 60
+        edev_list_poll_seconds: 60
+        fsa_list_poll_seconds: 60
+        der_list_poll_seconds: 60
+        derp_list_poll_seconds: 60
+        mup_post_seconds: 60
+    - type: create-der-program
+      parameters:
+        primacy: 0
+  checks:
+    - type: end-device-contents
+      parameters: {}
+    
+Steps:
+
+  # (a, b)
+  WAIT-POLL-UPDATE:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 60
+    actions:
+      - type: set-comms-rate
+        parameters:
+          derp_list_poll_seconds: 120
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERP-LIST-1
+            - WAIT-10-MINS
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-POLL-UPDATE
+    
+  # (c)
+  GET-DERP-LIST-1:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/fsa/1/derp
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERP-LIST-1
+
+  # (a, e)
+  WAIT-10-MINS:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 600
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERP-LIST-2
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-10-MINS
+    instructions:
+      - Client shall maintain changed DERProgramList poll rate of 120s
+
+  # (h)
+  # We will start a "timer" as soon as the client picks up the updated poll rate
+  GET-DERP-LIST-2:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/fsa/1/derp
+    actions:
+      - type: set-comms-rate
+        parameters:
+          derp_list_poll_seconds: 60
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERP-LIST-3
+            - WAIT-TEST-END
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERP-LIST-2
+
+
+  # (h)
+  # This step waiting for an updated poll and WAIT-TEST-END will ensure it happens within 60 seconds (the new poll rate)
+  GET-DERP-LIST-3:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/fsa/1/derp
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERP-LIST-3
+
+  # (g)
+  WAIT-TEST-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 90
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: finish-test
+        parameters: {}
+    instructions:
+      - Client shall return to 60s polling
+
+  

cactus_test_definitions/client/procedures/ALL-21.yaml

@@ -0,0 +1,203 @@
+Description: Scheduling
+Category: Control
+Classes:
+  - A
+  - DR-A
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+    - type: response-contents
+      parameters:
+        all: true
+        status: 1 # Every control has a received response
+    - type: response-contents
+      parameters:
+        all: true
+        status: 2 # Every control has a started response
+    - type: response-contents
+      parameters:
+        all: true
+        status: 3 # Every control has a completed response
+
+Preconditions:
+  init_actions:
+    - type: set-comms-rate
+      parameters:
+        dcap_poll_seconds: 60
+        edev_list_poll_seconds: 60
+        fsa_list_poll_seconds: 60
+        der_list_poll_seconds: 60
+        derp_list_poll_seconds: 60
+        mup_post_seconds: 60
+  checks:
+    - type: end-device-contents
+      parameters: {}
+    - type: der-settings-contents
+      parameters: {}
+  actions:
+    # 24 minutes of sequential, non overlapping controls with random values (chosen by rolling a D10)
+    - type: create-der-control
+      parameters:
+        start: $(now)
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.3)
+        opModImpLimW: $(setMaxW * 0.3)
+    - type: create-der-control
+      parameters:
+        start: $(now + '1 minute')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.6)
+        opModImpLimW: $(setMaxW * 0.6)
+    - type: create-der-control
+      parameters:
+        start: $(now + '2 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.4)
+        opModImpLimW: $(setMaxW * 0.4)
+    - type: create-der-control
+      parameters:
+        start: $(now + '3 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.5)
+        opModImpLimW: $(setMaxW * 0.5)
+    - type: create-der-control
+      parameters:
+        start: $(now + '4 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.2)
+        opModImpLimW: $(setMaxW * 0.2)
+    - type: create-der-control
+      parameters:
+        start: $(now + '5 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.1)
+        opModImpLimW: $(setMaxW * 0.1)
+    - type: create-der-control
+      parameters:
+        start: $(now + '6 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.7)
+        opModImpLimW: $(setMaxW * 0.7)
+    - type: create-der-control
+      parameters:
+        start: $(now + '7 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.2)
+        opModImpLimW: $(setMaxW * 0.2)
+    - type: create-der-control
+      parameters:
+        start: $(now + '8 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.3)
+        opModImpLimW: $(setMaxW * 0.3)
+    - type: create-der-control
+      parameters:
+        start: $(now + '9 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.3)
+        opModImpLimW: $(setMaxW * 0.3)
+    - type: create-der-control
+      parameters:
+        start: $(now + '10 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.5)
+        opModImpLimW: $(setMaxW * 0.5)
+    - type: create-der-control
+      parameters:
+        start: $(now + '11 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.9)
+        opModImpLimW: $(setMaxW * 0.9)
+    - type: create-der-control
+      parameters:
+        start: $(now + '12 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.1)
+        opModImpLimW: $(setMaxW * 0.1)
+    - type: create-der-control
+      parameters:
+        start: $(now + '13 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.1)
+        opModImpLimW: $(setMaxW * 0.1)
+    - type: create-der-control
+      parameters:
+        start: $(now + '14 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.5)
+        opModImpLimW: $(setMaxW * 0.5)
+    - type: create-der-control
+      parameters:
+        start: $(now + '15 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.4)
+        opModImpLimW: $(setMaxW * 0.4)
+    - type: create-der-control
+      parameters:
+        start: $(now + '16 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.1)
+        opModImpLimW: $(setMaxW * 0.1)
+    - type: create-der-control
+      parameters:
+        start: $(now + '17 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.7)
+        opModImpLimW: $(setMaxW * 0.7)
+    - type: create-der-control
+      parameters:
+        start: $(now + '18 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.9)
+        opModImpLimW: $(setMaxW * 0.9)
+    - type: create-der-control
+      parameters:
+        start: $(now + '19 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.1)
+        opModImpLimW: $(setMaxW * 0.1)
+    - type: create-der-control
+      parameters:
+        start: $(now + '20 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.4)
+        opModImpLimW: $(setMaxW * 0.4)
+    - type: create-der-control
+      parameters:
+        start: $(now + '21 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.3)
+        opModImpLimW: $(setMaxW * 0.3)
+    - type: create-der-control
+      parameters:
+        start: $(now + '22 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.7)
+        opModImpLimW: $(setMaxW * 0.7)
+    - type: create-der-control
+      parameters:
+        start: $(now + '23 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW)
+        opModImpLimW: $(setMaxW)
+
+Steps:
+  WAIT-TEST-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 1500 # 25 minutes
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: finish-test
+        parameters: {}
+

cactus_test_definitions/client/procedures/ALL-22.yaml

@@ -0,0 +1,82 @@
+Description: Randomisation
+Category: Control
+Classes:
+  - A
+  - DR-A
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+
+Preconditions:
+  init_actions:
+    - type: set-comms-rate
+      parameters:
+        dcap_poll_seconds: 60
+        edev_list_poll_seconds: 60
+        fsa_list_poll_seconds: 60
+        der_list_poll_seconds: 60
+        derp_list_poll_seconds: 60
+        mup_post_seconds: 60
+  checks:
+    - type: end-device-contents
+      parameters: {}
+    - type: der-settings-contents
+      parameters: {}
+  actions:
+    - type: create-der-control
+      parameters:
+        start: $(now)
+        duration_seconds: 120
+        randomizeStart_seconds: 60
+        opModExpLimW: $(setMaxW * 2)
+    - type: create-der-control
+      parameters:
+        start: $(now + '120 seconds')
+        duration_seconds: 120
+        randomizeStart_seconds: 60
+        opModExpLimW: $(setMaxW * 2)
+    - type: create-der-control
+      parameters:
+        start: $(now + '240 seconds')
+        duration_seconds: 120
+        randomizeStart_seconds: 60
+        opModExpLimW: $(setMaxW * 2)
+    - type: create-der-control
+      parameters:
+        start: $(now + '360 seconds')
+        duration_seconds: 120
+        randomizeStart_seconds: 60
+        opModExpLimW: $(setMaxW * 2)
+    - type: create-der-control
+      parameters:
+        start: $(now + '480 seconds')
+        duration_seconds: 120
+        randomizeStart_seconds: 60
+        opModExpLimW: $(setMaxW * 2)
+    
+    
+Steps:
+
+  # We don't have a "is random enough" check - it is expected that will be evaluated by a human administering the test
+  # specifically looking at the response timings
+  WAIT-TEST-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 660
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: finish-test
+        parameters: {}
+    instructions:
+      - Each DERControl should have their actual start time randomized within a 120s window.
+      - This will need to be evaluated via manual inspection.

cactus_test_definitions/client/procedures/ALL-23.yaml

@@ -0,0 +1,158 @@
+Description: Communication Loss
+Category: Control
+Classes:
+  - A
+  - DR-A
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+
+Preconditions:
+  init_actions:
+    - type: set-comms-rate
+      parameters:
+        dcap_poll_seconds: 60
+        edev_list_poll_seconds: 60
+        fsa_list_poll_seconds: 60
+        der_list_poll_seconds: 60
+        derp_list_poll_seconds: 60
+        mup_post_seconds: 60
+  checks:
+    - type: end-device-contents
+      parameters: {}
+    - type: der-settings-contents
+      parameters: {}
+  actions:
+    - type: create-der-control
+      parameters:
+        start: $(now)
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 2)
+        opModImpLimW: $(setMaxW * 2)
+    - type: create-der-control
+      parameters:
+        start: $(now + '1 minute')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.2)
+        opModImpLimW: $(setMaxW * 0.2)
+    - type: create-der-control
+      parameters:
+        start: $(now + '2 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 1.8)
+        opModImpLimW: $(setMaxW * 1.8)
+    - type: create-der-control
+      parameters:
+        start: $(now + '3 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 0.7)
+        opModImpLimW: $(setMaxW * 0.7)
+    - type: create-der-control
+      parameters:
+        start: $(now + '4 minutes')
+        duration_seconds: 60
+        opModExpLimW: $(setMaxW * 1.3)
+        opModImpLimW: $(setMaxW * 1.3)
+  instructions:
+    - DER shall be generating or consuming at least 50% of its active power rating.
+    
+Steps:
+  # (a, b)
+  GET-DEFAULT-DERC:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/dderc
+    actions:
+      - type: set-default-der-control
+        parameters:
+          opModImpLimW: 0  
+          opModExpLimW: 0
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-SHORT-PERIOD
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DEFAULT-DERC
+
+  # (c)
+  WAIT-SHORT-PERIOD:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 10
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-SHORT-PERIOD
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-SCHEDULE-END
+      - type: communications-status
+        parameters:
+          enabled: false
+
+  # (d, e)
+  WAIT-SCHEDULE-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 420
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-SCHEDULE-END
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-TEST-FINISH
+            - GET-DERC-AFTER-COMMS-RESTORE
+      - type: communications-status
+        parameters:
+          enabled: true
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 300
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+    instructions:
+      - DER should continue to follow the DERControl schedule and then reduce to the DefaultDERControl value of 0W after.
+
+  # (f) - We validate comms restore by another poll to DERControlLst
+  GET-DERC-AFTER-COMMS-RESTORE:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-AFTER-COMMS-RESTORE
+
+  # (f)
+  WAIT-TEST-FINISH:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 120
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-FINISH
+      - type: finish-test
+        parameters: {}
+

cactus_test_definitions/client/procedures/ALL-24.yaml

@@ -0,0 +1,132 @@
+Description: Validation of Scaling Factors
+Category: Control
+Classes:
+  - A
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+
+    # TS 5573 states "Control responses sent by the DER client reflect the ongoing status of each control..."
+    # There is a chance that the controls might overlap slightly (depending on client polling) so we just cover
+    # the received/started Responses - other tests cover this in more detail
+    - type: response-contents
+      parameters:
+        all: true
+        status: 1 # Received
+    - type: response-contents
+      parameters:
+        all: true
+        status: 2 # Started
+
+Preconditions:
+  init_actions:
+    - type: set-comms-rate
+      parameters:
+        dcap_poll_seconds: 120
+        edev_list_poll_seconds: 120
+        fsa_list_poll_seconds: 120
+        der_list_poll_seconds: 120
+        derp_list_poll_seconds: 120
+        mup_post_seconds: 60
+  checks:
+    - type: end-device-contents
+      parameters: {}
+    - type: der-settings-contents
+      parameters: {}
+  actions:
+    - type: create-der-program
+      parameters:
+        primacy: 0
+
+  instructions:
+    - DER shall be exporting or importing at least 50% of its active power rating at the connection point.
+    
+Steps:
+  # (precondition)
+  GET-DERC-1:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 120
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-2
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-1
+
+
+  # (a, b)
+  GET-DERC-2:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 120
+          opModExpLimW: $(setMaxW * 0.3)
+          opModImpLimW: $(setMaxW * 0.3)
+          pow_10_multipliers: 2
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-3
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-2
+
+  # (c, d)
+  GET-DERC-3:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 120
+          opModExpLimW: $(setMaxW * 0.4)
+          opModImpLimW: $(setMaxW * 0.4)
+          pow_10_multipliers: 1
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-3
+
+  # Give the control a chance to run and finish
+  WAIT-TEST-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 180
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: finish-test
+        parameters: {}