mirror of
https://github.com/1technophile/OpenMQTTGateway.git
synced 2026-03-07 15:57:13 +01:00
115 lines
25 KiB
HTML
115 lines
25 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en-US">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>Integrate OPENHAB 3/4 | Theengs OpenMQTTGateway DEVELOPMENT SHA:497dc8 TEST ONLY</title>
|
|
<meta name="generator" content="VuePress 1.9.10">
|
|
<link rel="apple-touch-icon" sizes="180x180" href=".apple-touch-icon.png">
|
|
<link rel="icon" type="image/png" sizes="32x32" href="/dev/favicon-32x32.png">
|
|
<link rel="icon" type="image/png" sizes="16x16" href="/dev/favicon-16x16.png">
|
|
<link rel="manifest" href="/dev/manifest.json">
|
|
<link rel="mask-icon" href="/dev/icons/safari-pinned-tab.svg" color="#3eaf7c">
|
|
<script type="module" src="https://unpkg.com/esp-web-tools@9.4.3/dist/web/install-button.js?module"></script>
|
|
<meta name="description" content="One gateway, many technologies: MQTT gateway for ESP8266 or ESP32 with bidirectional 433mhz/315mhz/868mhz, Infrared communications, BLE, LoRa, beacons detection, mi flora / mi jia / LYWSD02/ Mi Scale compatibility, SMS & LORA.">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<meta name="theme-color" content="#3eaf7c">
|
|
<meta name="apple-mobile-web-app-capable" content="yes">
|
|
<meta name="apple-mobile-web-app-status-bar-style" content="black">
|
|
<meta name="msapplication-TileImage" content="/favicon-144x144.png">
|
|
<meta name="msapplication-TileColor" content="#000000">
|
|
|
|
<link rel="preload" href="/dev/assets/css/0.styles.0f5b7756.css" as="style"><link rel="preload" href="/dev/assets/js/app.2701250f.js" as="script"><link rel="preload" href="/dev/assets/js/2.f90febc1.js" as="script"><link rel="preload" href="/dev/assets/js/1.848070c7.js" as="script"><link rel="preload" href="/dev/assets/js/13.efb7256d.js" as="script"><link rel="prefetch" href="/dev/assets/js/10.da69edf3.js"><link rel="prefetch" href="/dev/assets/js/11.6556d787.js"><link rel="prefetch" href="/dev/assets/js/12.1e6cb39c.js"><link rel="prefetch" href="/dev/assets/js/14.286ec29b.js"><link rel="prefetch" href="/dev/assets/js/15.91304de5.js"><link rel="prefetch" href="/dev/assets/js/16.74c01ec1.js"><link rel="prefetch" href="/dev/assets/js/17.8dcf617b.js"><link rel="prefetch" href="/dev/assets/js/18.bb4184c5.js"><link rel="prefetch" href="/dev/assets/js/19.71e6901b.js"><link rel="prefetch" href="/dev/assets/js/20.fbef6fa1.js"><link rel="prefetch" href="/dev/assets/js/21.0e500e6c.js"><link rel="prefetch" href="/dev/assets/js/22.1fa11360.js"><link rel="prefetch" href="/dev/assets/js/23.d5ff69ee.js"><link rel="prefetch" href="/dev/assets/js/24.7abe1c27.js"><link rel="prefetch" href="/dev/assets/js/25.3cdd6711.js"><link rel="prefetch" href="/dev/assets/js/26.4ca97ce3.js"><link rel="prefetch" href="/dev/assets/js/27.8d8ada9a.js"><link rel="prefetch" href="/dev/assets/js/28.afe597be.js"><link rel="prefetch" href="/dev/assets/js/29.ee885138.js"><link rel="prefetch" href="/dev/assets/js/3.2fb8cc22.js"><link rel="prefetch" href="/dev/assets/js/30.f2afadfe.js"><link rel="prefetch" href="/dev/assets/js/31.7ec0b927.js"><link rel="prefetch" href="/dev/assets/js/32.bf6ed2d3.js"><link rel="prefetch" href="/dev/assets/js/33.66867073.js"><link rel="prefetch" href="/dev/assets/js/34.8c8c3249.js"><link rel="prefetch" href="/dev/assets/js/35.de5ccc4f.js"><link rel="prefetch" href="/dev/assets/js/36.1f7a3de9.js"><link rel="prefetch" href="/dev/assets/js/37.83508dbe.js"><link rel="prefetch" href="/dev/assets/js/38.55a68009.js"><link rel="prefetch" href="/dev/assets/js/39.20ae555e.js"><link rel="prefetch" href="/dev/assets/js/4.ee469e2f.js"><link rel="prefetch" href="/dev/assets/js/40.eb26a150.js"><link rel="prefetch" href="/dev/assets/js/41.c56bed06.js"><link rel="prefetch" href="/dev/assets/js/42.31ca9dd3.js"><link rel="prefetch" href="/dev/assets/js/43.2b960116.js"><link rel="prefetch" href="/dev/assets/js/44.790d8d70.js"><link rel="prefetch" href="/dev/assets/js/45.690ecbfb.js"><link rel="prefetch" href="/dev/assets/js/46.f4cf083c.js"><link rel="prefetch" href="/dev/assets/js/47.39d975c4.js"><link rel="prefetch" href="/dev/assets/js/48.bfb4afae.js"><link rel="prefetch" href="/dev/assets/js/49.d705f84d.js"><link rel="prefetch" href="/dev/assets/js/5.45a12acb.js"><link rel="prefetch" href="/dev/assets/js/50.891c9f1b.js"><link rel="prefetch" href="/dev/assets/js/51.f851c3ef.js"><link rel="prefetch" href="/dev/assets/js/52.33ace286.js"><link rel="prefetch" href="/dev/assets/js/53.3adb747e.js"><link rel="prefetch" href="/dev/assets/js/54.0bae6b28.js"><link rel="prefetch" href="/dev/assets/js/55.482aace6.js"><link rel="prefetch" href="/dev/assets/js/56.1fe4be81.js"><link rel="prefetch" href="/dev/assets/js/57.27eb5af9.js"><link rel="prefetch" href="/dev/assets/js/58.06281c56.js"><link rel="prefetch" href="/dev/assets/js/59.8265bd7e.js"><link rel="prefetch" href="/dev/assets/js/6.88e76e8e.js"><link rel="prefetch" href="/dev/assets/js/60.7e3979c2.js"><link rel="prefetch" href="/dev/assets/js/61.5d8381b6.js"><link rel="prefetch" href="/dev/assets/js/62.d32662df.js"><link rel="prefetch" href="/dev/assets/js/63.118c24b3.js"><link rel="prefetch" href="/dev/assets/js/64.25208722.js"><link rel="prefetch" href="/dev/assets/js/65.bd30a68b.js"><link rel="prefetch" href="/dev/assets/js/66.6b3e6794.js"><link rel="prefetch" href="/dev/assets/js/67.0d566ba2.js"><link rel="prefetch" href="/dev/assets/js/7.747393f7.js"><link rel="prefetch" href="/dev/assets/js/vendors~docsearch.9de5652f.js">
|
|
<link rel="stylesheet" href="/dev/assets/css/0.styles.0f5b7756.css">
|
|
</head>
|
|
<body>
|
|
<div id="app" data-server-rendered="true"><div class="theme-container"><header class="navbar"><div class="sidebar-button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <a href="/dev/" class="home-link router-link-active"><!----> <span class="site-name">Theengs OpenMQTTGateway DEVELOPMENT SHA:497dc8 TEST ONLY</span></a> <div class="links"><!----> <nav class="nav-links can-hide"><div class="nav-item"><a href="https://www.theengs.io" target="_self" class="nav-link external">
|
|
Home
|
|
<!----></a></div><div class="nav-item"><div class="dropdown-wrapper"><button type="button" aria-label="Use cases" class="dropdown-title"><span class="title">Use cases</span> <span class="arrow down"></span></button> <button type="button" aria-label="Use cases" class="mobile-dropdown-title"><span class="title">Use cases</span> <span class="arrow right"></span></button> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="https://www.theengs.io/usecases/smarthome.html" target="_self" class="nav-link external">
|
|
Smart Home
|
|
<!----></a></li><li class="dropdown-item"><!----> <a href="https://www.theengs.io/usecases/iot.html" target="_self" class="nav-link external">
|
|
IoT
|
|
<!----></a></li><li class="dropdown-item"><!----> <a href="https://www.theengs.io/usecases/research.html" target="_self" class="nav-link external">
|
|
Research
|
|
<!----></a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><button type="button" aria-label="Solutions" class="dropdown-title"><span class="title">Solutions</span> <span class="arrow down"></span></button> <button type="button" aria-label="Solutions" class="mobile-dropdown-title"><span class="title">Solutions</span> <span class="arrow right"></span></button> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><h4>
|
|
Hardware
|
|
</h4> <ul class="dropdown-subitem-wrapper"><li class="dropdown-subitem"><a href="https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption" target="_self" class="nav-link external">
|
|
Theengs Plug
|
|
<!----></a></li><li class="dropdown-subitem"><a href="https://shop.theengs.io/products/theengs-bridge-esp32-ble-mqtt-gateway-with-ethernet-and-external-antenna" target="_self" class="nav-link external">
|
|
Theengs Bridge
|
|
<!----></a></li></ul></li><li class="dropdown-item"><h4>
|
|
Software
|
|
</h4> <ul class="dropdown-subitem-wrapper"><li class="dropdown-subitem"><a href="https://app.theengs.io" target="_self" class="nav-link external">
|
|
Mobile App
|
|
<!----></a></li><li class="dropdown-subitem"><a href="https://docs.openmqttgateway.com" target="_self" class="nav-link external">
|
|
OpenMQTTGateway
|
|
<!----></a></li><li class="dropdown-subitem"><a href="https://gateway.theengs.io" target="_self" class="nav-link external">
|
|
Gateway
|
|
<!----></a></li></ul></li><li class="dropdown-item"><h4>
|
|
Core
|
|
</h4> <ul class="dropdown-subitem-wrapper"><li class="dropdown-subitem"><a href="https://decoder.theengs.io" target="_self" class="nav-link external">
|
|
Decoder
|
|
<!----></a></li><li class="dropdown-subitem"><a href="https://parser.theengs.io" target="_self" class="nav-link external">
|
|
Web Parser
|
|
<!----></a></li></ul></li></ul></div></div><div class="nav-item"><a href="https://decoder.theengs.io/devices/devices.html" target="_self" class="nav-link external">
|
|
Compatible devices
|
|
<!----></a></div><div class="nav-item"><a href="https://community.openmqttgateway.com" target="_self" class="nav-link external">
|
|
Community
|
|
<!----></a></div><div class="nav-item"><a href="https://shop.theengs.io/" target="_self" class="nav-link external">
|
|
Shop
|
|
<!----></a></div><div class="nav-item"><a href="https://github.com/sponsors/theengs" target="_self" class="nav-link external">
|
|
Sponsor 🤍
|
|
<!----></a></div> <a href="https://github.com/1technophile/OpenMQTTGateway" target="_blank" rel="noopener noreferrer" class="repo-link">
|
|
GitHub
|
|
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></nav></div></header> <div class="sidebar-mask"></div> <aside class="sidebar"><nav class="nav-links"><div class="nav-item"><a href="https://www.theengs.io" target="_self" class="nav-link external">
|
|
Home
|
|
<!----></a></div><div class="nav-item"><div class="dropdown-wrapper"><button type="button" aria-label="Use cases" class="dropdown-title"><span class="title">Use cases</span> <span class="arrow down"></span></button> <button type="button" aria-label="Use cases" class="mobile-dropdown-title"><span class="title">Use cases</span> <span class="arrow right"></span></button> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><!----> <a href="https://www.theengs.io/usecases/smarthome.html" target="_self" class="nav-link external">
|
|
Smart Home
|
|
<!----></a></li><li class="dropdown-item"><!----> <a href="https://www.theengs.io/usecases/iot.html" target="_self" class="nav-link external">
|
|
IoT
|
|
<!----></a></li><li class="dropdown-item"><!----> <a href="https://www.theengs.io/usecases/research.html" target="_self" class="nav-link external">
|
|
Research
|
|
<!----></a></li></ul></div></div><div class="nav-item"><div class="dropdown-wrapper"><button type="button" aria-label="Solutions" class="dropdown-title"><span class="title">Solutions</span> <span class="arrow down"></span></button> <button type="button" aria-label="Solutions" class="mobile-dropdown-title"><span class="title">Solutions</span> <span class="arrow right"></span></button> <ul class="nav-dropdown" style="display:none;"><li class="dropdown-item"><h4>
|
|
Hardware
|
|
</h4> <ul class="dropdown-subitem-wrapper"><li class="dropdown-subitem"><a href="https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption" target="_self" class="nav-link external">
|
|
Theengs Plug
|
|
<!----></a></li><li class="dropdown-subitem"><a href="https://shop.theengs.io/products/theengs-bridge-esp32-ble-mqtt-gateway-with-ethernet-and-external-antenna" target="_self" class="nav-link external">
|
|
Theengs Bridge
|
|
<!----></a></li></ul></li><li class="dropdown-item"><h4>
|
|
Software
|
|
</h4> <ul class="dropdown-subitem-wrapper"><li class="dropdown-subitem"><a href="https://app.theengs.io" target="_self" class="nav-link external">
|
|
Mobile App
|
|
<!----></a></li><li class="dropdown-subitem"><a href="https://docs.openmqttgateway.com" target="_self" class="nav-link external">
|
|
OpenMQTTGateway
|
|
<!----></a></li><li class="dropdown-subitem"><a href="https://gateway.theengs.io" target="_self" class="nav-link external">
|
|
Gateway
|
|
<!----></a></li></ul></li><li class="dropdown-item"><h4>
|
|
Core
|
|
</h4> <ul class="dropdown-subitem-wrapper"><li class="dropdown-subitem"><a href="https://decoder.theengs.io" target="_self" class="nav-link external">
|
|
Decoder
|
|
<!----></a></li><li class="dropdown-subitem"><a href="https://parser.theengs.io" target="_self" class="nav-link external">
|
|
Web Parser
|
|
<!----></a></li></ul></li></ul></div></div><div class="nav-item"><a href="https://decoder.theengs.io/devices/devices.html" target="_self" class="nav-link external">
|
|
Compatible devices
|
|
<!----></a></div><div class="nav-item"><a href="https://community.openmqttgateway.com" target="_self" class="nav-link external">
|
|
Community
|
|
<!----></a></div><div class="nav-item"><a href="https://shop.theengs.io/" target="_self" class="nav-link external">
|
|
Shop
|
|
<!----></a></div><div class="nav-item"><a href="https://github.com/sponsors/theengs" target="_self" class="nav-link external">
|
|
Sponsor 🤍
|
|
<!----></a></div> <a href="https://github.com/1technophile/OpenMQTTGateway" target="_blank" rel="noopener noreferrer" class="repo-link">
|
|
GitHub
|
|
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></nav> <ul class="sidebar-links"><li><a href="/dev/" aria-current="page" class="sidebar-link">0 - What is it for 🏠</a></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>1 - Prerequisites🧭</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>2 - Set it up 🔨</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>3 - Upload ➡️</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>4 - Use ✈️</span> <span class="arrow right"></span></p> <!----></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading open"><span>5 - Integrate 🎉</span> <span class="arrow down"></span></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/dev/integrate/openhab2.html" class="sidebar-link">Integrate OPENHAB2</a></li><li><a href="/dev/integrate/openhab3.html" aria-current="page" class="active sidebar-link">Integrate OPENHAB 3/4</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/dev/integrate/openhab3.html#prerequisites" class="sidebar-link">Prerequisites</a></li><li class="sidebar-sub-header"><a href="/dev/integrate/openhab3.html#ip-address-if-your-broker-is-installed-on-the-same-server-as-openhab" class="sidebar-link">IP address (if your broker is installed on the same server as OpenHAB)</a></li><li class="sidebar-sub-header"><a href="/dev/integrate/openhab3.html#install-the-mqtt-binding" class="sidebar-link">Install the MQTT binding</a></li><li class="sidebar-sub-header"><a href="/dev/integrate/openhab3.html#install-jinja-and-jsonpath-transformations" class="sidebar-link">Install Jinja and JSONPath Transformations</a></li><li class="sidebar-sub-header"><a href="/dev/integrate/openhab3.html#upload-openmqttgateway-to-an-esp32" class="sidebar-link">Upload OpenMQTTGateway to an ESP32</a></li><li class="sidebar-sub-header"><a href="/dev/integrate/openhab3.html#configure-openmqttgateway-from-the-web-portal" class="sidebar-link">Configure OpenMQTTGateway from the web portal</a></li><li class="sidebar-sub-header"><a href="/dev/integrate/openhab3.html#adding-the-things" class="sidebar-link">Adding the things</a></li></ul></li><li><a href="/dev/integrate/home_assistant.html" class="sidebar-link">Integrate Home Assistant</a></li><li><a href="/dev/integrate/node_red.html" class="sidebar-link">Integrate Node-Red</a></li><li><a href="/dev/integrate/aws_iot.html" class="sidebar-link">Integrate AWS IOT</a></li><li><a href="/dev/integrate/jeedom.html" class="sidebar-link">Integrate Jeedom</a></li></ul></section></li><li><section class="sidebar-group collapsable depth-0"><p class="sidebar-heading"><span>6 - Participate 💻</span> <span class="arrow right"></span></p> <!----></section></li></ul> </aside> <main class="page"> <div class="theme-default-content content__default"><h1 id="integrate-openhab-3-4"><a href="#integrate-openhab-3-4" class="header-anchor">#</a> Integrate OPENHAB 3/4</h1> <p>This tutorial will show how to integrate the BLE gateway to OpenHAB 3 or 4 leveraging the auto discovery functionality.
|
|
After this tutorial, you should see your Bluetooth Low Energy devices in OpenHAB without any file based manual configuration.</p> <h2 id="prerequisites"><a href="#prerequisites" class="header-anchor">#</a> Prerequisites</h2> <ul><li>OpenHAB 3.3 or higher</li> <li>MQTT broker installed with or without authentication</li> <li>A location defined in the "Model" section under "Settings"</li></ul> <h2 id="ip-address-if-your-broker-is-installed-on-the-same-server-as-openhab"><a href="#ip-address-if-your-broker-is-installed-on-the-same-server-as-openhab" class="header-anchor">#</a> IP address (if your broker is installed on the same server as OpenHAB)</h2> <p>The goal is to disable the IPv6 address of the broker server, so that the gateway can connect through IPv4.</p> <ol><li>From the Administration click on Settings</li> <li>Click on Network Settings</li> <li>Click on Show Advanced</li> <li>Disable IPv6</li> <li>Click on Save</li></ol> <p><img src="/dev/assets/img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-ip.8d63f8c6.png" alt="OpenHAB integration"></p> <div class="custom-block warning"><p class="custom-block-title">Note</p> <p>If the broker is installed on another server you will also need to configure it with an IPv4 address.</p></div> <h2 id="install-the-mqtt-binding"><a href="#install-the-mqtt-binding" class="header-anchor">#</a> Install the MQTT binding</h2> <ol><li>From the Administration click on Settings</li> <li>Click on Bindings</li> <li>Install the MQTT binding (you can search at the bottom right)</li></ol> <p><img src="/dev/assets/img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding.4a6275c5.png" alt="OpenHAB integration"></p> <ol start="4"><li>Once installed click on Things under Settings</li> <li>Click on the + at the bottom right</li> <li>Click on MQTT Binding</li></ol> <p><img src="/dev/assets/img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding2.266324d8.png" alt="OpenHAB integration"></p> <ol start="7"><li>Click on MQTT broker</li></ol> <p><img src="/dev/assets/img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding3.506b08c5.png" alt="OpenHAB integration"></p> <ol start="8"><li>Enter for the "Broker Hostname/IP" field, the IP address of your broker, if it is installed on the same server you can enter <code>localhost</code></li></ol> <p><img src="/dev/assets/img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding4.3be7eff4.png" alt="OpenHAB integration"></p> <ol start="9"><li>Click on "Show Advanced" if your broker has authentication activated, if not you can go to step 11</li> <li>Enter the broker credentials: username and password</li></ol> <p><img src="/dev/assets/img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding5.8c71ca36.png" alt="OpenHAB integration"></p> <ol start="11"><li>Click on Create Thing at the bottom, you should see your MQTT Broker in the Things list with the status "online"</li></ol> <p><img src="/dev/assets/img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-binding6.48cd3dee.png" alt="OpenHAB integration"></p> <p>Bravo👏, second step done! Now let's add the Jinja transformation service.</p> <h2 id="install-jinja-and-jsonpath-transformations"><a href="#install-jinja-and-jsonpath-transformations" class="header-anchor">#</a> Install Jinja and JSONPath Transformations</h2> <ol><li>From the Administration click on Settings</li> <li>Click on Bindings</li> <li>Install Jinja Transformation (you can search at the bottom right)</li> <li>Install JSONPath Transformation</li></ol> <p><img src="/dev/assets/img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-jinja.270ad9f2.png" alt="OpenHAB integration"></p> <p>Second step done!</p> <h2 id="upload-openmqttgateway-to-an-esp32"><a href="#upload-openmqttgateway-to-an-esp32" class="header-anchor">#</a> Upload OpenMQTTGateway to an ESP32</h2> <p><a href="/dev/upload/web-install.html">Upload OpenMQTTGateway from the web</a> by selecting the environment corresponding to your need.</p> <p>Or use another upload method from the Upload section.</p> <h2 id="configure-openmqttgateway-from-the-web-portal"><a href="#configure-openmqttgateway-from-the-web-portal" class="header-anchor">#</a> Configure OpenMQTTGateway from the web portal</h2> <p><a href="/dev/upload/portal.html">Wifi and MQTT configuration</a></p> <p>Or use another upload method from the Upload section that requires credentials before the build.</p> <p>You should see the gateway connected to your broker by checking with an MQTT client like MQTT Explorer.</p> <h2 id="adding-the-things"><a href="#adding-the-things" class="header-anchor">#</a> Adding the things</h2> <ol><li>From the Administration click on "Things" under "Settings", you should see a number in the INBOX button</li></ol> <p><img src="/dev/assets/img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things.b9bcbb97.png" alt="OpenHAB integration"></p> <ol start="2"><li>Click on INBOX, you should see your BLE devices and the gateway</li></ol> <p><img src="/dev/assets/img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things2.550b24da.png" alt="OpenHAB integration"></p> <ol start="3"><li>Click on a device, a pop up "Add as Thing" should appear</li> <li>Rename it if you need, and click OK, repeat for each Thing discovered. The devices should appears as online progressively.</li></ol> <p><img src="/dev/assets/img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things3.e83eb23c.png" alt="OpenHAB integration"></p> <ol start="5"><li>Click on Model</li> <li>Select the location of where you want to create the Equipment</li> <li>Click on "Create Equipment from Thing"</li> <li>Click on Thing</li> <li>Select a Thing</li> <li>Rename your Equipment if you need</li> <li>Select the Channels</li></ol> <p><img src="/dev/assets/img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things4.45af5919.png" alt="OpenHAB integration"></p> <ol start="12"><li>Click on "Add to Model"</li> <li>Go to Model, if you unfold your location and Equipment you should be able to see values</li></ol> <p><img src="/dev/assets/img/OpenMQTTGateway-OpenHAB-Theengs-mqtt-things5.bf15e337.png" alt="OpenHAB integration"></p> <p>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.</p> <p><img src="/dev/assets/img/OpenMQTTGateway-OpenHAB-Theengs-mqtt.719d8beb.png" alt="OpenHAB integration"></p></div> <footer class="page-edit"><div class="edit-link"><a href="https://github.com/1technophile/OpenMQTTGateway/edit/development/docs/integrate/openhab3.md" target="_blank" rel="noopener noreferrer">Edit this page</a> <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></div> <div class="last-updated"><span class="prefix">Last Updated:</span> <span class="time">1/22/2026, 1:16:34 PM</span></div></footer> <div class="page-nav"><p class="inner"><span class="prev">
|
|
←
|
|
<a href="/dev/integrate/openhab2.html" class="prev">
|
|
Integrate OPENHAB2
|
|
</a></span> <span class="next"><a href="/dev/integrate/home_assistant.html">
|
|
Integrate Home Assistant
|
|
</a>
|
|
→
|
|
</span></p></div> </main></div><div class="global-ui"></div></div>
|
|
<script src="/dev/assets/js/app.2701250f.js" defer></script><script src="/dev/assets/js/2.f90febc1.js" defer></script><script src="/dev/assets/js/1.848070c7.js" defer></script><script src="/dev/assets/js/13.efb7256d.js" defer></script>
|
|
</body>
|
|
</html>
|