drivers/vdebug: add support for DAP level interface
[fw/openocd] / src / jtag / drivers / bitbang.h
index bbbc693df5634fcffca85a33950b619937a4f17c..4ea1cc0454d64e71f9cc29ef4b071c907ea70601 100644 (file)
@@ -1,22 +1,11 @@
+/* SPDX-License-Identifier: GPL-2.0-or-later */
+
 /***************************************************************************
  *   Copyright (C) 2005 by Dominic Rath                                    *
  *   Dominic.Rath@gmx.de                                                   *
  *                                                                         *
  *   Copyright (C) 2007,2008 Ã˜yvind Harboe                                 *
  *   oyvind.harboe@zylin.com                                               *
- *                                                                         *
- *   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_DRIVERS_BITBANG_H
@@ -38,32 +27,39 @@ typedef enum {
  * sample requests together. Not waiting for a value to come back can greatly
  * increase throughput. */
 struct bitbang_interface {
-       /** Sample TDO. */
+       /** Sample TDO and return the value. */
        bb_value_t (*read)(void);
 
        /** The number of TDO samples that can be buffered up before the caller has
         * to call read_sample. */
        size_t buf_size;
+
        /** Sample TDO and put the result in a buffer. */
        int (*sample)(void);
+
        /** Return the next unread value from the buffer. */
        bb_value_t (*read_sample)(void);
 
        /** Set TCK, TMS, and TDI to the given values. */
        int (*write)(int tck, int tms, int tdi);
+
+       /** Blink led (optional). */
        int (*blink)(int on);
+
+       /** Sample SWDIO and return the value. */
        int (*swdio_read)(void);
+
+       /** Set direction of SWDIO. */
        void (*swdio_drive)(bool on);
+
+       /** Set SWCLK and SWDIO to the given value. */
+       int (*swd_write)(int swclk, int swdio);
 };
 
 extern const struct swd_driver bitbang_swd;
 
-extern bool swd_mode;
-
 int bitbang_execute_queue(void);
 
 extern struct bitbang_interface *bitbang_interface;
-void bitbang_switch_to_swd(void);
-int bitbang_swd_switch_seq(enum swd_special_seq seq);
 
 #endif /* OPENOCD_JTAG_DRIVERS_BITBANG_H */