summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorzwelch <zwelch@b42882b7-edfa-0310-969c-e2dbd0fdcd60>2009-05-15 00:49:30 +0000
committerzwelch <zwelch@b42882b7-edfa-0310-969c-e2dbd0fdcd60>2009-05-15 00:49:30 +0000
commit8ed887456dcb9c150ca087fb54b56622574786b8 (patch)
tree1cf17eb0a6ed5062a087f9cb291877fb4246a05e
parent789b639a3949412c3a4f40196ec9b920d8615d54 (diff)
downloadopenocd+libswd-8ed887456dcb9c150ca087fb54b56622574786b8.tar.gz
openocd+libswd-8ed887456dcb9c150ca087fb54b56622574786b8.tar.bz2
openocd+libswd-8ed887456dcb9c150ca087fb54b56622574786b8.tar.xz
openocd+libswd-8ed887456dcb9c150ca087fb54b56622574786b8.zip
Add current draft of The List of Pending and Open Tasks.
git-svn-id: svn://svn.berlios.de/openocd/trunk@1791 b42882b7-edfa-0310-969c-e2dbd0fdcd60
-rw-r--r--TODO176
-rw-r--r--doc/manual/main.txt16
2 files changed, 187 insertions, 5 deletions
diff --git a/TODO b/TODO
index 2b2bb405..b1dc19f9 100644
--- a/TODO
+++ b/TODO
@@ -1,2 +1,176 @@
-This document is not in use. See mailing list.
+/** @page thelist Pending and Open Tasks
+This page lists pending and open tasks being considered or worked upon
+by the OpenOCD community.
+
+
+Items with a current patch available should include a link to its
+posting on the openocd-developer mailing list archives.
+
+Some items may be in progress, usually indicated by the individual whose
+initials in parentheses following it. A key for decoding these initials
+appears after The List.
+
+Most items are open for the taking, but please post to the mailing list
+before spending much time working on anything lists here. The community
+may have evolved an idea since it was added here.
+
+Feel free to send patches to add or clarify items on this list, too.
+
+@verbatim
+==================================================================
+ The List
+------------------------------------------------------------------
+@endverbatim
+
+- JTAG/TAP changes:
+ - update all drivers to use tap_get_tms_path_len API.
+ - link to posted patch: @missing
+ - rework TAP state table (started but still needs work)
+ - link to posted patch: @missing
+ - use tap_set_state everywhere to allow logging TAP state transitions
+ - rename other tap_states to use standard JTAG names (suggested by ML)
+ - write script that automate production of the series of 16-17 patches
+ - produce and distribute current series against the current trunk
+ - distribute script so developers can use on WC through live commits
+ - make live commits after giving sufficient notice to others
+ - add TAP_UNKNOWN to augment TAP_INVALID? (suggested by ML/DH)
+
+- JTAG Interfaces:
+ - autodetect devices present on the scan chain
+ - implement 'discover_taps' command
+ - FT2232 driver: (DH)
+ - integrate FTD2XX High-Speed Device Patch
+ - link to posted patch: @missing
+ - fix non-recoverability of cable connect/reconnect
+ - link to posted patch: @missing
+ - fix outstanding bugs
+ - J-Link driver: (ZW)
+ - fix outstanding bugs
+ - test with known targets (i.e. working with other interfaces)
+ - test compatibility between v6.0 (yellow) and older units (e.g. v5.2)
+ - TCP driver:
+ - add TCP/IP client and server for remote JTAG interface control
+ - Do others need some help? Probably....
+
+- Other Interfaces
+ - SVF/XSVF:
+ - pending tasks??
+ - SPI/UART emulation:
+ - (ab)use bit-banging JTAG interfaces to emulate SPI/UART
+ - allow SPI to program flash, MCUs, etc.
+ - SWD
+
+- Target Support:
+ - ARM11 improvements (MB?)
+ - fix single stepping (reported by ØH)
+ - implement missing functionality (grep FNC_INFO_NOTIMPLEMENTED ...)
+ - Cortex A8 support (ML)
+ - add target implementation (ML)
+ - what else remains to be done?
+ - MC1322x support (JW/DE?)
+ - integrate and test support from JW (and DE?)
+ - get working with a known good interface (i.e. not today's jlink)
+ - AT91SAM92xx:
+ - improvements for unknown-board-atmel-at91sam9260.cfg (RD)
+ - STR9x: (ZW)
+ - improvements to str912.cfg to be more general purpose
+ - AVR: (SQ)
+ - independently verify implementation
+ - incrementally improve working prototype in trunk. (SQ)
+ - work out how to debug this target
+ - AVR debugging protocol.
+ - FPGA:
+ - improve things (??)
+ - Coldfire (suggested by NC)
+ - can we draw from the BDM project? @par
+ http://bdm.sourceforge.net/
+
+ - other targets? (suggestions always welcome)
+
+- CFI:
+ - speed enhancements (posted Apr 22 by NC) (??)
+ - link to patch: @missing
+ - finish implementing bus width/chip width handling (suggested by NC)
+ - link to patch: @missing
+ - factor vendor-specific code into separate source files
+ - add new callback interface for vendor-specific code
+ - investigate/implement "thin wrapper" to use eCos CFI drivers (ØH)
+
+- TCL
+ - Isolate all TCL command support:
+ - Allow pure C CLI implementations using --disable-builtin-tcl
+ - Allow full TCL support? add --with-tcl=/path/to/installed/tcl
+ - Move TCL support in foo.* to foo_tcl.* (other ideas?)
+
+- Debugger Support
+ - Keil AGDI interface to OpenOCD (submitted by Dario Vecchio)
+
+- Architectural Upgrades
+ - Allow N:M:P mapping of servers, targets, and interfaces
+ - loadable module support for interface/target/flash drivers
+ - libopenocd support: @par
+ https://lists.berlios.de/pipermail/openocd-development/2009-May/006405.html
+
+- Test Suite:
+ - implement server unit tests
+ - implement JTAG core unit tests
+ - implement JTAG interface unit tests
+ - implement flash unit tests
+ - implement target unit tests
+
+- Test Feedback Tools: @par
+ https://lists.berlios.de/pipermail/openocd-development/2009-May/006358.html
+
+ - extend target test script to produce helpful pass/fail output
+ - provide results submission script
+
+
+- Generic Hardware Tester:
+ - implement VHDL to use for FPGA-based JTAG TAP testing device
+ - develop test suite that utilizes this testing device
+
+- Build Systems (Autotools, CMake, etc.)
+ - investigate fixes to permit the use of -Wshadow
+ - change bootstrap to call 'configure --enable-maintainer-mode <opts>'?
+
+- Miscellaneous:
+ - make JTAG and USB debug output a run-time configuration option
+ - review and clean up interface/target/flash APIs
+ - factor code to eliminate duplicated functionality
+ - overhaul use of types to improve 32/64-bit portability
+
+- Berlios Admin:
+ - use patch tracker? @par
+ https://developer.berlios.de/patch/?group_id=4148
+ - use bug tracking? we need something!
+
+@verbatim
+==================================================================
+OpenOCD's Active Developers and Testers
+------------------------------------------------------------------
+
+** | Name | Status | Targets | Interfaces
+---+-----------------+--------+------------------+----------------
+NC | Nico Coesel | * | AU1100 | *
+DE | Duane Ellis | * | * | *
+DH | Dick Hollenbeck | ? | * | FT2232
+ØH | Øyvind Harboe | * | * | ZY1000
+JK | Joern Keipf | * | * | FT2232H/FT4232HS?
+JW | Jeff Williams | ? | MC1322x | J-Link
+MA | Mariano Alvira | * | MC1322x | J-Link, FTDI
+MB | Michael Bruck | * | ARM11 | *
+ML | Magnus Lundin | * | * | *
+RA | Rick Altherr | * | * | *
+RD | Rene Doss | * | AT91SAM92xx | *
+SQ | Simon Qian | * | AVR | *
+ZW | Zach Welch | * | STR912 | J-Link
+
+Status Key:
+* - Active Contributor
+? - Missing In Action
+V - On Vacation
+
+@endverbatim
+
+*/
diff --git a/doc/manual/main.txt b/doc/manual/main.txt
index be1460b3..018c025f 100644
--- a/doc/manual/main.txt
+++ b/doc/manual/main.txt
@@ -1,10 +1,15 @@
/** @mainpage OpenOCD Reference Manual
-The @ref primer page provides introductory materials for new developers.
-
-The @ref oocd page explains how the code has been organized into layers
-of APIs and gives an overview of how they fit together.
+@ref oocd explains how the code has been organized into layers
+of APIs and gives an overview of how they fit together. These pages
+attempt to give developers a high-level perspective of the various
+code modules provided by OpenOCD.
+@ref primer provide introductory materials for new developers.
+
+The List of @ref thelist enumerates opportunities for improving or
+extending the OpenOCD platform.
+
*/
/** @page primer OpenOCD Technical Primers
@@ -54,4 +59,7 @@ modules are stacked in the current implementation (from bottom to top):
Obviously, there are some nuances to the stack that are not shown by
this linear list of layers.
+The List of @ref thelist enumerates opportunities for improving or
+extending the OpenOCD platform.
+
*/