aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorTomas Vanek <vanekt@fbl.cz>2021-11-23 13:17:47 +0100
committerAntonio Borneo <borneo.antonio@gmail.com>2021-12-03 21:52:12 +0000
commitaf723387be87fadd02abb1f01a2734d004cbb5bc (patch)
tree318609f8bc48bcf7e34ae64c9124e5ad2bf3c6e8 /doc
parent57d9fd9bbc79e0bf7d642754f41390f17987d8cc (diff)
downloadriscv-openocd-af723387be87fadd02abb1f01a2734d004cbb5bc.zip
riscv-openocd-af723387be87fadd02abb1f01a2734d004cbb5bc.tar.gz
riscv-openocd-af723387be87fadd02abb1f01a2734d004cbb5bc.tar.bz2
doc: mention SWD multidrop
Change-Id: I361dc351c407b67613eadef4d29e27ed0e00bd05 Signed-off-by: Tomas Vanek <vanekt@fbl.cz> Reviewed-on: https://review.openocd.org/c/openocd/+/6744 Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com> Tested-by: jenkins
Diffstat (limited to 'doc')
-rw-r--r--doc/openocd.texi12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/openocd.texi b/doc/openocd.texi
index 3373281..4b93a89 100644
--- a/doc/openocd.texi
+++ b/doc/openocd.texi
@@ -3433,6 +3433,17 @@ Parameters are currently the same as "jtag newtap" but this is
expected to change.
@end deffn
+@cindex SWD multi-drop
+The newer SWD devices (SW-DP v2 or SWJ-DP v2) support the multi-drop extension
+of SWD protocol: two or more devices can be connected to one SWD adapter.
+SWD transport works in multi-drop mode if @ref{dap_create,DAP} is configured
+with both @code{-dp-id} and @code{-instance-id} parameters regardless how many
+DAPs are created.
+
+Not all adapters and adapter drivers support SWD multi-drop. Only the following
+adapter drivers are SWD multi-drop capable:
+cmsis_dap (use an adapter with CMSIS-DAP version 2.0), ftdi, all bitbang based.
+
@subsection SPI Transport
@cindex SPI
@cindex Serial Peripheral Interface
@@ -4346,6 +4357,7 @@ instead of "@option{-chain-position} @var{dotted.name}" when the target is creat
The @command{dap} command group supports the following sub-commands:
+@anchor{dap_create}
@deffn {Command} {dap create} dap_name @option{-chain-position} dotted.name configparams...
Declare a DAP instance named @var{dap_name} linked to the JTAG tap
@var{dotted.name}. This also creates a new command (@command{dap_name})