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

cactus_test_definitions/client/procedures/LOA-12.yaml

@@ -0,0 +1,376 @@
+Description: Variable Load Limit
+Category: DER
+Classes:
+  - DER-L
+
+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:
+
+  # (precondition) - Create a DERControl - set to 200% of max
+  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: 60
+          opModLoadLimW: $(setMaxW * 2)
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-2
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-1
+
+  # (a,b) - Create a DERControl - set to 100% of max
+  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: 60
+          opModLoadLimW: $(setMaxW)
+      - type: enable-steps
+        parameters:
+          steps:
+            - POST-DERC-2-RESPONSE-RECEIVED
+            - POST-DERC-2-RESPONSE-STARTED
+            - POST-DERC-2-RESPONSE-COMPLETE
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-2
+
+  # (b) Wait for "received" response from DERC-2
+  POST-DERC-2-RESPONSE-RECEIVED:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/1/rsps/site_control/rsp
+        serve_request_first: true
+    checks:
+      - type: response-contents
+        parameters: 
+          latest: true
+          status: 1
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-DERC-2-RESPONSE-RECEIVED
+
+  # (b) Wait for "Started" response from DERC-2
+  POST-DERC-2-RESPONSE-STARTED:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/1/rsps/site_control/rsp
+        serve_request_first: true
+    checks:
+      - type: response-contents
+        parameters: 
+          latest: true
+          status: 2
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-DERC-2-RESPONSE-STARTED
+
+  # (b) Wait for "complete" response from DERC-2 - this will trigger the injection of the next control
+  POST-DERC-2-RESPONSE-COMPLETE:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/1/rsps/site_control/rsp
+        serve_request_first: true
+    checks:
+      - type: response-contents
+        parameters: 
+          latest: true
+          status: 3
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-3
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-DERC-2-RESPONSE-COMPLETE
+
+  # (c,d) - Create a DERControl - set to 40% of max
+  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: 60
+          opModLoadLimW: $(setMaxW * 0.4)
+      - type: enable-steps
+        parameters:
+          steps:
+            - POST-DERC-3-RESPONSE-RECEIVED
+            - POST-DERC-3-RESPONSE-STARTED
+            - POST-DERC-3-RESPONSE-COMPLETE
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-3
+
+  # (b) Wait for "received" response from DERC-3
+  POST-DERC-3-RESPONSE-RECEIVED:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/1/rsps/site_control/rsp
+        serve_request_first: true
+    checks:
+      - type: response-contents
+        parameters: 
+          latest: true
+          status: 1
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-DERC-3-RESPONSE-RECEIVED
+
+  # (b) Wait for "Started" response from DERC-3
+  POST-DERC-3-RESPONSE-STARTED:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/1/rsps/site_control/rsp
+        serve_request_first: true
+    checks:
+      - type: response-contents
+        parameters: 
+          latest: true
+          status: 2
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-DERC-3-RESPONSE-STARTED
+
+  # (b) Wait for "complete" response from DERC-3
+  POST-DERC-3-RESPONSE-COMPLETE:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/1/rsps/site_control/rsp
+        serve_request_first: true
+    checks:
+      - type: response-contents
+        parameters: 
+          latest: true
+          status: 3
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-4
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-DERC-3-RESPONSE-COMPLETE
+
+  # (e, f) - Create a DERControl - set to 25% of max
+  GET-DERC-4:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 60
+          opModLoadLimW: $(setMaxW * 0.25)
+      - type: enable-steps
+        parameters:
+          steps:
+            - POST-DERC-4-RESPONSE-RECEIVED
+            - POST-DERC-4-RESPONSE-STARTED
+            - POST-DERC-4-RESPONSE-COMPLETE
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-4
+
+  # (f) Wait for "received" response from DERC-4
+  POST-DERC-4-RESPONSE-RECEIVED:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/1/rsps/site_control/rsp
+        serve_request_first: true
+    checks:
+      - type: response-contents
+        parameters: 
+          latest: true
+          status: 1
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-DERC-4-RESPONSE-RECEIVED
+
+  # (f) Wait for "Started" response from DERC-4
+  POST-DERC-4-RESPONSE-STARTED:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/1/rsps/site_control/rsp
+        serve_request_first: true
+    checks:
+      - type: response-contents
+        parameters: 
+          latest: true
+          status: 2
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-DERC-4-RESPONSE-STARTED
+
+  # (f) Wait for "complete" response from DERC-4
+  POST-DERC-4-RESPONSE-COMPLETE:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/1/rsps/site_control/rsp
+        serve_request_first: true
+    checks:
+      - type: response-contents
+        parameters: 
+          latest: true
+          status: 3
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-5
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-DERC-4-RESPONSE-COMPLETE
+  
+  # (g, h) - Create a DERControl - set to 0% of max
+  GET-DERC-5:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 60
+          opModLoadLimW: 0
+      - type: enable-steps
+        parameters:
+          steps:
+            - POST-DERC-5-RESPONSE-RECEIVED
+            - POST-DERC-5-RESPONSE-STARTED
+            - POST-DERC-5-RESPONSE-COMPLETE
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-5
+
+  # (h) Wait for "received" response from DERC-5
+  POST-DERC-5-RESPONSE-RECEIVED:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/1/rsps/site_control/rsp
+        serve_request_first: true
+    checks:
+      - type: response-contents
+        parameters: 
+          latest: true
+          status: 1
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-DERC-5-RESPONSE-RECEIVED
+
+  # (h) Wait for "Started" response from DERC-5
+  POST-DERC-5-RESPONSE-STARTED:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/1/rsps/site_control/rsp
+        serve_request_first: true
+    checks:
+      - type: response-contents
+        parameters: 
+          latest: true
+          status: 2
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-DERC-5-RESPONSE-STARTED
+
+  # (f) Wait for "complete" response from DERC-5
+  POST-DERC-5-RESPONSE-COMPLETE:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/1/rsps/site_control/rsp
+        serve_request_first: true
+    checks:
+      - type: response-contents
+        parameters: 
+          latest: true
+          status: 3
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-DERC-5-RESPONSE-COMPLETE
+      - type: finish-test
+        parameters: {}

