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

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
+  
+      

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

@@ -0,0 +1,51 @@
+Description: Scheduling
+Category: Control
+Classes:
+ - A
+
+TargetVersions:
+ - v1.2
+
+Preconditions:
+  required_clients:
+    - id: client
+  
+Steps:
+  - id: (A) PRECONDITION
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - The utility server is configured to generate a schedule of 24 sequential, non-overlapping controls with a range of export and/or import limits, each with 1min duration.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - EndDevice
+          - DERControl
+    checks:
+      - type: der-control
+        parameters:
+          minimum_count: 24
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW)
+          event_status: 0 # Scheduled (will ensure non overlapping , superseeded)
+          duration: 60
+  
+  - id: (1) DERControlQuery
+    client: client
+    action: 
+      type: discovery
+      parameters:
+        list_limit: 10  # sets s=0, l=10 for paging
+        resources:
+          - DERControl
+    checks:
+      - type: der-control
+        parameters:
+          minimum_count: 10
+          maximum_count: 10
+          opModExpLimW: $(setMaxW * 2)
+          opModImpLimW: $(setMaxW)
+          event_status: 0
+          duration: 60
+  

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

@@ -0,0 +1,34 @@
+Description: Randomisation
+Category: Control
+Classes:
+ - A
+
+TargetVersions:
+ - v1.2
+
+Preconditions:
+  required_clients:
+    - id: client
+  
+Steps:
+  - id: (A) PRECONDITION
+    repeat_until_pass: true
+    client: client
+    instructions:
+      - The utility server is configured with five sequential, non-overlapping active controls, each with - Duration = 120s, randomizeStart = 60s, opModExpLimW = 200% of the DER's rated active power.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - EndDevice
+          - DERControl
+    checks:
+      - type: der-control
+        parameters:
+          minimum_count: 5
+          maximum_count: 5
+          opModExpLimW: $(setMaxW * 2)
+          randomizeStart: 60
+          event_status: 0 # Scheduled (non-overlapping)
+          duration: 120
+  

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

@@ -0,0 +1,29 @@
+Description: Changing Ramp-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 utility server is configured with a DefaultDERControl with setGradW = 1% per second.
+    action: 
+      type: discovery
+      parameters:
+        resources:
+          - EndDevice
+          - DefaultDERControl
+    checks:
+      - type: default-der-control
+        parameters:
+          minimum_count: 1
+          setGradW: 1