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.0a11.tar.gz (17.7 kB view details)

Uploaded Source

Built Distribution

ble2mqtt-0.1.0a11-py3-none-any.whl (21.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ble2mqtt-0.1.0a11.tar.gz
  • Upload date:
  • Size: 17.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.53.0 CPython/3.9.0

File hashes

Hashes for ble2mqtt-0.1.0a11.tar.gz
Algorithm Hash digest
SHA256 22f8995e71ee56bac2b207ec6fe8031fe7b4f0c878712355b47376bfa93b2c65
MD5 57cf71f1b54e8edea5a6fd48d5d18824
BLAKE2b-256 148b1c8eec81674dcbb535517ebc64b70d57781fe78dda88c14a6a86dc0cacdd

See more details on using hashes here.

File details

Details for the file ble2mqtt-0.1.0a11-py3-none-any.whl.

File metadata

  • Download URL: ble2mqtt-0.1.0a11-py3-none-any.whl
  • Upload date:
  • Size: 21.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.53.0 CPython/3.9.0

File hashes

Hashes for ble2mqtt-0.1.0a11-py3-none-any.whl
Algorithm Hash digest
SHA256 26c017efd4b36b66d5d9325206142c852a107f49a1485a3e04afaa995ef5ad07
MD5 f45274c1e810fd9b529e24c5bd9186b0
BLAKE2b-256 e3f8d25d3d47328b5c2ac9e6ee8be9d6e133d3c145a11d92bdd626a7a37db744

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