[DOCS] Theengs Plug highlight and SEO improvements (#1730)
* [DOCS] Theengs Plug highlight * Add alt content for images and description
This commit is contained in:
Florian authored and GitHub committed
1 parent
79a8591b83
commit
7a2bb04a1b
19 files changed
+138
-109
No files matched your search
@@ -4,7 +4,7 @@
|
||||
|
||||
[](http://isitmaintained.com/project/1technophile/openmqttgateway "Percentage of issues still open")
|
||||
|
||||
[](https://community.openmqttgateway.com)
|
||||
[](https://community.openmqttgateway.com)
|
||||
|
||||
OpenMQTTGateway project goal is to concentrate in one firmware different technologies and protocols, decreasing by the way the number of physical bridges needed, and hiding the different technologies singularity behind a simple & wide spread communication protocol; MQTT.
|
||||
|
||||
@@ -23,15 +23,15 @@ The reference sheet, with the list of all functions, pinouts is [here](https://d
|
||||
Upload OpenMQTTGateway directly from the [upload page](https://docs.openmqttgateway.com/upload/web-install.html) (no additional software required) or [build your own configuration](https://docs.openmqttgateway.com/upload/builds.html) with [PlatformIO](https://platformio.org/) or [Arduino IDE](https://www.arduino.cc/en/software)
|
||||
|
||||
|
||||
## First ready to go OpenMQTTGateway device !
|
||||
## The first plug-and-play OpenMQTTGateway BLE gateway and Smart Plug !
|
||||
|
||||
[Theengs plug](https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption) is available flashed with OpenMQTTGateway, and brings the functions below:
|
||||
* BLE to MQTT gateway, tens of Bluetooth devices supported thanks to Theengs Decoder library. The plug uses an ESP32 acting as a BLE to Wifi gateway to scan, decode and forward the data of the nearby sensors,
|
||||
* BLE to MQTT gateway, tens of [Bluetooth devices](https://compatible.openmqttgateway.com/index.php/devices/ble-devices/) supported thanks to Theengs Decoder library. The plug uses an ESP32 acting as a BLE to Wifi gateway to scan, decode and forward the data of the nearby sensors,
|
||||
* Smart plug that can be controlled remotely,
|
||||
* Energy consumption monitoring,
|
||||
* Presence detection (beta).
|
||||
|
||||
[](https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption)
|
||||
[](https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption)
|
||||
|
||||
Support the project by purchasing the [Theengs plug](https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption)
|
||||
The plug is available in North America only, other regions are planned.
|
||||
|
||||
+3
-3
@@ -41,15 +41,15 @@ Behind the scene you will find functionalities dedicated to gateways like:
|
||||
* Secure connections
|
||||
* Over the air updates
|
||||
|
||||
## First ready to go OpenMQTTGateway device !
|
||||
## The first plug-and-play OpenMQTTGateway BLE gateway and Smart Plug !
|
||||
|
||||
[Theengs plug](https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption) is available flashed with OpenMQTTGateway, and brings the functions below:
|
||||
* BLE to MQTT gateway, tens of Bluetooth devices supported thanks to Theengs Decoder library. The plug uses an ESP32 acting as a BLE to Wifi gateway to scan, decode and forward the data of the nearby sensors,
|
||||
* BLE to MQTT gateway, tens of [Bluetooth devices](https://compatible.openmqttgateway.com/index.php/devices/ble-devices/) supported thanks to Theengs Decoder library. The plug uses an ESP32 acting as a BLE to Wifi gateway to scan, decode and forward the data of the nearby sensors,
|
||||
* Smart plug that can be controlled remotely,
|
||||
* Energy consumption monitoring,
|
||||
* Presence detection (beta).
|
||||
|
||||
[](https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption)
|
||||
[](https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption)
|
||||
|
||||
Support the project by purchasing the [Theengs plug](https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption)
|
||||
The plug is available in North America only, other regions are planned.
|
||||
|
||||
+16
-16
@@ -4,21 +4,21 @@
|
||||
* From AWS console, search for IOT core
|
||||
* Create a Thing and name it, this name will be used as the OpenMQTTGateway name.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Create a policy
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
* Add this json code to the policy
|
||||
```json
|
||||
@@ -46,26 +46,26 @@
|
||||
|
||||
* Create a new certificate
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
* Download certificates and key
|
||||
|
||||
|
||||
|
||||
|
||||
## Attach Policy with certificate
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Activate certificate and attach it to Thing
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Find AWS EndPoint
|
||||
|
||||
|
||||
|
||||
|
||||
## Gather the information for OpenMQTTGateway configuration
|
||||
|
||||
@@ -106,4 +106,4 @@ Enter your credentials and verify that Secure connection is marked.
|
||||
|
||||
You should see messages coming.
|
||||
|
||||
|
||||
|
||||
@@ -15,11 +15,11 @@ On OpenMQTTGateway the Home Assistant discovery is enabled by default on all bin
|
||||
|
||||
Enable discovery on your MQTT integration in HASS (activated per default).
|
||||
|
||||
|
||||
|
||||
|
||||
The gateway will need an MQTT username and password, you have to create a new user(recommended) into Home Assistant->Configuration->Users (available in admin mode) or use an existing username/pwd combination (not recommended). This user doesn't need to be an administrator.
|
||||
|
||||
|
||||
|
||||
|
||||
::: warning Note
|
||||
The max size of the username is 30 and 60 for the password.
|
||||
@@ -27,11 +27,11 @@ The max size of the username is 30 and 60 for the password.
|
||||
|
||||
OMG will use the auto discovery functionality of home assistant to create gateway and sensors into your HASS instance automatically.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
::: info
|
||||
The Bluetooth and the RTL_433 gateway will create automatically devices and entities, the RF gateway will create DeviceTrigger.
|
||||
|
||||
+25
-25
@@ -14,28 +14,28 @@ To be able to use MQTT protocol into Jeedom and decode json payloads, [plugin jM
|
||||
* Install the stable version,
|
||||
* Go to the plugin configuration page next.
|
||||
|
||||
|
||||
|
||||
|
||||
* On the plugin configuration page, activate the plugin,
|
||||
|
||||
|
||||
|
||||
|
||||
* If you don't already have a MQTT Broker or you want to install Mosquitto on the local machine, then check "Install Mosquitto locally" box.
|
||||
Otherwise, if you already use the "MQTT" plugin OR the "MQTT Manager" plugin OR you already have a Broker you know of, then ensure the "Install Mosquitto locally" box is uncheck,
|
||||
|
||||
|
||||
|
||||
|
||||
* Install the dependencies, if they have not already started,
|
||||
|
||||
|
||||
|
||||
|
||||
* Wait until they are installed, and start the Daemon,
|
||||
|
||||
|
||||
|
||||
|
||||
* Dependencies and Daemon are now OK,
|
||||
|
||||
|
||||
|
||||
|
||||
-> If you checked "Install Mosquitto locally", Then you can skip to "[Creation of the OMG device](#creation-of-the-omg-device)" step, jMQTT has automagically created a Broker called "local" for you.
|
||||
|
||||
@@ -44,13 +44,13 @@ Otherwise, if you already use the "MQTT" plugin OR the "MQTT Manager" plugin OR
|
||||
* Click on "Add a broker",
|
||||
* Enter "local" as Broker name (or whatever name you want),
|
||||
|
||||
|
||||
|
||||
|
||||
* Check "Activer" box and switch to "Broker" tab without saving (yet),
|
||||
* Enter "jMQTT" as "Identifier/ClientId" so as not to interfere with other topics,
|
||||
-> If your Broker is not local, then fill in "IP/Hostname of the Broker" and "Port of the Broker",
|
||||
|
||||
|
||||
|
||||
|
||||
* Save the device, the initial configuration of jMQTT is complete.
|
||||
|
||||
@@ -61,45 +61,45 @@ This step aims to create an equipment in jMQTT representing the OMG device itsel
|
||||
* Go to the jMQTT plugin page via "Plugin> Domotic protocol> jMQTT",
|
||||
* Click on "Add equipment" on the Broker created in step 2 (or existing one):
|
||||
|
||||
|
||||
|
||||
|
||||
* Give it the name "gateway name" configured in step 4 (for me OMG_tuto),
|
||||
* In "Registered with the Topic", put the basic topic of the EST, followed by the "gateway name", followed by a slash and a hash (for me `bt/OMG_tuto/#`), this will allow to receive all messages starting with `bt/OMG_tuto/`,
|
||||
* Check the "Automatic addition of commands" box checked and the other default values,
|
||||
* Activate the equipment and save:
|
||||
|
||||
|
||||
|
||||
|
||||
* Restart the OMG device, quickly commands should start to appear:
|
||||
|
||||
|
||||
|
||||
|
||||
* Let it run for 5 minutes, go smoke a coffee, you deserve it,
|
||||
* Uncheck the "Automatically add commands" box and save,
|
||||
* Go to the Commands tab, several info commands should have appeared:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Creation of the Last Will and Testament command
|
||||
* The interesting command here is "LWT", put it in binary info, activate "Historize", deactivate "Display" and save:
|
||||
|
||||
|
||||
|
||||
|
||||
* In the advanced properties of the command, Configuration tab, define the "Calculation formula" `#value# == "online"`, save:
|
||||
|
||||
|
||||
|
||||
|
||||
* Electrically disconnect the OMG device, the control goes to 0 after about ten seconds.
|
||||
Congratulations you have a command that lets you know if your OMG device is alive!
|
||||
Creation of "uptime", "freemem", "frestack" and "rssi" info commands:
|
||||
* Among the discovered commands, there must also be "SYStoMQTT":
|
||||
|
||||
|
||||
|
||||
|
||||
* Switch to JSON mode, there are various interesting sub-commands:
|
||||
|
||||
|
||||
|
||||
|
||||
If you want, you can create 'uptime', 'freemem', 'frestack' and 'rssi'.
|
||||
|
||||
@@ -107,7 +107,7 @@ If you want, you can create 'uptime', 'freemem', 'frestack' and 'rssi'.
|
||||
* OMG has several commands 1 that can be executed directly in MQTT.
|
||||
* Create an action command to restart the OMG device:
|
||||
|
||||
|
||||
|
||||
|
||||
(topic: `bt/OMG_tuto/commands/MQTTtoSYS/config`; payload: `{"cmd":"restart"}`)
|
||||
* Press the "Test" button on the control,
|
||||
@@ -125,7 +125,7 @@ If you want, you can create 'uptime', 'freemem', 'frestack' and 'rssi'.
|
||||
* Check "Automatic command creation", "Enable", "Visible", and save,
|
||||
* Many devices are detected and added to this equipment:
|
||||
|
||||
|
||||
|
||||
|
||||
* We see that the topics always end with the MAC address of the equipment,
|
||||
* Once you have identified the equipment you are interested in, 2 options are available to you:
|
||||
@@ -137,7 +137,7 @@ If you want, you can create 'uptime', 'freemem', 'frestack' and 'rssi'.
|
||||
* Identify in the list the MAC of your devices,
|
||||
* You may have seen this in the previous captures:
|
||||
|
||||
|
||||
|
||||
|
||||
This is exactly what you think it is!
|
||||
|
||||
@@ -147,28 +147,28 @@ This is exactly what you think it is!
|
||||
* Leave "Automatic addition of commands" deactivated,
|
||||
* Check Enable and Visible, but no need to save for now,
|
||||
|
||||
|
||||
|
||||
|
||||
* In the Commands tab, create an info "tmp" command of another type on the topic `bt/OMG_tuto/BTtoMQTT/582D3431FE5F` and save:
|
||||
|
||||
|
||||
|
||||
|
||||
* After a few minutes, a value arrives in the command,
|
||||
* Then switch to JSON view and create the commands you need:
|
||||
|
||||
|
||||
|
||||
|
||||
* Delete "tmp" which is no longer useful and save:
|
||||
|
||||
|
||||
|
||||
|
||||
* All that remains is to do the visual part as you want it on your Dashboard:
|
||||
|
||||
|
||||
|
||||
|
||||
For example:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
+13
-13
@@ -10,7 +10,7 @@ Prerequisites: node-red, node-red-dashboard
|
||||
* Add a new broker or connect to an existing one (server field)
|
||||
* Set the topic like below with the MAC address at the end being the one of the device you want to integrate
|
||||
|
||||
|
||||
|
||||
|
||||
::: tip
|
||||
The "+" enables to process the data from all the gateways whatever name they have. So you may setup several OpenMQTTGateway, you will not have to change the Node-Red configuration.
|
||||
@@ -21,17 +21,17 @@ This configuration enables to process all the data coming from the sensor.
|
||||
* Click on done
|
||||
* So as to monitor the traffic coming; you can add a debug node with *msg.payload* as Output
|
||||
|
||||
|
||||
|
||||
|
||||
* Link it to the `mqtt in` node
|
||||
|
||||
|
||||
|
||||
|
||||
* Deploy
|
||||
* Open the debug panel
|
||||
* You should see messages coming when the gateway will receive data
|
||||
|
||||
|
||||
|
||||
|
||||
### Json message processing
|
||||
We need to process the json message so as to extract the value that we want to display.
|
||||
@@ -40,7 +40,7 @@ We need to process the json message so as to extract the value that we want to d
|
||||
* Configure it as `Move`
|
||||
* Add the msg value you would like to process example *msg.payload.tempc* and the target *msg.payload*
|
||||
|
||||
|
||||
|
||||
|
||||
* Connect the `change` node to the `mqtt in` node
|
||||
|
||||
@@ -51,7 +51,7 @@ You can now add widget so as to display the value processed above
|
||||
* Add a group and organize your dashboard
|
||||
* Add your value format to process the payload like below
|
||||
|
||||
|
||||
|
||||
|
||||
* Click on Done
|
||||
* Deploy
|
||||
@@ -59,17 +59,17 @@ You can now add widget so as to display the value processed above
|
||||
|
||||
You should see the gauge with the last value displayed
|
||||
|
||||
|
||||
|
||||
|
||||
You can also add easily a chart node:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Or a function with a notification:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Integrate RF
|
||||
@@ -77,11 +77,11 @@ Here is a simple set of flows for integrating OpenMQTTGateway with NodeRED via a
|
||||
|
||||
In this example I have used a Wemos D1 Mini with some cheap RF modules.
|
||||
|
||||
|
||||
|
||||
|
||||
A flow to receive 433MHz signals into NodeRED (you will need to update the IP address of your broker)
|
||||
|
||||
|
||||
|
||||
|
||||
```json
|
||||
[
|
||||
@@ -141,7 +141,7 @@ A flow to receive 433MHz signals into NodeRED (you will need to update the IP ad
|
||||
|
||||
A flow to send 433MHz signals from NodeRED
|
||||
|
||||
|
||||
|
||||
|
||||
```json
|
||||
[
|
||||
|
||||
@@ -12,7 +12,7 @@ If you are connecting to BLE devices it is highly recommended to set `filterConn
|
||||
:::
|
||||
|
||||
The things will appear in the inbox of the paperUI, add them and links the channels. You should see them into the control panel for further usage.
|
||||
|
||||
|
||||
|
||||
## MQTT 2 manual setup >=Openhab2.4
|
||||
You should have an MQTT broker installed (either mosquitto or the OpenHAB2 embedded one)
|
||||
|
||||
+14
-14
@@ -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
|
||||
|
||||
|
||||
|
||||
|
||||
::: 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)
|
||||
|
||||
|
||||
|
||||
|
||||
4. Once installed click on Things under Settings
|
||||
5. Click on the + at the bottom right
|
||||
6. Click on MQTT Binding
|
||||
|
||||
|
||||
|
||||
|
||||
7. Click on MQTT broker
|
||||
|
||||
|
||||
|
||||
|
||||
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`
|
||||
|
||||
|
||||
|
||||
|
||||
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
|
||||
|
||||
|
||||
|
||||
|
||||
11. Click on Create Thing at the bottom, you should see your MQTT Broker in the Things list with the status "online"
|
||||
|
||||
|
||||
|
||||
|
||||
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
|
||||
|
||||
|
||||
|
||||
|
||||
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
|
||||
|
||||
|
||||
|
||||
|
||||
2. Click on INBOX, you should see your BLE devices and the gateway
|
||||
|
||||
|
||||
|
||||
|
||||
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.
|
||||
|
||||
|
||||
|
||||
|
||||
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
|
||||
|
||||
|
||||
|
||||
|
||||
12. Click on "Add to Model"
|
||||
13. Go to Model, if you unfold your location and Equipment you should be able to see values
|
||||
|
||||
|
||||
|
||||
|
||||
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.
|
||||
|
||||
|
||||
|
||||
@@ -17,14 +17,14 @@ The display is always OFF, if the board has a led, the led is used when processi
|
||||
To change the low power mode you can do it by [MQTT](../use/boards#low-power-mode-for-m5-boards) or by pushing the middle button (btn B) of the M5Stack and the top button (btn B) of the M5Stick C
|
||||
|
||||
### Start screen
|
||||
|
||||
|
||||
|
||||
### Sleep screen
|
||||
The screen brightness is put to a minimum so as to reduce power consumption.
|
||||
|
||||
|
||||
|
||||
### Log display in case of warning
|
||||
If the gateway detects a warning or an error the sleep go out the sleep screen and show the message with a red (error) or orange (warning) background.
|
||||
|
||||
|
||||
|
||||
The M5Stick support low power mode 2 but its display is not supported for the moment.
|
||||
@@ -21,7 +21,7 @@ If you want to use the BLE decoding capabilities of OpenMQTTGateway with a table
|
||||
* Energy consumption monitoring,
|
||||
* Presence detection (beta).
|
||||
|
||||
[](https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption)
|
||||
[](https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption)
|
||||
|
||||
Support the project by purchasing the [Theengs plug](https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption)
|
||||
The plug is available in North America only, other regions are planned.
|
||||
|
||||
+2
-2
@@ -4,7 +4,7 @@
|
||||
|
||||
You can use a barebone ESP32 or some nice looking products like the ones below (from M5Stack):
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
For Arduino and ESP8266, we previously used HM10, this module is no longer supported by OpenMQTTGateway, prefer an ESP32.
|
||||
@@ -67,7 +67,7 @@ To your environment definition.
|
||||
|
||||
So as to create the MQTT username and password, you have to create a new user(recommended) into Home Assistant->Configuration->Users (available in admin mode) or use an existing username/pwd combination (not recommended). This user doesn't need to be an administrator.
|
||||
|
||||
|
||||
|
||||
|
||||
::: warning
|
||||
The max size of the username is 30 and 60 for the password.
|
||||
@@ -77,4 +77,4 @@ OMG will use the auto discovery functionality of home assistant to create sensor
|
||||
|
||||
The gateway device will be available into Configuration->Devices section of Home Assistant.
|
||||
|
||||
|
||||
|
||||
@@ -73,7 +73,7 @@ If you want to upload the ready-to-go binary from Linux (or any other OS where y
|
||||
https://github.com/marcelstoer/nodemcu-pyflasher/releases
|
||||
* Execute `NodeMCU-PyFlasher`
|
||||
* Set the files and parameters as below:
|
||||
|
||||
|
||||
* Connect your board and select the COM port
|
||||
* Click on *FlashNodeMCU*
|
||||
The upload details appears.
|
||||
|
||||
@@ -10,9 +10,9 @@ To build OpenMQTTGateway from the web and download the binary, follow these step
|
||||
3. A first build for `esp32dev-ble` will be launched automatically. To modify the environment configuration, go to the environments.ini file in the root folder and launch the command like the one shown at the bottom of the image below:
|
||||
`platformio run -e <environment name>`
|
||||
|
||||
|
||||
|
||||
|
||||
4. Wait for the server to build the binary. Once you see [SUCCESS], you can go to `.pio/build/<environment name>` and download `firmware.bin` and `partitions.bin` by right-clicking on each and selecting "Download."
|
||||
|
||||
|
||||
|
||||
5. Finally, follow [Option 2](binaries.md) to upload the binary.
|
||||
+26
-10
@@ -1,14 +1,30 @@
|
||||
---
|
||||
title: ESP32 BLE MQTT Gateway
|
||||
description: Versatile BLE gateway that scans and decodes data from various Bluetooth devices. It integrates seamlessly with MQTT brokers and controllers like Home Assistant and OpenHAB. Monitor temperature, humidity, pressure, and more for smarter control.
|
||||
---
|
||||
# BLE gateway
|
||||
|
||||
The manufacturer agnostic BLE gateway acts as a powerful BLE scanner of devices and decoder, allowing you to visualize and analyze information from a wide range of BLE devices.
|
||||
It can also act as a presence detection gateway by reading the nearby BLE tags or tracker devices.
|
||||
The manufacturer agnostic BLE gateway acts as a powerful BLE scanner and decoder of [Bluetooth devices](https://compatible.openmqttgateway.com/index.php/devices/ble-devices/), allowing you to visualize and analyze information from a wide range of sensors.
|
||||
It can also act as a presence detection gateway by reading the nearby BLE tags or tracker.
|
||||
|
||||
Data are transmitted to an MQTT broker, where it can be used to trigger events and rules, as well as displayed, stored and processed in your favorite controller.
|
||||
Data are transmitted to an MQTT broker, where it can be used to trigger events and rules, as well as displayed, stored and processed in your favorite controller (Home Assistant, OpenHAB, Jeedom, Domoticz, ioBroker or any MQTT compatible software).
|
||||
|
||||
With the ability to monitor and analyze data such as temperature, humidity, moisture, luminance, weight, pressure, fine particles, and more, the BLE gateway provides a flexible and customizable solution for integrating BLE technology into your control and monitoring systems.
|
||||
|
||||
|
||||
|
||||
|
||||
## The first plug-and-play OpenMQTTGateway BLE gateway and Smart Plug!
|
||||
|
||||
[Theengs plug](https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption) is available flashed with OpenMQTTGateway, and brings the functions below:
|
||||
* BLE to MQTT gateway, tens of [Bluetooth devices](https://compatible.openmqttgateway.com/index.php/devices/ble-devices/) supported thanks to Theengs Decoder library. The plug uses an ESP32 acting as a BLE to Wifi gateway to scan, decode and forward the data of the nearby sensors,
|
||||
* Smart plug that can be controlled remotely,
|
||||
* Energy consumption monitoring,
|
||||
* Presence detection (beta).
|
||||
|
||||
[](https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption)
|
||||
|
||||
Support the project by purchasing the [Theengs plug](https://shop.theengs.io/products/theengs-plug-smart-plug-ble-gateway-and-energy-consumption)
|
||||
The plug is available in North America only, other regions are planned.
|
||||
|
||||
## Receiving signals from [compatible BLE sensors](https://decoder.theengs.io/devices/devices_by_brand.html) to publish it to an MQTT broker.
|
||||
To receive data from BLE sensors you can use an ESP32-based device with a programming USB port or use a Serial adapter.
|
||||
@@ -21,11 +37,11 @@ OpenMQTTGateway is also available preloaded and configured with the [Theengs plu
|
||||
|
||||
1. You should see data coming in your broker.
|
||||
|
||||
|
||||
|
||||
|
||||
Once the data has been transmitted to the MQTT broker, it can be easily integrated with your preferred controller. For example, the data can be automatically discovered and made available within popular controllers, example below with Home Assistant.
|
||||
|
||||
|
||||
|
||||
|
||||
Examples of compatible sensors among [our list](https://decoder.theengs.io/devices/devices_by_brand.html: Mi Flora, Mi jia, LYWDS02, LYWSD03MMC, ClearGrass, Mi scale, iBBQ, TPMS
|
||||
|
||||
@@ -35,8 +51,8 @@ To do this activate the "BT: Publish HASS presence" switch in your controller or
|
||||
`mosquitto_pub -t home/OpenMQTTGateway/commands/MQTTtoBT/config -m '{"hasspresence":true}'`
|
||||
|
||||
The entity created can be attached to a person to leverage presence detection. The `away` or `not home` state is triggered if the BLE tracker is not detected during the timer defined by `presenceawaytimer`.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
If you have multiple gateways, your BLE trackers may not be detected temporary by one gateway but still by the others. In this case you will see the tracker appears offline briefly and online again once it is detected by the others gateways.
|
||||
|
||||
@@ -65,9 +81,9 @@ To ensure proper functionality, configure the beacon using the KBeacon or KBeaco
|
||||
* In the General tab, set the Trigger Command to "motion".
|
||||
* In the Slot tab, enable advertisement with the Beacon Type set to "KSensor", the Trigger Only Advertisement option set to "YES", and the Sensor Axis set to "ON".
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## Setting a white or black list
|
||||
A black list is a list of MAC addresses that will never be published by OMG
|
||||
|
||||
+1
-1
@@ -128,7 +128,7 @@ It can be used with version 1.5.0 and above.
|
||||
|
||||
Note that this update option is also autodiscovered through Home Assistant convention, you can update directly from the device page with 2 clicks.
|
||||
|
||||
|
||||
|
||||
|
||||
You can also indicate the target version to update:
|
||||
```
|
||||
|
||||
+6
-1
@@ -1,3 +1,8 @@
|
||||
---
|
||||
title: Infrared MQTT Gateway
|
||||
description: Unlock the potential of Infrared technology with our universal gateway. Decode signals from various devices, and integrate seamlessly with MQTT systems abd controllers like Home Assistant and OpenHAB.
|
||||
---
|
||||
|
||||
# IR gateway
|
||||
There is two methods for finding the IR codes you want to replicate:
|
||||
1. Point the remote control to an IR receiver see [Receiving data from IR signal](#receiving-data-from-ir-signal) & [Send data by MQTT to convert it on IR signal](#send-data-by-mqtt-to-convert-it-on-ir-signal)
|
||||
@@ -24,7 +29,7 @@ To receive big dump of raw data you need first to modify the [config_IR.h](https
|
||||
Unknown protocols are filtered by default, if you want to see the unknown protocols set into [config_IR.h](https://github.com/1technophile/OpenMQTTGateway/blob/master/config_IR.h)
|
||||
`#define pubIRunknownPrtcl true` instead of false
|
||||
|
||||
|
||||
|
||||
|
||||
You can take this code and try to reproduce it with the gateway either by using [decimal value](#send-data-by-mqtt-to-convert-it-on-ir-signal) or the [raw value](#send-raw-ir-data-by-mqtt).
|
||||
|
||||
|
||||
+6
-2
@@ -1,3 +1,7 @@
|
||||
---
|
||||
title: LORA MQTT Gateway
|
||||
description: Explore the LORA MQTT gateway, designed for integration with devices utilizing LORA technology, including the MakerFab soil and moisture sensor. Unlock long range communication with the power of LORA..
|
||||
---
|
||||
# LORA gateway
|
||||
|
||||
Tutorial on how to leverage LORA for a mailbox sensor from [PricelessToolkit](https://www.youtube.com/channel/UCz75N6inuLHXnRC5tqagNLw):
|
||||
@@ -11,7 +15,7 @@ Subscribe to all the messages with mosquitto or open your MQTT client software:
|
||||
|
||||
Generate your LORA signals by using another TTGO LORA module, you can flash the sender program from [this repository](https://github.com/LilyGO/TTGO-LORA32-V2.0) and the SSD1306 library [there](https://github.com/ThingPulse/esp8266-oled-ssd1306)
|
||||
|
||||
|
||||
|
||||
|
||||
Once one board flashed with OMG and the other with the sender program you should receive regular packets into `home/OpenMQTTGateway_ESP32_LORA_TEST/LORAtoMQTT` like below:
|
||||
|
||||
@@ -34,7 +38,7 @@ And from a supported device (in this case, a WiPhone), looks like this:
|
||||
|
||||
This command will send by LORA the message "hello OMG1" and use the default parameters defined in [config_LORA.h](https://github.com/1technophile/OpenMQTTGateway/blob/4b8d28179b63ae3f3d454da57ec8c109c159c386/config_LORA.h#L32)
|
||||
|
||||
|
||||
|
||||
|
||||
If you want to test that your sending works you can use another TTGO LORA module, you can flash the receiver program from [this repository](https://github.com/LilyGO/TTGO-LORA32-V2.0) and the SSD1306 library [there](https://github.com/ThingPulse/esp8266-oled-ssd1306)
|
||||
|
||||
|
||||
+7
-3
@@ -1,3 +1,7 @@
|
||||
---
|
||||
title: 433Mhz MQTT Gateway
|
||||
description: Unlock the potential of RF 433 MHz technology with our universal gateway. Decode signals from various devices, and integrate seamlessly with MQTT systems and controllers like Home Assistant and OpenHAB.
|
||||
---
|
||||
|
||||
# RF gateways (433mhz/315mhz)
|
||||
|
||||
@@ -197,13 +201,13 @@ This command will send by RF the code 1315156 and use the default parameters (pr
|
||||
|
||||
Arduino IDE serial data received when publishing data by MQTT
|
||||
|
||||
|
||||
|
||||
|
||||
We see that the Arduino receive the value 1315156 on the MQTT subject "MQTTto433" and send the data by RF
|
||||
|
||||
Arduino IDE serial data received when receiving data by 433Mhz
|
||||
|
||||
|
||||
|
||||
|
||||
### Send data by MQTT with advanced RF parameters
|
||||
|
||||
@@ -261,7 +265,7 @@ Subscribe to all the messages with mosquitto or open your MQTT client software:
|
||||
|
||||
Generate your RF signals by pressing a remote button or other and you will see :
|
||||
|
||||
|
||||
|
||||
|
||||
#### Enabling RAW packet return support
|
||||
First, you need to compile a binary with `Pilight_rawEnabled true` uncommented in config_RF.h.
|
||||
|
||||
Reference in new issue
Block a user