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
;
Linking to existing account procedure
If you already have an account and want to add another login method
you
MUST first sign in with your existing account and
then change URL to read
https://review.openocd.org/login/?link
to get to this page again but this time it'll work for linking. Thank you.
SSH host keys fingerprints
1024 SHA256:YKx8b7u5ZWdcbp7/4AeXNaqElP49m6QrwfXaqQGJAOk gerrit-code-review@openocd.zylin.com (DSA)
384 SHA256:jHIbSQa4REvwCFG4cq5LBlBLxmxSqelQPem/EXIrxjk gerrit-code-review@openocd.org (ECDSA)
521 SHA256:UAOPYkU9Fjtcao0Ul/Rrlnj/OsQvt+pgdYSZ4jOYdgs gerrit-code-review@openocd.org (ECDSA)
256 SHA256:A13M5QlnozFOvTllybRZH6vm7iSt0XLxbA48yfc2yfY gerrit-code-review@openocd.org (ECDSA)
256 SHA256:spYMBqEYoAOtK7yZBrcwE8ZpYt6b68Cfh9yEVetvbXg gerrit-code-review@openocd.org (ED25519)
+--[ED25519 256]--+
|=.. |
|+o.. . |
|*.o . . |
|+B . . . |
|Bo. = o S |
|Oo.+ + = |
|oB=.* = . o |
| =+=.+ + E |
|. .=o . o |
+----[SHA256]-----+
2048 SHA256:0Onrb7/PHjpo6iVZ7xQX2riKN83FJ3KGU0TvI0TaFG4 gerrit-code-review@openocd.zylin.com (RSA)