Merge branch 'current' into docker-image-missing-jq

Author: swoboda1337

content/components/sensor/am2320.md

@@ -8,9 +8,11 @@ params:
 ---
 
 The `am2320` Temperature+Humidity sensor allows you to use your AM2320
-([datasheet](https://akizukidenshi.com/download/ds/aosong/AM2320.pdf)) I²C-based sensor with ESPHome.
+([datasheet](https://cdn-shop.adafruit.com/product-files/3721/AM2320.pdf)) I²C-based sensor with
+ESPHome.
 
-{{< img src="am2320-full.jpg" alt="Image" caption="AM2320 Temperature & Humidity Sensor." width="50.0%" class="align-center" >}}
+{{< img src="am2320-full.jpg" alt="Image" caption="AM2320 Temperature & Humidity Sensor." width="50.0%"
+class="align-center" >}}
 
 {{< img src="temperature-humidity.png" alt="Image" width="80.0%" class="align-center" >}}
 
@@ -39,11 +41,19 @@ sensor:
 
   - All options from [Sensor](#config-sensor).
 
-- **update_interval** (*Optional*, [Time](#config-time)): The interval to check the sensor. Defaults to `60s`.
+- **update_interval** (*Optional*, [Time](#config-time)): The interval to check the sensor. Defaults to
+  `60s`.
+
+## Troubleshooting
+
+If you experience communication or reliability issues with the AM2320 sensor, the
+{{< docref "i2c" >}} frequency may be too high. The AM2320 supports I²C standard-mode with a maximum
+clock frequency of 100 kHz.
 
 ## See Also
 
 - [Sensor Filters](#sensor-filters)
+- {{< docref "i2c" >}}
 - {{< docref "absolute_humidity/" >}}
 - {{< docref "dht/" >}}
 - {{< docref "dht12/" >}}