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

cactus_test_definitions/client/procedures/ALL-03.yaml

@@ -0,0 +1,110 @@
+Description: Connection Point registration
+Category: Registration
+Classes:
+  - C
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+    - type: end-device-contents
+      parameters:
+        has_connection_point_id: true
+        check_lfdi: true
+
+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:
+  GET-DCAP:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /dcap
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-EDEV
+            - GET-TM
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DCAP
+
+  GET-EDEV:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - POST-EDEV
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-EDEV
+
+  GET-TM:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /tm
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-TM
+
+  POST-EDEV:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DER
+            - PUT-CP
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-EDEV
+
+  GET-DER:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/der
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DER
+
+  PUT-CP:
+    event:
+      type: PUT-request-received
+      parameters:
+        endpoint: /edev/1/cp
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-CP

cactus_test_definitions/client/procedures/ALL-04.yaml

@@ -0,0 +1,69 @@
+Description: Client Registration and PIN Validation
+Category: Registration
+Classes:
+  - A
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      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: register-end-device
+      parameters:
+        registration_pin: 11111 # With checksum is 111115
+        aggregator_lfdi: 3E4F45AB31EDFE5B67E343E5E4562E3100000000 # Trailing PEN digits set to 0
+        aggregator_sfdi: 16726121139
+
+
+Steps:
+  # (e, f, g)
+  GET-REGISTRATION:
+    instructions:
+      - "An EndDevice has already been registered (out of band) with PIN 111115"
+      - "[Aggregator Client Only] LFDI: 3E4F45AB31EDFE5B67E343E5E4562E31XXXXXXXX (The X values will match your client PEN)"
+      - "[Aggregator Client Only] SFDI: 16726121139"
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/rg
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-REGISTRATION
+
+  # (h)
+  WAIT-TEST-END:
+    instructions:
+      - The client should continue communicating with the utility server after validating that the PIN matches.
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 120
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - WAIT-TEST-END
+      - type: finish-test
+        parameters: {}

cactus_test_definitions/client/procedures/ALL-05.yaml

@@ -0,0 +1,117 @@
+Description: Client Response to Lack of RegistrationLink 
+Category: Registration
+Classes:
+  - A
+
+TargetVersions:
+  - v1.2
+  - 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
+  actions:
+    - type: 'edev-registration-links'
+      parameters:
+        enabled: false
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+
+# Note - these steps aren't annotated with the TS 5573 test procedure steps due to them having some dubious
+# references to links appearing in the wrong entities / unusual ordering
+# 
+# The steps still represent the "intended" interpretation of a client continuing to undergo normal in band registration
+# despite the EndDevice registration links being removed.
+Steps:
+  GET-DCAP:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /dcap
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-EDEV
+            - GET-TM
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DCAP
+  
+  GET-EDEV:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - POST-EDEV
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-EDEV
+  
+  GET-TM:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /tm
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-TM
+  
+  POST-EDEV:
+    event:
+      type: POST-request-received
+      parameters:
+        endpoint: /edev
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - GET-DER
+            - GET-FSA
+      - type: remove-steps
+        parameters:
+          steps:
+            - POST-EDEV
+  
+  GET-FSA:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/fsa
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-FSA
+
+  GET-DER:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /edev/1/der
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-DER
+
+  

cactus_test_definitions/client/procedures/ALL-06.yaml

@@ -0,0 +1,128 @@
+Description: Individual Readings
+Category: Monitoring
+Classes:
+  - A
+  - DR-A
+
+TargetVersions:
+  - v1.2
+  - v1.3-beta/storage
+
+Criteria:
+  checks:
+    - type: all-steps-complete
+      parameters: {}
+
+    # Test is ~8 minutes of waiting which should leave enough time for at least 6 reading posts
+    - type: readings-site-active-power
+      parameters: {"minimum_count": 6} 
+    - type: readings-site-reactive-power
+      parameters: {"minimum_count": 6}
+    - type: readings-voltage
+      parameters: {"minimum_count": 6}
+    - type: readings-der-active-power
+      parameters: {"minimum_count": 6}
+    - type: readings-der-reactive-power
+      parameters: {"minimum_count": 6}
+
+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
+  instructions:
+    - Connect a test load electrically in parallel with the DER.
+    - Set the load to consume 25% of the DER's rated active power.
+
+Steps:
+  # (b, c)
+  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
+  # (d, e) 
+  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
+
+  # (f, g)
+  GET-MUP-2:
+    event:
+      type: GET-request-received
+      parameters:
+        endpoint: /mup
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - SET-CONTROL
+      - type: remove-steps
+        parameters:
+          steps:
+            - GET-MUP-2
+
+  # (h) - Will be validated via test criteria
+  # (i, j, k)
+  SET-CONTROL:
+    event:
+      type: wait
+      parameters:
+        duration_seconds: 300 # Wait for at least 4 sets of readings to arrive (with post rate 60 seconds)
+    actions:
+      - type: create-der-control
+        parameters:
+          start: $(now)
+          duration_seconds: 300
+          opModImpLimW: 0
+          opModExpLimW: 0
+      - type: enable-steps
+        parameters:
+          steps:
+            - WAIT-CONTROL
+      - type: remove-steps
+        parameters:
+          steps:
+            - SET-CONTROL
+
+  # 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)
+  # (j, k)
+  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/ALL-07.yaml

@@ -0,0 +1,76 @@
+Description: Connection Status
+Category: Monitoring
+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: {}
+    - type: der-status-contents
+      parameters: 
+        genConnectStatus_bit0: true
+
+Steps:
+  
+  # (b, c)
+  PUT-DERSTATUS-DISCONNECT:
+    instructions:
+      - Disconnect all DER from the grid.
+    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
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-DISCONNECT
+  
+  # (d, e)
+  PUT-DERSTATUS-CONNECT:
+    instructions:
+      - Reconnect all DER to the grid.
+    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

cactus_test_definitions/client/procedures/ALL-08.yaml

@@ -0,0 +1,78 @@
+Description: Operational Mode Status
+Category: Monitoring
+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: {}
+    - type: der-status-contents
+      parameters: 
+        operationalModeStatus: 2
+  instructions:
+    - DER shall be generating or consuming at least 50% of the DER's active power rating.
+      
+Steps:
+  
+  # (c, d)
+  PUT-DERSTATUS-DISCONNECT:
+    instructions:
+      - Stop DER from generating or consuming active power. (e.g. power source/sink is set to 0W)
+    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
+    actions:
+      - type: enable-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-CONNECT
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-DISCONNECT
+  
+  # (e, f)
+  PUT-DERSTATUS-CONNECT:
+    instructions:
+      - Re-enable ability of DER to generate or consume active power.
+    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
+    actions:
+      - type: remove-steps
+        parameters:
+          steps:
+            - PUT-DERSTATUS-CONNECT

cactus_test_definitions/client/procedures/ALL-09.yaml

@@ -0,0 +1,103 @@
+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:
+        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:
+        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