finish removing deprecated/obsolete commands
It's been about a year since these were deprecated and, in most cases, removed. There's no point in carrying that documentation, or backwards compatibility for "jtag_device" and "jtag_speed", around forever. (Or a few remnants of obsolete code...) Removed a few obsolete uses of "jtag_speed": - The Calao stuff hasn't worked since July 2008. (Those Atmel targets need to work with a 32KHz core clock after reset until board-specific init-reset code sets up the PLL and enables a faster JTAg clock.) - Parport speed controls don't actually work (tops out at about 1 MHz on typical HW). - In general, speed controls need to live in board.cfg files (or sometimes target.cfg files), not interface.cfg ... Signed-off-by: David Brownell <dbrownell@users.sourceforge.net>
This commit is contained in:
David Brownell
@@ -81,7 +81,6 @@ Free Documentation License''.
|
||||
* TFTP:: TFTP
|
||||
* GDB and OpenOCD:: Using GDB and OpenOCD
|
||||
* Tcl Scripting API:: Tcl Scripting API
|
||||
* Upgrading:: Deprecated/Removed Commands
|
||||
* FAQ:: Frequently Asked Questions
|
||||
* Tcl Crash Course:: Tcl Crash Course
|
||||
* License:: GNU Free Documentation License
|
||||
@@ -6507,91 +6506,6 @@ We should add support for a variable like Tcl variable
|
||||
is jim, not real tcl).
|
||||
@end quotation
|
||||
|
||||
@node Upgrading
|
||||
@chapter Deprecated/Removed Commands
|
||||
@cindex Deprecated/Removed Commands
|
||||
Certain OpenOCD commands have been deprecated or
|
||||
removed during the various revisions.
|
||||
|
||||
Upgrade your scripts as soon as possible.
|
||||
These descriptions for old commands may be removed
|
||||
a year after the command itself was removed.
|
||||
This means that in January 2010 this chapter may
|
||||
become much shorter.
|
||||
|
||||
@itemize @bullet
|
||||
@item @b{arm7_9 fast_writes}
|
||||
@cindex arm7_9 fast_writes
|
||||
@*Use @command{arm7_9 fast_memory_access} instead.
|
||||
@xref{arm7_9 fast_memory_access}.
|
||||
@item @b{endstate}
|
||||
@cindex endstate
|
||||
@*An buggy old command that would not really work since background polling would wipe out the global endstate
|
||||
@item @b{arm7_9 force_hw_bkpts}
|
||||
@*Use @command{gdb_breakpoint_override} instead. Note that GDB will use hardware breakpoints
|
||||
for flash if the GDB memory map has been set up(default when flash is declared in
|
||||
target configuration). @xref{gdb_breakpoint_override}.
|
||||
@item @b{arm7_9 sw_bkpts}
|
||||
@*On by default. @xref{gdb_breakpoint_override}.
|
||||
@item @b{daemon_startup}
|
||||
@*this config option has been removed, simply adding @option{init} and @option{reset halt} to
|
||||
the end of your config script will give the same behaviour as using @option{daemon_startup reset}
|
||||
and @option{target cortex_m3 little reset_halt 0}.
|
||||
@item @b{dump_binary}
|
||||
@*use @option{dump_image} command with same args. @xref{dump_image}.
|
||||
@item @b{flash erase}
|
||||
@*use @option{flash erase_sector} command with same args. @xref{flash erase_sector}.
|
||||
@item @b{flash write}
|
||||
@*use @option{flash write_bank} command with same args. @xref{flash write_bank}.
|
||||
@item @b{flash write_binary}
|
||||
@*use @option{flash write_bank} command with same args. @xref{flash write_bank}.
|
||||
@item @b{flash auto_erase}
|
||||
@*use @option{flash write_image} command passing @option{erase} as the first parameter. @xref{flash write_image}.
|
||||
|
||||
@item @b{jtag_device}
|
||||
@*use the @command{jtag newtap} command, converting from positional syntax
|
||||
to named prefixes, and naming the TAP.
|
||||
@xref{jtag newtap}.
|
||||
Note that if you try to use the old command, a message will tell you the
|
||||
right new command to use; and that the fourth parameter in the old syntax
|
||||
was never actually used.
|
||||
@example
|
||||
OLD: jtag_device 8 0x01 0xe3 0xfe
|
||||
NEW: jtag newtap CHIPNAME TAPNAME \
|
||||
-irlen 8 -ircapture 0x01 -irmask 0xe3
|
||||
@end example
|
||||
|
||||
@item @b{jtag_speed} value
|
||||
@*@xref{JTAG Speed}.
|
||||
Usually, a value of zero means maximum
|
||||
speed. The actual effect of this option depends on the JTAG interface used.
|
||||
@itemize @minus
|
||||
@item wiggler: maximum speed / @var{number}
|
||||
@item ft2232: 6MHz / (@var{number}+1)
|
||||
@item amt jtagaccel: 8 / 2**@var{number}
|
||||
@item jlink: maximum speed in kHz (0-12000), 0 will use RTCK
|
||||
@item rlink: 24MHz / @var{number}, but only for certain values of @var{number}
|
||||
@comment end speed list.
|
||||
@end itemize
|
||||
|
||||
@item @b{load_binary}
|
||||
@*use @option{load_image} command with same args. @xref{load_image}.
|
||||
@item @b{run_and_halt_time}
|
||||
@*This command has been removed for simpler reset behaviour, it can be simulated with the
|
||||
following commands:
|
||||
@smallexample
|
||||
reset run
|
||||
sleep 100
|
||||
halt
|
||||
@end smallexample
|
||||
@item @b{target} <@var{type}> <@var{endian}> <@var{jtag-position}>
|
||||
@*use the create subcommand of @option{target}.
|
||||
@item @b{target_script} <@var{target#}> <@var{eventname}> <@var{scriptname}>
|
||||
@*use <@var{target_name}> configure -event <@var{eventname}> "script <@var{scriptname}>"
|
||||
@item @b{working_area}
|
||||
@*use the @option{configure} subcommand of @option{target} to set the work-area-virt, work-area-phy, work-area-size, and work-area-backup properties of the target.
|
||||
@end itemize
|
||||
|
||||
@node FAQ
|
||||
@chapter FAQ
|
||||
@cindex faq
|
||||
|
||||
Reference in New Issue
Block a user