chriz/OpenMQTT-Gateway
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 5 Wiki Activity

[DOCS] Theengs Plug highlight and SEO improvements (#1730)

Browse Source 
* [DOCS] Theengs Plug highlight

* Add alt content for images and description
This commit is contained in:
Florian authored and GitHub committed 2023-08-11 13:04:52 -05:00
1 parent 79a8591b83
commit 7a2bb04a1b
19 files changed
+138 -109
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/integrate/openhab3.md
+14 -14
View File
@@ -16,7 +16,7 @@ The goal is to disable the IPv6 address of the broker server, so that the gatewa
4. Disable IPv6
5. Click on Save
![](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-ip.png)
![OpenHAB integration](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-ip.png)
::: warning Note
If the broker is installed on another server you will also need to configure it with an IPv4 address.
@@ -27,30 +27,30 @@ If the broker is installed on another server you will also need to configure it
2. Click on Bindings
3. Install the MQTT binding (you can search at the bottom right)
![](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding.png)
![OpenHAB integration](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding.png)
4. Once installed click on Things under Settings
5. Click on the + at the bottom right
6. Click on MQTT Binding
![](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding2.png)
![OpenHAB integration](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding2.png)
7. Click on MQTT broker
![](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding3.png)
![OpenHAB integration](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding3.png)
8. Enter for the "Broker Hostname/IP" field, the IP address of your broker, if it is installed on the same server you can enter `localhost`
![](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding4.png)
![OpenHAB integration](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding4.png)
9. Click on "Show Advanced" if your broker has authentication activated, if not you can go to step 11
10. Enter the broker credentials: username and password
![](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding5.png)
![OpenHAB integration](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding5.png)
11. Click on Create Thing at the bottom, you should see your MQTT Broker in the Things list with the status "online"
![](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding6.png)
![OpenHAB integration](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding6.png)
Bravo👏, second step done! Now let's add the Jinja transformation service.
@@ -60,7 +60,7 @@ Bravo👏, second step done! Now let's add the Jinja transformation service.
3. Install Jinja Transformation (you can search at the bottom right)
4. Install JSONPath Transformation
![](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-jinja.png)
![OpenHAB integration](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-jinja.png)
Second step done!
@@ -83,16 +83,16 @@ To make the auto discovery compatible with OpenHAB you have to send the followin
## Adding the things
1. From the Administration click on "Things" under "Settings", you should see a number in the INBOX button
![](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things.png)
![OpenHAB integration](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things.png)
2. Click on INBOX, you should see your BLE devices and the gateway
![](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things2.png)
![OpenHAB integration](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things2.png)
3. Click on a device, a pop up "Add as Thing" should appear
4. Rename it if you need, and click OK, repeat for each Thing discovered. The devices should appears as online progressively.
![](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things3.png)
![OpenHAB integration](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things3.png)
5. Click on Model
6. Select the location of where you want to create the Equipment
@@ -102,13 +102,13 @@ To make the auto discovery compatible with OpenHAB you have to send the followin
10. Rename your Equipment if you need
11. Select the Channels
![](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things4.png)
![OpenHAB integration](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things4.png)
12. Click on "Add to Model"
13. Go to Model, if you unfold your location and Equipment you should be able to see values
![](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things5.png)
![OpenHAB integration](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things5.png)
Congratulation🎉! You were able to get data from your BLE sensors into OpenHAB. You can now add the others and use the data to build pages, leverage rules and enjoy all the function of your Home Automation controller with BLE devices.
![](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt.png)
![OpenHAB integration](../img/OpenMQTTGateway-OpenHAB-Theengs-mqtt.png)