cactus_test_definitions/client/procedures/LOA-13.yaml

@@ -0,0 +1,71 @@
+Description: Tracking import-limit through variable load
+Category: DER
+Classes:
+  - DER-L
+
+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
+        opModImpLimW: $(setMaxW * 2)
+    - type: create-der-control
+      parameters:
+        start: $(now + '1 minute')
+        duration_seconds: 420
+        opModImpLimW: $(setMaxW * 0.2)
+  instructions:
+    - Connect a test load electrically in parallel with the DER.
+    - Set the load to consume 0W.
+
+Steps:
+
+  # This test is purely following a sequence of DERControls. It's expected that the following events occurs out of band:
+  # at t=0 - Test load is consuming 0W
+  # at t=120s - Test load is consuming 20% of setMaxW
+  # at t=240s - Test load is consuming 10% of setMaxW
+  # at t=360s - Test load is consuming 0W
+  #
+  # Validation MUST be performed by power meter to ensure that the DER is adjusting its power in response to changing 
+  # loads
+  WAIT-TEST-END:
+    instructions:
+      - At t=120s, set the load to consume 20% of the DER's rated active power.
+      - At t=240s, set the load to consume 10% of the DER's rated active power.
+      - At t=360s, set the load to consume 0W.
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 500
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: finish-test
+        parameters: {}

cactus_test_definitions/client/procedures/MUL-01.yaml

