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

cactus_test_definitions/server/procedures/S-ALL-25.yaml

@@ -0,0 +1,151 @@
+Description: Subscribe
+Category: Subscription / Notification
+Classes:
+ - A
+
+TargetVersions:
+ - v1.2
+
+Preconditions:
+  required_clients:
+    - id: client
+  
+Steps:
+  - id: PRECONDITION
+    repeat_until_pass: true
+    instructions:
+      - Create an EndDevice registration for client.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - EndDevice
+          - FunctionSetAssignments
+          - DERProgram
+          - SubscriptionList
+    checks:
+      - type: end-device 
+        parameters:
+          matches_client: true
+
+  - id: EDEV LIST SUBSCRIBE
+    action: 
+      type: create-subscription
+      parameters:
+        sub_id: edev_list_sub
+        resource: EndDeviceList
+
+  - id: AWAIT EDEV LIST NOTIFICATION
+    repeat_until_pass: true
+    instructions:
+      - Change the EndDeviceList to have a pollRate of 30 seconds. Ensure it sends a Notification.
+    action: 
+      type: notifications
+      parameters:
+        sub_id: edev_list_sub
+        collect: true
+    checks:
+      - type: end-device-list
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          poll_rate: 30
+          sub_id: edev_list_sub
+
+  - id: FSA LIST SUBSCRIBE
+    action: 
+      type: create-subscription
+      parameters:
+        sub_id: fsa_list_sub
+        resource: FunctionSetAssignmentsList
+    
+  - id: AWAIT FSA LIST NOTIFICATION
+    repeat_until_pass: true
+    instructions:
+      - Add a new FunctionSetAssignment to client EndDevice. Ensure it sends a Notification.
+    action: 
+      type: notifications
+      parameters:
+        sub_id: fsa_list_sub
+        collect: true
+    checks:
+      - type: function-set-assignment
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          matches_client_edev: true
+          sub_id: fsa_list_sub
+
+
+  # At this point the client will have a FunctionSetAssignment with a LINK to a DERProgramList but NO
+  # physical record of that DERProgramList - we can't just subscribe to a ListLink.href as the actual underlying
+  # record might NOT be subscribable (we can only discover that by resolving the record)
+  #
+  # For these reasons - we are forced to actually resolve the DERProgramList via discovery.
+  - id: DISCOVER NEW DERP LIST
+    action:
+      type: discovery
+      parameters:
+        resources:
+          - DERProgramList
+
+  - id: DERP LIST SUBSCRIBE
+    action: 
+      type: create-subscription
+      parameters:
+        sub_id: derp_list_sub
+        resource: DERProgramList
+
+  - id: AWAIT DERP LIST NOTIFICATION
+    repeat_until_pass: true
+    instructions:
+      - Add a new DERProgram to the newly created FunctionSetAssignment. Ensure it sends a Notification.
+    action: 
+      type: notifications
+      parameters:
+        sub_id: derp_list_sub
+        collect: true
+    checks:
+      - type: der-program
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          fsa_index: -1 # Must belong to the latest FunctionSetAssignment
+          sub_id: derp_list_sub
+
+  # Same as above - we don't have the DefaultDERControl (only a link) - we need to resolve it
+  - id: DISCOVER NEW DERC
+    repeat_until_pass: true
+    instructions:
+      - Add a DefaultDERControl to the recently created DERProgram. Ensure it's subscribable.
+    action:
+      type: discovery
+      parameters:
+        resources:
+          - DefaultDERControl
+    checks:
+      - type: default-der-control
+        parameters: 
+          minimum_count: 1
+
+  - id: DEFAULT DERC SUBSCRIBE
+    action: 
+      type: create-subscription
+      parameters:
+        sub_id: dderc_sub
+        resource: DefaultDERControl
+
+  - id: AWAIT DEFAULT DERC NOTIFICATION
+    repeat_until_pass: true
+    instructions:
+      - Adjust the DefaultDERControl to have opModeExpLimW 2000 W. Ensure it sends a Notification.
+    action: 
+      type: notifications
+      parameters:
+        sub_id: dderc_sub
+        collect: true
+    checks:
+      - type: default-der-control
+        parameters:
+          opModExpLimW: 2000
+          sub_id: dderc_sub

