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

Uploaded Source

Built Distribution

ble2mqtt-0.1.0a7-py2-none-any.whl (19.6 kB view details)

Uploaded Python 2

File details

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

File metadata

  • Download URL: ble2mqtt-0.1.0a7.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.0a7.tar.gz
Algorithm Hash digest
SHA256 18721a230aa9351e6297f2d67b3ec0d18d1611a1c387a5c410cc06029dabc026
MD5 cfc5d800bf292b1a84fbb7d04a6c3c01
BLAKE2b-256 7a608200f1ecf7d73c967a864419f02c22e0c29a1984c6f558cc2e661e19675a

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ble2mqtt-0.1.0a7-py2-none-any.whl
  • Upload date:
  • Size: 19.6 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.0a7-py2-none-any.whl
Algorithm Hash digest
SHA256 fa4407b950a7c914e471319e2a488eca3d09201a081e72affa2984d3c9a08a73
MD5 65d82ff124f101eafadff300a9974743
BLAKE2b-256 9550f3e711e9395126c7c03cf19230c8cbc6b2358a93995c3908ddffe2c3dafa

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