1 /***************************************************************************
2 * Copyright (C) 2011 by Mathias Kuester *
3 * Mathias Kuester <kesmtp@freenet.de> *
5 * Copyright (C) 2012 by Spencer Oliver *
6 * spen@spen-soft.co.uk *
8 * This program is free software; you can redistribute it and/or modify *
9 * it under the terms of the GNU General Public License as published by *
10 * the Free Software Foundation; either version 2 of the License, or *
11 * (at your option) any later version. *
13 * This program is distributed in the hope that it will be useful, *
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
16 * GNU General Public License for more details. *
18 * You should have received a copy of the GNU General Public License *
19 * along with this program. If not, see <http://www.gnu.org/licenses/>. *
20 ***************************************************************************/
26 /* project specific includes */
27 #include <jtag/interface.h>
28 #include <transport/transport.h>
29 #include <helper/time_support.h>
31 #include <jtag/hla/hla_tcl.h>
32 #include <jtag/hla/hla_layout.h>
33 #include <jtag/hla/hla_transport.h>
34 #include <jtag/hla/hla_interface.h>
36 #include <target/target.h>
38 static struct hl_interface_s hl_if
= { {0, 0, { 0 }, { 0 }, 0, HL_TRANSPORT_UNKNOWN
, false, -1}, 0, 0 };
40 int hl_interface_open(enum hl_transports tr
)
42 LOG_DEBUG("hl_interface_open");
44 enum reset_types jtag_reset_config
= jtag_get_reset_config();
46 if (jtag_reset_config
& RESET_CNCT_UNDER_SRST
) {
47 if (jtag_reset_config
& RESET_SRST_NO_GATING
)
48 hl_if
.param
.connect_under_reset
= true;
50 LOG_WARNING("\'srst_nogate\' reset_config option is required");
53 /* set transport mode */
54 hl_if
.param
.transport
= tr
;
56 int result
= hl_if
.layout
->open(&hl_if
);
57 if (result
!= ERROR_OK
)
60 return hl_interface_init_reset();
63 int hl_interface_init_target(struct target
*t
)
67 LOG_DEBUG("hl_interface_init_target");
69 /* this is the interface for the current target and we
70 * can setup the private pointer in the tap structure
71 * if the interface match the tap idcode
73 res
= hl_if
.layout
->api
->idcode(hl_if
.handle
, &t
->tap
->idcode
);
78 unsigned ii
, limit
= t
->tap
->expected_ids_cnt
;
81 for (ii
= 0; ii
< limit
; ii
++) {
82 uint32_t expected
= t
->tap
->expected_ids
[ii
];
84 /* treat "-expected-id 0" as a "don't-warn" wildcard */
85 if (!expected
|| !t
->tap
->idcode
||
86 (t
->tap
->idcode
== expected
)) {
93 LOG_WARNING("UNEXPECTED idcode: 0x%08" PRIx32
, t
->tap
->idcode
);
94 for (ii
= 0; ii
< limit
; ii
++)
95 LOG_ERROR("expected %u of %u: 0x%08" PRIx32
, ii
+ 1, limit
,
96 t
->tap
->expected_ids
[ii
]);
101 t
->tap
->priv
= &hl_if
;
102 t
->tap
->hasidcode
= 1;
107 static int hl_interface_init(void)
109 LOG_DEBUG("hl_interface_init");
111 /* here we can initialize the layout */
112 return hl_layout_init(&hl_if
);
115 static int hl_interface_quit(void)
117 LOG_DEBUG("hl_interface_quit");
119 if (hl_if
.layout
->api
->close
)
120 hl_if
.layout
->api
->close(hl_if
.handle
);
122 jtag_command_queue_reset();
124 free((void *)hl_if
.param
.device_desc
);
125 free((void *)hl_if
.param
.serial
);
130 static int hl_interface_reset(int req_trst
, int req_srst
)
132 return hl_if
.layout
->api
->assert_srst(hl_if
.handle
, req_srst
? 0 : 1);
135 static int hl_interface_execute_queue(void)
137 LOG_DEBUG("hl_interface_execute_queue: ignored");
142 int hl_interface_init_reset(void)
144 /* in case the adapter has not already handled asserting srst
145 * we will attempt it again */
146 if (hl_if
.param
.connect_under_reset
) {
147 adapter_assert_reset();
149 adapter_deassert_reset();
155 static int hl_interface_khz(int khz
, int *jtag_speed
)
157 if (hl_if
.layout
->api
->speed
== NULL
)
160 *jtag_speed
= hl_if
.layout
->api
->speed(hl_if
.handle
, khz
, true);
164 static int hl_interface_speed_div(int speed
, int *khz
)
170 static int hl_interface_speed(int speed
)
172 if (hl_if
.layout
->api
->speed
== NULL
)
175 if (hl_if
.handle
== NULL
) {
176 /* pass speed as initial param as interface not open yet */
177 hl_if
.param
.initial_interface_speed
= speed
;
181 hl_if
.layout
->api
->speed(hl_if
.handle
, speed
, false);
186 int hl_interface_override_target(const char **targetname
)
188 if (hl_if
.layout
->api
->override_target
) {
189 if (hl_if
.layout
->api
->override_target(*targetname
)) {
190 *targetname
= "hla_target";
198 int hl_interface_config_trace(bool enabled
, enum tpiu_pin_protocol pin_protocol
,
199 uint32_t port_size
, unsigned int *trace_freq
,
200 unsigned int traceclkin_freq
, uint16_t *prescaler
)
202 if (hl_if
.layout
->api
->config_trace
)
203 return hl_if
.layout
->api
->config_trace(hl_if
.handle
, enabled
,
204 pin_protocol
, port_size
, trace_freq
, traceclkin_freq
, prescaler
);
206 LOG_ERROR("The selected interface does not support tracing");
213 int hl_interface_poll_trace(uint8_t *buf
, size_t *size
)
215 if (hl_if
.layout
->api
->poll_trace
)
216 return hl_if
.layout
->api
->poll_trace(hl_if
.handle
, buf
, size
);
221 COMMAND_HANDLER(hl_interface_handle_device_desc_command
)
223 LOG_DEBUG("hl_interface_handle_device_desc_command");
226 hl_if
.param
.device_desc
= strdup(CMD_ARGV
[0]);
228 LOG_ERROR("expected exactly one argument to hl_device_desc <description>");
234 COMMAND_HANDLER(hl_interface_handle_serial_command
)
236 LOG_DEBUG("hl_interface_handle_serial_command");
239 hl_if
.param
.serial
= strdup(CMD_ARGV
[0]);
241 LOG_ERROR("expected exactly one argument to hl_serial <serial-number>");
247 COMMAND_HANDLER(hl_interface_handle_layout_command
)
249 LOG_DEBUG("hl_interface_handle_layout_command");
252 LOG_ERROR("Need exactly one argument to stlink_layout");
253 return ERROR_COMMAND_SYNTAX_ERROR
;
257 LOG_ERROR("already specified hl_layout %s",
259 return (strcmp(hl_if
.layout
->name
, CMD_ARGV
[0]) != 0)
260 ? ERROR_FAIL
: ERROR_OK
;
263 for (const struct hl_layout
*l
= hl_layout_get_list(); l
->name
;
265 if (strcmp(l
->name
, CMD_ARGV
[0]) == 0) {
271 LOG_ERROR("No adapter layout '%s' found", CMD_ARGV
[0]);
275 COMMAND_HANDLER(hl_interface_handle_vid_pid_command
)
277 if (CMD_ARGC
> HLA_MAX_USB_IDS
* 2) {
278 LOG_WARNING("ignoring extra IDs in hla_vid_pid "
279 "(maximum is %d pairs)", HLA_MAX_USB_IDS
);
280 CMD_ARGC
= HLA_MAX_USB_IDS
* 2;
282 if (CMD_ARGC
< 2 || (CMD_ARGC
& 1)) {
283 LOG_WARNING("incomplete hla_vid_pid configuration directive");
284 return ERROR_COMMAND_SYNTAX_ERROR
;
288 for (i
= 0; i
< CMD_ARGC
; i
+= 2) {
289 COMMAND_PARSE_NUMBER(u16
, CMD_ARGV
[i
], hl_if
.param
.vid
[i
/ 2]);
290 COMMAND_PARSE_NUMBER(u16
, CMD_ARGV
[i
+ 1], hl_if
.param
.pid
[i
/ 2]);
294 * Explicitly terminate, in case there are multiple instances of
297 hl_if
.param
.vid
[i
/ 2] = hl_if
.param
.pid
[i
/ 2] = 0;
302 COMMAND_HANDLER(interface_handle_hla_command
)
305 return ERROR_COMMAND_SYNTAX_ERROR
;
307 if (!hl_if
.layout
->api
->custom_command
) {
308 LOG_ERROR("The selected adapter doesn't support custom commands");
312 hl_if
.layout
->api
->custom_command(hl_if
.handle
, CMD_ARGV
[0]);
317 static const struct command_registration hl_interface_command_handlers
[] = {
319 .name
= "hla_device_desc",
320 .handler
= &hl_interface_handle_device_desc_command
,
321 .mode
= COMMAND_CONFIG
,
322 .help
= "set the a device description of the adapter",
323 .usage
= "description_string",
326 .name
= "hla_serial",
327 .handler
= &hl_interface_handle_serial_command
,
328 .mode
= COMMAND_CONFIG
,
329 .help
= "set the serial number of the adapter",
330 .usage
= "serial_string",
333 .name
= "hla_layout",
334 .handler
= &hl_interface_handle_layout_command
,
335 .mode
= COMMAND_CONFIG
,
336 .help
= "set the layout of the adapter",
337 .usage
= "layout_name",
340 .name
= "hla_vid_pid",
341 .handler
= &hl_interface_handle_vid_pid_command
,
342 .mode
= COMMAND_CONFIG
,
343 .help
= "the vendor and product ID of the adapter",
344 .usage
= "(vid pid)* ",
347 .name
= "hla_command",
348 .handler
= &interface_handle_hla_command
,
349 .mode
= COMMAND_EXEC
,
350 .help
= "execute a custom adapter-specific command",
351 .usage
= "hla_command <command>",
353 COMMAND_REGISTRATION_DONE
356 struct jtag_interface hl_interface
= {
359 .commands
= hl_interface_command_handlers
,
360 .transports
= hl_transports
,
361 .init
= hl_interface_init
,
362 .quit
= hl_interface_quit
,
363 .reset
= hl_interface_reset
,
364 .execute_queue
= hl_interface_execute_queue
,
365 .speed
= &hl_interface_speed
,
366 .khz
= &hl_interface_khz
,
367 .speed_div
= &hl_interface_speed_div
,
368 .config_trace
= &hl_interface_config_trace
,
369 .poll_trace
= &hl_interface_poll_trace
,
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)