interface.h

Go to the documentation of this file.

/* 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                                               *
 *                                                                         *
 *   Copyright (C) 2009 Zachary T Welch                                    *
 *   zw@superlucidity.net                                                  *
 ***************************************************************************/
 
#ifndef OPENOCD_JTAG_INTERFACE_H
#define OPENOCD_JTAG_INTERFACE_H
 
#include <jtag/jtag.h>
#include <jtag/swim.h>
#include <target/arm_tpiu_swo.h>
 
/* @file
 * The "Cable Helper API" is what the cable drivers can use to help
 * implement their "Cable API".  So a Cable Helper API is a set of
 * helper functions used by cable drivers, and this is different from a
 * Cable API.  A "Cable API" is what higher level code used to talk to a
 * cable.
 */
 
 
void tap_set_state_impl(tap_state_t new_state);
 
#define tap_set_state(new_state) \
    do { \
        LOG_DEBUG_IO("tap_set_state(%s)", tap_state_name(new_state)); \
        tap_set_state_impl(new_state); \
    } while (0)
 
tap_state_t tap_get_state(void);
 
void tap_set_end_state(tap_state_t new_end_state);
 
tap_state_t tap_get_end_state(void);
 
int tap_get_tms_path(tap_state_t from, tap_state_t to);
 
int tap_get_tms_path_len(tap_state_t from, tap_state_t to);
 
 
int tap_move_ndx(tap_state_t astate);
 
bool tap_is_state_stable(tap_state_t astate);
 
tap_state_t tap_state_transition(tap_state_t current_state, bool tms);
 
void tap_use_new_tms_table(bool use_new);
bool tap_uses_new_tms_table(void);
 
 
static inline tap_state_t jtag_debug_state_machine(const void *tms_buf,
        const void *tdi_buf, unsigned tap_len, tap_state_t start_tap_state)
{
    /* Private declaration */
    tap_state_t jtag_debug_state_machine_(const void *tms_buf, const void *tdi_buf,
            unsigned tap_len, tap_state_t start_tap_state);
 
    if (LOG_LEVEL_IS(LOG_LVL_DEBUG_IO))
        return jtag_debug_state_machine_(tms_buf, tdi_buf, tap_len, start_tap_state);
    else
        return start_tap_state;
}
 
struct jtag_interface {
    unsigned supported;
#define DEBUG_CAP_TMS_SEQ   (1 << 0)
 
    int (*execute_queue)(void);
};
 
struct adapter_driver {
    const char * const name;
 
    const char * const *transports;
 
    const struct command_registration *commands;
 
    int (*init)(void);
 
    int (*quit)(void);
 
    int (*reset)(int srst, int trst);
 
    int (*speed)(int speed);
 
    int (*khz)(int khz, int *jtag_speed);
 
    int (*speed_div)(int speed, int *khz);
 
    int (*power_dropout)(int *power_dropout);
 
    int (*srst_asserted)(int *srst_asserted);
 
    int (*config_trace)(bool enabled, enum tpiu_pin_protocol pin_protocol,
        uint32_t port_size, unsigned int *trace_freq,
        unsigned int traceclkin_freq, uint16_t *prescaler);
 
    int (*poll_trace)(uint8_t *buf, size_t *size);
 
    struct jtag_interface *jtag_ops;
 
    const struct swd_driver *swd_ops;
 
    /* DAP APIs over JTAG transport */
    const struct dap_ops *dap_jtag_ops;
 
    /* DAP APIs over SWD transport */
    const struct dap_ops *dap_swd_ops;
 
    /* SWIM APIs */
    const struct swim_driver *swim_ops;
};
 
extern const char * const jtag_only[];
 
int adapter_resets(int assert_trst, int assert_srst);
int adapter_assert_reset(void);
int adapter_deassert_reset(void);
int adapter_config_trace(bool enabled, enum tpiu_pin_protocol pin_protocol,
        uint32_t port_size, unsigned int *trace_freq,
        unsigned int traceclkin_freq, uint16_t *prescaler);
int adapter_poll_trace(uint8_t *buf, size_t *size);
 
#endif /* OPENOCD_JTAG_INTERFACE_H */