Generalized triggerDescriptorUpdate manipulation to multiple ReportParts.

CHANGELOG.md

@@ -41,6 +41,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
+- generalized triggerDescriptorUpdate manipulation to multiple ReportParts
 
 ### Removed
 

src/t2iapi/device/device_requests.proto

@@ -51,3 +51,10 @@ message SetBatteryUsageRequest {
                         // electrical power source
     bool use = 2;       // specifies whether the battery shall be used as the electrical power source
 }
+
+/*
+Request a DescriptionModificationReport with (multiple) Upt-ReportParts.
+*/
+message TriggerDescriptorUpdateRequest{
+    repeated string handle = 1;
+}

src/t2iapi/device/service.proto

@@ -57,6 +57,8 @@ service DeviceService {
     and whose descriptors are of the given class.
     Includes handles which have been removed already and can be reinserted.
     Handles must stay the same once reinserted into the MDIB.
+    NOTE: When the requirement Biceps:R5025 is applicable to a Device, it is advisable to have at least one
+          removable descriptor that has children.
 
     Calling GetRemovableDescriptorsOfClass with descriptor_class = DESCRIPTOR_CLASS_ABSTRACT
     returns the unfiltered handles while other values for descriptor_class
@@ -89,11 +91,11 @@ 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 descriptor update for the provided handles.
+    This manipulation of the device shall result in a msg:DescriptionModificationReport message with one report part with
+    modification type upt for each handle provided.
      */
-    rpc TriggerDescriptorUpdate (BasicHandleRequest) returns (BasicResponse);
+    rpc TriggerDescriptorUpdate (TriggerDescriptorUpdateRequest) returns (BasicResponse);
 
     /*
     Trigger a descriptor update.