Merge branch 'staging/4.2' into release/4.2

Author: ashvayka

_data/hardware-partners.yml

@@ -206,6 +206,16 @@
   site:
     href: https://www.milesight.com/
   links:
+    general-guides:
+      0:
+        label: ThingsBoard Platform-Milesight Integration via TTI
+        href: https://support.milesight-iot.com/support/solutions/articles/73000658954-thingsboard-platform-milesight-integration-via-tti
+      1:
+        label: ThingsBoard Platform-Milesight Integration via HTTP
+        href: https://support.milesight-iot.com/support/solutions/articles/73000658955-thingsboard-platform-milesight-integration-via-http
+      2:
+        label: ThingsBoard Platform-Milesight Integration via MQTT
+        href: https://support.milesight-iot.com/support/solutions/articles/73000658957-thingsboard-platform-milesight-integration-via-mqtt
     sensor-guides:
       0:
         label: AM308 Lorawan 9-IN-1 IAQ Sensor

_includes/templates/iot-gateway/get-set-connector-rpc/mqtt.md

@@ -5,6 +5,7 @@ With the GET method you can subscribe to MQTT topic and receive message from it.
 ```bash
 get requestTopicExpression=<requestTopicExpression>;responseTopicExpression=<responseTopicExpression>;value=<value>;
 ```
+{: .copy-code}
 
 Where:
 - `<requestTopicExpression>` - the topic to publish the request;
@@ -18,54 +19,52 @@ To read the value of the room light level, run this query:
 ```bash
 get requestTopicExpression=data/get_light_level;responseTopicExpression=data/response;value=${params};
 ```
+{: .copy-code}
 
-**Response:**
-
-```json
-{"result":  {"success":true}}
-```
+Also, let's take a look at the data received from the MQTT topic **"data/response"**:
 
 {:refdef: style="text-align: left;"}
 ![image](https://img.thingsboard.io/gateway/get-set-connector-rpc/mqtt-get-set-rpc-1.png)
 {: refdef}
 
-Also, let's take a look at the data received from the MQTT topic **"data/response"**:
-
-{:refdef: style="text-align: left;"}
-![image](https://img.thingsboard.io/gateway/get-set-connector-rpc/mqtt-get-set-rpc-3.jpeg)
-{: refdef}
 
 ### SET method
 
 With the SET method you can publish a message to MQTT topic.
 
 ```bash
-set requestTopicExpression=data/get_light_level;value=${params};
+set requestTopicExpression=data/set_light_level;value=${params};
 ```
+{: .copy-code}
 
 Where:
 - `<requestTopicExpression>` - the topic to publish request;
 - `<value>` - the value to send.
 
 For example, in our case, we know that we can set the value of the room light level to the MQTT topic
-**"data/light_level"**. To set the value of the room light level, run the following query:
+**"sata/light_level"**. To set the value of the room light level, run the following query:
 
 ```bash
 set requestTopicExpression=data/set_light_level;value=80;
 ```
+{: .copy-code}
 
-**Response:**
-
-```json
-{"result":  {"success":true}}
-```
+On the screenshot below, you can see that we have successfully sent the SET request to the MQTT topic **"data/set_light_level"**:
 
 {:refdef: style="text-align: left;"}
 ![image](https://img.thingsboard.io/gateway/get-set-connector-rpc/mqtt-get-set-rpc-2.png)
 {: refdef}
 
-Also, let's take a look at the result in the **"data/light_level"** MQTT topic:
+Also, let's take a look at the result after SET method in the **"data/light_level"** MQTT topic by sending Two way GET RPC request.
+To read the value of the room light level to make sure the room light level is really updated, run this query:
+
+```bash
+get requestTopicExpression=data/get_light_level;responseTopicExpression=data/response;value=${params};
+```
+{: .copy-code}
+
+On the screenshot below, you can see that the room light level value is updated to 80 after the SET request:
 
 {:refdef: style="text-align: left;"}
-![image](https://img.thingsboard.io/gateway/get-set-connector-rpc/mqtt-get-set-rpc-4.jpeg)
+![image](https://img.thingsboard.io/gateway/get-set-connector-rpc/mqtt-get-set-rpc-3.png)
 {: refdef}

_includes/templates/iot-gateway/mqtt-connector/attribute-request-subsection-advanced.md

@@ -1,4 +1,18 @@
-To adding new requests mapping, navigate to the "Requests mapping" tab and click the "plus" icon.
-In the open modal window, select the "Attribute request" type, set a topic filter. Fill in the fields of the "Input request parsing" and "Output request parsing" sections. Then, click "Add".
+In order to add new attribute request mapping, follow these steps:
 
-![image](https://img.thingsboard.io/gateway/mqtt-connector/attribute-request-1-ce.png)
+{% assign AttributesRequest = '
+    ===
+        image: https://img.thingsboard.io/gateway/mqtt-connector/mqtt-gateway-configuring-11-ce.png,
+        title: Click the "**Add mapping**" under "**Requests mapping**" section to add new attribute request mapping.
+    ===
+        image: https://img.thingsboard.io/gateway/mqtt-connector/mqtt-attribute-requests-1.png,
+        title: Select "**Attribute request**" in the **Request type** field, enter the "**Topic filter**"
+    ===
+        image: https://img.thingsboard.io/gateway/mqtt-connector/mqtt-attribute-requests-2.png,
+        title: Configure the **Device name expression**, **Response topic expression**, and **Attribute name expression** fields. 
+        Select the source type for each field (`Message`, `Topic`, or `Constant`) and enter the corresponding values. 
+        You can also set the **Retain** option to determine whether the attribute response message should be retained by the MQTT broker.
+    '
+%}
+
+{% include images-gallery.liquid showListImageTitles="true" imageCollection=AttributesRequest %}

_includes/templates/iot-gateway/mqtt-connector/attribute-request-subsection-basic.md

@@ -1,4 +1,17 @@
-To adding new requests mapping, navigate to the "Requests mapping" tab and click the "plus" icon. 
-In the open modal window, select the "Attribute update" type, and set a device name filter, attribute filter, response value expression, and response topic expression. Then, click “Add”.
+In order to add new attribute update mapping, follow these steps:
 
-![image](https://img.thingsboard.io/gateway/mqtt-connector/attribute-updates-example-basic-1-ce.png)
+{% assign AttributesUpdate = '
+    ===
+        image: https://img.thingsboard.io/gateway/mqtt-connector/mqtt-gateway-configuring-11-ce.png,
+        title: Click the "**Add mapping**" under "**Requests mapping**" section to add new attribute request mapping.
+    ===
+        image: https://img.thingsboard.io/gateway/mqtt-connector/mqtt-attribute-updates-1.png,
+        title: Select "**Attribute update**" in the **Request type** field, enter the "**Device name filter**"
+    ===
+        image: https://img.thingsboard.io/gateway/mqtt-connector/mqtt-attribute-updates-2.png,
+        title: Configure the **Attribute filter**, **Response value expression**, and **Response topic expression** fields.
+        You can also set the **Retain** option to determine whether the attribute response message should be retained by the MQTT broker.
+    '
+%}
+
+{% include images-gallery.liquid showListImageTitles="true" imageCollection=AttributesUpdate %}