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

cactus_test_definitions/client/procedures/GEN-04.yaml

@@ -0,0 +1,161 @@
+Description: Default Control – Generation Limit
+Category: Control
+Classes:
+  - G
+
+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: 900
+        opModGenLimW: $(setMaxW * 2)
+  instructions:
+    - DER shall be generating 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:
+          opModGenLimW: $(setMaxW * 0.3)
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-1
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DEFAULT-DERC
+
+  # (b, c, d) This will be the first poll after client has received the defaults
+  # the client will see the existing control but it will be cancelled immediately after
+  GET-DERC-1:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+        serve_request_first: true # Run this AFTER server receives the request
+    actions:
+      - type: cancel-active-der-controls
+        parameters: {}
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-2
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-1
+
+  # (d, e) On this poll, client will discover control was cancelled and a new control will be added at 200% of setMaxW
+  GET-DERC-2:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+        serve_request_first: true # Run this AFTER server receives the request
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 600
+          opModGenLimW: $(setMaxW * 2)
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-END
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-2
+      
+  # (f, g) Waits for the new control to finish (with a bit of overtime)
+  WAIT-CONTROL-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 660
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-3
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-END
+    instructions:
+    - DER should ramp down generation to 30% at the rate of setGradW (default 0.27%/s)
+    - DER should then discover a new control and then ramp up to unconstrained at the rate of setGradW (default 0.27%/s)
+    - Upon control completion, DER should then ramp down to 30% at the rate of setGradW (default 0.27%/s)
+  
+  # (h) On this poll, client will discover control the DefaultDERControl is cancelled and a new 0W control is in place
+  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: 600
+          opModGenLimW: 0
+      - type: set-default-der-control
+        parameters:
+          cancelled: true
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-3
+
+
+  WAIT-TEST-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 120
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: finish-test
+        parameters: {}
+    instructions:
+    - DER shall ramp down generation to 0W at the rate of setGradW (default 0.27%/s)

cactus_test_definitions/client/procedures/GEN-05.yaml

@@ -0,0 +1,89 @@
+Description: Active Control – Export Limit
+Category: Control
+Classes:
+  - G
+  - S
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+    - type: all-notifications-transmitted
+      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: 900 # Set to a large value - testing whether they respond due to notification - not polls
+        derp_list_poll_seconds: 900 # Set to a large value - testing whether they respond due to notification - not polls
+        mup_post_seconds: 60
+    - type: create-der-program
+      parameters:
+        primacy: 0
+
+  checks:
+    - type: end-device-contents
+      parameters: {}
+    - type: der-settings-contents
+      parameters: {}
+    - type: subscription-contents
+      parameters:
+        subscribed_resource: /edev/1/derp/1/derc
+        
+  actions:
+    - type: create-der-control
+      parameters:
+        start: $(now)
+        duration_seconds: 300
+        opModExpLimW: $(setMaxW * 2)
+  instructions:
+    - EndDevice should be registered with active subscriptions before starting.
+    - DER shall be exporting at the connection point at least 50% of its active power rating.
+    
+Steps:
+
+  # NOTE - The majority of this test's validation is watching 
+
+  # (a, b, c)
+  # After a short delay (to allow precondition actions to propagate subscriptions)
+  WAIT-CREATE-DERC:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 60
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now + '5 minutes')
+          duration_seconds: 120
+          opModExpLimW: 0
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-TEST-FINISH
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CREATE-DERC
+
+  # (a, b, c)
+  WAIT-TEST-FINISH:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 480 # enough time for the control to start, run and then finish
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-FINISH
+    instructions:
+      - DER should be observed ramping to and then from 0W control.

cactus_test_definitions/client/procedures/GEN-06.yaml

@@ -0,0 +1,90 @@
+Description: Active Control – Generation Limit
+Category: Control
+Classes:
+  - G
+  - S
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+    - type: all-notifications-transmitted
+      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: 900 # Set to a large value - testing whether they respond due to notification - not polls
+        derp_list_poll_seconds: 900 # Set to a large value - testing whether they respond due to notification - not polls
+        mup_post_seconds: 60
+    - type: create-der-program
+      parameters:
+        primacy: 0
+        
+  checks:
+    - type: end-device-contents
+      parameters: {}
+    - type: der-settings-contents
+      parameters: {}
+    - type: subscription-contents
+      parameters:
+        subscribed_resource: /edev/1/derp/1/derc
+
+  actions:
+    - type: create-der-control
+      parameters:
+        start: $(now)
+        duration_seconds: 300
+        opModGenLimW: $(setMaxW * 2)
+
+  instructions:
+    - EndDevice should be registered with active subscriptions before starting.
+    - DER shall be generating at least 50% of its active power rating.
+    
+Steps:
+
+  # NOTE - The majority of this test's validation is watching 
+
+  # (a, b, c)
+  # After a short delay (to allow precondition actions to propagate subscriptions)
+  WAIT-CREATE-DERC:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 60
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now + '5 minutes')
+          duration_seconds: 120
+          opModGenLimW: 0
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-TEST-FINISH
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CREATE-DERC
+
+  # (a, b, c)
+  WAIT-TEST-FINISH:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 480 # enough time for the control to start, run and then finish
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-FINISH
+    instructions:
+      - DER should be observed ramping to and then from 0W control.

cactus_test_definitions/client/procedures/GEN-07.yaml

