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

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

cactus_test_definitions/client/procedures/ALL-15.yaml

@@ -0,0 +1,109 @@
+Description: Active Controls – Energize/de-energize
+Category: Control
+Classes:
+  # Note - A is explicitly omitted, this test is ONLY for subscription clients
+  - 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 this to a large value - testing they respond due to notification - not polling
+        derp_list_poll_seconds: 900 # Set this to a large value - testing they respond due to notification - not polling
+        mup_post_seconds: 60
+    - type: create-der-program
+      parameters:
+        primacy: 0
+    
+  checks:
+    - type: end-device-contents
+      parameters: {}
+    - type: subscription-contents
+      parameters:
+        subscribed_resource: /edev/1/derp/1/derc
+
+  actions:
+    - type: create-der-control
+      parameters:
+        start: $(now)
+        duration_seconds: 300
+        opModEnergize: false
+  instructions:
+    - EndDevice should be registered with active subscriptions before starting.
+    - DER shall be generating or consuming at least 50% of its active power rating.
+
+Steps:
+
+  # (c, d)
+  PUT-DERSTATUS-DEENERGIZE:
+    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: 
+            genConnectStatus_bit2: false
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-ENERGIZE
+            - WAIT-TEST-END
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 600
+          opModEnergize: true
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-DEENERGIZE
+
+  # (f)
+  PUT-DERSTATUS-ENERGIZE:
+    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: 
+            genConnectStatus_bit2: true
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-ENERGIZE
+
+  # (e) We give the client a short period to respond with a re-energize
+  WAIT-TEST-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 180
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: finish-test
+        parameters: {}

cactus_test_definitions/client/procedures/ALL-16.yaml

@@ -0,0 +1,102 @@
+Description: Active Controls – Disconnect
+Category: Control
+Classes:
+  # Note - A is explicitly omitted, this test is ONLY for subscription clients
+  - 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 this to a large value - testing they respond due to notification - not polling
+        derp_list_poll_seconds: 900 # Set this to a large value - testing they respond due to notification - not polling
+        mup_post_seconds: 60
+  checks:
+    - type: end-device-contents
+      parameters: {}
+  actions:
+    # (a, b)
+    - type: create-der-control
+      parameters:
+        start: $(now)
+        duration_seconds: 300
+        opModConnect: false
+  instructions:
+    - EndDevice should be registered with active subscriptions before starting.
+    - DER shall be generating or consuming at least 50% of its active power rating.
+    
+Steps:
+  
+  # (c, d)
+  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
+      # Only trigger this if the server has an updated DERStatus
+      checks:
+        - type: der-status-contents
+          parameters: 
+            genConnectStatus_bit0: false
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-CONNECT
+            - WAIT-TEST-END
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 600
+          opModConnect: true
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-DISCONNECT
+
+  # (f)
+  PUT-DERSTATUS-CONNECT:
+    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: 
+            genConnectStatus_bit0: true
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-CONNECT
+
+  # (e) We give the client a short period to respond with a reconnect
+  WAIT-TEST-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 180
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: finish-test
+        parameters: {}

cactus_test_definitions/client/procedures/ALL-17.yaml

@@ -0,0 +1,63 @@
+Description: Default Controls – Ramp Rate
+Category: Control
+Classes:
+  # Note - A is explicitly omitted, this test is ONLY for subscription clients
+  - 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 this to a large value - testing they respond due to notification - not polling
+        derp_list_poll_seconds: 900 # Set this to a large value - testing they respond due to notification - not polling
+        mup_post_seconds: 60
+    - type: create-der-program
+      parameters:
+        primacy: 0
+
+  checks:
+    - type: end-device-contents
+      parameters: {}
+    - type: subscription-contents
+      parameters:
+        subscribed_resource: /edev/1/derp/1/dderc
+
+  actions:
+    # (a)
+    - type: set-default-der-control
+      parameters:
+        setGradW: 100 # hundredths of a percent - this is 1%
+    
+Steps:
+  
+  # (b, c)
+  # This will wait until the client POST's a DERSettings with the 1% setGradW
+  PUT-DERSETTINGS-SET-GRAD-W:
+    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: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS-SET-GRAD-W