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

cactus_test_definitions/client/procedures/DRL-01.yaml

@@ -0,0 +1,327 @@
+Description: Load operational instructions
+Category: Demand Response
+Classes:
+  - DR-L
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Preconditions:
+  checks:
+    - type: end-device-contents
+      parameters: {}
+    - type: der-settings-contents
+      parameters: {}
+  actions:
+    - type: set-comms-rate
+      parameters:
+        der_list_poll_seconds: 60
+        derp_list_poll_seconds: 60
+  instructions:
+    - The controlled device should be connected to the grid and consuming 90% (+/- 5%) of its nameplate rating maximum.
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+    
+Steps:
+
+  # (a, b)
+  GET-DERC-1:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now + '60 seconds')
+          duration_seconds: 60
+          opModFixedW: -75
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-1
+            - PUT-DERSETTINGS-1
+            - WAIT-DERC-1
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-1
+
+  # (c)
+  PUT-DERSTATUS-1:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/ders
+        serve_request_first: true # Run this AFTER server receives the request
+    checks:
+      type: der-status-contents
+      parameters:
+        alarmStatus: 0
+        operationalModeStatus: 103
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-1
+
+  # (c)
+  PUT-DERSETTINGS-1:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/derg
+        serve_request_first: true # Run this AFTER server receives the request
+    checks:
+      type: der-settings-contents
+      parameters:
+        modesEnabled: 80 # bit 7
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS-1
+
+
+  # (d) After the end of the previous control...
+  WAIT-DERC-1:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 120 # Wait for DERControls to fully complete
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-2
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-DERC-1
+
+  # (d) ... create a new DERControl
+  GET-DERC-2:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now + '60 seconds')
+          duration_seconds: 60
+          opModFixedW: -50
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-2
+            - PUT-DERSETTINGS-2
+            - WAIT-DERC-2
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-2
+
+
+  # (e, f)
+  PUT-DERSTATUS-2:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/ders
+        serve_request_first: true # Run this AFTER server receives the request
+    checks:
+      type: der-status-contents
+      parameters:
+        alarmStatus: 0
+        operationalModeStatus: 102
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-2
+
+  # (e, f)
+  PUT-DERSETTINGS-2:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/derg
+        serve_request_first: true # Run this AFTER server receives the request
+    checks:
+      type: der-settings-contents
+      parameters:
+        modesEnabled: 80 # bit 7
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS-2
+
+  # (g) After the end of the previous control...
+  WAIT-DERC-2:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 120 # Wait for DERControls to fully complete
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-3
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-DERC-2
+
+
+  # (g) ... create a new DERControl
+  GET-DERC-3:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now + '60 seconds')
+          duration_seconds: 60
+          opModFixedW: -0.01
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-3
+            - PUT-DERSETTINGS-3
+            - WAIT-DERC-3
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-3
+
+  # (h, i)
+  PUT-DERSTATUS-3:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/ders
+        serve_request_first: true # Run this AFTER server receives the request
+    checks:
+      type: der-status-contents
+      parameters:
+        alarmStatus: 0
+        operationalModeStatus: 101
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-3
+
+  # (h, i)
+  PUT-DERSETTINGS-3:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/derg
+        serve_request_first: true # Run this AFTER server receives the request
+    checks:
+      type: der-settings-contents
+      parameters:
+        modesEnabled: 80 # bit 7
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS-3
+
+  # (j) After the end of the previous control...
+  WAIT-DERC-3:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 120 # Wait for DERControls to fully complete
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-4
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-DERC-3
+
+  # (j) ... create a new DERControl
+  GET-DERC-4:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now + '60 seconds')
+          duration_seconds: 60
+          opModFixedW: -100
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-4
+            - PUT-DERSETTINGS-4
+            - WAIT-DERC-4
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-4
+
+  # (k, l)
+  PUT-DERSTATUS-4:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/ders
+        serve_request_first: true # Run this AFTER server receives the request
+    checks:
+      type: der-status-contents
+      parameters:
+        alarmStatus: 0
+        operationalModeStatus: 104
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-4
+
+  # (k, l)
+  PUT-DERSETTINGS-4:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/derg
+        serve_request_first: true # Run this AFTER server receives the request
+    checks:
+      type: der-settings-contents
+      parameters:
+        modesEnabled: 80 # bit 7
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS-4
+
+  # Wait for the controls to finish
+  WAIT-DERC-4:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 120 # Wait for DERControls to fully complete
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-DERC-4
+      - type: finish-test
+        parameters: {}
+

cactus_test_definitions/client/procedures/GEN-01.yaml

@@ -0,0 +1,73 @@
+Description: Active Control – Export 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: 300
+        opModExpLimW: $(setMaxW * 2)
+  instructions:
+    - DER shall be generating at the connection point at least 50% of its active power rating.
+    
+Steps:
+  # (precondition)
+  GET-DERC-INITIAL:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-ZERO
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-INITIAL
+
+  # (a, b, c)
+  GET-DERC-ZERO:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 300
+          opModExpLimW: 0
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-ZERO
+          
+  

cactus_test_definitions/client/procedures/GEN-02.yaml

@@ -0,0 +1,72 @@
+Description: Active 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: 300
+        opModGenLimW: $(setMaxW * 2)
+  instructions:
+    - DER shall be generating at the connection point at least 50% of its active power rating.
+    
+Steps:
+  # (precondition)
+  GET-DERC-INITIAL:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-ZERO
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-INITIAL
+
+  # (a, b, c)
+  GET-DERC-ZERO:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 300
+          opModGenLimW: 0
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-ZERO

cactus_test_definitions/client/procedures/GEN-03.yaml

@@ -0,0 +1,160 @@
+Description: Default Control – Export 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
+        opModExpLimW: $(setMaxW * 2)
+  instructions:
+    - DER shall be exporting at the connection point 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:
+          opModExpLimW: $(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
+          opModExpLimW: $(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 export 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
+          opModExpLimW: 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 export to 0W at the rate of setGradW (default 0.27%/s)