adi_v5_swd.c File Reference

Utilities to support ARM "Serial Wire Debug" (SWD), a low pin-count debug link protocol used in cases where JTAG is not wanted. More...

Include dependency graph for adi_v5_swd.c:

Go to the source code of this file.

Functions
static int	check_sync (struct adiv5_dap *dap)
static int	swd_check_reconnect (struct adiv5_dap *dap)
static void	swd_clear_sticky_errors (struct adiv5_dap *dap)
static int	swd_connect (struct adiv5_dap *dap)
static int	swd_connect_multidrop (struct adiv5_dap *dap)
static int	swd_connect_single (struct adiv5_dap *dap)
static void	swd_constructor (void)
static void	swd_finish_read (struct adiv5_dap *dap)
static int	swd_init (struct command_context *ctx)
static int	swd_multidrop_select (struct adiv5_dap *dap)
static int	swd_multidrop_select_inner (struct adiv5_dap *dap, uint32_t *dpidr_ptr, uint32_t *dlpidr_ptr, bool clear_sticky)
static int	swd_pre_connect (struct adiv5_dap *dap)
static int	swd_queue_ap_abort (struct adiv5_dap *dap, uint8_t *ack)
static int	swd_queue_ap_bankselect (struct adiv5_ap *ap, unsigned int reg)
	Select the AP register bank. More...
static int	swd_queue_ap_read (struct adiv5_ap *ap, unsigned int reg, uint32_t *data)
static int	swd_queue_ap_write (struct adiv5_ap *ap, unsigned int reg, uint32_t data)
static int	swd_queue_dp_bankselect (struct adiv5_dap *dap, unsigned int reg)
	Select the DP register bank. More...
static int	swd_queue_dp_read (struct adiv5_dap *dap, unsigned int reg, uint32_t *data)
static int	swd_queue_dp_read_inner (struct adiv5_dap *dap, unsigned int reg, uint32_t *data)
static int	swd_queue_dp_write (struct adiv5_dap *dap, unsigned int reg, uint32_t data)
static int	swd_queue_dp_write_inner (struct adiv5_dap *dap, unsigned int reg, uint32_t data)
static void	swd_quit (struct adiv5_dap *dap)
	Put the SWJ-DP back to JTAG mode. More...
static int	swd_run (struct adiv5_dap *dap)
	Executes all queued DAP operations. More...
static int	swd_run_inner (struct adiv5_dap *dap)
static int	swd_select (struct command_context *ctx)
static int	swd_send_sequence (struct adiv5_dap *dap, enum swd_special_seq seq)
bool	transport_is_swd (void)
	Returns true if the current debug session is using SWD as its transport. More...

Variables
static bool	do_sync
static const struct command_registration	swd_commands []
const struct dap_ops	swd_dap_ops
static const struct command_registration	swd_handlers []
static bool	swd_multidrop_in_swd_state
static struct adiv5_dap *	swd_multidrop_selected_dap
static struct transport	swd_transport

Detailed Description

Utilities to support ARM "Serial Wire Debug" (SWD), a low pin-count debug link protocol used in cases where JTAG is not wanted.

This is coupled to recent versions of ARM's "CoreSight" debug framework. This specific code is a transport level interface, with "target/arm_adi_v5.[hc]" code understanding operation semantics, shared with the JTAG transport.

Single DAP and multidrop-SWD support.

for details, see "ARM IHI 0031A" ARM Debug Interface v5 Architecture Specification especially section 5.3 for SWD protocol and "ARM IHI 0074C" ARM Debug Interface Architecture Specification ADIv6.0

On many chips (most current Cortex-M3 parts) SWD is a run-time alternative to JTAG. Boards may support one or both. There are also SWD-only chips, (using SW-DP not SWJ-DP).

Even boards that also support JTAG can benefit from SWD support, because usually there's no way to access the SWO trace view mechanism in JTAG mode. That is, trace access may require SWD support.

Definition in file adi_v5_swd.c.

