# Theengs Bridge, Easy Setup Guide

Discover the Theengs Bridge, a smart Bridge and BLE gateway in one device. This guide will help you quickly connect your Bridge to an MQTT broker.

  1. Plug it in: Connect the device to a 5V USB-C power supply. An orange LED will turn on steadily.

  2. Connect to WiFi: On your smartphone, search for a WiFi network starting with OMG_. Alternatively, you can connect an ethernet cable to the bridge and access the configuration by typing the bridge IP into a browser (the bridge IP can be found on your router or by a serial connection)

  3. Access the setup page: A webpage may pop up automatically. If not, click on the gear icon next to the WiFi network.

  4. Then click on "Manage router".


If your smartphone disconnects from the Bridge's WiFi network and reconnects to your main WiFi, "forget" your main WiFi to maintain a stable connection with the Bridge. After configuration, reconnect to your main WiFi. If the configuration portal doesn't appear, access it at in your web browser.

  1. Configure WiFi: Click on "Configure WiFi".

  2. Enter your settings: Fill in the following required details:

  • Your WiFi Access Point (SSID - optional if ethernet connected)
  • Your WiFi password (Password - optional if ethernet connected)
  • Your MQTT server
  • Your MQTT port

Optionally, adjust the following settings if needed:

  • MQTT user
  • MQTT password
  • Secure connection and certificates (if required)
  • Gateway name
  • Base topic
  • Password (this password will be used for configuration portal and Over The Air updates)


When using the bridge with ethernet, entering WiFi Access Point and Password will enable to have a fallback connection network if ethernet is disconnect.

  1. Save: Click on Save.

When connected, the bridge first LED should turn green and second LED will blink blue during scanning.

For further integration with a Home Automation Controller, refer to the OpenMQTTGateway documentation (opens new window).

For assistance or support, email: florian@theengs.io.

# Safety Instructions

When using the Theengs Bridge, please follow these safety guidelines to ensure proper operation and to prevent potential hazards:

a. Read and follow all instructions provided in this manual before using the Theengs Bridge.

b. The Theengs Bridge is designed for indoor use only. Do not use it outdoors or expose it to moisture, excessive heat, or direct sunlight.

c. Ensure that the power supply used is in good working condition and complies with local electrical codes.

e. Keep the Theengs Bridge away from water, flammable materials, and sources of ignition.

f. Disconnect the Theengs Bridge from its power supply before cleaning or performing any maintenance. Use a dry cloth to clean the Theengs Bridge, and avoid using harsh chemicals or abrasive materials.

g. Do not attempt to disassemble, repair, or modify the Theengs Bridge. Doing so may cause damage, void the warranty, and potentially create safety hazards.

h. In the event of a malfunction or suspected problem with the Theengs Bridge, disconnect it immediately and contact customer support for assistance.

i. Keep the Theengs Bridge and its packaging materials out of reach of children and pets to avoid the risk of choking or injury.

# Specifications

Feature Specification
Power Supply USB-C 5.0V
Microcontroller ESP32
Memory 8MB
WiFi Band 2.4 GHz
Protocol MQTT
Ethernet RJ45
Antenna 2.4GHz 6dBi 50ohm Wireless Antenna
Board type Development board with Grove connector
Dimensions 4.05in * 1.37in * 2.4in (160 × 120 × 30 mm without antenna)
Usage Indoor use only

# Warranty

The Theengs Bridge hardware warranty is one year from the date of purchase. See details here (opens new window)

The Bridge is delivered with firmware developed under GPLv3 license (opens new window), by using it, you accept the terms and conditions of this license.

Last Updated: 3/13/2024, 8:14:59 PM