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

cactus_test_definitions/client/procedures/ALL-29.yaml

@@ -0,0 +1,87 @@
+Description: Validate Operating Telemetry
+Category: DER
+Classes:
+  - DER-A
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+
+    # Test is ~11 minutes of waiting which should leave enough time for at least 9 reading posts
+    - type: readings-site-active-power
+      parameters: {"minimum_count": 9} 
+    - type: readings-der-active-power
+      parameters: {"minimum_count": 9}
+
+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: 120
+        opModExpLimW: $(setMaxW * 2)
+        opModImpLimW: $(setMaxW * 2)
+    - type: create-der-control
+      parameters:
+        start: $(now + '2 minutes')
+        duration_seconds: 120
+        opModExpLimW: $(setMaxW * 0.3)
+        opModImpLimW: $(setMaxW * 0.3)
+    - type: create-der-control
+      parameters:
+        start: $(now + '4 minutes')
+        duration_seconds: 120
+        opModExpLimW: $(setMaxW * 0.2)
+        opModImpLimW: $(setMaxW * 0.2)
+    - type: create-der-control
+      parameters:
+        start: $(now + '6 minutes')
+        duration_seconds: 120
+        opModExpLimW: $(setMaxW * 0.1)
+        opModImpLimW: $(setMaxW * 0.1)
+    - type: create-der-control
+      parameters:
+        start: $(now + '8 minutes')
+        duration_seconds: 120
+        opModExpLimW: 0
+        opModImpLimW: 0
+  instructions:
+    - DER is operating at least 50% if its rated power.
+    - Connect a test load electrically in parallel with the DER.
+    - Set the load to consume 10% of the DER's rated active power.
+
+Steps:
+  
+  WAIT-TEST-END:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 660 # Wait for all controls to expire
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: finish-test
+        parameters: {}
+    instructions:
+      - Client should continue submitting regular readings for the duration of the test.

cactus_test_definitions/client/procedures/ALL-30.yaml

@@ -0,0 +1,188 @@
+Description: Persisting Settings Through Reconnection
+Category: DER
+Classes:
+  - DER-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: {}
+    - type: der-settings-contents
+      parameters: {}
+  actions:
+    - type: set-default-der-control
+      parameters:
+        opModExpLimW: $(setMaxW * 0.3)
+        opModImpLimW: $(setMaxW * 0.3)
+        
+  instructions:
+    - DER is operating at least 50% if its rated power.
+
+Steps:
+  
+  # (precondition)
+  PRECONDITION-STARTUP:
+    instructions:
+      - This step is to give time for the DER to start importing/exporting at least 50% of its rated power.
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 240
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+      - type: enable-steps
+        parameters:
+          steps:
+            - PRECONDITION-STARTUP-WAIT
+      - type: remove-steps
+        parameters:
+          steps:
+            - PRECONDITION-STARTUP
+  
+  # (precondition)
+  PRECONDITION-STARTUP-WAIT:
+    instructions:
+      - This step is to give time for the DER to start importing/exporting at least 50% of its rated power.
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 120
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DEFAULT-DERC
+      - type: remove-steps
+        parameters:
+          steps:
+            - PRECONDITION-STARTUP-WAIT
+
+  # (precondition) - Wait for the DefaultDERControl to be picked up
+  GET-DEFAULT-DERC:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/dderc
+        serve_request_first: true
+    actions:
+      - type: communications-status
+        parameters:
+          enabled: false
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-POWER-OFF
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DEFAULT-DERC
+
+  # (a, b, c)
+  WAIT-POWER-OFF:
+    instructions:
+      - Power cycle (turn off then back on again) the communications client, and while it is offline, disable the communications interface between the client and utility server (e.g. by unplugging an appropriate network cable).
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 120 # Wait for two polls
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 900
+          opModExpLimW: $(setMaxW * 0.5)
+          opModImpLimW: $(setMaxW * 0.5)
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-POWER-ON
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-POWER-OFF
+  
+  # (d)
+  WAIT-POWER-ON:
+    instructions:
+      - Re-establish communications between the client and utility server (e.g. by plugging the network cable back in).
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 180 
+    actions:
+      - type: communications-status
+        parameters:
+          enabled: true
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-UPDATED-DERC
+            - POST-RESPONSE-STARTED
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-POWER-ON
+
+
+  # (e)
+  GET-UPDATED-DERC:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 900
+          opModExpLimW: $(setMaxW * 0.5)
+          opModImpLimW: $(setMaxW * 0.5)
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-UPDATED-DERC
+
+  # (e)
+  POST-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-RESPONSE-STARTED
+    

cactus_test_definitions/client/procedures/BES-01.yaml

