From 8360b1f3939ffa1e112536db35c83d1f19f8a3f8 Mon Sep 17 00:00:00 2001
From: pstaeck <36667270+pstaeck@users.noreply.github.com>
Date: Wed, 18 Oct 2023 09:06:48 +0200
Subject: [PATCH] New manip modify invocation effective timeout (#69)

Add a manipulation that triggers the
device to set @InvocationEffectiveTimeout less than or equal to the
requested threshold.

# Checklist

The following aspects have been respected by the author of this pull
request, confirmed by both pull request assignee **and** reviewer:

* Changelog update (necessity checked and entry added or not added
respectively)
  * [x] Pull Request Assignee
  * [x] Reviewer
* README update (necessity checked and entry added or not added
respectively)
  * [x] Pull Request Assignee
  * [x] Reviewer

---------

Co-authored-by: Staeck, Philipp <philipp.staeck.contractor@draeger.com>
---
 CHANGELOG.md                                  |  1 +
 src/t2iapi/operation/operation_requests.proto | 16 +++++++++++++++-
 src/t2iapi/operation/service.proto            |  7 +++++++
 3 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 922169f..8da171b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- manipulation SetInvocationEffectiveTimeoutLessThanOrEqualToThreshold for operations
 - manipulation SetModeOfOperationAndSetOperatingMode for combined settings
 - manipulation ConveyMetricDemoValues for metrics
 - manipulation SetAlertConditionAndAlertSignalActivationState for alert activation states
diff --git a/src/t2iapi/operation/operation_requests.proto b/src/t2iapi/operation/operation_requests.proto
index d49c6f6..6574789 100644
--- a/src/t2iapi/operation/operation_requests.proto
+++ b/src/t2iapi/operation/operation_requests.proto
@@ -10,6 +10,7 @@ syntax = "proto3";
 package t2iapi.operation;
 
 import "t2iapi/operation/types.proto";
+import "google/protobuf/duration.proto";
 
 option java_package = "com.draeger.medical.t2iapi.operation";
 option java_outer_classname = "OperationRequests";
@@ -20,4 +21,17 @@ Request to change the devices state, which results in setting the requested Oper
 message SetOperatingModeRequest {
     string handle = 1;
     OperatingMode operating_mode = 2;
-}
\ No newline at end of file
+}
+
+/*
+Request to set the @InvocationEffectiveTimeout of the pm:AbstractOperationDescriptor with the given handle to a value
+that is less than or equal to the requested threshold.
+*/
+message SetInvocationEffectiveTimeoutLessThanOrEqualToThresholdRequest {
+    string handle = 1;  // handle of the pm:AbstractOperationDescriptor for which the @InvocationEffectiveTimeout
+                        // shall be set
+    google.protobuf.Duration threshold = 2;  // threshold value for which applies that the @InvocationEffectiveTimeout
+                                             // is less than or equal to this threshold value
+                                             // threshold value is represented as a count of seconds and fractions of
+                                             // seconds at nanosecond resolution
+}
diff --git a/src/t2iapi/operation/service.proto b/src/t2iapi/operation/service.proto
index b63b100..18da8bc 100644
--- a/src/t2iapi/operation/service.proto
+++ b/src/t2iapi/operation/service.proto
@@ -29,4 +29,11 @@ service OperationService {
     rpc SetOperatingMode (t2iapi.operation.SetOperatingModeRequest)
         returns (BasicResponse);
 
+    /*
+    Set the @InvocationEffectiveTimeout of the pm:AbstractOperationDescriptor with the given handle to a value that is
+    less than or equal to the requested threshold.
+    */
+    rpc SetInvocationEffectiveTimeoutLessThanOrEqualToThreshold (
+        SetInvocationEffectiveTimeoutLessThanOrEqualToThresholdRequest)
+        returns (BasicResponse);
 }