[Openocd-svn] r2188 - trunk/src/jtag

[<zw...@ma...>]

Author: zwelch
Date: 2009-06-11 09:08:34 +0200 (Thu, 11 Jun 2009)
New Revision: 2188

Modified:
   trunk/src/jtag/jtag.h
Log:
Improve grouping of JTAG KHz and verification accessors in header file.
Add some quick Doxygen comments for these routines.


Modified: trunk/src/jtag/jtag.h
===================================================================
--- trunk/src/jtag/jtag.h	2009-06-11 07:08:28 UTC (rev 2187)
+++ trunk/src/jtag/jtag.h	2009-06-11 07:08:34 UTC (rev 2188)
@@ -250,6 +250,15 @@
  */
 int jtag_set_speed(int speed);
 
+
+/// Attempt to configure the interface for the specified KHz.
+int jtag_config_khz(unsigned khz);
+/// Set the clock speed of the JTAG interface in KHz.
+void jtag_set_speed_khz(unsigned speed);
+/// Retreives the clock speed of the JTAG interface in KHz.
+unsigned jtag_get_speed_khz(void);
+
+
 enum reset_types {
 	RESET_NONE            = 0x0,
 	RESET_HAS_TRST        = 0x1,
@@ -275,7 +284,15 @@
 /// @returns The current state of SRST.
 int jtag_get_srst(void);
 
+/// Enable or disable data scan verification checking.
+void jtag_set_verify(bool enable);
+/// @returns True if data scan verification will be performed.
+bool jtag_will_verify(void);
 
+/// Enable or disable verification of IR scan checking.
+void jtag_set_verify_capture_ir(bool enable);
+/// @returns True if IR scan verification will be performed.
+bool jtag_will_verify_capture_ir(void);
 
 /**
  * Initialize interface upon startup.  Return a successful no-op upon
@@ -672,16 +689,6 @@
 /// @returns the number of times the scan queue has been flushed
 int jtag_get_flush_queue_count(void);
 
-int jtag_config_khz(unsigned khz);
-void jtag_set_speed_khz(unsigned speed);
-unsigned jtag_get_speed_khz(void);
-
-void jtag_set_verify(bool enable);
-bool jtag_will_verify(void);
-
-void jtag_set_verify_capture_ir(bool enable);
-bool jtag_will_verify_capture_ir(void);
-
 /**
  * Set the current JTAG core execution error, unless one was set
  * by a previous call previously.  Driver or application code must