cactus_test_definitions/server/procedures/S-ALL-41.yaml

@@ -0,0 +1,343 @@
+Description: Control Responses
+Category: Control
+Classes:
+ - A
+
+TargetVersions:
+ - v1.2
+
+Preconditions:
+  required_clients:
+    - id: client
+  
+Steps:
+  - id: (A) PRECONDITION
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - Create an EndDevice registration.
+      - Configure an active control with opModExpLimW and opModImpLimW = 200% of the DERs rated active power, responseRequired = 03, and replyTo set to the response endpoint on the test utility server.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - EndDevice
+          - DERControl
+    checks:
+      - type: end-device 
+        parameters:
+          matches_client: true 
+      - type: der-control
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+          # replyTo should also be set but this check is implicit in later communications
+          event_status: 0 # Scheduled
+
+
+################################## TEST SECTION 1 - Receive, Start, Complete ##################################
+
+
+  - id: (1b) DERControl 1 - Received
+    client: client
+    action:
+      type: respond-der-controls # send response status = 1 (received) immediately after it is sent
+
+  - id: (2) DERControl 1 - Active
+    repeat_until_pass: True # The first DER Control can start any time and be of any duration.
+    client: client
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DERControl
+    checks:
+      - type: der-control # Check event status has been updated
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+          event_status: 1 # Active
+  
+  - id: (2b) DERControl 1 - Started
+    client: client
+    action: 
+      type: respond-der-controls # send response status = 2 (started)
+    
+  - id: (3) DERControl 1 - Completed
+    repeat_until_pass: true # Wait until event status has been updated
+    client: client
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DERControl
+    checks:
+      - type: der-control # Check event status has been updated
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+          event_status: 2 # Completed
+
+  - id: (3b) DERControl 1 - Completed
+    client: client
+    action:
+      type: respond-der-controls # send response status = 3 (Completed)
+
+  - id: WAIT for completed DERControl to be removed from server (20 seconds buffer from completion time)
+    client: client
+    action:
+      type: wait
+      parameters:
+        duration_seconds: 20
+
+  - id: CLEAR OUT DERControls
+    client: client
+    instructions: The server should clear out the completed control ready to begin the next controls.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - DERControl
+    checks:
+      - type: der-control
+        parameters:
+          maximum_count: 0  # Empty list of controls
+
+
+################################## TEST SECTION 2 - CANCELLATION ##################################
+  
+
+  - id: (4) DERControl 2
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - The utility server is configured with an active control with opModExpLimW and opModImpLimW = 200% of the DERs rated active power, responseRequired = 03 and replyTo set to the response endpoint on the test utility server, to begin in 5 minutes.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - DERControl
+    checks:
+      - type: der-control
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+          responseRequired: 3
+          # replyTo should also be set but this check is implicit in later communications
+          event_status: 0 # Scheduled
+          # start time should be set to 5 mins, check is implicit in the next step
+  
+  - id: (4b) DERControl 2 - Received
+    client: client
+    action: 
+      type: respond-der-controls # send response status = 1 (Received)
+  
+  - id: WAIT for DERControl start time
+    client: client
+    action:
+      type: wait
+      parameters:
+        duration_seconds: 320 # 5 minutes and 20 second buffer
+
+  - id: (4c) DERControl 2 - Started
+    client: client
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DERControl
+    checks:
+      - type: der-control # Check event status has been updated
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+          event_status: 1 # Active
+
+  - id: (4d) DERControl 2 - Started
+    client: client
+    action:
+      type: respond-der-controls # send response status = 2 (Started)
+
+  - id: (5) DERControl 2 - Cancelled.
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - The utility server is configured to cancel the active control while it is still active.
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DERControl
+    checks:
+      - type: der-control
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+          responseRequired: 3
+          event_status: 2 # Cancelled
+  
+  - id: CHECK pt. 1 - Cancelled DERControl isnt just removed immediately (client has a chance to see cancellation)
+    client: client
+    action:
+      type: wait
+      parameters:
+        duration_seconds: 10 # little buffer to check behaviour
+  
+  - id: CHECK pt. 2 - Cancelled DERControl isnt just removed immediately (client has a chance to see cancellation)
+    client: client
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DERControl
+    checks:
+      - type: der-control # Check DER Control still exists
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+          event_status: 2 # Cancelled
+
+  - id: (5b) DERControl 2 - Respond to cancelled DERControl
+    client: client
+    action: 
+      type: respond-der-controls # Will post control response status = 6 (cancelled).
+
+  - id: CLEAR OUT DERControls for next section of the test
+    repeat_until_pass: true
+    client: client
+    instructions: The server should clear out the cancelled control ready to begin the next controls (not written but makes next section easier to test).
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - DERControl
+    checks:
+      - type: der-control
+        parameters:
+          maximum_count: 0  # Empty list of controls
+
+
+################################## TEST SECTION 3 - SUPERSEEDED ##################################
+
+
+  - id: (6) DERControl 3
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - The utility server is configured with an active control with opModExpLimW and opModImpLimW = 200% of the DERs rated active power, responseRequired = 03 and replyTo set to the response endpoint on the test utility server, to begin in 10 minutes.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - DERControl
+    checks:
+      - type: der-control
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+          responseRequired: 3
+          # replyTo should also be set but this check is implicit in later communications
+          event_status: 0 # Scheduled
+          # start time should be set to 10 mins but we do not check here
+  
+  - id: (6b) Respond to scheduled DERControl 3
+    client: client
+    action: 
+      type: respond-der-controls # Respond status = 1 (received).
+
+  - id: (7) DERControl 3 - Cancel
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - The utility server is configured to cancel the scheduled control before it is active.
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DERControl
+    checks:
+      - type: der-control
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+          responseRequired: 3
+          event_status: 2 # Cancelled
+
+  - id: (7b) Respond to cancelled DERControl 3
+    client: client
+    action: 
+      type: respond-der-controls # Will post control response status = 6 (cancelled).
+
+  - id: (8) DERControl 4
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - The utility server configures an active control with opModExpLimW and opModImpLimW = 200% of the DERs rated active power to begin in 10 minutes.
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DERControl
+    checks:
+      - type: der-control
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+          event_status: 0 # Scheduled
+
+  - id: (8b) Respond to scheduled DERControl 4
+    client: client
+    action: 
+      type: respond-der-controls # Will post control response status = 1 (received).
+
+  - id: (9) DERControl 5
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - The utility server configures an active control with the same primacy and an overlapping control window.
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DERControl
+    checks:
+      - type: der-control
+        parameters:
+          minimum_count: 1 # The control above should now be set to superseeded not scheduled, so still only one expected.
+          maximum_count: 1
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+          event_status: 0 # Scheduled
+
+  - id: (9b) Respond to scheduled DERControls 4 and 5
+    client: client
+    action: 
+      type: respond-der-controls # Send both: control 4 (7 superseeded), and control 5 (1 scheduled).
+
+  - id: (9c) Check DERControl 4 is superseeded
+    repeat_until_pass: true
+    client: client
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DERControl
+    checks:
+      - type: der-control
+        parameters:
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW * 2)
+          event_status: 4 # Superseeded
+          minimum_count: 1
+          maximum_count: 1

