X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=src%2Fjtag%2Finterface.h;h=958af8f5a518b5844db4322ae80a83c2f9830c1b;hb=8eb92c7e99c018c1cb48be76b0c9736b6c64cba9;hp=5727298513b1cbd65a2ef6a4acfe77c57df5048a;hpb=9f535f9af7c6b7e8843033049a6da0f6d76d513b;p=openocd diff --git a/src/jtag/interface.h b/src/jtag/interface.h index 57272985..958af8f5 100644 --- a/src/jtag/interface.h +++ b/src/jtag/interface.h @@ -26,7 +26,7 @@ #ifndef OPENOCD_JTAG_INTERFACE_H #define OPENOCD_JTAG_INTERFACE_H -#include "jtag.h" +#include /* @file * The "Cable Helper API" is what the cable drivers can use to help @@ -184,10 +184,33 @@ static inline tap_state_t jtag_debug_state_machine(const void *tms_buf, } #endif // _DEBUG_JTAG_IO_ +/** + * Represents a driver for a debugging interface. + * + * @todo Rename; perhaps "debug_driver". This isn't an interface, + * it's a driver! Also, not all drivers support JTAG. + * + * @todo We need a per-instance structure too, and changes to pass + * that structure to the driver. Instances can for example be in + * either SWD or JTAG modes. This will help remove globals, and + * eventually to cope with systems which have more than one such + * debugging interface. + */ struct jtag_interface { /// The name of the JTAG interface driver. char* name; + /** + * Bit vector listing capabilities exposed by this driver. + */ + unsigned supported; +#define DEBUG_CAP_TMS_SEQ (1 << 0) + + /** transports supported in C code (NULL terminated vector) */ + const char **transports; + + const struct swd_driver *swd; + /** * Execute queued commands. * @returns ERROR_OK on success, or an error code on failure. @@ -204,10 +227,8 @@ struct jtag_interface { /** * The interface driver may register additional commands to expose * additional features not covered by the standard command set. - * @param cmd_ctx The context in which commands should be registered. - * @returns ERROR_OK on success, or an error code on failure. */ - int (*register_commands)(struct command_context_s* cmd_ctx); + const struct command_registration *commands; /** * Interface driver must initalize any resources and connect to a @@ -273,4 +294,8 @@ struct jtag_interface { }; +extern const char *jtag_only[]; + +extern const struct swd_driver *swd; + #endif // OPENOCD_JTAG_INTERFACE_H