25218e8935
With zy1000 removed, there is no other implementation that uses the minidriver, apart from the test/example minidriver-dummy. While the idea of the minidriver is probably still valid (that is to intercept jtag primitives before serialization), there is no current use case, no guarantee it is really working, and the way it was implemented (by macros and #if conditionals) is really hard to maintain and test. Let's let it rip in git history, from where it could eventually be taken back in a more modern implementation. The entry points of minidriver API are still in the code with the original names. Change-Id: I882e32cb26cf5842f9cba14e3badaf8948e3760d Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-on: http://openocd.zylin.com/6091 Tested-by: jenkins Reviewed-by: Tomas Vanek <vanekt@fbl.cz>
91 lines
4.0 KiB
C
91 lines
4.0 KiB
C
/***************************************************************************
|
|
* Copyright (C) 2005 by Dominic Rath *
|
|
* Dominic.Rath@gmx.de *
|
|
* *
|
|
* Copyright (C) 2007,2008 Øyvind Harboe *
|
|
* oyvind.harboe@zylin.com *
|
|
* *
|
|
* Copyright (C) 2009 Zachary T Welch *
|
|
* zw@superlucidity.net *
|
|
* *
|
|
* This program is free software; you can redistribute it and/or modify *
|
|
* it under the terms of the GNU General Public License as published by *
|
|
* the Free Software Foundation; either version 2 of the License, or *
|
|
* (at your option) any later version. *
|
|
* *
|
|
* This program is distributed in the hope that it will be useful, *
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
|
|
* GNU General Public License for more details. *
|
|
* *
|
|
* You should have received a copy of the GNU General Public License *
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>. *
|
|
***************************************************************************/
|
|
|
|
#ifndef OPENOCD_JTAG_MINIDRIVER_H
|
|
#define OPENOCD_JTAG_MINIDRIVER_H
|
|
|
|
/**
|
|
* @page jtagminidriver JTAG Mini-Driver
|
|
*
|
|
* The JTAG minidriver interface allows the definition of alternate
|
|
* interface functions, instead of the built-in asynchronous driver
|
|
* module that is used by the standard JTAG interface drivers.
|
|
*
|
|
* In addtion to the functions defined in the @c minidriver.h file, the
|
|
* @c jtag_minidriver.h file must declare the following functions (or
|
|
* define static inline versions of them):
|
|
* - jtag_add_callback
|
|
* - jtag_add_callback4
|
|
*
|
|
* The following core functions are declared in this file for use by
|
|
* the minidriver and do @b not need to be defined by an implementation:
|
|
* - default_interface_jtag_execute_queue()
|
|
*/
|
|
|
|
/* this header will be provided by the minidriver implementation, */
|
|
/* and it may provide additional declarations that must be defined. */
|
|
#include <jtag/drivers/minidriver_imp.h>
|
|
|
|
int interface_jtag_add_ir_scan(struct jtag_tap *active,
|
|
const struct scan_field *fields,
|
|
tap_state_t endstate);
|
|
int interface_jtag_add_plain_ir_scan(
|
|
int num_bits, const uint8_t *out_bits, uint8_t *in_bits,
|
|
tap_state_t endstate);
|
|
|
|
int interface_jtag_add_dr_scan(struct jtag_tap *active,
|
|
int num_fields, const struct scan_field *fields,
|
|
tap_state_t endstate);
|
|
int interface_jtag_add_plain_dr_scan(
|
|
int num_bits, const uint8_t *out_bits, uint8_t *in_bits,
|
|
tap_state_t endstate);
|
|
|
|
int interface_jtag_add_tlr(void);
|
|
int interface_jtag_add_pathmove(int num_states, const tap_state_t *path);
|
|
int interface_jtag_add_runtest(int num_cycles, tap_state_t endstate);
|
|
|
|
int interface_add_tms_seq(unsigned num_bits,
|
|
const uint8_t *bits, enum tap_state state);
|
|
|
|
/**
|
|
* This drives the actual srst and trst pins. srst will always be 0
|
|
* if jtag_reset_config & RESET_SRST_PULLS_TRST != 0 and ditto for
|
|
* trst.
|
|
*
|
|
* the higher level jtag_add_reset will invoke jtag_add_tlr() if
|
|
* appropriate
|
|
*/
|
|
int interface_jtag_add_reset(int trst, int srst);
|
|
int interface_jtag_add_sleep(uint32_t us);
|
|
int interface_jtag_add_clocks(int num_cycles);
|
|
int interface_jtag_execute_queue(void);
|
|
|
|
/**
|
|
* Calls the interface callback to execute the queue. This routine
|
|
* is used by the JTAG driver layer and should not be called directly.
|
|
*/
|
|
int default_interface_jtag_execute_queue(void);
|
|
|
|
#endif /* OPENOCD_JTAG_MINIDRIVER_H */
|