cactus_test_definitions/server/procedures/S-ALL-42.yaml

@@ -0,0 +1,81 @@
+Description: Delayed Response to Cancelled Export Control
+Category: Control
+Classes:
+ - A
+
+TargetVersions:
+ - v1.2
+
+Preconditions:
+  required_clients:
+    - id: client
+  
+Steps:
+  - id: (A) PRECONDITION
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - The client has a DER that is exporting at the connection point at least 50% of its rated active power.
+      - The utility server has a current active control in operation with opModExpLimW set to 200% of the DER's rated active power, and a default DER control in-place with opModExpLimW set to 30% of the DER's rated active power.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - EndDevice
+          - DERControl
+          - DefaultDERControl
+    checks:
+      - type: end-device 
+        parameters:
+          matches_client: true 
+      - type: der-control
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          opModExpLimW: $(setMaxW * 2)
+          event_status: 1 # Active
+      - type: default-der-control
+        parameters:
+          opModExpLimW: $(setMaxW * 0.3)
+
+  - id: (1) Cancel active controls
+    repeat_until_pass: True
+    instructions: The server should set all active controls to cancelled.
+    client: client
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DERControl
+    checks:
+      - type: der-control # Check event status has been updated
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          opModExpLimW: $(setMaxW * 2)
+          event_status: 2 # Cancelled
+  
+  - id: WAIT to see that cancelled responses are not immediately removed
+    client: client
+    action:
+      type: wait
+      parameters:
+        duration_seconds: 60
+
+  - id: (2) CHECK to see that cancelled responses are not immediately removed
+    client: client
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DERControl
+    checks:
+      - type: der-control
+        parameters:
+          minimum_count: 1
+          maximum_count: 1
+          opModExpLimW: $(setMaxW * 2)
+          event_status: 2 # Cancelled
+  
+  - id: (3) Response
+    client: client
+    action:
+      type: respond-der-controls # send response status = 6 (Cancelled)

