add FAQ entry about timing issue on open with certain devices

git-svn-id: http://svn.code.sf.net/p/pyserial/code/trunk/pyserial@393 f19166aa-fa4f-0410-85c2-fa1106f25c8a

1 files changed, 12 insertions, 0 deletions

diff --git a/documentation/appendix.rst b/documentation/appendix.rst
index a2dfc80..6c43981 100644
--- a/documentation/appendix.rst
+++ b/documentation/appendix.rst
@@ -61,6 +61,18 @@ with that:
   'serial.urlhandler.protocol_rfc2217', etc.)
 
 
+FAQ
+===
+Example works in miniterm but not in script.
+    The RTS and DTR lines are switched when the port is opened. This may cause
+    some processing or reset on the connected device. In such a cases an
+    immediately following call to :meth:`write` may not be received by the
+    device.
+
+    A delay after opening the port, before the first :meth:`write`, is
+    recommended in this situation. E.g. a ``time.sleep(1)``
+
+
 Related software
 ================