User's Guide: add quickie setup notes
[openocd/jflash.git] / NEWS-0.2.0
blobf56c7a4f38342d5790b64d1862ef700a4db633c5
1 The OpenOCD 0.2.0 source archive release includes numerous improvements
2 that were made since the initial 0.1.0 source archive release.  Many
3 contributors helped make this release a great success, and the community
4 of developers and maintainers look forward to any response.
6 In addition to the list of changes below, countless bug fixing and
7 cleaning was performed across the tree.  Various TCL command parameters
8 must past stricter value checks, and many more error conditions have
9 been handled correctly.  These efforts helped to make the 0.2.0 release
10 more stable and robust, though some changes may expose latent bugs in
11 your existing configuration scripts.
13 This release does not maintain backward compatibility in all respects,
14 so some target or configuration scripts may need to be updated.  In some
15 cases, you may also see warnings; resolve those, because they indicate
16 commands that will be removed in the future.
18 The following areas of OpenOCD functionality changed in this release:
20 JTAG Layer:
21 - Improves modularity: core, TCL, driver commands, and interface have
22   been separated, encapsulated, and documented for developers.  Mostly.
23 - Improves JTAG TAP transition tables: 
24    * Makes TAP paths variable length, rather than being fixed at 7 steps.
25    * Fixes problems with some targets that did not like longer paths.
26 - Improves JTAG driver/minidriver modularity and encapsulation.
27 - New drivers:
28    * Adds stub minidriver for developing new embedded JTAG interfaces.
29 - Improves drivers:
30    * ft2232+ftd2xx:
31       + Adds initial high-speed device support: --enable-ftd2xx-highspeed
32       + Supports more types of FTDI-based devices.
33    * jlink:
34       + Works with more versions of the firmware (v3 and newer)
35       + Supports dynamically detects device capabilities and limits
36    * vsllink:
37       + Supports very long scan chains
38    * amtjtagaccel:
39       + Fixes broken ID code detection problems.
41 Target Layer:
42 - New devices: AVR, FA526
43 - Improved support: ARM ADI, ARM11, MIPS
44 - Numerous other bug fixes and improvements
46 Flash Layer:
47 - Improved drivers: mflash
48 - New drivers: AT91SAM3, AVR, Davinci NAND
50 Board, Interface, and Target Configuration Scripts:
51 - Many new and improved targets and boards are now available.
52 - Better separation of "board" and "target" configuration
53 - Moved all TCL files to top-level "tcl" directory in the source tree
54 - Installation moved from '$pkglibdir/' to '$pkgdatadir/scripts/'.
55 - Site-specific files should be installed under '$pkgdatadir/site/';
56   files that exist this tree will be used in preference to default
57   distribution configurations in '$pkgdatadir/scripts/'.
59 Documentation:
60 - Updated User Guide:     http://openocd.berlios.de/doc/html/index.html
61    * Partially re-written and re-organized.
62    * Standardized presentation for all commands.
63    * Covers many drivers and commands that were previously omitted.
64    * New index for commands and drivers.
65 - Added Developer Manual: http://openocd.berlios.de/doc/doxygen/index.html
66    * Now includes architecture, technical primers, style guides, and more.
67    * Available in-tree and on-line.
69 Build and Release:
70 - Increased configuration and compilation warning coverage.
71    * Use --disable-werror to work around build errors caused by warnings.
72 - Use libtool to produce helper libraries as a step toward "libopenocd".
73 - New processes and scripting to facilitate future source releases.
75 For more details about what has changed since 0.1.0, see the ChangeLog
76 associated with this release.
78 For more information about contributing test reports, bug fixes, or new
79 features and device support, please read the new Developer Manual (or
80 the BUGS and PATCHES files in the source archive).