SVF: all content between parentheses is one parameter
[fw/openocd] / NEWS
diff --git a/NEWS b/NEWS
index a5a5401dad78548e96d81122ce3d3c2632411165..f7bf1d313255b6e3ff55df8a0834e127f5138a62 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,54 +1,96 @@
-This file should include highlights of the changes made in the
-OpenOCD openocd-0.3.0 source archive release.  See the repository
-history for details about what changed, including bugfixes and
-other issues not mentioned here.
+This file includes highlights of the changes made in the
+OpenOCD 0.4.0 source archive release.  See the repository
+history for details about what changed, including bugfixes
+and other issues not mentioned here.
 
 JTAG Layer:
-    FT2232H (high speed USB) support doesn't need separate configuration
-    New reset_config options for SRST gating the JTAG clock (or not)
-    TAP declaration no longer requires ircapture and mask attributes
-    New "post-reset" event handler for TAP-invariant setup code
+       Support KT-Link JTAG adapter.
+       Support USB-JTAG, Altera USB-Blaster and compatibles.
+
+Boundary Scan:
 
 Target Layer:
-    New commands for use with Cortex-M3 processors:
-       "cortex_m3 disassemble" ... Thumb2 disassembly (UAL format)
-       "cortex_m3 vector_catch" ... traps certain hardware faults
-               without tying up breakpoint resources
-    If you're willing to help debug it
-       VERY EARLY Cortex-A8 and ARMv7A support
-       Updated BeagleBoard.org hardware support
-    New commands for use with XScale processors: "xscale vector_table"
-    ARM11
-       single stepping support for i.MX31
-       bugfix for missing "arm11" prefix on "arm11 memwrite ..."
-    ETM support
-       Unavailable registers are not listed
+       General
+               - new "reset-assert" event, for systems without SRST
+       ARM
+               - supports "reset-assert" event (except on Cortex-M3)
+               - renamed "armv4_5" command prefix as "arm"
+               - recognize TrustZone "Secure Monitor" mode
+               - "arm regs" command output changed
+               - register names use "sp" not "r13"
+               - add top-level "mcr" and "mrc" commands, replacing
+                 various core-specific operations
+               - basic semihosting support (ARM7/ARM9 only, for now)
+       ARM11
+               - Should act much more like other ARM cores:
+                  * Preliminary ETM and ETB hookup
+                  * accelerated "flash erase_check"
+                  * accelerated GDB memory checksum
+                  * support "arm regs" command
+                  * can access all core modes and registers
+                  * watchpoint support
+               - Shares some core debug code with Cortex-A8
+       Cortex-A8
+               - Should act much more like other ARM cores:
+                  * support "arm regs" command
+                  * can access all core modes and registers
+                  * watchpoint support
+               - Shares some core debug code with ARM11
+       Cortex-M3
+               - Exposed DWT registers like cycle counter
+               - vector_catch settings not clobbered by resets
+               - no longer interferes with firmware's fault handling
+       ETM, ETB
+               - "trigger_percent" command moved ETM --> ETB
+               - "etm trigger_debug" command added
+       MIPS
+               - use fastdata writes
+       Freescale DSP563xx cores (partial support)
 
 Flash Layer:
-    The lpc2000 driver handles the new NXP LPC1700 (Cortex-M3) chips
-    New lpc2900 driver for NXP LPC2900 chips (ARM968 based)
-    New "last" flag for NOR "flash erase_sector" and "flash protect"
-    The "nand erase N" command now erases all of bank N
+       'flash bank' and 'nand device' take <bank_name> as first argument.
+       With this, flash/NAND commands allow referencing banks by name:
+               - <bank_name>: reference the bank with its defined name
+               - <driver_name>[.N]: reference the driver's Nth bank
+       New 'nand verify' command to check bank against an image file.
+       The "flash erase_address" command now rejects partial sectors;
+               previously it would silently erase extra data.  If you
+               want to erase the rest of the first and/or last sectors
+               instead of failing, you must pass an explicit "pad" flag.
+       New at91sam9 NAND controller driver.
+       New s3c64xx NAND controller driver.
 
 Board, Target, and Interface Configuration Scripts:
-    Amontec JTAGkey2 support
-    Cleanup and additions for the TI/Luminary Stellaris scripts
-    LPC1768 target (and flash) support
-       Keil MCB1700 eval board
-    Samsung s3c2450
-       Mini2440 board
-    Numeric TAP and Target identifiers now trigger warnings
+       ARM9
+               - ETM and ETB hookup for iMX2* targets
+       Add $HOME/.openocd to the search path.
+       Handle Rev C of LM3S811 eval boards.
+               - use "luminary-lm3s811.cfg" for older boards
+               - use "luminary.cfg" for RevC and newer
+
+Core Jim/TCL Scripting:
+       New 'usage' command to provide terse command help.
+       Improved command 'help' command output (sorted and indented).
+       Improved command handling:
+               - Most boolean settings now accept any of the following:
+                 on/off, enable/disable, true/false, yes/no, 1/0
+               - More error checking and reporting.
 
 Documentation:
-    Capture more debugging and setup advice
-    Notes on target source code changes that may help debugging
+       New built-in command development documentation and primer.
 
 Build and Release:
+       Use --enable-doxygen-pdf to build PDF developer documentation.
+       Consider upgrading to libftdi 0.17 if you use that library; it
+               includes bugfixes which improve FT2232H support.
 
 For more details about what has changed since the last release,
-see the ChangeLog associated with this source archive.  For older NEWS,
-see the NEWS files associated with each release (i.e. NEWS-<version>).
+see the git repository history.  With gitweb, you can browse that
+in various levels of detail.
+
+For older NEWS, see the NEWS files associated with each release
+(i.e. NEWS-<version>).
 
 For more information about contributing test reports, bug fixes, or new
 features and device support, please read the new Developer Manual (or
-the BUGS and PATCHES files in the source archive).
+the BUGS and PATCHES.txt files in the source archive).