Function Documentation

check_sync()

static int check_sync ( struct adiv5_dap *  dap )

inlinestatic

Definition at line 91 of file adi_v5_swd.c.

References do_sync, ERROR_OK, and swd_run_inner().

Referenced by swd_queue_ap_abort(), swd_queue_ap_read(), swd_queue_ap_write(), swd_queue_dp_read_inner(), and swd_queue_dp_write_inner().

swd_check_reconnect()

static int swd_check_reconnect ( struct adiv5_dap *  dap )

static

Definition at line 462 of file adi_v5_swd.c.

References adiv5_dap::do_reconnect, ERROR_OK, and swd_connect().

Referenced by swd_queue_ap_read(), swd_queue_ap_write(), swd_queue_dp_read(), and swd_queue_dp_write().

swd_clear_sticky_errors()

static void swd_clear_sticky_errors ( struct adiv5_dap *  dap )

static

Definition at line 75 of file adi_v5_swd.c.

References adiv5_dap_swd_driver(), DP_ABORT, ORUNERRCLR, STKCMPCLR, STKERRCLR, swd_cmd(), WDERRCLR, and swd_driver::write_reg.

Referenced by swd_connect_single(), and swd_multidrop_select_inner().

swd_connect()

static int swd_connect ( struct adiv5_dap *  dap )

static

Definition at line 411 of file adi_v5_swd.c.

References adapter_assert_reset(), dap_dp_init(), dap_is_multidrop(), DAPABORT, adiv5_dap::do_reconnect, DP_ABORT, ERROR_OK, ERROR_WAIT, jtag_get_reset_config(), jtag_reset_config, LOG_WARNING, ORUNERRCLR, RESET_CNCT_UNDER_SRST, RESET_SRST_NO_GATING, status, STKCMPCLR, STKERRCLR, swd_connect_multidrop(), swd_connect_single(), swd_queue_dp_write_inner(), swd_run_inner(), and WDERRCLR.

Referenced by swd_check_reconnect().

swd_connect_multidrop()

static int swd_connect_multidrop ( struct adiv5_dap *  dap )

static

Definition at line 295 of file adi_v5_swd.c.

References adiv5_dap_name(), alive_sleep(), dap_invalidate_cache(), adiv5_dap::do_reconnect, ERROR_OK, LOG_ERROR, LOG_INFO, NULL, swd_multidrop_in_swd_state, swd_multidrop_select_inner(), swd_multidrop_selected_dap, and timeval_ms().

Referenced by swd_connect().

swd_connect_single()

static int swd_connect_single ( struct adiv5_dap *  dap )

static

Definition at line 334 of file adi_v5_swd.c.

References alive_sleep(), dap_invalidate_cache(), adiv5_dap::do_reconnect, DORMANT_TO_SWD, DP_DPIDR, ERROR_OK, ERROR_WAIT, JTAG_TO_DORMANT, JTAG_TO_SWD, LOG_ERROR, LOG_INFO, adiv5_dap::select_dpbanksel_valid, swd_clear_sticky_errors(), swd_queue_dp_read_inner(), swd_run_inner(), swd_send_sequence(), adiv5_dap::switch_through_dormant, and timeval_ms().

Referenced by swd_connect().

swd_constructor()

static void swd_constructor ( void  )

static

Definition at line 767 of file adi_v5_swd.c.

swd_finish_read()

static void swd_finish_read ( struct adiv5_dap *  dap )

static

Definition at line 66 of file adi_v5_swd.c.

References adiv5_dap_swd_driver(), DP_RDBUFF, adiv5_dap::last_read, NULL, swd_driver::read_reg, and swd_cmd().

Referenced by swd_queue_ap_write(), swd_queue_dp_write_inner(), and swd_run().

swd_init()

static int swd_init ( struct command_context *  ctx )

static

Definition at line 754 of file adi_v5_swd.c.

References ERROR_OK.

swd_multidrop_select()

