From a92f5d37eaa957238d9c7ba2f71639dab74a15e2 Mon Sep 17 00:00:00 2001
From: Teemu R <tpr@iki.fi>
Date: Mon, 21 Jan 2019 21:09:00 +0100
Subject: [PATCH] add a troubleshooting entry for vacuum timeouts (#463)

---
 docs/troubleshooting.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst
index 3a594f19f..664fad2cf 100644
--- a/docs/troubleshooting.rst
+++ b/docs/troubleshooting.rst
@@ -35,3 +35,20 @@ If you're in control of the router in between, then you have one more chance to
 .. note::
 
     Read more about `Network address translation on Wikipedia <https://en.wikipedia.org/wiki/Network_address_translation>`_. 
+
+
+Intermittent connection issues, timeouts (Xiaomi Vacuum)
+--------------------------------------------------------
+
+Blocking the network access from vacuums is known to cause connectivity problems, presenting themselves as connection timeouts (discussed in `this github issue <https://github.com/rytilahti/python-miio/issues/92>`_):
+
+.. code-block:: text
+
+    mirobo.device.DeviceException: Unable to discover the device x.x.x.x
+
+The root cause lies in the software running on the device, which will hang when it is unable to receive responses.
+The connectivity will get restored by device's internal watchdog restarting the service (``miio_client``).
+
+.. hint::
+
+    If you want to keep your device out from the Internet, use REJECT instead of DROP in your firewall confinguration.