diff --git a/CHANGELOG.md b/CHANGELOG.md index 282eebb..62f9124 100644 --- a/CHANGELOG.md +++ b/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 diff --git a/src/t2iapi/device/device_requests.proto b/src/t2iapi/device/device_requests.proto index 28fa67d..6204c80 100644 --- a/src/t2iapi/device/device_requests.proto +++ b/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; +} diff --git a/src/t2iapi/device/service.proto b/src/t2iapi/device/service.proto index 393ee4c..806f1c1 100644 --- a/src/t2iapi/device/service.proto +++ b/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.