@@ -0,0 +1,92 @@
+Description: Returning DERStatus Values for Multiple DER
+Category: Monitoring
+Classes:
+  - M
+
+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: {}
+    - type: der-status-contents
+      parameters: 
+        genConnectStatus_bit0: true
+  actions:
+    - type: create-der-control
+      parameters:
+        start: $(now)
+        duration_seconds: 900
+        opModExpLimW: $(setMaxW * 2)
+        opModImpLimW: $(setMaxW * 2)
+
+Steps:
+  
+  # The client powers off one DER
+  PUT-DERSTATUS-FIRST-DISCONNECT:
+    instructions:
+      - Power off one DER either by a hardware switch on the DER or by disconnection from the grid supply. Priority should be given to DER capable of generation.
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/ders
+        serve_request_first: true # Run this AFTER server receives the request
+      # Only trigger this if the server has an updated DERStatus
+      checks:
+        - type: der-status-contents
+          parameters: 
+            operationalModeStatus: 2
+            genConnectStatus_bit0: true
+            genConnectStatus_bit1: true
+            genConnectStatus_bit2: true
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-FULL-DISCONNECT
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-FIRST-DISCONNECT
+  
+  # The client powers off all remaining DER
+  PUT-DERSTATUS-FULL-DISCONNECT:
+    instructions:
+      - Power off off remaining DER.
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/ders
+        serve_request_first: true # Run this AFTER server receives the request
+      # Only trigger this if the server has an updated DERStatus
+      checks:
+        - type: der-status-contents
+          parameters: 
+            operationalModeStatus: 1
+            genConnectStatus_bit0: false
+            genConnectStatus_bit1: false
+            genConnectStatus_bit2: false
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-FULL-DISCONNECT

cactus_test_definitions/client/procedures/MUL-02.yaml

@@ -0,0 +1,80 @@
+Description: Reporting Aggregated Telemetry for Multiple DER
+Category: Monitoring
+Classes:
+  - M
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+
+    # Test is ~5 minutes of waiting which should leave enough time for at least 3 reading posts
+    - type: readings-site-active-power
+      parameters: {"minimum_count": 3} 
+    - type: readings-site-reactive-power
+      parameters: {"minimum_count": 3}
+    - type: readings-voltage
+      parameters: {"minimum_count": 3}
+    - type: readings-der-active-power
+      parameters: {"minimum_count": 3}
+    - type: readings-der-reactive-power
+      parameters: {"minimum_count": 3}
+
+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: set-comms-rate
+      parameters:
+        der_list_poll_seconds: 60
+        mup_post_seconds: 60
+    - type: create-der-control
+      parameters:
+        start: $(now)
+        duration_seconds: 120
+        opModExpLimW: $(setMaxW * 2)
+        opModImpLimW: $(setMaxW * 2)
+    - type: create-der-control
+      parameters:
+        start: $(now + '2 minutes')
+        duration_seconds: 120
+        opModExpLimW: 0
+        opModImpLimW: 0
+  instructions:
+    - Connect a test load electrically in parallel with the DER.
+    - Set the load to consume 10% of the sum total of the DERs' rated active power.
+
+Steps:
+
+  # Wait for the test end - validation of device response will need to be validated out of band
+  WAIT-TEST-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 300 # Wait for at least 4/5 sets of readings to arrive (with post rate 60 seconds)
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: finish-test
+        parameters: {}
+    instructions:
+      - DER should send correct readings, aggregated according TS 5573 2025

cactus_test_definitions/client/procedures/MUL-03.yaml

@@ -0,0 +1,78 @@
+Description: Validate DERCapability and DERSettings For Multiple DER
+Category: Monitoring
+Classes:
+  - M
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+    - type: der-capability-contents
+      parameters: {}
+    - type: der-settings-contents
+      parameters: {}
+    - type: der-status-contents
+      parameters: {}
+
+Preconditions:
+  immediate_start: true # There will be no "init" phase - all interactions will be immediately logged against the test
+  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, c)
+  PUT-DERSETTINGS-FIRST:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/derg
+    actions:
+      - type: set-default-der-control
+        parameters:
+          setGradW: 100 # Value in hundredths, 100 = 1%
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS-FIRST
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS-UPDATED
+      
+  # (d)
+  PUT-DERSETTINGS-UPDATED:
+    instructions:
+      - Modify the maximum rating of one DER in the device settings.
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/derg
+        serve_request_first: true
+    checks:
+        type: der-settings-contents
+        parameters:
+          setGradW: 100
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS-UPDATED