add manipulation ProvideInformationAboutNextCalibration (#81)

Add new manipulation ProvideInformationAboutNextCalibration for devices

# 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

Author: jannast

Diff for: CHANGELOG.md

@@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- manipulation ProvideInformationAboutNextCalibration for devices
 - manipulation SetSystemContextActivationStateAndContextAssociation for combined settings
 
 ## [4.1.0] - 2024-02-22

Diff for: src/t2iapi/device/device_requests.proto

@@ -65,3 +65,13 @@ Note that when no handle is given, every DescriptionModificationReport fulfills
 message TriggerDescriptorUpdateRequest{
     repeated string handle = 1;
 }
+
+/*
+Request to provide information about the pm:NextCalibration/@ComponentCalibrationState for the given descriptor handle.
+ */
+message ProvideInformationAboutNextCalibrationRequest {
+    string handle = 1;  // handle of the pm:AbstractDeviceComponentDescriptor for which
+                        // the next calibration information shall be provided
+    CalibrationState calibration_state = 2;     // ComponentCalibrationState value to set as the next calibration
+                                                // information
+}

Diff for: src/t2iapi/device/service.proto

@@ -121,4 +121,11 @@ service DeviceService {
     not able to maintain the static state, it shall return RESULT_NOT_SUPPORTED.
      */
     rpc SetBatteryUsage (t2iapi.device.SetBatteryUsageRequest) returns (BasicResponse);
+
+     /*
+    Provide information about the pm:NextCalibration for the given pm:AbstractDeviceComponentDescriptor.
+    If the device is not able to provide the information, it shall return RESULT_NOT_SUPPORTED.
+     */
+    rpc ProvideInformationAboutNextCalibration (t2iapi.device.ProvideInformationAboutNextCalibrationRequest)
+        returns (BasicResponse);
 }

Diff for: src/t2iapi/device/types.proto

@@ -69,3 +69,14 @@ message ExpandedName {
     string local_name = 2;
 }
 
+/*
+Represents pm:CalibrationState from the IEEE Std 11073-10207-2017.
+ */
+enum CalibrationState{
+    CALIBRATION_STATE_NOT_CALIBRATED = 0;
+    CALIBRATION_STATE_CALIBRATION_REQUIRED = 1;
+    CALIBRATION_STATE_RUNNING = 2;
+    CALIBRATION_STATE_CALIBRATED = 3;
+    CALIBRATION_STATE_OTHER = 4;
+}
+