1 // SPDX-License-Identifier: GPL-2.0-or-later
4 * Copyright (C) 2019, STMicroelectronics - All Rights Reserved
5 * Author(s): Antonio Borneo <borneo.antonio@gmail.com> for STMicroelectronics
10 * Utilities to support in-circuit debuggers that provide APIs to access
11 * directly ARM DAP, hiding the access to the underlining transport used
12 * for the physical connection (either JTAG or SWD).
13 * E.g. STMicroelectronics ST-Link/V2 (from version V2J24) and STLINK-V3.
15 * Single-DAP support only.
17 * For details, see "ARM IHI 0031A"
18 * ARM Debug Interface v5 Architecture Specification
20 * FIXME: in JTAG mode, trst is not managed
27 #include <jtag/interface.h>
29 #include <transport/transport.h>
31 COMMAND_HANDLER(dapdirect_jtag_empty_command)
33 LOG_DEBUG("dapdirect_jtag_empty_command(\"%s\")", CMD_NAME);
38 COMMAND_HANDLER(dapdirect_jtag_reset_command)
40 enum reset_types jtag_reset_config = jtag_get_reset_config();
43 * in case the adapter has not already handled asserting srst
44 * we will attempt it again
46 if (jtag_reset_config & RESET_CNCT_UNDER_SRST) {
47 if (jtag_reset_config & RESET_SRST_NO_GATING) {
48 adapter_assert_reset();
51 LOG_WARNING("\'srst_nogate\' reset_config option is required");
53 adapter_deassert_reset();
57 static const struct command_registration dapdirect_jtag_subcommand_handlers[] = {
60 .mode = COMMAND_CONFIG,
61 .jim_handler = jim_jtag_newtap,
62 .help = "declare a new TAP"
67 .handler = dapdirect_jtag_empty_command,
73 .handler = dapdirect_jtag_empty_command,
77 .name = "arp_init-reset",
79 .handler = dapdirect_jtag_reset_command,
83 .name = "tapisenabled",
85 .jim_handler = jim_jtag_tap_enabler,
90 .jim_handler = jim_jtag_tap_enabler,
95 .handler = dapdirect_jtag_empty_command,
101 .handler = dapdirect_jtag_empty_command,
106 .mode = COMMAND_EXEC,
107 .jim_handler = jim_jtag_configure,
112 .handler = dapdirect_jtag_empty_command,
115 COMMAND_REGISTRATION_DONE
118 static const struct command_registration dapdirect_jtag_handlers[] = {
122 .chain = dapdirect_jtag_subcommand_handlers,
126 .name = "jtag_ntrst_delay",
128 .handler = dapdirect_jtag_empty_command,
131 COMMAND_REGISTRATION_DONE
134 static const struct command_registration dapdirect_swd_subcommand_handlers[] = {
137 .mode = COMMAND_CONFIG,
138 .jim_handler = jim_jtag_newtap,
139 .help = "declare a new SWD DAP",
141 COMMAND_REGISTRATION_DONE
144 static const struct command_registration dapdirect_swd_handlers[] = {
148 .help = "SWD command group",
150 .chain = dapdirect_swd_subcommand_handlers,
152 COMMAND_REGISTRATION_DONE
155 static int dapdirect_jtag_select(struct command_context *ctx)
157 LOG_DEBUG("dapdirect_jtag_select()");
159 return register_commands(ctx, NULL, dapdirect_jtag_handlers);
162 static int dapdirect_swd_select(struct command_context *ctx)
164 LOG_DEBUG("dapdirect_swd_select()");
166 return register_commands(ctx, NULL, dapdirect_swd_handlers);
169 static int dapdirect_init(struct command_context *ctx)
171 enum reset_types jtag_reset_config = jtag_get_reset_config();
173 LOG_DEBUG("dapdirect_init()");
175 if (jtag_reset_config & RESET_CNCT_UNDER_SRST) {
176 if (jtag_reset_config & RESET_SRST_NO_GATING)
177 adapter_assert_reset();
179 LOG_WARNING("\'srst_nogate\' reset_config option is required");
181 adapter_deassert_reset();
186 static struct transport dapdirect_jtag_transport = {
187 .name = "dapdirect_jtag",
188 .select = dapdirect_jtag_select,
189 .init = dapdirect_init,
192 static struct transport dapdirect_swd_transport = {
193 .name = "dapdirect_swd",
194 .select = dapdirect_swd_select,
195 .init = dapdirect_init,
198 static void dapdirect_constructor(void) __attribute__((constructor));
199 static void dapdirect_constructor(void)
201 transport_register(&dapdirect_jtag_transport);
202 transport_register(&dapdirect_swd_transport);
206 * Returns true if the current debug session
207 * is using JTAG as its transport.
209 bool transport_is_dapdirect_jtag(void)
211 return get_current_transport() == &dapdirect_jtag_transport;
215 * Returns true if the current debug session
216 * is using SWD as its transport.
218 bool transport_is_dapdirect_swd(void)
220 return get_current_transport() == &dapdirect_swd_transport;