From 8766d396176a277cf1af4ce9a0bbc20d62fe8eb5 Mon Sep 17 00:00:00 2001 From: oharboe Date: Tue, 15 Jul 2008 14:10:13 +0000 Subject: feeble beginnings for tcl api rules. git-svn-id: svn://svn.berlios.de/openocd/trunk@809 b42882b7-edfa-0310-969c-e2dbd0fdcd60 --- doc/openocd.texi | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) (limited to 'doc') diff --git a/doc/openocd.texi b/doc/openocd.texi index 573457b5..3fc5fa5e 100644 --- a/doc/openocd.texi +++ b/doc/openocd.texi @@ -52,6 +52,7 @@ This manual documents edition @value{EDITION} of the Open On-Chip Debugger * Sample Scripts:: Sample Target Scripts * GDB and OpenOCD:: Using GDB and OpenOCD * TCL and OpenOCD:: Using TCL and OpenOCD +* TCL scripting API:: Tcl scripting API * Upgrading:: Deprecated/Removed Commands * FAQ:: Frequently Asked Questions * License:: GNU Free Documentation License @@ -1399,6 +1400,49 @@ close $fo This script can easily be modified to front various GUIs or be a sub component of a larger framework for control and interaction. + +@node TCL scripting API +@chapter TCL scripting API +@cindex TCL scripting API +API rules + +The commands are stateless. E.g. the telnet command line has a concept +of currently active target, the Tcl API proc's take this sort of state +information as an argument to each proc. + +There are three main types of return values: single value, name value +pair list and lists. + +Name value pair. The proc 'foo' below returns a name/value pair +list. + +@verbatim + + > set foo(me) Duane + > set foo(you) Oyvind + > set foo(mouse) Micky + > set foo(duck) Donald + +If one does this: + + > set foo + +The result is: + + me Duane you Oyvind mouse Micky duck Donald + +Thus, to get the names of the associative array is easy: + + foreach { name value } [set foo] { + puts "Name: $name, Value: $value" + } +@end verbatim + +Lists returned must be relatively small. Otherwise a range +should be passed in to the proc in question. + + + @node Upgrading @chapter Deprecated/Removed Commands @cindex Deprecated/Removed Commands -- cgit v1.2.3