[Openocd-svn] r2729 - trunk/doc

[dbrownell at B. <dbr...@ma...>]

Author: dbrownell
Date: 2009-09-19 08:42:50 +0200 (Sat, 19 Sep 2009)
New Revision: 2729

Modified:
   trunk/doc/openocd.texi
Log:
Minor tweaks to description of JTAG adapter/dongle issues.


Modified: trunk/doc/openocd.texi
===================================================================
--- trunk/doc/openocd.texi	2009-09-18 15:11:46 UTC (rev 2728)
+++ trunk/doc/openocd.texi	2009-09-19 06:42:50 UTC (rev 2729)
@@ -250,12 +250,16 @@
 
 @section Choosing a Dongle
 
-There are three things you should keep in mind when choosing a dongle. 
+There are several things you should keep in mind when choosing a dongle.
 
 @enumerate 
-@item @b{Voltage} What voltage is your target? 1.8, 2.8, 3.3, or 5V? Does your dongle support it?
-@item @b{Connection} Printer Ports - Does your computer have one?
-@item @b{Connection} Is that long printer bit-bang cable practical? 
+@item @b{Voltage} What voltage is your target - 1.8, 2.8, 3.3, or 5V?
+Does your dongle support it?  You might need a level converter.
+@item @b{Pinout} What pinout does your target board use?
+Does your dongle support it?  You may be able to use jumper
+wires, or an "octopus" connector, to convert pinouts.
+@item @b{Connection} Does your computer have the USB, printer, or
+Ethernet port needed?
 @item @b{RTCK} Do you require RTCK? Also known as ``adaptive clocking'' 
 @end enumerate
 
@@ -356,6 +360,10 @@
 and the MacGraigor Wiggler. There are many clones and variations of
 these on the market.
 
+Note that parallel ports are becoming much less common, so if you
+have the choice you should probably avoid these adapters in favor
+of USB-based ones.
+
 @itemize @bullet
 
 @item @b{Wiggler} - There are many clones of this.