Skip to main content

BLE to MQTT bridge

Project description

Service to export BLE devices to MQTT with Home Assistant discovery

!!! It is a very early alpha release !!!

Use this software at your own risk.

Default config should be located in /etc/ble2mqtt.json or can be overridden with BLE2MQTT_CONFIG environment variable.

Example run command:

BLE2MQTT_CONFIG=./ble2mqtt.json python3 ble2mqtt.py

The configuration file is a JSON with the following content:

{
    "mqtt_host": "localhost",
    "mqtt_port": 1883,
    "mqtt_user": "",
    "mqtt_password": "",
    "devices": [
        {
            "address": "11:22:33:aa:bb:cc",
            "type": "redmond200"
        },
        {
            "address": "11:22:33:aa:bb:dd",
            "type": "xiaomihtv1"
        },
        {
            "address": "11:22:33:aa:bb:ee",
            "type": "xiaomilywsd"
        }
    ]
}

Supported devices:

Kettles:

  • Redmond G2xx series (redmond200)

Humidity sensors:

  • Xiaomi MJ_HT_V1 (xiaomihtv1)
  • Xiaomi LYWSD03MMC (xiaomilywsd)

OpenWRT installation

Execute the following commands in the terminal:

opkg update
opkg install python3-twisted python3-pip python3-asyncio
pip install -U ble2mqtt

Create the configuration file in /etc/ble2mqtt.json and append your devices.

Bluetooth must be turned on.

hciconfig hci0 up

Run the service in background

python -m ble2mqtt 2> /tmp/ble2mqtt.log &

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ble2mqtt-0.1.0a5.tar.gz (15.5 kB view details)

Uploaded Source

Built Distribution

ble2mqtt-0.1.0a5-py2-none-any.whl (19.5 kB view details)

Uploaded Python 2

File details

Details for the file ble2mqtt-0.1.0a5.tar.gz.

File metadata

  • Download URL: ble2mqtt-0.1.0a5.tar.gz
  • Upload date:
  • Size: 15.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.6

File hashes

Hashes for ble2mqtt-0.1.0a5.tar.gz
Algorithm Hash digest
SHA256 75d65436c9027b7a6845aebf9e0bdc5f4b3e54a8fa7c13e7b4b6a1a65ef4e5be
MD5 1aa0f92ca5ac1c3017a3b53653834185
BLAKE2b-256 d196047593f6cd4840d38cd7a8075263ace3d27fb1db78c331f7d43e6a640270

See more details on using hashes here.

File details

Details for the file ble2mqtt-0.1.0a5-py2-none-any.whl.

File metadata

  • Download URL: ble2mqtt-0.1.0a5-py2-none-any.whl
  • Upload date:
  • Size: 19.5 kB
  • Tags: Python 2
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.6

File hashes

Hashes for ble2mqtt-0.1.0a5-py2-none-any.whl
Algorithm Hash digest
SHA256 266cec08f1af687aae33d21e54c3a0b30476d302c8f50c93693805f3d32fa20e
MD5 93d72058b241206e50e4d4caf3626b31
BLAKE2b-256 2e0ebd91e35b695bce2796a9eb310d107048746e4d2a79edd661c1fa2f70a2e2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page