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

cactus_test_definitions/client/procedures/ALL-09.yaml

@@ -0,0 +1,111 @@
+Description: Capabilities and Settings
+Category: Monitoring
+Classes:
+  - A
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+    - type: der-capability-contents
+      parameters:
+        #
+        # NOTE - These checks have been loosened from TS:5573 (which requires EVERYTHING) until clarification on
+        #        about what the MINIMUM subset of values is determined for each class of device
+        #
+        # rtgMaxChargeRateW: true # Maximum rate of energy transfer received
+        # rtgMaxDischargeRateW: true # Maximum rate of energy transfer delivered
+        # rtgMaxVA: true # Maximum apparent power
+        # rtgMaxVar: true # Maximum reactive power delivered
+        # rtgMaxVarNeg: true # Maximum reactive power received
+        rtgMaxW: true # Maximum active power
+        # rtgMinPFOverExcited: true # Minimum power factor displacement
+        # rtgMinPFUnderExcited: true # Minimum power factor displacement
+        doeModesSupported: true # CSIP-Aus DOE modes supported
+    - type: der-settings-contents
+      parameters:
+        #
+        # NOTE - These checks have been loosened from TS:5573 (which requires EVERYTHING) until clarification on
+        #        about what the MINIMUM subset of values is determined for each class of device
+        #
+        # setMaxChargeRateW: true # Maximum rate of energy transfer received
+        # setMaxDischargeRateW: true # Maximum rate of energy transfer delivered
+        # setMaxVA: true # Maximum apparent power
+        # setMaxVar: true # Maximum reactive power delivered
+        # setMaxVarNeg: true # Maximum reactive power received
+        setMaxW: true # Maximum active power
+        # setMinPFOverExcited: true # Minimum power factor displacement
+        # setMinPFUnderExcited: true # Minimum power factor displacement
+        doeModesEnabled: true # CSIP-Aus DOE modes enabled
+    - 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
+
+Steps:
+  # (a) - This is a proxy that assumes the device has underwent initial registration / discovery
+  GET-DER:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/der
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS
+            - PUT-DERCAPABILITY
+            - PUT-DERSETTINGS
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DER
+  # (b)
+  PUT-DERSTATUS:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/ders
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS
+  
+  # (b)
+  PUT-DERCAPABILITY:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/dercap
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERCAPABILITY
+
+  # (b)
+  PUT-DERSETTINGS:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/derg
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS

cactus_test_definitions/client/procedures/ALL-10.yaml