static int swd_multidrop_select ( struct adiv5_dap *  dap )

static

Definition at line 264 of file adi_v5_swd.c.

References adiv5_dap_name(), dap_is_multidrop(), adiv5_dap::do_reconnect, ERROR_OK, LOG_DEBUG, LOG_ERROR, NULL, swd_multidrop_select_inner(), and swd_multidrop_selected_dap.

Referenced by swd_queue_ap_abort(), swd_queue_ap_read(), swd_queue_ap_write(), swd_queue_dp_read(), swd_queue_dp_write(), and swd_run().

swd_multidrop_select_inner()

static int swd_multidrop_select_inner ( struct adiv5_dap *  dap, uint32_t *  dpidr_ptr, uint32_t *  dlpidr_ptr, bool  clear_sticky  )

static

Definition at line 179 of file adi_v5_swd.c.

References dap_is_multidrop(), DORMANT_TO_SWD, DP_ABORT, DP_DLPIDR, DP_DLPIDR_PROTVSN, DP_DPIDR, DP_DPIDR_VERSION_MASK, DP_DPIDR_VERSION_SHIFT, DP_TARGETSEL, DP_TARGETSEL_INSTANCEID_MASK, ERROR_FAIL, ERROR_OK, JTAG_TO_DORMANT, LINE_RESET, LOG_DEBUG_IO, LOG_INFO, adiv5_dap::multidrop_targetsel, ORUNERRCLR, adiv5_dap::select, adiv5_dap::select1_valid, adiv5_dap::select_dpbanksel_valid, adiv5_dap::select_valid, swd_clear_sticky_errors(), swd_multidrop_in_swd_state, swd_multidrop_selected_dap, swd_queue_dp_read_inner(), swd_queue_dp_write_inner(), swd_run_inner(), and swd_send_sequence().

Referenced by swd_connect_multidrop(), and swd_multidrop_select().

swd_pre_connect()

static int swd_pre_connect ( struct adiv5_dap *  dap )

static

Definition at line 404 of file adi_v5_swd.c.

References ERROR_OK, and swd_multidrop_in_swd_state.

swd_queue_ap_abort()

static int swd_queue_ap_abort ( struct adiv5_dap *  dap, uint8_t *  ack  )

static

Definition at line 470 of file adi_v5_swd.c.

References adiv5_dap_swd_driver(), check_sync(), DAPABORT, DP_ABORT, ERROR_OK, ORUNERRCLR, STKCMPCLR, STKERRCLR, swd_cmd(), swd_multidrop_select(), WDERRCLR, and swd_driver::write_reg.

swd_queue_ap_bankselect()

static int swd_queue_ap_bankselect ( struct adiv5_ap *  ap, unsigned int  reg  )

static

Select the AP register bank.

Definition at line 520 of file adi_v5_swd.c.

References ADIV5_DP_SELECT_APBANK, adiv5_dap::ap, adiv5_ap::ap_num, adiv5_dap::asize, adiv5_ap::dap, DP_SELECT, DP_SELECT1, DP_SELECT_DPBANK, ERROR_OK, is_adiv6(), LOG_DEBUG_IO, adiv5_dap::select, adiv5_dap::select1_valid, SELECT_AP_MASK, adiv5_dap::select_valid, and swd_queue_dp_write().

Referenced by swd_queue_ap_read(), and swd_queue_ap_write().

swd_queue_ap_read()

static int swd_queue_ap_read ( struct adiv5_ap *  ap, unsigned int  reg, uint32_t *  data  )

static

Definition at line 570 of file adi_v5_swd.c.

References adiv5_dap_swd_driver(), adiv5_dap::ap, check_sync(), adiv5_ap::dap, ERROR_OK, adiv5_dap::last_read, adiv5_ap::memaccess_tck, swd_driver::read_reg, swd_check_reconnect(), swd_cmd(), swd_multidrop_select(), and swd_queue_ap_bankselect().

swd_queue_ap_write()

