Generalized triggerDescriptorUpdate manipulation to multiple ReportParts.

CHANGELOG.md

@@ -43,6 +43,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     SetMetricValuesWithQualityMode
 - semantics for SetDeviceOperatingMode manipulation
 - message PartialIdentification to message PartialInstanceIdentifier
+- TriggerDescriptorUpdate to request an update for an arbitrary amount of handles
 
 ### Removed
 

src/t2iapi/device/device_requests.proto

@@ -51,3 +51,17 @@ message SetBatteryUsageRequest {
                         // electrical power source
     bool use = 2;       // specifies whether the battery shall be used as the electrical power source
 }
+
+/*
+Request a DescriptionModificationReport that fulfills the following:
+
+For each given handle there exists an "Upt"-ReportPart that contains an updated descriptor, whose @DescriptorHandle
+is equal to the given handle, and that is contained in the DescriptionModificationReport.
+
+---
+
+Note that when no handle is given, every DescriptionModificationReport fulfills the request.
+*/
+message TriggerDescriptorUpdateRequest{
+    repeated string handle = 1;
+}

src/t2iapi/device/service.proto

@@ -89,11 +89,16 @@ service DeviceService {
     rpc RemoveMdsDescriptor (BasicHandleRequest) returns (BasicResponse);
 
     /*
-    Trigger a descriptor update for the provided handle.
-    This manipulation of the device shall result in a msg:DescriptionModificationReport message with a report part with
-    modification type upt.
+    Trigger a DescriptionManipulationReport that fulfills the following:
+
+    For each given handle there exists an "Upt"-ReportPart that contains an updated descriptor, whose @DescriptorHandle
+    is equal to the given handle, and that is contained in the DescriptionModificationReport.
+
+    ---
+
+    Note that when no handle is given, every DescriptionModificationReport fulfills the request.
      */
-    rpc TriggerDescriptorUpdate (BasicHandleRequest) returns (BasicResponse);
+    rpc TriggerDescriptorUpdate (TriggerDescriptorUpdateRequest) returns (BasicResponse);
 
     /*
     Trigger a descriptor update.