* doc/avrdude.texi: new appendix "Troubleshooting"

git-svn-id: svn://svn.savannah.nongnu.org/avrdude/trunk@400 81a1dc3b-b13d-400b-aceb-764788c761c2

avrdude/ChangeLog

@@ -1,3 +1,7 @@
+2004-01-17  Jan-Hinnerk Reichert  <hinni@despammed.com>
+
+	* doc/avrdude.texi: new appendix "Troubleshooting"
+
 2004-01-12  Jan-Hinnerk Reichert  <hinni@despammed.com>
 
 	* avr910.c, avrpart.c, avrpart.h, doc/TODO:

avrdude/doc/avrdude.texi

@@ -101,6 +101,7 @@ For avrdude version @value{VERSION}, @value{UPDATED}.
 * Terminal Mode Operation::
 * Configuration File::          
 * Platform Dependent Information::
+* Troubleshooting::
 @end menu
 
 @c
@@ -1101,7 +1102,7 @@ problem with the at90s4433/2333's; see the at90s4433 errata at:
 @c
 @c Node
 @c
-@node Platform Dependent Information,  , Configuration File, Top
+@node Platform Dependent Information, Troubleshooting, Configuration File, Top
 @appendix Platform Dependent Information
 
 @menu
@@ -1542,4 +1543,55 @@ line driven and for writing the batch files.
 
 @end itemize
 
+@c
+@c Node
+@c
+@node Troubleshooting, ,Platform Dependent Information ,Top
+@appendix Troubleshooting
+
+@itemize @bullet
+
+@item
+Problem: I'm using a serial programmer under Windows and get the following
+error:
+
+@code{avrdude: serial_open(): can't set attributes for device "com1"},
+
+Solution: This problem seems to appear with certain versions of Cygwin. Specifying
+@code{"/dev/com1"} instead of @code{"com1"} should help.
+
+
+@item
+Problem: I'm using linux and my AVR910 programmer is really slow.
+
+Solution (short): @code{setserial @var{port} low_latency}
+
+Solution (long):
+There are two problems here. First, the system may wait some time before it
+passes data from the serial port to the program. Under Linux the following
+command works around this (you may need root privileges for this).
+
+@code{setserial @var{port} low_latency}
+
+Secondly, the serial interface chip may delay the interrupt for some time.
+This behaviour can be changed by setting the FIFO-threshold to one. Under Linux this
+can only be done by changing the kernel source in @code{drivers/char/serial.c}.
+Search the file for @code{UART_FCR_TRIGGER_8} and replace it with @code{UART_FCR_TRIGGER_1}. Note that overall performance might suffer if there
+is high throughput on serial lines. Also note that you are modifying the kernel at
+your own risk.
+
+
+@item
+Problem: I'm not using linux and my AVR910 programmer is really slow.
+
+Solutions: The reasons for this are the same as above.
+If you know how to work around this on your OS, please let us know.
+
+
+
+@end itemize
+
+
+
 @bye
+