Improve the control interface usage examples

[krucod3]

Description

The Control Interface usage examples currently do not show how to deal with the response message of an update request.
Additionally one method called "write.. " is updating and reading the current state.

We should update the examples, s.t. it is clear how to use the control interface. Additionally the example in the documentation has to reflect reading the update request response message. It would be also good to show kind of in a sequence that each request has its response and that ids are matching.

Goals

• Update all Control Interface usage examples:
  ** to reflect the request response model
  ** to show better the reading of the complete state by separating it into its own method.
• User documentation:
  ** Review the user documentation regarding the control interface usage
  ** Reflect the request-response model there too
  ** Add a sequence diagram showing how an update is performed
  ** add something about the IDs and that they shall be unique in case of parallel calls

Final result

Summary

To be filled when the final solution is sketched.

Tasks

• Task 1
• Task 2
• ...

[krucod3]

This should be done after the SDKs are available #263 and #304.