From 9da7eeddea41f939f35d15e0d595b201f1e15ca6 Mon Sep 17 00:00:00 2001
From: Hugo Gresse <hugo.gresse@gmail.com>
Date: Tue, 17 Oct 2017 21:11:42 +0200
Subject: [PATCH] Improve one-wire sensor (#3656)

* Improve one-wire sensor

* Minor changes
---
 source/_components/sensor.onewire.markdown | 25 ++++++++++++++++------
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/source/_components/sensor.onewire.markdown b/source/_components/sensor.onewire.markdown
index 4ec2ca7565e..19396863493 100644
--- a/source/_components/sensor.onewire.markdown
+++ b/source/_components/sensor.onewire.markdown
@@ -22,25 +22,38 @@ Supported devices:
 - [DS1822](https://datasheets.maximintegrated.com/en/ds/DS1822.pdf)
 - [DS1825](https://datasheets.maximintegrated.com/en/ds/DS1825.pdf)
 - [DS28EA00](https://datasheets.maximintegrated.com/en/ds/DS28EA00.pdf) temperature sensors
-- [DS2406/TAI-8570] (https://datasheets.maximintegrated.com/en/ds/DS2406.pdf) Temperature and pressure sensor made by AAG
-- [DS2438/B1-R1-A] (https://datasheets.maximintegrated.com/en/ds/DS2438.pdf) Temperature, pressure and humidity sensor by AAG
+- [DS2406/TAI-8570](https://datasheets.maximintegrated.com/en/ds/DS2406.pdf) Temperature and pressure sensor made by AAG
+- [DS2438/B1-R1-A](https://datasheets.maximintegrated.com/en/ds/DS2438.pdf) Temperature, pressure and humidity sensor by AAG
 
-The 1-Wire bus can be connected directly to the IO pins of Raspberry Pi or using dedicated interface adapter (e.g [DS9490R](https://datasheets.maximintegrated.com/en/ds/DS9490-DS9490R.pdf)). When an interface adapter is used, sensors can be accessed on Linux hosts via [owfs 1-Wire file system](http://owfs.org/). When using an interface adapter and the owfs, the 'mount_dir' option must be configured to correspond a directory, where owfs device tree has been mounted. If you are using Raspberry Pi and IO pin connected bus setup, don't use the 'mount_dir' option.
+The 1-Wire bus can be connected directly to the IO pins of Raspberry Pi or using dedicated interface adapter (e.g [DS9490R](https://datasheets.maximintegrated.com/en/ds/DS9490-DS9490R.pdf)). 
+
+#### Raspberry Pi setup
+In order ot setup 1-Wire support on Raspberry Pi, you'll need to edit `/boot/config.txt` following [this documentation](https://www.waveshare.com/wiki/Raspberry_Pi_Tutorial_Series:_1-Wire_DS18B20_Sensor#Enable_1-Wire). Don't use the `mount_dir` option.
+
+#### Interface adapter setup
+When an interface adapter is used, sensors can be accessed on Linux hosts via [owfs 1-Wire file system](http://owfs.org/). When using an interface adapter and the owfs, the `mount_dir` option must be configured to correspond a directory, where owfs device tree has been mounted.
 
 <p class='note warning'>
 This component has been modified to work with devices with multiple sensors which will cause a discontinuity in recorded values. Existing devices will receive a new ID and therefore show up as new devices.
 If you wish to maintain continuity it can be resolved in the database by renaming the old devices to the new names.
 
-Connect to your database using the instructions from https://home-assistant.io/docs/backend/database/
-Check the names of sensors:
+Connect to your database using the instructions from [home-assistant.io/docs/backend/database/](https://home-assistant.io/docs/backend/database/). Check the names of sensors:
+
+```sql
 SELECT entity_id, COUNT(*) as count FROM states GROUP BY entity_id ORDER BY count DESC LIMIT 10;
+```
 Alter the names of sensors using the following examples:
+
+```sql
 UPDATE states SET entity_id='sensor.<sensor_name>_temperature' WHERE entity_id LIKE 'sensor.<sensor_name>%' AND attributes LIKE '%\u00b0C%';
 UPDATE states SET entity_id='sensor.<sensor_name>_pressure' WHERE entity_id LIKE 'sensor.<sensor_name>%' AND attributes LIKE '%mb%';
 UPDATE states SET entity_id='sensor.<sensor_name>_humidity' WHERE entity_id LIKE 'sensor.<sensor_name>%' AND attributes LIKE '%%%' ESCAPE '';
-Remember to replace <sensor_name> with the actual name of the sensor as seen in the SELECT query.
+```
+Remember to replace `<sensor_name>` with the actual name of the sensor as seen in the `SELECT` query.
 </p>
 
+#### Home Assistant setup
+
 To enable One wire sensors in your installation, add the following to your `configuration.yaml` file:
 
 ```yaml