@@ -0,0 +1,128 @@
+Description: Update telemetry post rates
+Category: Monitoring
+Classes:
+  - A
+  - DR-A
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+    # Test is ~11.5 minutes of waiting which should leave enough time for:
+    #   one post @ 60 seconds (during startup - might not happen if timings line up)
+    #   two posts @ 300 seconds
+    #   one post @ 60 seconds (after update)
+    - 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: {}
+
+Steps:
+  
+  # (a, b)
+  GET-MUP-INITIAL:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /mup
+    actions:
+      - type: set-comms-rate
+        parameters:
+          mup_post_seconds: 300
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-TILL-UPDATE
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-MUP-INITIAL
+
+  # NOTE - (c) will be evaluated via TestCriteria checks
+
+  # (d, e)
+  WAIT-TILL-UPDATE:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 600
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-MUP-UPDATED
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TILL-UPDATE
+
+  # (d, e)
+  GET-MUP-UPDATED:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /mup
+    actions:
+      - type: set-comms-rate
+        parameters:
+          mup_post_seconds: 60
+      - type: enable-steps
+        parameters:
+          steps:
+            - POST-MUP-1
+            - WAIT-TILL-END
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-MUP-UPDATED
+
+  # (f) - This is our proxy for making sure that post rate has returned to 60s - it has 90 seconds to be hit after GET-MUP-UPDATED
+  POST-MUP-1:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /mup/*
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-MUP-1
+
+  # (f)
+  WAIT-TILL-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 90
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TILL-END
+      - type: finish-test
+        parameters: {}
+  

cactus_test_definitions/client/procedures/ALL-11.yaml

@@ -0,0 +1,111 @@
+Description: Active Control – Energise / De-energise
+Category: Control
+Classes:
+  - 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: 300
+        derp_list_poll_seconds: 300
+        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
+        opModEnergize: true
+    - type: create-der-control
+      parameters:
+        start: $(now + '5 minutes')
+        duration_seconds: 300
+        opModEnergize: false
+  instructions:
+    - DER shall be generating or consuming at least 50% of its active power rating.
+
+Steps:
+  
+  # (b) - Wait until just before the opModEnergize: False control before accepting a DERStatus update
+  WAIT-CONTROL-START:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 270
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-DISCONNECT
+            - WAIT-CONTROL-END
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-START
+  
+  # (c)
+  PUT-DERSTATUS-DISCONNECT:
+    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:
+            genConnectStatus_bit0: false
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-DISCONNECT
+
+  # (d) - This is soley to prevent a client from reporting reconnect too early
+  WAIT-CONTROL-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 600
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-RECONNECT
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-END
+
+  # (d)
+  PUT-DERSTATUS-RECONNECT:
+    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:
+            genConnectStatus_bit0: true
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-RECONNECT

cactus_test_definitions/client/procedures/ALL-12.yaml

@@ -0,0 +1,126 @@
+Description: Active Control – Disconnect 
+Category: Control
+Classes:
+  - 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: {}
+  actions:
+    - type: create-der-program
+      parameters:
+        primacy: 0
+
+  instructions:
+    - DER shall be generating or consuming at least 50% of its active power rating.
+
+Steps:
+  # (precondition, a, b)
+  GET-DERC:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now + '5 minutes')
+          duration_seconds: 600
+          opModConnect: false
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-START
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC
+
+  # (b) - Wait until just before the opModEnergize: False control before accepting a DERStatus update
+  WAIT-CONTROL-START:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 270
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-DISCONNECT
+            - WAIT-CONTROL-END
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-START
+
+  # (c) waits for a DERStatus disconnected
+  PUT-DERSTATUS-DISCONNECT:
+    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:
+            genConnectStatus_bit0: false
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-DISCONNECT
+            
+  # (d) - This is soley to prevent a client from reporting reconnect too early
+  WAIT-CONTROL-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 600 # We enable this 30 seconds before the control expires to allow for timing errors
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-RECONNECT
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-END
+
+  # (d) This will wait until the client POST's a DERStatus saying it has reconnected
+  PUT-DERSTATUS-RECONNECT:
+    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:
+            genConnectStatus_bit0: true
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-RECONNECT
+  
+
+

cactus_test_definitions/client/procedures/ALL-13.yaml

@@ -0,0 +1,112 @@
+Description: Default Controls – Ramp Rate
+Category: Control
+Classes:
+  - 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)
+  # On first poll of default control - set setGradW to 1%/s
+  GET-DEFAULT-DERC-100:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/dderc
+    actions:
+      - type: set-default-der-control
+        parameters:
+          setGradW: 100 # hundredths of a percent - this is 1%
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS-SET-GRAD-W-100
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DEFAULT-DERC-100
+
+  # (c)
+  # This will wait until the client POST's a DERSettings with the 1% setGradW
+  PUT-DERSETTINGS-SET-GRAD-W-100:
+    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:
+            setGradW: 100
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DEFAULT-DERC-27
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS-SET-GRAD-W-100
+
+  # (after)
+  GET-DEFAULT-DERC-27:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/dderc
+    actions:
+      - type: set-default-der-control
+        parameters:
+          setGradW: 27 # hundredths of a percent - this is 0.27%
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS-SET-GRAD-W-27
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DEFAULT-DERC-27
+
+  # (after)
+  # This will wait until the client POST's a DERSettings with the 0.27% setGradW
+  PUT-DERSETTINGS-SET-GRAD-W-27:
+    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:
+            setGradW: 27
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS-SET-GRAD-W-27
+