From 2d1ae4a17cbad0c198d9409faedd4925911e77a2 Mon Sep 17 00:00:00 2001
From: happyleaves <happyleaves.tfr@gmail.com>
Date: Sun, 20 Dec 2015 18:34:48 -0500
Subject: [PATCH] torque sensor doc

---
 source/_components/sensor.torque.markdown | 50 +++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 source/_components/sensor.torque.markdown

diff --git a/source/_components/sensor.torque.markdown b/source/_components/sensor.torque.markdown
new file mode 100644
index 00000000000..057de9dbfe9
--- /dev/null
+++ b/source/_components/sensor.torque.markdown
@@ -0,0 +1,50 @@
+---
+layout: component
+title: "Torque sensor"
+description: "Instructions how to integrate Torque sensors into Home Assistant."
+date: 2015-12-20 18:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+ha_category: Sensor
+---
+
+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` as the **Webserver URL**, where `HOST` and `PORT` are your externally-accessible Home Assistant HTTP host and port.
+- 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.
+