X-Git-Url: https://review.openocd.org/gitweb?p=openocd.git;a=blobdiff_plain;f=doc%2Fopenocd.texi;h=a2bcaf8507801886cc26dff1ed3688a5ba42a16a;hp=4caefb8c899e3b6d4812d084eb06ee39655b02d2;hb=1f3ca0b5b81d9f9e4565cf177797a17ad37ef2c3;hpb=6e40c5203a7696967fa0706c305e5b441dd7cfa9 diff --git a/doc/openocd.texi b/doc/openocd.texi index 4caefb8c89..a2bcaf8507 100644 --- a/doc/openocd.texi +++ b/doc/openocd.texi @@ -4179,6 +4179,17 @@ There are several variants defined: @code{pxa26x} ... instruction register length is 5 bits @item @code{pxa3xx} ... instruction register length is 11 bits @end itemize +@item @code{openrisc} -- this is an OpenRISC 1000 core. +The current implementation supports two JTAG TAP cores: +@itemize @minus +@item @code{OpenCores TAP} (See: @emph{http://opencores.org/project,jtag}) +@item @code{Altera Virtual JTAG TAP} (See: @emph{http://www.altera.com/literature/ug/ug_virtualjtag.pdf}) +@end itemize +And two debug interfaces cores: +@itemize @minus +@item @code{Advanced debug interface} (See: @emph{http://opencores.org/project,adv_debug_sys}) +@item @code{SoC Debug Interface} (See: @emph{http://opencores.org/project,dbg_interface}) +@end itemize @end itemize @end deffn @@ -4851,6 +4862,12 @@ specifies "to the end of the flash bank". The @var{num} parameter is a value shown by @command{flash banks}. @end deffn +@deffn Command {flash padded_value} num value +Sets the default value used for padding any image sections, This should +normally match the flash bank erased value. If not specified by this +comamnd or the flash driver then it defaults to 0xff. +@end deffn + @anchor{program} @deffn Command {program} filename [verify] [reset] [offset] This is a helper script that simplifies using OpenOCD as a standalone @@ -7493,6 +7510,51 @@ the peripherals. @xref{targetevents,,Target Events}. @end deffn +@section OpenRISC Architecture + +The OpenRISC CPU is a soft core. It is used in a programmable SoC which can be +configured with any of the TAP / Debug Unit available. + +@subsection TAP and Debug Unit selection commands +@deffn Command {tap_select} (@option{vjtag}|@option{mohor}) +Select between the Altera Virtual JTAG and Mohor TAP. +@end deffn +@deffn Command {du_select} (@option{adv}|@option{mohor}) [option] +Select between the Advanced Debug Interface and the classic one. + +An option can be passed as a second argument to the debug unit. + +When using the Advanced Debug Interface, option = 1 means the RTL core is +configured with ADBG_USE_HISPEED = 1. This configuration skips status checking +between bytes while doing read or write bursts. +@end deffn + +@subsection Registers commands +@deffn Command {addreg} [name] [address] [feature] [reg_group] +Add a new register in the cpu register list. This register will be +included in the generated target descriptor file. + +@strong{[feature]} must be "org.gnu.gdb.or1k.group[0..10]". + +@strong{[reg_group]} can be anything. The default register list defines "system", + "dmmu", "immu", "dcache", "icache", "mac", "debug", "perf", "power", "pic" + and "timer" groups. + +@emph{example:} +@example +addreg rtest 0x1234 org.gnu.gdb.or1k.group0 system +@end example + + +@end deffn +@deffn Command {readgroup} (@option{group}) +Display all registers in @emph{group}. + +@emph{group} can be "system", + "dmmu", "immu", "dcache", "icache", "mac", "debug", "perf", "power", "pic", + "timer" or any new group created with addreg command. +@end deffn + @anchor{softwaredebugmessagesandtracing} @section Software Debug Messages and Tracing @cindex Linux-ARM DCC support