ESP32-BLE2MQTT
A BLE to MQTT bridge for ESP32 that exposes Bluetooth GATT characteristics and advertisements as MQTT topics.
What is ESP32-BLE2MQTT?
ESP32-BLE2MQTT is a firmware application for ESP32 microcontrollers that bridges Bluetooth Low Energy (BLE) devices to an MQTT broker. It translates BLE GATT characteristics and broadcaster advertisements into MQTT topics, enabling seamless integration of BLE sensors and peripherals into IoT and home automation systems.
IoT developers and hobbyists building home automation or industrial monitoring systems that need to integrate BLE sensors and devices into an MQTT-based ecosystem.
It provides a robust, configurable bridge that simplifies integrating diverse BLE devices into MQTT-based ecosystems, emphasizing automation and interoperability, with features like automatic notifications, connection management, and over-the-air updates.
Overview
A BLE to MQTT bridge running on an ESP32
Use Cases
Best For
- Integrating BLE sensors (e.g., temperature, humidity, battery level) into home automation platforms like Home Assistant via MQTT.
- Bridging non-connectable BLE broadcasters (e.g., iBeacon, Eddystone, Xiaomi sensors) to publish advertisements as MQTT messages.
- Building IoT systems that require bidirectional communication with BLE peripherals through readable and writable MQTT topics.
- Managing multiple ESP32 bridge instances with connection status and ownership topics to prevent conflicts.
- Deploying remote firmware and configuration updates over-the-air after initial serial flashing.
- Connecting ESP32 devices to networks via either WiFi or Ethernet with configurable security and device filtering.
Not Ideal For
- Projects needing a plug-and-play solution without compiling or firmware development – requires ESP-IDF setup and build process.
- Systems that rely on non-MQTT protocols like HTTP or CoAP for device communication, as it's MQTT-centric.
- Applications requiring real-time, low-latency control of BLE devices where MQTT's pub/sub model might introduce network delays.
- Teams without embedded systems experience, due to the need for board-specific configurations and potential debugging.
Pros & Cons
Pros
Maps GATT characteristics and supports various broadcasters like iBeacon and Xiaomi sensors, automatically publishing decoded data to MQTT topics with notifications and read/write capabilities.
Implements ownership and connection status topics to prevent conflicts between multiple bridge instances, ensuring stable and conflict-free device management.
Supports both WiFi and Ethernet connectivity with configurable security, including WPA-Enterprise and MQTT SSL, allowing adaptation to diverse network environments.
Enables over-the-air updates for firmware and configuration via MQTT after initial serial flashing, simplifying maintenance and deployment.
Cons
Must use ESP-IDF v5.2.1 specifically; the README warns that other versions might not compile or be stable, limiting flexibility and upgrade options.
Requires full ESP-IDF toolchain installation, compiling, and flashing, which can be time-consuming and challenging for those new to embedded development.
For boards like Olimex ESP32-POE, manual configuration changes in JSON and menuconfig are required, indicating lack of out-of-the-box support for all ESP32 variants.
Frequently Asked Questions
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.