server: tcl_notifications command

Implements async target notifications to the tcl server

Change-Id: I4d83e9fa209e95426c440030597f99e9f0c3b260
Signed-off-by: Austin Morton <austinpmorton@gmail.com>
Reviewed-on: http://openocd.zylin.com/2336
Reviewed-by: Paul Fertser <fercerpav@gmail.com>
Tested-by: jenkins
Reviewed-by: Spencer Oliver <spen@spen-soft.co.uk>
This commit is contained in:
Austin Morton
2015-02-21 04:20:33 -05:00
committed by Paul Fertser
parent c50047bb41
commit 1d0cf0df37
4 changed files with 212 additions and 4 deletions

View File

@@ -8642,6 +8642,28 @@ Remember that most of the OpenOCD commands need to be prefixed with
See @file{contrib/rpc_examples/} for specific client implementations.
@section Tcl RPC server notifications
@cindex RPC Notifications
Notifications are sent asynchronously to other commands being executed over
the RPC server, so the port must be polled continuously.
Target event, state and reset notifications are emitted as Tcl associative arrays
in the following format.
@verbatim
type target_event event [event-name]
type target_state state [state-name]
type target_reset mode [reset-mode]
@end verbatim
@deffn {Command} tcl_notifications [on/off]
Toggle output of target notifications to the current Tcl RPC server.
Only available from the Tcl RPC server.
Defaults to off.
@end deffn
@node FAQ
@chapter FAQ
@cindex faq