1 /***************************************************************************
2 * Copyright (C) 2005 by Dominic Rath *
3 * Dominic.Rath@gmx.de *
5 * Copyright (C) 2007-2010 Øyvind Harboe *
6 * oyvind.harboe@zylin.com *
8 * Copyright (C) 2009 SoftPLC Corporation *
12 * Copyright (C) 2009 Zachary T Welch *
13 * zw@superlucidity.net *
15 * This program is free software; you can redistribute it and/or modify *
16 * it under the terms of the GNU General Public License as published by *
17 * the Free Software Foundation; either version 2 of the License, or *
18 * (at your option) any later version. *
20 * This program is distributed in the hope that it will be useful, *
21 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
23 * GNU General Public License for more details. *
25 * You should have received a copy of the GNU General Public License *
26 * along with this program; if not, write to the *
27 * Free Software Foundation, Inc., *
28 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
29 ***************************************************************************/
36 #include "minidriver.h"
37 #include "interface.h"
38 #include "interfaces.h"
39 #include <transport/transport.h>
47 * Holds support for configuring debug adapters from TCl scripts.
50 extern struct jtag_interface
*jtag_interface
;
51 const char *jtag_only
[] = { "jtag", NULL
};
53 static int jim_adapter_name(Jim_Interp
*interp
, int argc
, Jim_Obj
* const *argv
)
56 Jim_GetOpt_Setup(&goi
, interp
, argc
-1, argv
+ 1);
58 /* return the name of the interface */
59 /* TCL code might need to know the exact type... */
60 /* FUTURE: we allow this as a means to "set" the interface. */
62 Jim_WrongNumArgs(goi
.interp
, 1, goi
.argv
-1, "(no params)");
65 const char *name
= jtag_interface
? jtag_interface
->name
: NULL
;
66 Jim_SetResultString(goi
.interp
, name
? : "undefined", -1);
70 static int default_khz(int khz
, int *jtag_speed
)
72 LOG_ERROR("Translation from khz to jtag_speed not implemented");
76 static int default_speed_div(int speed
, int *khz
)
78 LOG_ERROR("Translation from jtag_speed to khz not implemented");
82 static int default_power_dropout(int *dropout
)
84 *dropout
= 0; /* by default we can't detect power dropout */
88 static int default_srst_asserted(int *srst_asserted
)
90 *srst_asserted
= 0; /* by default we can't detect srst asserted */
94 COMMAND_HANDLER(interface_transport_command
)
99 retval
= CALL_COMMAND_HANDLER(transport_list_parse
, &transports
);
100 if (retval
!= ERROR_OK
)
103 retval
= allow_transports(CMD_CTX
, (const char **)transports
);
105 if (retval
!= ERROR_OK
) {
106 for (unsigned i
= 0; transports
[i
]; i
++)
113 COMMAND_HANDLER(handle_interface_list_command
)
115 if (strcmp(CMD_NAME
, "interface_list") == 0 && CMD_ARGC
> 0)
116 return ERROR_COMMAND_SYNTAX_ERROR
;
118 command_print(CMD_CTX
, "The following debug interfaces are available:");
119 for (unsigned i
= 0; NULL
!= jtag_interfaces
[i
]; i
++) {
120 const char *name
= jtag_interfaces
[i
]->name
;
121 command_print(CMD_CTX
, "%u: %s", i
+ 1, name
);
127 COMMAND_HANDLER(handle_interface_command
)
131 /* check whether the interface is already configured */
132 if (jtag_interface
) {
133 LOG_WARNING("Interface already configured, ignoring");
137 /* interface name is a mandatory argument */
138 if (CMD_ARGC
!= 1 || CMD_ARGV
[0][0] == '\0')
139 return ERROR_COMMAND_SYNTAX_ERROR
;
141 for (unsigned i
= 0; NULL
!= jtag_interfaces
[i
]; i
++) {
142 if (strcmp(CMD_ARGV
[0], jtag_interfaces
[i
]->name
) != 0)
145 if (NULL
!= jtag_interfaces
[i
]->commands
) {
146 retval
= register_commands(CMD_CTX
, NULL
,
147 jtag_interfaces
[i
]->commands
);
148 if (ERROR_OK
!= retval
)
152 jtag_interface
= jtag_interfaces
[i
];
154 /* LEGACY SUPPORT ... adapter drivers must declare what
155 * transports they allow. Until they all do so, assume
156 * the legacy drivers are JTAG-only
158 if (!jtag_interface
->transports
)
159 LOG_WARNING("Adapter driver '%s' did not declare "
160 "which transports it allows; assuming "
161 "legacy JTAG-only", jtag_interface
->name
);
162 retval
= allow_transports(CMD_CTX
, jtag_interface
->transports
163 ? jtag_interface
->transports
: jtag_only
);
164 if (ERROR_OK
!= retval
)
167 if (jtag_interface
->khz
== NULL
)
168 jtag_interface
->khz
= default_khz
;
169 if (jtag_interface
->speed_div
== NULL
)
170 jtag_interface
->speed_div
= default_speed_div
;
171 if (jtag_interface
->power_dropout
== NULL
)
172 jtag_interface
->power_dropout
= default_power_dropout
;
173 if (jtag_interface
->srst_asserted
== NULL
)
174 jtag_interface
->srst_asserted
= default_srst_asserted
;
179 /* no valid interface was found (i.e. the configuration option,
180 * didn't match one of the compiled-in interfaces
182 LOG_ERROR("The specified debug interface was not found (%s)",
184 CALL_COMMAND_HANDLER(handle_interface_list_command
);
185 return ERROR_JTAG_INVALID_INTERFACE
;
188 COMMAND_HANDLER(handle_reset_config_command
)
193 /* Original versions cared about the order of these tokens:
194 * reset_config signals [combination [trst_type [srst_type]]]
195 * They also clobbered the previous configuration even on error.
197 * Here we don't care about the order, and only change values
198 * which have been explicitly specified.
200 for (; CMD_ARGC
; CMD_ARGC
--, CMD_ARGV
++) {
205 m
= RESET_SRST_NO_GATING
;
206 if (strcmp(*CMD_ARGV
, "srst_gates_jtag") == 0)
207 /* default: don't use JTAG while SRST asserted */;
208 else if (strcmp(*CMD_ARGV
, "srst_nogate") == 0)
209 tmp
= RESET_SRST_NO_GATING
;
213 LOG_ERROR("extra reset_config %s spec (%s)",
214 "gating", *CMD_ARGV
);
215 return ERROR_COMMAND_SYNTAX_ERROR
;
221 m
= RESET_HAS_TRST
| RESET_HAS_SRST
;
222 if (strcmp(*CMD_ARGV
, "none") == 0)
224 else if (strcmp(*CMD_ARGV
, "trst_only") == 0)
225 tmp
= RESET_HAS_TRST
;
226 else if (strcmp(*CMD_ARGV
, "srst_only") == 0)
227 tmp
= RESET_HAS_SRST
;
228 else if (strcmp(*CMD_ARGV
, "trst_and_srst") == 0)
229 tmp
= RESET_HAS_TRST
| RESET_HAS_SRST
;
233 LOG_ERROR("extra reset_config %s spec (%s)",
234 "signal", *CMD_ARGV
);
235 return ERROR_COMMAND_SYNTAX_ERROR
;
240 /* combination (options for broken wiring) */
241 m
= RESET_SRST_PULLS_TRST
| RESET_TRST_PULLS_SRST
;
242 if (strcmp(*CMD_ARGV
, "separate") == 0)
243 /* separate reset lines - default */;
244 else if (strcmp(*CMD_ARGV
, "srst_pulls_trst") == 0)
245 tmp
|= RESET_SRST_PULLS_TRST
;
246 else if (strcmp(*CMD_ARGV
, "trst_pulls_srst") == 0)
247 tmp
|= RESET_TRST_PULLS_SRST
;
248 else if (strcmp(*CMD_ARGV
, "combined") == 0)
249 tmp
|= RESET_SRST_PULLS_TRST
| RESET_TRST_PULLS_SRST
;
253 LOG_ERROR("extra reset_config %s spec (%s)",
254 "combination", *CMD_ARGV
);
255 return ERROR_COMMAND_SYNTAX_ERROR
;
260 /* trst_type (NOP without HAS_TRST) */
261 m
= RESET_TRST_OPEN_DRAIN
;
262 if (strcmp(*CMD_ARGV
, "trst_open_drain") == 0)
263 tmp
|= RESET_TRST_OPEN_DRAIN
;
264 else if (strcmp(*CMD_ARGV
, "trst_push_pull") == 0)
265 /* push/pull from adapter - default */;
269 LOG_ERROR("extra reset_config %s spec (%s)",
270 "trst_type", *CMD_ARGV
);
271 return ERROR_COMMAND_SYNTAX_ERROR
;
276 /* srst_type (NOP without HAS_SRST) */
277 m
|= RESET_SRST_PUSH_PULL
;
278 if (strcmp(*CMD_ARGV
, "srst_push_pull") == 0)
279 tmp
|= RESET_SRST_PUSH_PULL
;
280 else if (strcmp(*CMD_ARGV
, "srst_open_drain") == 0)
281 /* open drain from adapter - default */;
285 LOG_ERROR("extra reset_config %s spec (%s)",
286 "srst_type", *CMD_ARGV
);
287 return ERROR_COMMAND_SYNTAX_ERROR
;
292 /* caller provided nonsense; fail */
293 LOG_ERROR("unknown reset_config flag (%s)", *CMD_ARGV
);
294 return ERROR_COMMAND_SYNTAX_ERROR
;
297 /* Remember the bits which were specified (mask)
298 * and their new values (new_cfg).
304 /* clear previous values of those bits, save new values */
306 int old_cfg
= jtag_get_reset_config();
310 jtag_set_reset_config(new_cfg
);
312 new_cfg
= jtag_get_reset_config();
315 * Display the (now-)current reset mode
319 /* minimal JTAG has neither SRST nor TRST (so that's the default) */
320 switch (new_cfg
& (RESET_HAS_TRST
| RESET_HAS_SRST
)) {
322 modes
[0] = "srst_only";
325 modes
[0] = "trst_only";
327 case RESET_TRST_AND_SRST
:
328 modes
[0] = "trst_and_srst";
335 /* normally SRST and TRST are decoupled; but bugs happen ... */
336 switch (new_cfg
& (RESET_SRST_PULLS_TRST
| RESET_TRST_PULLS_SRST
)) {
337 case RESET_SRST_PULLS_TRST
:
338 modes
[1] = "srst_pulls_trst";
340 case RESET_TRST_PULLS_SRST
:
341 modes
[1] = "trst_pulls_srst";
343 case RESET_SRST_PULLS_TRST
| RESET_TRST_PULLS_SRST
:
344 modes
[1] = "combined";
347 modes
[1] = "separate";
351 /* TRST-less connectors include Altera, Xilinx, and minimal JTAG */
352 if (new_cfg
& RESET_HAS_TRST
) {
353 if (new_cfg
& RESET_TRST_OPEN_DRAIN
)
354 modes
[3] = " trst_open_drain";
356 modes
[3] = " trst_push_pull";
360 /* SRST-less connectors include TI-14, Xilinx, and minimal JTAG */
361 if (new_cfg
& RESET_HAS_SRST
) {
362 if (new_cfg
& RESET_SRST_NO_GATING
)
363 modes
[2] = " srst_nogate";
365 modes
[2] = " srst_gates_jtag";
367 if (new_cfg
& RESET_SRST_PUSH_PULL
)
368 modes
[4] = " srst_push_pull";
370 modes
[4] = " srst_open_drain";
376 command_print(CMD_CTX
, "%s %s%s%s%s",
378 modes
[2], modes
[3], modes
[4]);
383 COMMAND_HANDLER(handle_adapter_nsrst_delay_command
)
386 return ERROR_COMMAND_SYNTAX_ERROR
;
389 COMMAND_PARSE_NUMBER(uint
, CMD_ARGV
[0], delay
);
391 jtag_set_nsrst_delay(delay
);
393 command_print(CMD_CTX
, "adapter_nsrst_delay: %u", jtag_get_nsrst_delay());
397 COMMAND_HANDLER(handle_adapter_nsrst_assert_width_command
)
400 return ERROR_COMMAND_SYNTAX_ERROR
;
403 COMMAND_PARSE_NUMBER(uint
, CMD_ARGV
[0], width
);
405 jtag_set_nsrst_assert_width(width
);
407 command_print(CMD_CTX
, "adapter_nsrst_assert_width: %u", jtag_get_nsrst_assert_width());
411 COMMAND_HANDLER(handle_adapter_khz_command
)
414 return ERROR_COMMAND_SYNTAX_ERROR
;
416 int retval
= ERROR_OK
;
419 COMMAND_PARSE_NUMBER(uint
, CMD_ARGV
[0], khz
);
421 retval
= jtag_config_khz(khz
);
422 if (ERROR_OK
!= retval
)
426 int cur_speed
= jtag_get_speed_khz();
427 retval
= jtag_get_speed_readable(&cur_speed
);
428 if (ERROR_OK
!= retval
)
432 command_print(CMD_CTX
, "adapter speed: %d kHz", cur_speed
);
434 command_print(CMD_CTX
, "adapter speed: RCLK - adaptive");
439 static const struct command_registration interface_command_handlers
[] = {
441 .name
= "adapter_khz",
442 .handler
= handle_adapter_khz_command
,
444 .help
= "With an argument, change to the specified maximum "
445 "jtag speed. For JTAG, 0 KHz signifies adaptive "
447 "With or without argument, display current setting.",
451 .name
= "adapter_name",
453 .jim_handler
= jim_adapter_name
,
454 .help
= "Returns the name of the currently "
455 "selected adapter (driver)",
458 .name
= "adapter_nsrst_delay",
459 .handler
= handle_adapter_nsrst_delay_command
,
461 .help
= "delay after deasserting SRST in ms",
462 .usage
= "[milliseconds]",
465 .name
= "adapter_nsrst_assert_width",
466 .handler
= handle_adapter_nsrst_assert_width_command
,
468 .help
= "delay after asserting SRST in ms",
469 .usage
= "[milliseconds]",
473 .handler
= handle_interface_command
,
474 .mode
= COMMAND_CONFIG
,
475 .help
= "Select a debug adapter interface (driver)",
476 .usage
= "driver_name",
479 .name
= "interface_transports",
480 .handler
= interface_transport_command
,
481 .mode
= COMMAND_CONFIG
,
482 .help
= "Declare transports the interface supports.",
483 .usage
= "transport ... ",
486 .name
= "interface_list",
487 .handler
= handle_interface_list_command
,
489 .help
= "List all built-in debug adapter interfaces (drivers)",
492 .name
= "reset_config",
493 .handler
= handle_reset_config_command
,
495 .help
= "configure adapter reset behavior",
496 .usage
= "[none|trst_only|srst_only|trst_and_srst] "
497 "[srst_pulls_trst|trst_pulls_srst|combined|separate] "
498 "[srst_gates_jtag|srst_nogate] "
499 "[trst_push_pull|trst_open_drain] "
500 "[srst_push_pull|srst_open_drain]",
502 COMMAND_REGISTRATION_DONE
506 * Register the commands which deal with arbitrary debug adapter drivers.
508 * @todo Remove internal assumptions that all debug adapters use JTAG for
509 * transport. Various types and data structures are not named generically.
511 int interface_register_commands(struct command_context
*ctx
)
513 return register_commands(ctx
, NULL
, interface_command_handlers
);
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)