@@ -0,0 +1,145 @@
+Description: Default Controls – Export Limit
+Category: Control
+Classes:
+  - G
+  - S
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+    - type: all-notifications-transmitted
+      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: 1800 # Set to a large value - testing whether they respond due to notification - not polls
+        derp_list_poll_seconds: 1800 # Set to a large value - testing whether they respond due to notification - not polls
+        mup_post_seconds: 60
+    - type: create-der-program
+      parameters:
+        primacy: 0
+      
+  checks:
+    - type: end-device-contents
+      parameters: {}
+    - type: der-settings-contents
+      parameters: {}
+    - type: subscription-contents
+      parameters:
+        subscribed_resource: /edev/1/derp/1/derc
+    - type: subscription-contents
+      parameters:
+        subscribed_resource: /edev/1/derp/1/dderc
+
+  actions:
+    - type: create-der-control
+      parameters:
+        start: $(now)
+        duration_seconds: 300
+        opModExpLimW: $(setMaxW * 2)
+    # (a, b)
+    - type: set-default-der-control
+      parameters:
+        opModExpLimW: $(setMaxW * 0.3)
+  instructions:
+    - EndDevice should be registered with active subscriptions before starting.
+    - DER shall be exporting at the connection point with at least 50% of its active power rating.
+    
+Steps:
+
+  # (c)
+  # Give enough time for precondition notifications to propagate before cancelling all DERControls
+  WAIT-CANCEL-DERC:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 60
+    actions:
+      - type: cancel-active-der-controls
+        parameters: {}
+          
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-DEVICE-RAMP
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CANCEL-DERC
+
+  # (d, e)
+  WAIT-DEVICE-RAMP:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 120
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 600
+          opModExpLimW: $(setMaxW * 2)
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-FINISH
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-DEVICE-RAMP
+    instructions:
+      - DER should be ramping to the DefaultDERControl value of 30% max power at rate setGradW (default 0.27%/s).
+
+  # (f, g, h)
+  WAIT-CONTROL-FINISH:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 720
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 600
+          opModExpLimW: 0
+      - type: set-default-der-control
+        parameters:
+          cancelled: true
+
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-TEST-FINISH
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-FINISH
+    instructions:
+      - DER should be ramping to the active DERControl unconstrained value at rate setGradW (default 0.27%/s).
+      - Upon completion of the active DERControl (10 minutes) the DER should ramp to the DefaultDERControl value of 30% max power.
+
+  # (i)
+  WAIT-TEST-FINISH:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 720
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-FINISH
+      - type: finish-test
+        parameters: {}
+    instructions:
+      - DER should be ramping to the active DERControl 0W value at rate setGradW (default 0.27%/s).

cactus_test_definitions/client/procedures/GEN-08.yaml

@@ -0,0 +1,145 @@
+Description: Default Controls – Generation Limit
+Category: Control
+Classes:
+  - G
+  - S
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+    - type: all-notifications-transmitted
+      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: 1800 # Set to a large value - testing whether they respond due to notification - not polls
+        derp_list_poll_seconds: 1800 # Set to a large value - testing whether they respond due to notification - not polls
+        mup_post_seconds: 60
+    - type: create-der-program
+      parameters:
+        primacy: 0
+      
+  checks:
+    - type: end-device-contents
+      parameters: {}
+    - type: der-settings-contents
+      parameters: {}
+    - type: subscription-contents
+      parameters:
+        subscribed_resource: /edev/1/derp/1/derc
+    - type: subscription-contents
+      parameters:
+        subscribed_resource: /edev/1/derp/1/dderc
+
+  actions:
+    - type: create-der-control
+      parameters:
+        start: $(now)
+        duration_seconds: 300
+        opModGenLimW: $(setMaxW * 2)
+    # (a, b)
+    - type: set-default-der-control
+      parameters:
+        opModGenLimW: $(setMaxW * 0.3)
+  instructions:
+    - EndDevice should be registered with active subscriptions before starting.
+    - DER shall be generating at least 50% of its active power rating.
+    
+Steps:
+
+  # (c)
+  # Give enough time for precondition notifications to propagate before cancelling all DERControls
+  WAIT-CANCEL-DERC:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 60
+    actions:
+      - type: cancel-active-der-controls
+        parameters: {}
+          
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-DEVICE-RAMP
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CANCEL-DERC
+
+  # (d, e)
+  WAIT-DEVICE-RAMP:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 120
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 600
+          opModGenLimW: $(setMaxW * 2)
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-FINISH
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-DEVICE-RAMP
+    instructions:
+      - DER should be ramping to the DefaultDERControl value of 30% max power at rate setGradW (default 0.27%/s).
+
+  # (f, g, h)
+  WAIT-CONTROL-FINISH:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 720
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 600
+          opModGenLimW: 0
+      - type: set-default-der-control
+        parameters:
+          cancelled: true
+
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-TEST-FINISH
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-FINISH
+    instructions:
+      - DER should be ramping to the active DERControl unconstrained value at rate setGradW (default 0.27%/s).
+      - Upon completion of the active DERControl (10 minutes) the DER should ramp to the DefaultDERControl value of 30% max power.
+
+  # (i)
+  WAIT-TEST-FINISH:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 720
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-FINISH
+      - type: finish-test
+        parameters: {}
+    instructions:
+      - DER should be ramping to the active DERControl 0W value at rate setGradW (default 0.27%/s).