A Home Assistant integration for reading OBD2 vehicle data via Bluetooth Low Energy (BLE).
- 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
- Add this repository to HACS as custom repository.
- Search for "OBD2 BLE" in HACS and install it.
- Restart Home Assistant
- Copy the
custom_component/obd2_blefolder to your Home Assistantcustom_componentsdirectory - Restart Home Assistant
- Go to Settings → Devices & Services → Create Automation → and add the integration
- Restart Home Assistant
The integration is configured via the UI. No YAML configuration is required.
- 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.
- Once device is added klick options (cog-wheel) and "Configure commands"
- In the Commands config first selection page all supported commands (measuremetns) should be selectable.
- The Connad config page will be repeated for each selected command
- Once finished the integration will re-load and a device with the selecte commands should appear.
- A compatible OBD2 BLE device (using the standard BLE service UUID
0000ffe0-0000-1000-8000-00805f9b34fb) - Home Assistant with connected ESPHome Bluetooth Proxy
This integration supports OBD2 dongles with BLE connectivity. It has been tested with devices using the standard OBD2 BLE GATT service.
- 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
For issues and feature requests, please visit the GitHub repository