static int swd_queue_ap_write ( struct adiv5_ap *  ap, unsigned int  reg, uint32_t  data  )

static

Definition at line 595 of file adi_v5_swd.c.

References adiv5_dap_swd_driver(), adiv5_dap::ap, check_sync(), adiv5_ap::dap, ERROR_OK, adiv5_ap::memaccess_tck, swd_check_reconnect(), swd_cmd(), swd_finish_read(), swd_multidrop_select(), swd_queue_ap_bankselect(), and swd_driver::write_reg.

swd_queue_dp_bankselect()

static int swd_queue_dp_bankselect ( struct adiv5_dap *  dap, unsigned int  reg  )

static

Select the DP register bank.

Definition at line 97 of file adi_v5_swd.c.

References DP_SELECT, DP_SELECT_DPBANK, ERROR_OK, is_adiv6(), LOG_DEBUG_IO, adiv5_dap::select, SELECT_AP_MASK, adiv5_dap::select_dpbanksel_valid, adiv5_dap::select_valid, and swd_queue_dp_write_inner().

Referenced by swd_queue_dp_read_inner(), and swd_queue_dp_write_inner().

swd_queue_dp_read()

static int swd_queue_dp_read ( struct adiv5_dap *  dap, unsigned int  reg, uint32_t *  data  )

static

Definition at line 488 of file adi_v5_swd.c.

References ERROR_OK, swd_check_reconnect(), swd_multidrop_select(), and swd_queue_dp_read_inner().

swd_queue_dp_read_inner()

static int swd_queue_dp_read_inner ( struct adiv5_dap *  dap, unsigned int  reg, uint32_t *  data  )

static

Definition at line 122 of file adi_v5_swd.c.

References adiv5_dap_swd_driver(), check_sync(), ERROR_OK, swd_driver::read_reg, swd_cmd(), and swd_queue_dp_bankselect().

Referenced by swd_connect_single(), swd_multidrop_select_inner(), and swd_queue_dp_read().

swd_queue_dp_write()

static int swd_queue_dp_write ( struct adiv5_dap *  dap, unsigned int  reg, uint32_t  data  )

static

Definition at line 502 of file adi_v5_swd.c.

References adiv5_dap_swd_driver(), ERROR_OK, swd_check_reconnect(), swd_multidrop_select(), and swd_queue_dp_write_inner().

Referenced by swd_queue_ap_bankselect().

swd_queue_dp_write_inner()

static int swd_queue_dp_write_inner ( struct adiv5_dap *  dap, unsigned int  reg, uint32_t  data  )

static

Definition at line 137 of file adi_v5_swd.c.

References adiv5_dap_swd_driver(), check_sync(), DP_ABORT, DP_SELECT, DP_SELECT1, ERROR_OK, adiv5_dap::select, adiv5_dap::select1_valid, adiv5_dap::select_dpbanksel_valid, adiv5_dap::select_valid, swd_cmd(), swd_finish_read(), swd_queue_dp_bankselect(), and swd_driver::write_reg.

Referenced by swd_connect(), swd_multidrop_select_inner(), swd_queue_dp_bankselect(), and swd_queue_dp_write().

swd_quit()

static void swd_quit ( struct adiv5_dap *  dap )

static

Put the SWJ-DP back to JTAG mode.

Definition at line 640 of file adi_v5_swd.c.

swd_run()

static int swd_run ( struct adiv5_dap *  dap )

static

Executes all queued DAP operations.

Definition at line 622 of file adi_v5_swd.c.

References adiv5_dap::do_reconnect, ERROR_OK, swd_finish_read(), swd_multidrop_select(), and swd_run_inner().

swd_run_inner()

static int swd_run_inner ( struct adiv5_dap *  dap )

static

Definition at line 84 of file adi_v5_swd.c.

References adiv5_dap_swd_driver(), and swd_driver::run.

Referenced by check_sync(), swd_connect(), swd_connect_single(), swd_multidrop_select_inner(), and swd_run().

