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 .handler
= handle_jtag_tap_enabler
,
93 .help
= "Returns a Tcl boolean (0/1) indicating whether "
94 "the TAP is enabled (1) or not (0).",
100 .handler
= handle_jtag_tap_enabler
,
101 .help
= "Try to enable the specified TAP using the "
102 "'tap-enable' TAP event.",
106 .name
= "tapdisable",
107 .mode
= COMMAND_EXEC
,
108 .handler
= dapdirect_jtag_empty_command
,
114 .handler
= dapdirect_jtag_empty_command
,
119 .mode
= COMMAND_EXEC
,
120 .jim_handler
= jim_jtag_configure
,
125 .handler
= dapdirect_jtag_empty_command
,
128 COMMAND_REGISTRATION_DONE
131 static const struct command_registration dapdirect_jtag_handlers
[] = {
135 .chain
= dapdirect_jtag_subcommand_handlers
,
139 .name
= "jtag_ntrst_delay",
141 .handler
= dapdirect_jtag_empty_command
,
144 COMMAND_REGISTRATION_DONE
147 static const struct command_registration dapdirect_swd_subcommand_handlers
[] = {
150 .mode
= COMMAND_CONFIG
,
151 .handler
= handle_jtag_newtap
,
152 .help
= "declare a new SWD DAP",
153 .usage
= "basename dap_type ['-irlen' count] "
154 "['-enable'|'-disable'] "
155 "['-expected_id' number] "
156 "['-ignore-version'] "
157 "['-ignore-bypass'] "
158 "['-ircapture' number] "
161 COMMAND_REGISTRATION_DONE
164 static const struct command_registration dapdirect_swd_handlers
[] = {
168 .help
= "SWD command group",
170 .chain
= dapdirect_swd_subcommand_handlers
,
172 COMMAND_REGISTRATION_DONE
175 static int dapdirect_jtag_select(struct command_context
*ctx
)
177 LOG_DEBUG("dapdirect_jtag_select()");
179 return register_commands(ctx
, NULL
, dapdirect_jtag_handlers
);
182 static int dapdirect_swd_select(struct command_context
*ctx
)
184 LOG_DEBUG("dapdirect_swd_select()");
186 return register_commands(ctx
, NULL
, dapdirect_swd_handlers
);
189 static int dapdirect_init(struct command_context
*ctx
)
191 enum reset_types jtag_reset_config
= jtag_get_reset_config();
193 LOG_DEBUG("dapdirect_init()");
195 if (jtag_reset_config
& RESET_CNCT_UNDER_SRST
) {
196 if (jtag_reset_config
& RESET_SRST_NO_GATING
)
197 adapter_assert_reset();
199 LOG_WARNING("\'srst_nogate\' reset_config option is required");
201 adapter_deassert_reset();
206 static struct transport dapdirect_jtag_transport
= {
207 .name
= "dapdirect_jtag",
208 .select
= dapdirect_jtag_select
,
209 .init
= dapdirect_init
,
212 static struct transport dapdirect_swd_transport
= {
213 .name
= "dapdirect_swd",
214 .select
= dapdirect_swd_select
,
215 .init
= dapdirect_init
,
218 static void dapdirect_constructor(void) __attribute__((constructor
));
219 static void dapdirect_constructor(void)
221 transport_register(&dapdirect_jtag_transport
);
222 transport_register(&dapdirect_swd_transport
);
226 * Returns true if the current debug session
227 * is using JTAG as its transport.
229 bool transport_is_dapdirect_jtag(void)
231 return get_current_transport() == &dapdirect_jtag_transport
;
235 * Returns true if the current debug session
236 * is using SWD as its transport.
238 bool transport_is_dapdirect_swd(void)
240 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)