From: Spencer Oliver <spen@spen-soft.co.uk>
Date: Mon, 6 Feb 2012 14:54:00 +0000 (+0000)
Subject: docs: add original stlink (STLINK-V1) usage note
X-Git-Tag: v0.6.0-rc1~252
X-Git-Url: https://review.openocd.org/gitweb?p=openocd.git;a=commitdiff_plain;h=dbbe2a5388c7060e2522279725dbebf78b085a67

docs: add original stlink (STLINK-V1) usage note

Add a note to the docs about the original stlink being broken under linux.

Change-Id: Ib440d78e5c7d31eeace99f611a76fcf701bfb8bc
Signed-off-by: Spencer Oliver <spen@spen-soft.co.uk>
Reviewed-on: http://openocd.zylin.com/433
Tested-by: jenkins
Reviewed-by: Mathias Küster <kesmtp@freenet.de>
Reviewed-by: Andreas Fritiofson <andreas.fritiofson@gmail.com>
---

diff --git a/doc/openocd.texi b/doc/openocd.texi
index 824e744cda..7bfad9bf2d 100644
--- a/doc/openocd.texi
+++ b/doc/openocd.texi
@@ -434,6 +434,14 @@ They only works with ST Micro chips, notably STM32 and STM8.
 @* Link: @url{http://www.st.com/internet/evalboard/product/251168.jsp}
 @end itemize
 
+For info the original ST-LINK enumerates using the mass storage usb class, however
+it's implementation is completely broken. The result is this causes issues under linux.
+The simplest solution is to get linux to ignore the ST-LINK using one of the following method's:
+@itemize @bullet
+@item modprobe -r usb-storage && modprobe usb-storage quirks=483:3744:i
+@item add "options usb-storage quirks=483:3744:i" to /etc/modprobe.conf
+@end itemize
+
 @section USB Other
 @itemize @bullet
 @item @b{USBprog}