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

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: {}

cactus_test_definitions/client/procedures/ALL-25-EXT.yaml

@@ -0,0 +1,228 @@
+Description: Extended operations
+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 # Received
+    - type: response-contents
+      parameters:
+        all: true
+        status: 2 # Started
+    - type: response-contents
+      parameters:
+        all: true
+        status: 3 # Completed
+    - type: readings-site-active-power
+      parameters: {"minimum_count": 70} # This test is 72 hours at 1 hour post rate
+
+Preconditions:
+  init_actions:
+    # We will be slowing down the comms significantly due to the 72hour nature of this test
+    - type: set-comms-rate
+      parameters:
+        dcap_poll_seconds: 3600
+        edev_list_poll_seconds: 3600
+        fsa_list_poll_seconds: 3600
+        der_list_poll_seconds: 3600
+        derp_list_poll_seconds: 3600
+        mup_post_seconds: 3600
+
+  checks:
+    - type: end-device-contents
+      parameters: {}
+    
+
+  actions:
+    - type: create-der-program
+      parameters:
+        primacy: 0
+
+    - type: set-default-der-control
+      parameters:
+        opModExpLimW: 0
+        opModImpLimW: 0
+
+Steps:
+
+  # This will supply 24 hours of controls
+  GET-DERC-DAY-1:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 21600 # 6 hours
+          opModExpLimW: $(setMaxW * 0.3)
+          opModImpLimW: $(setMaxW * 0.3)
+      - type: create-der-control
+        parameters:
+          start: $(now + '6 hours')
+          duration_seconds: 21600 # 6 hours
+          opModExpLimW: $(setMaxW * 1.2)
+          opModImpLimW: $(setMaxW * 1.2)
+      - type: create-der-control
+        parameters:
+          start: $(now + '12 hours')
+          duration_seconds: 21600 # 6 hours
+          opModExpLimW: $(setMaxW * 0.8)
+          opModImpLimW: $(setMaxW * 0.8)
+      - type: create-der-control
+        parameters:
+          start: $(now + '18 hours')
+          duration_seconds: 21600 # 6 hours
+          opModExpLimW: $(setMaxW * 0.1)
+          opModImpLimW: $(setMaxW * 0.1)
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-DAY1-END
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-DAY-1
+
+  # This will fire at the end of the first 24 hours
+  WAIT-DAY1-END:
+    instructions: 
+      - Please note that this test will run continuously for 72 hours. You are currently in the first 24 hours.
+      - New DERControls will be issued every 24 hours.
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 86700 # 24 hours, 5 minutes (to ensure we don't supersede anything)
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 21600 # 6 hours
+          opModExpLimW: $(setMaxW * 0.4)
+          opModImpLimW: $(setMaxW * 0.4)
+      - type: create-der-control
+        parameters:
+          start: $(now + '6 hours')
+          duration_seconds: 21600 # 6 hours
+          opModExpLimW: $(setMaxW * 1.5)
+          opModImpLimW: $(setMaxW * 1.5)
+      - type: create-der-control
+        parameters:
+          start: $(now + '12 hours')
+          duration_seconds: 21600 # 6 hours
+          opModExpLimW: $(setMaxW * 0.6)
+          opModImpLimW: $(setMaxW * 0.6)
+      - type: create-der-control
+        parameters:
+          start: $(now + '18 hours')
+          duration_seconds: 21600 # 6 hours
+          opModExpLimW: $(setMaxW * 0.2)
+          opModImpLimW: $(setMaxW * 0.2)
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-DAY2-END
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-DAY1-END
+
+  # This will fire at the end of the second 24 hours
+  WAIT-DAY2-END:
+    instructions: 
+      - Please note that this test will run continuously for 72 hours. You are currently in the second 24 hours.
+      - New DERControls will be issued every 24 hours.
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 86700 # 24 hours, 5 minutes (to ensure we don't supersede anything)
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 21600 # 6 hours
+          opModExpLimW: $(setMaxW * 0.5)
+          opModImpLimW: $(setMaxW * 0.5)
+      - type: create-der-control
+        parameters:
+          start: $(now + '6 hours')
+          duration_seconds: 21600 # 6 hours
+          opModExpLimW: $(setMaxW * 1)
+          opModImpLimW: $(setMaxW * 1)
+      - type: create-der-control
+        parameters:
+          start: $(now + '12 hours')
+          duration_seconds: 21600 # 6 hours
+          opModExpLimW: $(setMaxW * 0.3)
+          opModImpLimW: $(setMaxW * 0.3)
+      - type: create-der-control
+        parameters:
+          start: $(now + '18 hours')
+          duration_seconds: 21600 # 6 hours
+          opModExpLimW: $(setMaxW * 0.8)
+          opModImpLimW: $(setMaxW * 0.8)
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-DAY3-END
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-DAY2-END
+
+  # This will fire at the end of the test
+  WAIT-DAY3-END:
+    instructions: 
+      - Please note that this test will run continuously for 72 hours. You are currently in the final 24 hours.
+      - No more new controls will be issued after the current set. 
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 86700 # 24 hours, 5 minutes
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-DAY3-END
+
+  # This will fire at the end of the test
+  WAIT-TEST-END:
+    instructions: 
+      - The test is now complete - no more controls will be issued.
+      - This delay is purely a chance to ensure that EVERY DERControl has received a "Completed (3)" Response.
+      - This step will block indefinitely until the latest DERControl has a "Completed (3)" Response.
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 10 # Token amount of time - we want this to start checking immediately
+      checks:
+        # This check will repeatedly fire after the wait time is met - this will ensure that a late "completed" response
+        # won't waste 3 days of testing.
+        - type: response-contents
+          parameters:
+            latest: true
+            status: 3 
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: finish-test
+        parameters: {}
+