diff options
| author | Matthias Welwarsky <matthias.welwarsky@sysgo.com> | 2016-02-02 17:03:08 +0100 |
|---|---|---|
| committer | Paul Fertser <fercerpav@gmail.com> | 2016-03-24 08:52:14 +0000 |
| commit | 0a97b232b15c4519777f9223da33423379983dc4 (patch) | |
| tree | 774ddf1226e656d3e4828e41d09025a31aece828 /doc | |
| parent | 73b676c2fdedcb913f1c20be7de99ea0a94b11cc (diff) | |
| download | riscv-openocd-0a97b232b15c4519777f9223da33423379983dc4.zip riscv-openocd-0a97b232b15c4519777f9223da33423379983dc4.tar.gz riscv-openocd-0a97b232b15c4519777f9223da33423379983dc4.tar.bz2 | |
ftdi: allow selecting device by usb bus location
This patch adds a 'ftdi_location' command to select an adapter by usb
bus number and port path.
This is helpful if you have a rack full of adapters in a testing or
manufacturing setup where the only constant is the physical usb bus
location of the adapter you want to address. Vid:Pid are not unique,
serial number _may_ be unique (and maybe not with embedded adapters) but
will change when a new target is plugged.
Specifying a location allows to understand instantly which board failed
bringup or testing.
Change-Id: I403c7c6c8e34fe42041b3f967db80f3160a4f1a3
Signed-off-by: Matthias Welwarsky <matthias.welwarsky@sysgo.com>
Reviewed-on: http://openocd.zylin.com/3351
Tested-by: jenkins
Reviewed-by: Paul Fertser <fercerpav@gmail.com>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/openocd.texi | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/openocd.texi b/doc/openocd.texi index f272f21..fb987e7 100644 --- a/doc/openocd.texi +++ b/doc/openocd.texi @@ -2558,6 +2558,14 @@ If not specified, serial numbers are not considered. and are not restricted to containing only decimal digits.) @end deffn +@deffn {Config Command} {ftdi_location} <bus>:<port>[,<port>]... +Specifies the physical USB port of the adapter to use. The path +roots at @var{bus} and walks down the physical ports, with each +@var{port} option specifying a deeper level in the bus topology, the last +@var{port} denoting where the target adapter is actually plugged. +The USB bus topology can be queried with the command @emph{lsusb -t}. +@end deffn + @deffn {Config Command} {ftdi_channel} channel Selects the channel of the FTDI device to use for MPSSE operations. Most adapters use the default, channel 0, but there are exceptions. |