swd_select()

static int swd_select ( struct command_context *  ctx )

static

Definition at line 726 of file adi_v5_swd.c.

References adapter_driver, ERROR_FAIL, ERROR_OK, swd_driver::init, LOG_DEBUG, NULL, swd_driver::read_reg, register_commands(), swd_handlers, adapter_driver::swd_ops, and swd_driver::write_reg.

swd_send_sequence()

static int swd_send_sequence ( struct adiv5_dap *  dap, enum swd_special_seq  seq  )

static

Definition at line 58 of file adi_v5_swd.c.

References adiv5_dap_swd_driver(), and swd_driver::switch_seq.

Referenced by swd_connect_single(), and swd_multidrop_select_inner().

transport_is_swd()

bool transport_is_swd

(

void

)

Returns true if the current debug session is using SWD as its transport.

Definition at line 776 of file adi_v5_swd.c.

References get_current_transport(), and swd_transport.

Referenced by adapter_assert_reset(), adapter_deassert_reset(), adapter_resets(), am335xgpio_init(), bcm2835gpio_init(), bcm2835gpio_quit(), cleanup_all_fds(), COMMAND_HANDLER(), dap_check_config(), dap_init_all(), imx_gpio_init(), imx_gpio_quit(), linuxgpiod_init(), and sysfsgpio_init().

Variable Documentation

do_sync

bool do_sync

static

Definition at line 47 of file adi_v5_swd.c.

Referenced by check_sync().

swd_commands

const struct command_registration swd_commands[]

static

Initial value:

= {
    {
        
        .name = "newdap",
        .handler = handle_jtag_newtap,
        .mode = COMMAND_CONFIG,
        .help = "declare a new SWD DAP",
        .usage = "basename dap_type ['-irlen' count] "
            "['-enable'|'-disable'] "
            "['-expected_id' number] "
            "['-ignore-version'] "
            "['-ignore-bypass'] "
            "['-ircapture' number] "
            "['-ir-bypass' number] "
            "['-mask' number]",
    },
    COMMAND_REGISTRATION_DONE
}

Definition at line 640 of file adi_v5_swd.c.

swd_dap_ops

const struct dap_ops swd_dap_ops

Initial value:

= {
    .pre_connect_init = swd_pre_connect,
    .connect = swd_connect,
    .send_sequence = swd_send_sequence,
    .queue_dp_read = swd_queue_dp_read,
    .queue_dp_write = swd_queue_dp_write,
    .queue_ap_read = swd_queue_ap_read,
    .queue_ap_write = swd_queue_ap_write,
    .queue_ap_abort = swd_queue_ap_abort,
    .run = swd_run,
    .quit = swd_quit,
}

Definition at line 640 of file adi_v5_swd.c.

Referenced by dap_init_all().

swd_handlers

const struct command_registration swd_handlers[]

static

Initial value:

= {
    {
        .name = "swd",
        .mode = COMMAND_ANY,
        .help = "SWD command group",
        .chain = swd_commands,
        .usage = "",
    },
    COMMAND_REGISTRATION_DONE
}

Definition at line 640 of file adi_v5_swd.c.

Referenced by swd_select().

swd_multidrop_in_swd_state

bool swd_multidrop_in_swd_state

static

Definition at line 51 of file adi_v5_swd.c.

Referenced by swd_connect_multidrop(), swd_multidrop_select_inner(), and swd_pre_connect().

swd_multidrop_selected_dap

struct adiv5_dap* swd_multidrop_selected_dap

static

Definition at line 49 of file adi_v5_swd.c.

Referenced by swd_connect_multidrop(), swd_multidrop_select(), and swd_multidrop_select_inner().

swd_transport

struct transport swd_transport

static

Initial value:

= {
    .name = "swd",
    .select = swd_select,
    .init = swd_init,
}

Definition at line 754 of file adi_v5_swd.c.

Referenced by transport_is_swd().