mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-07 03:28:58 +00:00
52 lines
1.6 KiB
Markdown
52 lines
1.6 KiB
Markdown
---
|
|
layout: page
|
|
title: "Torque (OBD2)"
|
|
description: "Instructions how to integrate Torque sensors into Home Assistant."
|
|
date: 2015-12-20 18:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: torque.png
|
|
ha_category: Transport
|
|
ha_release: "0.10"
|
|
---
|
|
|
|
The `torque` platform will allow you to monitor [Torque](http://torque-bhp.com/) data relayed from a bluetooth OBD2 stick via the Torque mobile application.
|
|
|
|
## {% linkable_title Configuration %}
|
|
To use Torque sensors with your installation, you must configure both the Torque mobile application and Home Assistant.
|
|
|
|
### {% linkable_title Torque application %}
|
|
|
|
In **Settings** -> **Data Logging & Upload**:
|
|
|
|
Under the **Logging Preferences** header:
|
|
|
|
- Touch **Select what to log**, activate the menu in the upper right, and select **Add PID to log**.
|
|
- Select items of interest.
|
|
|
|
Under the **Realtime Web Upload** header:
|
|
|
|
- Check **Upload to webserver**.
|
|
- Enter `http://HOST:PORT/api/torque?api_password=YOUR_PASSWORD` as the **Webserver URL**, where `HOST` and `PORT` are your externally-accessible Home Assistant HTTP host and port and YOUR_PASSWORD is your password.
|
|
- Enter an email address in **User Email Address**.
|
|
- Optionally set the **Web Logging Interval**. The 2-second default may quickly fill up the Home Assistant history database.
|
|
|
|
### {% linkable_title Home Assistant %}
|
|
|
|
Add the following to your `configuration.yaml` file:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
sensor:
|
|
platform: torque
|
|
name: Your Vehicle Name
|
|
email: your_configured@email.com
|
|
```
|
|
|
|
Configuration variables:
|
|
|
|
- **name** (*Required*): Vehicle name (your choice).
|
|
- **email**: Email address configured in Torque application.
|