From 87ccff42970f812577feec7f74299d1b44cab4e8 Mon Sep 17 00:00:00 2001
From: Dennis <d@irrgang.dev>
Date: Sun, 30 Oct 2022 18:39:07 +0100
Subject: [PATCH] Added note about decimal accuracy of other sensors

Any sensors other than the DHT11 has at least one digit of accuracy. The default is 0, so this accuracy is lost and it's not obvious that the default masks the possibly higher resolution.
---
 components/sensor/dht.rst | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/components/sensor/dht.rst b/components/sensor/dht.rst
index ef4455b22..b89b00ce2 100644
--- a/components/sensor/dht.rst
+++ b/components/sensor/dht.rst
@@ -6,17 +6,14 @@ DHT Temperature+Humidity Sensor
     :image: dht.jpg
     :keywords: DHT11, DHT21, DHT22, AMS2301, AM2302, RHT03, SI7021
 
-The DHT Temperature+Humidity sensor allows you to use your DHT11
-(`datasheet <https://akizukidenshi.com/download/ds/aosong/DHT11.pdf>`__,
-`Adafruit <https://www.adafruit.com/product/386>`__), DHT21/DHT22
-(`datasheet <https://www.sparkfun.com/datasheets/Sensors/Temperature/DHT22.pdf>`__,
-`Adafruit <https://www.adafruit.com/product/385>`__), AMS2301/AM2302
-(`datasheet <https://cdn-shop.adafruit.com/datasheets/Digital+humidity+and+temperature+sensor+AM2302.pdf>`__,
-`Adafruit <https://www.adafruit.com/product/393>`__), RHT03
-(`datasheet <https://cdn.sparkfun.com/datasheets/Sensors/Weather/RHT03.pdf>`__,
-`SparkFun <https://cdn.sparkfun.com/datasheets/Sensors/Weather/RHT03.pdf>`__) and SI7021 (one wire Sonoff version)
-(`datasheet <https://cdn.sparkfun.com/assets/b/1/b/8/5/Si7021-A20.pdf>`__,
-`SparkFun <https://cdn.sparkfun.com/assets/b/1/b/8/5/Si7021-A20.pdf>`__)
+The DHT Temperature+Humidity sensor allows you to use your 
+
+- DHT11 (`datasheet <https://akizukidenshi.com/download/ds/aosong/DHT11.pdf>`__, `Adafruit <https://www.adafruit.com/product/386>`__), 
+- DHT21/DHT22 (`datasheet <https://www.sparkfun.com/datasheets/Sensors/Temperature/DHT22.pdf>`__, `Adafruit <https://www.adafruit.com/product/385>`__), 
+- AMS2301/AM2302 (`datasheet <https://cdn-shop.adafruit.com/datasheets/Digital+humidity+and+temperature+sensor+AM2302.pdf>`__, `Adafruit <https://www.adafruit.com/product/393>`__), 
+- RHT03 (`datasheet <https://cdn.sparkfun.com/datasheets/Sensors/Weather/RHT03.pdf>`__, `SparkFun <https://cdn.sparkfun.com/datasheets/Sensors/Weather/RHT03.pdf>`__) and 
+- SI7021 (one wire Sonoff version) (`datasheet <https://cdn.sparkfun.com/assets/b/1/b/8/5/Si7021-A20.pdf>`__, `SparkFun <https://cdn.sparkfun.com/assets/b/1/b/8/5/Si7021-A20.pdf>`__)
+
 sensors with ESPHome.
 
 .. figure:: images/dht-full.jpg
@@ -62,6 +59,7 @@ Configuration variables:
   - **name** (**Required**, string): The name for the humidity sensor.
   - **id** (*Optional*, :ref:`config-id`): Set the ID of this sensor for use in lambdas.
   - All other options from :ref:`Sensor <config-sensor>`.
+  
 
 - **model** (*Optional*, int): Manually specify the DHT model, can be
   one of ``AUTO_DETECT``, ``DHT11``, ``DHT22``, ``DHT22_TYPE2``, ``AM2302``, ``RHT03``, ``SI7021``
@@ -74,6 +72,8 @@ Configuration variables:
     If you're seeing lots of invalid temperature/humidity warnings in the logs, try manually setting the
     DHT model with the ``model:`` configuration variable. Other problems could be wrong pull-up resistor values
     on the DATA pin or too long cables.
+    
+    Also, the default ``accuracy_decimals`` value of the humidity levels is set to 0, as the DHT11 for which this was originally written does not have a higher resolution. All other DHT sensors have a higher resolution, and thus should be configured with ``accuracy_decimals: 1``.
 
 See Also
 --------