From 4caa72b9886238975b87ceea94d7dcd51aebde47 Mon Sep 17 00:00:00 2001 From: zwelch Date: Mon, 1 Jun 2009 23:09:19 +0000 Subject: [PATCH] David Brownell : Remove two sections about deprecated/removed commands, documenting them briefly in the chapter on deprecated/removed commands. The "working_area" command just duplicated text; "jtag_device" wasn't listed in that chapter before. Also start de-emphasizing those commands. Don't index them, and include a disclaimer that their documentation may start to vanish about a year after the code does (e.g. in January 2010). git-svn-id: svn://svn.berlios.de/openocd/trunk@1986 b42882b7-edfa-0310-969c-e2dbd0fdcd60 --- doc/openocd.texi | 64 +++++++++++++++++------------------------------- 1 file changed, 22 insertions(+), 42 deletions(-) diff --git a/doc/openocd.texi b/doc/openocd.texi index 028c292f4..c890d5be6 100644 --- a/doc/openocd.texi +++ b/doc/openocd.texi @@ -1823,9 +1823,9 @@ instead of indirectly by making a CPU do it. @end itemize +@anchor{jtag newtap} @section jtag newtap @b{@t{jtag newtap CHIPNAME TAPNAME configparams ....}} -@cindex jtag_device @cindex jtag newtap @cindex tap @cindex tap order @@ -1946,24 +1946,6 @@ have the taps created in the proper order. @comment END NOTES @end itemize @comment at command level -@comment DOCUMENT old command -@section jtag_device - REMOVED -@example -@b{jtag_device} <@var{IR length}> <@var{IR capture}> <@var{IR mask}> <@var{IDCODE instruction}> -@end example -@cindex jtag_device - -@* @b{Removed: 28/nov/2008} This command has been removed and replaced -by the ``jtag newtap'' command. The documentation remains here so that -one can easily convert the old syntax to the new syntax. About the old -syntax: The old syntax is positional, i.e.: The 3rd parameter is the -``irmask''. The new syntax requires named prefixes, and supports -additional options, for example ``-expected-id 0x3f0f0f0f''. Please refer to the -@b{jtag newtap} command for details. -@example -OLD: jtag_device 8 0x01 0xe3 0xfe -NEW: jtag newtap CHIPNAME TAPNAME -irlen 8 -ircapture 0x01 -irmask 0xe3 -@end example @section Enable/Disable Taps @b{Note:} These commands are intended to be used as a machine/script @@ -2376,15 +2358,6 @@ processor. You still need to enable @option{srst} on the reset configuration command to enable OpenOCD hardware reset functionality. @comment END variants @end itemize -@section working_area - Command Removed -@cindex working_area -@*@b{Please use the ``$_TARGETNAME configure -work-area-... parameters instead} -@* This documentation remains because there are existing scripts that -still use this that need to be converted. -@example - working_area target# address size backup| [virtualaddress] -@end example -@* The target# is a the 0 based target numerical index. @node Flash Commands @chapter Flash Commands @@ -4515,7 +4488,14 @@ is jim, not real tcl). @node Upgrading @chapter Deprecated/Removed Commands @cindex Deprecated/Removed Commands -Certain OpenOCD commands have been deprecated/removed during the various revisions. +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} @@ -4523,34 +4503,39 @@ Certain OpenOCD commands have been deprecated/removed during the various revisio @*Use @command{arm7_9 fast_memory_access} instead. @xref{arm7_9 fast_memory_access}. @item @b{arm7_9 force_hw_bkpts} -@cindex 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} -@cindex arm7_9 sw_bkpts @*On by default. @xref{gdb_breakpoint_override}. @item @b{daemon_startup} -@cindex 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} -@cindex dump_binary @*use @option{dump_image} command with same args. @xref{dump_image}. @item @b{flash erase} -@cindex flash erase @*use @option{flash erase_sector} command with same args. @xref{flash erase_sector}. @item @b{flash write} -@cindex flash write @*use @option{flash write_bank} command with same args. @xref{flash write_bank}. @item @b{flash write_binary} -@cindex flash write_binary @*use @option{flash write_bank} command with same args. @xref{flash write_bank}. @item @b{flash auto_erase} -@cindex 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 @@ -4565,10 +4550,8 @@ speed. The actual effect of this option depends on the JTAG interface used. @end itemize @item @b{load_binary} -@cindex load_binary @*use @option{load_image} command with same args. @xref{load_image}. @item @b{run_and_halt_time} -@cindex run_and_halt_time @*This command has been removed for simpler reset behaviour, it can be simulated with the following commands: @smallexample @@ -4577,13 +4560,10 @@ sleep 100 halt @end smallexample @item @b{target} <@var{type}> <@var{endian}> <@var{jtag-position}> -@cindex target @*use the create subcommand of @option{target}. @item @b{target_script} <@var{target#}> <@var{eventname}> <@var{scriptname}> -@cindex target_script @*use <@var{target_name}> configure -event <@var{eventname}> "script <@var{scriptname}>" @item @b{working_area} -@cindex 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