This release is a pre-release and may not be stable for production use.
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 ble2mqtt
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:cc:aa",
"type": "presence"
},
{
"address": "11:22:33:aa:bb:cc",
"type": "redmond200"
},
{
"address": "11:22:33:aa:bb:dd",
"type": "xiaomihtv1"
},
{
"address": "11:22:34:aa:bb:dd",
"type": "xiaomihtv1",
"passive": false
},
{
"address": "11:22:33:aa:bb:ee",
"type": "xiaomilywsd"
},
{
"address": "11:22:33:aa:bb:ff",
"type": "xiaomilywsd_atc"
}
]
}
Supported devices:
Any device
- Any bluetooth device can work as a presence tracker
Kettles:
- Redmond G2xx series (redmond200)
Humidity sensors:
- Xiaomi MJ_HT_V1 (xiaomihtv1)
- Xiaomi LYWSD03MMC (xiaomilywsd)
- Xiaomi LYWSD03MMC with custom ATC firmware (xiaomilywsd_atc)
By default, a device works in the passive mode without connection by
listening to advertisement packets from a device.
To use connection to the device provide "passive": false parameter.
Supported devices in passive mode:
- Xiaomi MJ_HT_V1 (xiaomihtv1)
- Xiaomi LYWSD03MMC with custom ATC firmware (xiaomilywsd_atc)
OpenWRT installation
Execute the following commands in the terminal:
opkg update
opkg install python3-pip python3-asyncio
pip3 install git+https://github.com/hbldh/bleak.git@f50a334e1173b27a8cf0a53d8ac56d9acc24fedf#egg=bleak
pip3 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
ble2mqtt 2> /tmp/ble2mqtt.log &
Container
Build the image as:
podman build -t ble2mqtt:dev .
Start the container and share the config file and DBus for Bluetooth connectivity:
podman run \
-d \
--net=host \
-v $PWD/ble2mqtt.json.sample:/etc/ble2mqtt.json:z \
-v /var/run/dbus:/var/run/dbus:z \
ble2mqtt:dev
Instead of sharing /var/run/dbus, you can export DBUS_SYSTEM_BUS_ADDRESS.
NOTE: --net=host is required as it needs to use the bluetooth interface
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ble2mqtt-0.1.0a21.tar.gz.
File metadata
- Download URL: ble2mqtt-0.1.0a21.tar.gz
- Upload date:
- Size: 20.0 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7a2bf32d19bd9e2edec5fe23074e9a8ef6da9e35e19ecaeb9ea7a9cb5efacc55
|
|
| MD5 |
bffe5257130aff6694313e391f978553
|
|
| BLAKE2b-256 |
4e736d92844b3c59ee1ffa26d39aaec8e62a435de7f9f1e47c149dd27b4aba85
|
File details
Details for the file ble2mqtt-0.1.0a21-py3-none-any.whl.
File metadata
- Download URL: ble2mqtt-0.1.0a21-py3-none-any.whl
- Upload date:
- Size: 24.9 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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
db9b7f511c820d6a48a7ea8d9bd33487dc9fe558a10d428a4d1b2fe9f9c32930
|
|
| MD5 |
8ab294354ef6ce9ef87ca5d82d528031
|
|
| BLAKE2b-256 |
d905444039952e415234538ae3fbb871c4ef4394199dea6f72f7170718b344ff
|