cactus_test_definitions/server/procedures/S-ALL-43.yaml

@@ -0,0 +1,146 @@
+Description: Update Poll Rates
+Category: Control
+Classes:
+ - A
+
+TargetVersions:
+ - v1.2
+
+Preconditions:
+  required_clients:
+    - id: client
+  
+Steps:
+  - id: (A) PRECONDITION
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - The client has a device with DeviceCapability, EndDeviceList and FunctionSetAssignmentsList poll-rate set to 300s, DERProgramList, DERList and MirrorUsagePoint to 60s.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - EndDevice
+          - DeviceCapability
+          - EndDeviceList
+          - FunctionSetAssignmentsList
+          - DERProgramList
+          - DERList
+          - MirrorUsagePoint
+    checks:
+      - type: poll-rate
+        parameters:
+          resource: DeviceCapability
+          poll_rate_seconds: 300
+      - type: poll-rate
+        parameters:
+          resource: EndDeviceList
+          poll_rate_seconds: 300
+      - type: poll-rate
+        parameters:
+          resource: FunctionSetAssignmentsList
+          poll_rate_seconds: 300
+      - type: poll-rate
+        parameters:
+          resource: DERProgramList
+          poll_rate_seconds: 60
+      - type: poll-rate
+        parameters:
+          resource: DERList
+          poll_rate_seconds: 60
+      - type: poll-rate
+        parameters:
+          resource: MirrorUsagePoint
+          poll_rate_seconds: 60
+  
+  - id: (1) UPDATE DeviceCapability poll-rate
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - Set DeviceCapabilitypoll poll rate to 60s.
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DeviceCapability
+    checks:
+      - type: poll-rate
+        parameters:
+          resource: DeviceCapability
+          poll_rate_seconds: 60
+
+  - id: (2) UPDATE EndDeviceList poll-rate
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - Set EndDeviceList poll rate to 60s.
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: EndDeviceList
+    checks:
+      - type: poll-rate
+        parameters:
+          resource: EndDeviceList
+          poll_rate_seconds: 60
+    
+  - id: (3) UPDATE FunctionSetAssignments poll-rate
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - Set FunctionSetAssignments poll rate to 60s.
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: FunctionSetAssignments
+    checks:
+      - type: poll-rate
+        parameters:
+          resource: FunctionSetAssignments
+          poll_rate_seconds: 60
+
+  - id: (4) UPDATE DERProgramList poll-rate
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - Set DERProgramList poll rate to 120s.
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DERProgramList
+    checks:
+      - type: poll-rate
+        parameters:
+          resource: DERProgramList
+          poll_rate_seconds: 120
+
+  - id: (5) UPDATE DERList poll-rate
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - Set DERList poll rate to 120s.
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: DERList
+    checks:
+      - type: poll-rate
+        parameters:
+          resource: DERList
+          poll_rate_seconds: 120
+
+  - id: (6) UPDATE MirrorUsagePoint poll-rate
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - Set MirrorUsagePoint poll rate to 120s.
+    action: 
+      type: refresh-resource
+      parameters:
+        resource: MirrorUsagePoint
+    checks:
+      - type: poll-rate
+        parameters:
+          resource: MirrorUsagePoint
+          poll_rate_seconds: 120
+  
+