[#1228] added notice that for "live" channel the device must understa…

…nd and respond in Ditto Protocol Signed-off-by: Thomas Jaeckle <thomas.jaeckle@bosch.io>
eclipse-ditto · Dec 21, 2021 · b64c6d9 · b64c6d9
1 parent f8ffff8
commit b64c6d9
Show file tree

Hide file tree

Showing 3 changed files with 13 additions and 0 deletions.
diff --git a/documentation/src/main/resources/_posts/2021-12-20-http-live-channel.md b/documentation/src/main/resources/_posts/2021-12-20-http-live-channel.md
@@ -28,6 +28,10 @@ Ditto supports two types of `channel`s for communication.
 * [live](protocol-twinlive.html#live): The `channel` parameter can be changed to `live` 
   to communicate with the real device.
 
+{% include note.html content="In order to use the live channel, the device receiving live commands must be able to understand
+  and answer in [Ditto Protocol messages](protocol-specification.html) with the
+[topic's channel being `live`](protocol-specification-topic.html#live-channel)." %}
+
 When using the `twin` channel, the command is routed to the Ditto backend and handled by the **twin** persistence.
 Before using the `live` channel, it is necessary to create the **digital twin** of the device in the 
 Ditto backend.

diff --git a/documentation/src/main/resources/_posts/2021-12-22-live-channel-condition.md b/documentation/src/main/resources/_posts/2021-12-22-live-channel-condition.md
@@ -17,6 +17,10 @@ requests (see also [blog post about "HTTP live channel"](2021-12-20-http-live-ch
 will retrieve data from a device via the live channel, or fall back to the persisted [twin](protocol-twinlive.html#twin) 
 otherwise.
 
+{% include note.html content="In order to use the live channel, the device receiving live commands must be able to understand
+    and answer in [Ditto Protocol messages](protocol-specification.html) with the
+[topic's channel being `live`](protocol-specification-topic.html#live-channel)." %}
+
 ## Relying on conditions
 
 Ditto 2.1.0 added support for [conditional requests](basic-conditional-requests.html) by e.g. specifying a `condition`

diff --git a/documentation/src/main/resources/pages/ditto/protocol-twinlive.md b/documentation/src/main/resources/pages/ditto/protocol-twinlive.md
@@ -26,6 +26,11 @@ specific to the solution and thus out of Ditto's scope.
 What Ditto however does, when routing **live** commands/messages, is an [authorization check](basic-auth.html).
 Thus Ditto ensures that only authorized parties are able to send commands or messages.
 
+{% include note.html content="In order to use the live channel, the device receiving live commands must be able to understand
+    and answer in [Ditto Protocol messages](protocol-specification.html) with the 
+    [topic's channel being `live`](protocol-specification-topic.html#live-channel)." %}
+
+
 ## Other
 
 Policy commands do not fit any of the above two categories as they are not directly related to a device. A Policy is