@@ -0,0 +1,136 @@
+Description: Individual readings - storage
+Category: Monitoring
+Classes:
+  - L
+
+TargetVersions:
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+
+    # Test includes ~ 5 minutes of waiting + initial reading sent during test
+    # A minimum of 4 readings is required by the test procedure
+    - type: readings-der-stored-energy
+      parameters: { "minimum_count": 4 }
+
+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
+    # Placeholder for later controls
+    - type: create-der-program
+      parameters:
+        primacy: 0
+        fsa_id: 1
+
+  checks:
+    - type: end-device-contents
+      parameters: {}
+
+Steps:
+  GET-MUP:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /mup
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - POST-MUP
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-MUP
+
+  POST-MUP:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /mup
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-MUP-2
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-MUP
+
+  GET-MUP-2:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /mup
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-READINGS
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-MUP-2
+
+  # Wait for at least 2 readings to arrive
+  WAIT-READINGS:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 180 # Wait for at least 2 sets of readings to arrive (with post rate 60 seconds)
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-READINGS
+
+  # On this poll, client will discover new 0W control is in place
+  GET-DERC:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 600
+          opModStorageTargetW: 0
+          primacy: 0
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC
+
+  # This just lets the test run for a few more posts after the control comes into effect
+  # after which, we will force the test to shutdown (as Criteria is partially defined by this ONLY running for a few posts)
+  WAIT-CONTROL:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 180 # Wait for at least 3 sets of readings to arrive (with post rate 60 seconds)
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL
+      - type: finish-test
+        parameters: {}

cactus_test_definitions/client/procedures/BES-02.yaml

@@ -0,0 +1,137 @@
+Description: Capabilities and settings - storage
+Category: Monitoring
+Classes:
+  - L
+
+TargetVersions:
+  - v1.3-beta/storage
+
+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
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+    - type: der-capability-contents
+      parameters: {
+        "rtgMaxChargeRateW": "$(this > 0)",
+        "rtgMaxDischargeRateW": "$(this > 0)",
+        "rtgMaxWh": "$(this > 0)",
+        "vppModesSupported_set": "01",
+      }
+    - type: der-settings-contents
+      parameters: {
+        "setMaxChargeRateW": "$(this <= rtgMaxChargeRateW)",
+        "setMaxDischargeRateW": "$(this <= rtgMaxDischargeRateW)",
+        "setMaxWh": "$(this <= rtgMaxWh)",
+        "setMinWh": "$(this >= 0)",
+        "vppModesEnabled_set": "01",
+      }
+
+Steps:
+  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
+
+  PUT-DERSTATUS:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/ders
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-2
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS
+
+  PUT-DERCAPABILITY:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/dercap
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERCAPABILITY-2
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERCAPABILITY
+
+  PUT-DERSETTINGS:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/derg
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS-2
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS
+
+
+  PUT-DERSTATUS-2:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/ders
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-2
+  
+  PUT-DERCAPABILITY-2:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/dercap
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERCAPABILITY-2
+
+  PUT-DERSETTINGS-2:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/der/1/derg
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSETTINGS-2
+

cactus_test_definitions/client/procedures/BES-03.yaml

@@ -0,0 +1,135 @@
+Description: Storage Control - opModStorageTargetW
+Category: Control
+Classes:
+  - L
+
+TargetVersions:
+  - 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-control
+      parameters:
+        start: $(now + '300 seconds')
+        duration_seconds: 900
+        opModStorageTargetW: $(rtgMaxDischargeRateW * 0.5)
+
+Steps:
+  # On this poll a new control will be discovered with opModStorageTargetW == 50% rtgMaxDischargeRateW
+  GET-DERC-1:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-END-1
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-1
+
+  # Waits for the new control to finish (with a bit of overtime)
+  WAIT-CONTROL-END-1:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 1260
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-2
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-END-1
+
+  # On this poll a new control will be discovered with 0W opModStorageTargetW
+  GET-DERC-2:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now + '300 seconds')
+          duration_seconds: 900
+          opModStorageTargetW: 0
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-END-2
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-2
+
+  # Waits for the new control to finish (with a bit of overtime)
+  WAIT-CONTROL-END-2:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 1260
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DERC-3
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-END-2
+
+  # On this poll a new control will be discovered with opModStorageTargetW == -50% rtgMaxChargeRateW
+  GET-DERC-3:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/derp/1/derc
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now + '300 seconds')
+          duration_seconds: 900
+          opModStorageTargetW: $(0.5 * negRtgMaxChargeRateW) # Negative value
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-END-3
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DERC-3
+
+  # Waits for the new control to finish (with a bit of overtime)
+  WAIT-CONTROL-END-3:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 1260
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL-END-3