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 .handler
= handle_jtag_newtap
,
62 .help
= "declare a new TAP",
63 .usage
= "basename tap_type '-irlen' count "
64 "['-enable'|'-disable'] "
65 "['-expected_id' number] "
66 "['-ignore-version'] "
68 "['-ircapture' number] "
74 .handler
= dapdirect_jtag_empty_command
,
80 .handler
= dapdirect_jtag_empty_command
,
84 .name
= "arp_init-reset",
86 .handler
= dapdirect_jtag_reset_command
,
90 .name
= "tapisenabled",
92 .jim_handler
= jim_jtag_tap_enabler
,
97 .jim_handler
= jim_jtag_tap_enabler
,
100 .name
= "tapdisable",
101 .mode
= COMMAND_EXEC
,
102 .handler
= dapdirect_jtag_empty_command
,
108 .handler
= dapdirect_jtag_empty_command
,
113 .mode
= COMMAND_EXEC
,
114 .jim_handler
= jim_jtag_configure
,
119 .handler
= dapdirect_jtag_empty_command
,
122 COMMAND_REGISTRATION_DONE
125 static const struct command_registration dapdirect_jtag_handlers
[] = {
129 .chain
= dapdirect_jtag_subcommand_handlers
,
133 .name
= "jtag_ntrst_delay",
135 .handler
= dapdirect_jtag_empty_command
,
138 COMMAND_REGISTRATION_DONE
141 static const struct command_registration dapdirect_swd_subcommand_handlers
[] = {
144 .mode
= COMMAND_CONFIG
,
145 .handler
= handle_jtag_newtap
,
146 .help
= "declare a new SWD DAP",
147 .usage
= "basename dap_type ['-irlen' count] "
148 "['-enable'|'-disable'] "
149 "['-expected_id' number] "
150 "['-ignore-version'] "
151 "['-ignore-bypass'] "
152 "['-ircapture' number] "
155 COMMAND_REGISTRATION_DONE
158 static const struct command_registration dapdirect_swd_handlers
[] = {
162 .help
= "SWD command group",
164 .chain
= dapdirect_swd_subcommand_handlers
,
166 COMMAND_REGISTRATION_DONE
169 static int dapdirect_jtag_select(struct command_context
*ctx
)
171 LOG_DEBUG("dapdirect_jtag_select()");
173 return register_commands(ctx
, NULL
, dapdirect_jtag_handlers
);
176 static int dapdirect_swd_select(struct command_context
*ctx
)
178 LOG_DEBUG("dapdirect_swd_select()");
180 return register_commands(ctx
, NULL
, dapdirect_swd_handlers
);
183 static int dapdirect_init(struct command_context
*ctx
)
185 enum reset_types jtag_reset_config
= jtag_get_reset_config();
187 LOG_DEBUG("dapdirect_init()");
189 if (jtag_reset_config
& RESET_CNCT_UNDER_SRST
) {
190 if (jtag_reset_config
& RESET_SRST_NO_GATING
)
191 adapter_assert_reset();
193 LOG_WARNING("\'srst_nogate\' reset_config option is required");
195 adapter_deassert_reset();
200 static struct transport dapdirect_jtag_transport
= {
201 .name
= "dapdirect_jtag",
202 .select
= dapdirect_jtag_select
,
203 .init
= dapdirect_init
,
206 static struct transport dapdirect_swd_transport
= {
207 .name
= "dapdirect_swd",
208 .select
= dapdirect_swd_select
,
209 .init
= dapdirect_init
,
212 static void dapdirect_constructor(void) __attribute__((constructor
));
213 static void dapdirect_constructor(void)
215 transport_register(&dapdirect_jtag_transport
);
216 transport_register(&dapdirect_swd_transport
);
220 * Returns true if the current debug session
221 * is using JTAG as its transport.
223 bool transport_is_dapdirect_jtag(void)
225 return get_current_transport() == &dapdirect_jtag_transport
;
229 * Returns true if the current debug session
230 * is using SWD as its transport.
232 bool transport_is_dapdirect_swd(void)
234 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)