https://github.com/dala318/obd2_ble
Home Assistant integration for OBD2 via Bluetooth Proxy
https://github.com/dala318/obd2_ble
bluetooth bluetooth-proxy hacs home-assistant obd2
Last synced: 6 days ago
JSON representation
Home Assistant integration for OBD2 via Bluetooth Proxy
- Host: GitHub
- URL: https://github.com/dala318/obd2_ble
- Owner: dala318
- License: mit
- Created: 2026-04-25T16:40:27.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-15T18:24:50.000Z (24 days ago)
- Last Synced: 2026-05-15T20:52:05.398Z (24 days ago)
- Topics: bluetooth, bluetooth-proxy, hacs, home-assistant, obd2
- Language: Python
- Homepage:
- Size: 396 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# OBD2 BLE
A Home Assistant integration for reading OBD2 vehicle data via Bluetooth Low Energy (BLE).
## Features
- Real-time OBD2 data reading from compatible BLE devices
- Automatic device discovery via Bluetooth
- Configurable polling intervals for different vehicle states
- Support for caching sensor values
- Automatic reconnection when device comes back in range
## Installation
### Via HACS (Recommended)
1. Add this repository to HACS as custom repository.
2. Search for "OBD2 BLE" in HACS and install it.
3. Restart Home Assistant
### Manual Installation
1. Copy the `custom_component/obd2_ble` folder to your Home Assistant `custom_components` directory
2. Restart Home Assistant
3. Go to Settings → Devices & Services → Create Automation → and add the integration
4. Restart Home Assistant
## Configuration
The integration is configured via the UI. No YAML configuration is required.
1. Supprted OBD2 BLE devices should be identified and proposed to be added, but manual add can be attempted if not.
If your device it not found but within range (appears in Bluetooth Advertisements) it's likely not supported.
2. Once device is added klick options (cog-wheel) and "Configure commands"
3. In the Commands config first selection page all supported commands (measuremetns) should be selectable.
4. The Commad config page will be repeated for each selected command
5. Once finished the integration will re-load and a device with the selecte commands should appear.
### Setup Requirements
- A compatible OBD2 BLE device (using the standard BLE service UUID `0000ffe0-0000-1000-8000-00805f9b34fb`)
- Home Assistant with connected ESPHome Bluetooth Proxy
## Supported Devices
This integration supports OBD2 dongles with BLE connectivity. It has been tested with devices using the standard OBD2 BLE GATT service.
## Troubleshooting
- Ensure your OBD2 BLE device is in range and has Bluetooth enabled
- Check Home Assistant logs for detailed error messages
- Verify the BLE service and characteristic UUIDs match your device's specifications
## Support
For issues and feature requests, please visit the [GitHub repository](https://github.com/dala318/obd2_ble/issues)