# (Option 1) Upload from the web
Running on a tablet or phone
If you want to use the BLE decoding capabilities of OpenMQTTGateway with a tablet or smartphone you can use Theengs App (opens new window).
Note
If you are on macOS and have a LilyGo LoRa32 V2.1 board, make sure you have the correct driver for the CH9102 Serial Chip (opens new window) installed and selected in the popup when initiating the web install.
To finalise the driver installation don't forget the confirmation in the Security section of System Preferences after the restart.
The correct driver to then select in the popup of this web install is
/dev/cu.wchusbserialXXXXXXXXXXX
You can upload the firmware to your ESP device directly from here.
- Plug in your ESP to a USB port.
- Select the firmware in the box below.
- Click the install button and choose the port that the ESP is connected to.
- Wait until the process is complete.
- Once completed you can configure your WiFi and MQTT credentials
Upload powered by ESP Web Tools (opens new window)
# Using OpenMQTTGateway ?
Support open-source development through sponsorship and gain exclusive access to our private forum. Your questions, issues, and feature requests will receive priority attention, plus you'll gain insider access to our roadmap.
# Environments characteristics
The auto-generated table below describes the libraries and the modules of each board configuration.
| Environment | uC | Description | Libraries | |
|---|---|---|---|---|
| 0 | airm2m_core_esp32c3 | airm2m_core_esp32c3 | BLE gateway on the C3 | , com-esp32.lib_deps, ble, decoder |
| 1 | avatto-bakeey-ir | esp01_1m | IR gateway bi directional | wifimanager8266, irremoteesp, esp8266_mdns |
| 2 | esp32-lolin32lite-ble | lolin32 | Suitable for low power with BLE gateway, tutorial (opens new window) | , com-esp32.lib_deps, ble, decoder |
| 3 | esp32-m5atom-lite | pico32 | Compact enclosure ESP32 with BLE gateway | , com-esp32.lib_deps, ble, decoder, irremoteesp, adafruit_neopixel |
| 4 | esp32-m5atom-matrix | pico32 | Compact enclosure ESP32 with BLE gateway | , com-esp32.lib_deps, ble, decoder, irremoteesp, adafruit_neopixel |
| 5 | esp32-m5stack-ble | m5stack-core-esp32 | Expandable module with BLE gateway and display | , com-esp32.lib_deps, m5stack, ble, decoder |
| 6 | esp32-m5stick-ble | m5stack-core-esp32 | Expandable module with BLE gateway, display, and little IR emitter | , com-esp32.lib_deps, ble, decoder, irremoteesp |
| 7 | esp32-m5stick-c-ble | m5stick-c | Expandable module with BLE gateway, display, and little IR emitter | , com-esp32.lib_deps, ble, decoder, m5stickc, irremoteesp |
| 8 | esp32-m5stick-cp-ble | pico32 | Expandable module with BLE gateway, display, and little IR emitter | , com-esp32.lib_deps, ble, decoder, m5stickcp, irremoteesp |
| 9 | esp32-m5tough-ble | m5stack-core-esp32 | Expandable module with BLE gateway and display, suitable for outdoor | , com-esp32.lib_deps, m5tough, ble, decoder |
| 10 | esp32-olimex-gtw-ble-eth | esp32-gateway | BLE gateway using ethernet or wifi | , com-esp32.lib_deps, ble, decoder |
| 11 | esp32-olimex-gtw-ble-poe | esp32-poe | BLE gateway using ethernet, need to be configured through PIO | , com-esp32.lib_deps, ble, decoder |
| 12 | esp32-olimex-gtw-ble-poe-iso | esp32-poe-iso | BLE gateway using ethernet, need to be configured through PIO | , com-esp32.lib_deps, ble, decoder |
| 13 | esp32-olimex-gtw-ble-wifi | esp32-gateway | BLE gateway using wifi | , com-esp32.lib_deps, ble, decoder |
| 14 | esp32-wt32-eth01-ble-eth | esp32-gateway | BLE gateway using ethernet, need to be configured through PIO | , com-esp32.lib_deps, ble, decoder |
| 15 | esp32c3-dev-c2-ble | esp32-c3-devkitm-1 | BLE gateway on Espressiv ESP32-C3evKitC-02 | , com-esp32.lib_deps, ble, decoder, adafruit_neopixel |
| 16 | esp32c3-dev-c2-ble-no-serial | BLE gateway on Espressiv ESP32-C3evKitC-02 without logging | ||
| 17 | esp32c3-dev-m1-ble | esp32-c3-devkitm-1 | BLE gateway on the C3 | , com-esp32.lib_deps, ble, decoder, adafruit_neopixel |
| 18 | esp32c3-m5stamp | esp32-c3-devkitm-1 | BLE gateway on ESP32C3 | , com-esp32.lib_deps, wifimanager32, ble, decoder, adafruit_neopixel |
| 19 | esp32c3_lolin_mini | lolin_c3_mini | BLE gateway on ESP32C3 | , com-esp32.lib_deps, ble, decoder, adafruit_neopixel |
| 20 | esp32c3_lolin_mini_with_serial | |||
| 21 | esp32c3u-m5stamp | esp32-c3-devkitm-1 | BLE gateway on ESP32C3 | , com-esp32.lib_deps, wifimanager32, ble, decoder, adafruit_neopixel |
| 22 | esp32dev-ble | esp32dev | Regular BLE gateway with adaptive scanning activated, automatically adapts the scan parameters depending on your devices | , com-esp32.lib_deps, ble, decoder |
| 23 | esp32dev-ble-aws | esp32dev | BLE gateway with AWS integration capability | , com-esp32.lib_deps, ble, decoder |
| 24 | esp32dev-ble-broker | esp32dev | MQTT Broker with BLE gateway with adaptive scanning activated, automatically adapts the scan parameters depending on your devices | , com-esp32.lib_deps, ble, decoder |
| 25 | esp32dev-ble-datatest | esp32dev | Default BLE gateway with additional servicedata, manufacturerdata and service uuid for analysing decoding issues | , com-esp32.lib_deps, ble, decoder |
| 26 | esp32dev-ble-idf | esp32dev | Regular BLE gateway based on esp-idf with adaptive scanning activated, automatically adapts the scan parameters depending on your devices | , com-esp32.lib_deps, ble, decoder |
| 27 | esp32dev-ble-mqtt-undecoded | esp32dev | BLE gateway with the decoding offloaded to Theengs Gateway | , com-esp32.lib_deps, ble |
| 28 | esp32dev-gf-sun-inverter | esp32dev | RS232 reading of GridFree Sun Inverter | , com-esp32.lib_deps, emodbus, gfSunInverter |
| 29 | esp32dev-ir | esp32dev | Infrared (Emitting and receiving) using IRremoteESP8266 | , com-esp32.lib_deps, irremoteesp |
| 30 | esp32dev-multi_receiver | esp32dev | Multi RF library with the possibility to switch between RTL_433_ESP, NewRemoteSwitch and RCSwitch, need CC1101 | , com-esp32.lib_deps, rc-switch, smartrc-cc1101-driver-lib, rtl_433_ESP, newremoteswitch |
| 31 | esp32dev-multi_receiver-pilight | esp32dev | Multi RF library with the possibility to switch between ESPilight, NewRemoteSwitch and RCSwitch, need CC1101 | , com-esp32.lib_deps, rc-switch, smartrc-cc1101-driver-lib, esppilight, newremoteswitch |
| 32 | esp32dev-pilight | esp32dev | RF gateway using ESPilight library | , com-esp32.lib_deps, esppilight |
| 33 | esp32dev-pilight-cc1101 | esp32dev | Gateway using ESPilight library only, need CC1101 | , com-esp32.lib_deps, esppilight, smartrc-cc1101-driver-lib |
| 34 | esp32dev-pilight-somfy-cc1101 | esp32dev | Gateway using Somfy Remote and ESPilight library, need CC1101 | , com-esp32.lib_deps, esppilight, somfy_remote, smartrc-cc1101-driver-lib |
| 35 | esp32dev-rf | esp32dev | RF gateway using RCSwitch library | , com-esp32.lib_deps, rc-switch |
| 36 | esp32dev-rtl_433 | esp32dev | Gateway using RTL_433_ESP library, need CC1101 | , com-esp32.lib_deps, rtl_433_ESP, smartrc-cc1101-driver-lib |
| 37 | esp32dev-somfy-cc1101 | esp32dev | Gateway using Somfy Remote library, need CC1101 | , com-esp32.lib_deps, somfy_remote, smartrc-cc1101-driver-lib |
| 38 | esp32dev-weatherstation | esp32dev | Gateway to retrieve weather station data Ventus W174/W132 (tested), Auriol H13726, Hama EWS 1500, Meteoscan W155/W160 using WeatherStationDataRx | , com-esp32.lib_deps, rfWeatherStation |
| 39 | esp32doitv1-aithinker-r01-sx1278 | esp32doit-devkit-v1 | Gateway using RTL_433_ESP library, need SX1278 | , com-esp32.lib_deps, rtl_433_ESP |
| 40 | esp32feather-ble | featheresp32 | BLE Gateway | , com-esp32.lib_deps, ble, decoder |
| 41 | esp32s3-atomS3U | m5stack-atoms3 | USB module with BLE gateway, and IR emitter | , com-esp32.lib_deps, ble, decoder, adafruit_neopixel, irremoteesp |
| 42 | esp32s3-dev-c1-ble | esp32-s3-devkitc-1 | BLE gateway on the S3 | , com-esp32.lib_deps, ble, decoder, adafruit_neopixel |
| 43 | esp32s3-m5stack-stamps3 | esp32-s3-devkitc-1 | BLE gateway on the M5Stack StampS3 | , com-esp32.lib_deps, ble, decoder, adafruit_neopixel |
| 44 | heltec-ble | heltec_wifi_lora_32_V2 | Heltec BLE gateway with adaptive scanning activated, automatically adapts the scan parameters depending on your devices | , com-esp32.lib_deps, ssd1306, ble, decoder |
| 45 | heltec-rtl_433 | heltec_wifi_lora_32_V2 | Gateway using RTL_433_ESP and RadioLib | , com-esp32.lib_deps, ssd1306, rtl_433_ESP |
| 46 | heltec-rtl_433-fsk | heltec_wifi_lora_32_V2 | Gateway using RTL_433_ESP and RadioLib with FSK modulation (beta) | , com-esp32.lib_deps, ssd1306, rtl_433_ESP |
| 47 | heltec-wifi-lora-32 | heltec_wifi_lora_32 | LORA communication using arduino-LoRA | , com-esp32.lib_deps, lora, ssd1306 |
| 48 | lilygo-ble | ttgo-lora32-v21 | LilyGo BLE gateway with adaptive scanning activated, automatically adapts the scan parameters depending on your devices | , com-esp32.lib_deps, ssd1306, ble, decoder |
| 49 | lilygo-rtl_433 | ttgo-lora32-v21 | For ESP32, Gateway using RTL_433_ESP and RadioLib | , com-esp32.lib_deps, ssd1306, rtl_433_ESP |
| 50 | lilygo-rtl_433-fsk | ttgo-lora32-v21 | For ESP32, Gateway using RTL_433_ESP and RadioLib with FSK modulation (beta) | , com-esp32.lib_deps, ssd1306, rtl_433_ESP |
| 51 | nodemcuv2-2g | nodemcuv2 | SMS gateway, need A6/A7 GSM module | wifimanager8266, a6lib |
| 52 | nodemcuv2-ir | nodemcuv2 | Infrared gateway using IRremoteESP8266 | wifimanager8266, irremoteesp, esp8266_mdns |
| 53 | nodemcuv2-pilight | nodemcuv2 | Gateway using ESPilight without the need of CC1101 | wifimanager8266, esppilight, esp8266_mdns |
| 54 | nodemcuv2-rf | nodemcuv2 | The historic RF gateway using RCSwitch library | wifimanager8266, rc-switch, esp8266_mdns |
| 55 | nodemcuv2-rf-cc1101 | nodemcuv2 | RF gateway using RCSwitch library with CC1101 | wifimanager8266, rc-switch, smartrc-cc1101-driver-lib, esp8266_mdns |
| 56 | nodemcuv2-rf2 | nodemcuv2 | KAKU RF gateway using NewRemoteSwitch library | wifimanager8266, newremoteswitch, esp8266_mdns |
| 57 | nodemcuv2-rf2-cc1101 | nodemcuv2 | KAKU RF gateway using NewRemoteSwitch library, need CC1101 | wifimanager8266, newremoteswitch, smartrc-cc1101-driver-lib, esp8266_mdns |
| 58 | nodemcuv2-serial | nodemcuv2 | SERIAL gateway | wifimanager8266, esp8266_mdns |
| 59 | nodemcuv2-somfy-cc1101 | nodemcuv2 | Somfy RF gateway using Somfy Remote library, need CC1101 | wifimanager8266, somfy_remote, smartrc-cc1101-driver-lib, esp8266_mdns |
| 60 | nodemcuv2-weatherstation | nodemcuv2 | RF gateway using WeatherStationDataRx library | wifimanager8266, rfWeatherStation, esp8266_mdns |
| 61 | rf-wifi-gateway | nodemcuv2 | RF gateway for USB stick using RCSwitch | wifimanager8266, rc-switch, esp8266_mdns |
| 62 | rfbridge | esp8285 | RF gateway for the Sonoff RF Bridge relying on the internal decoder | wifimanager8266, esp8266_mdns |
| 63 | rfbridge-direct | esp8285 | RF gateway for the Sonoff RF Bridge requiring direct hack, relying on ESPilight library, tutorial (opens new window). | wifimanager8266, esppilight |
| 64 | shelly-plus1 | esp32-solo1 | BLE, Relay control, Switch | , com-esp32.lib_deps, ble, decoder |
| 65 | sonoff-basic | esp8285 | Basic Sonoff wifi relay | wifimanager8266, esp8266_mdns |
| 66 | sonoff-basic-rfr3 | esp8285 | Wifi relay and RF receiver using RCSwitch library, tutorial (opens new window) | wifimanager8266, rc-switch, esp8266_mdns |
| 67 | theengs-bridge | esp32dev | BLE gateway with external antenna and Ethernet/WiFi connectivity, user guide (opens new window) | , com-esp32.lib_deps, ble, adafruit_neopixel, decoder |
| 68 | theengs-bridge-v11 | esp32dev | BLE gateway with external antenna and Ethernet/WiFi connectivity, user guide (opens new window) | , com-esp32.lib_deps, ble, adafruit_neopixel, decoder |
| 69 | theengs-plug | esp32dev | Smart Plug, BLE Gateway and energy monitoring, user guide (opens new window) | , com-esp32.lib_deps, ble, decoder, adafruit_neopixel, rn8209 |
| 70 | thingpulse-espgateway | esp32dev | BLE Gateway using ethernet or wifi with external antenna | , com-esp32.lib_deps, ble, adafruit_neopixel, decoder |
| 71 | tinypico-ble | tinypico | BLE gateway | , com-esp32.lib_deps, ble, decoder |
| 72 | ttgo-lora32-v1 | ttgo-lora32-v1 | LORA communication using arduino-LoRA configurable frequency | , com-esp32.lib_deps, ssd1306, lora |
| 73 | ttgo-lora32-v21 | ttgo-lora32-v21 | For ESP32, Gateway using LORA | , com-esp32.lib_deps, ssd1306, lora |
| 74 | ttgo-t-beam | ttgo-t-beam | BLE gateway with battery holder | , com-esp32.lib_deps, ble, decoder, lora |