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

Uploaded Source

Built Distribution

ble2mqtt-0.1.0a2-py3-none-any.whl (17.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ble2mqtt-0.1.0a2.tar.gz
  • Upload date:
  • Size: 14.1 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.0a2.tar.gz
Algorithm Hash digest
SHA256 fcd19c5d8d9feac66be406df29abd1108f674613057e37d4ae47f2750dcb91b8
MD5 d891ea0d49fd1b6027dc528989ac28f0
BLAKE2b-256 5777f32d7d168a9b766d177f03880eb3df8afbe404a5dc0fc2dbf74288295a4d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ble2mqtt-0.1.0a2-py3-none-any.whl
  • Upload date:
  • Size: 17.6 kB
  • Tags: Python 3
  • 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.0a2-py3-none-any.whl
Algorithm Hash digest
SHA256 7b8e4db77f4887dadd34e82db3e7a17d30ed30af575fc8975807d852fd6e444b
MD5 88902bb231b1cf92298e32050c45f22f
BLAKE2b-256 138f9f79e3f9e039c0347579201b3e2498b2b7d038d6ce152d8c1ec1dc112459

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