X-Git-Url: https://git.gag.com/?a=blobdiff_plain;f=src%2Fjtag%2Finterface.h;h=3226944e3f5b5ea04f51989f35a10d597c7d3559;hb=1c794320615d917d0e8fb4c40d096fd22f9a824f;hp=05e4048b1d3f06f86359745e902392013ee060e2;hpb=98723c4ecdbe06f90c66f3abec27b792c3b38e34;p=fw%2Fopenocd diff --git a/src/jtag/interface.h b/src/jtag/interface.h index 05e4048b1..3226944e3 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,31 @@ 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; + /** * Execute queued commands. * @returns ERROR_OK on success, or an error code on failure. @@ -204,10 +225,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* cmd_ctx); + const struct command_registration *commands; /** * Interface driver must initalize any resources and connect to a @@ -273,4 +292,6 @@ struct jtag_interface { }; +extern const char *jtag_only[]; + #endif // OPENOCD_JTAG_INTERFACE_H