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

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,108 @@
+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-TILL-END
+            - PUT-DERSTATUS-DISCONNECT
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC
+
+  # (c) This will wait until the client POST's a DERStatus saying it has 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: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-RECONNECT
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-DISCONNECT
+
+  # (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
+  
+  WAIT-TILL-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 960
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TILL-END
+      - type: finish-test
+        parameters: {}

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
+ 

cactus_test_definitions/client/procedures/ALL-14.yaml

@@ -0,0 +1,165 @@
+Description: Subscribe
+Category: Control
+Classes:
+  - S
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+    - type: all-notifications-transmitted
+      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
+
+  actions:  
+    - type: create-der-program
+      parameters:
+        primacy: 0
+    # Start by enabling everything at the beginning as each step is (mostly) independent of the others
+    - type: enable-steps
+      parameters:
+        steps:
+            - POST-SUBSCRIPTION-FSAL
+            - POST-SUBSCRIPTION-DERP
+            - POST-SUBSCRIPTION-DERC
+            - POST-SUBSCRIPTION-DEFAULT-DERC
+
+Steps:
+
+  # (a, b, c, d, e, f)
+  # Wait for a subscription to EndDeviceList and then update the active EndDevice's postRate to trigger a notification
+  POST-SUBSCRIPTION-EDEV:
+    instructions:
+      - Trigger an EndDeviceList subscription request from the aggregator client system (this can be an automated response to completing the Discovery process).
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/0/sub
+        serve_request_first: true
+      checks:
+        - type: subscription-contents
+          parameters: 
+            subscribed_resource: /edev
+    actions:
+      # Trigger notification
+      - type: set-comms-rate
+        parameters:
+          edev_post_seconds: 30
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-SUBSCRIPTION-EDEV
+
+  # (g, h, i, j, k, l)
+  # Wait for a subscription to FunctionSetAssignmentList and then update the active fsa list to trigger a notification
+  POST-SUBSCRIPTION-FSAL:
+    instructions:
+      - Trigger a FunctionSetAssignmentsList subscription request from the aggregator client system.
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/0/sub
+        serve_request_first: true
+      checks:
+        - type: subscription-contents
+          parameters: 
+            subscribed_resource: /edev/1/fsa
+    actions:
+      # Trigger notification
+      - type: set-comms-rate
+        parameters:
+          fsa_list_poll_seconds: 30
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-SUBSCRIPTION-FSAL
+
+  # (m, n, o, p, q, r)
+  # Wait for a DERProgram subscription and then update the active DERProgram list to trigger a notification
+  POST-SUBSCRIPTION-DERP:
+    instructions:
+      - Trigger a DERProgramList subscription request from the aggregator client system.
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/0/sub
+        serve_request_first: true
+      checks:
+        - type: subscription-contents
+          parameters: 
+            subscribed_resource: /edev/1/fsa/1/derp
+    actions:
+      # Trigger notification
+      - type: create-der-program
+        parameters:
+          primacy: 99
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-SUBSCRIPTION-DERP
+
+  # (s, t, u, v, w, x)
+  # Wait for a subscription to /edev/1/derp/1/derc and then create a DERControl to trigger a notification
+  POST-SUBSCRIPTION-DERC:
+    instructions:
+      - Trigger a DERControlList subscription request from the aggregator client system.
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/0/sub
+        serve_request_first: true
+      checks:
+        - type: subscription-contents
+          parameters: 
+            subscribed_resource: /edev/1/derp/1/derc
+    actions:
+      # Trigger notification
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 600
+          primacy: 0
+          opModExpLimW: 0
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-SUBSCRIPTION-DERC
+
+  # (y, z, aa, bb, cc)
+  # Wait for a subscription to /edev/1/derp/1/dderc and then update the DefaultDERControl to trigger a notification
+  POST-SUBSCRIPTION-DEFAULT-DERC:
+    instructions:
+      - Trigger a DefaultDERControl subscription request from the aggregator client system.
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev/0/sub
+        serve_request_first: true
+      checks:
+        - type: subscription-contents
+          parameters: 
+            subscribed_resource: /edev/1/derp/1/dderc
+    actions:
+      # Trigger notification
+      - type: set-default-der-control
+        parameters:
+          opModImpLimW: 1234
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-SUBSCRIPTION-DEFAULT-DERC