1 /***************************************************************************
2 * Copyright (C) 2013 by Andes Technology *
3 * Hsiangkai Wang <hkwang@andestech.com> *
5 * This program is free software; you can redistribute it and/or modify *
6 * it under the terms of the GNU General Public License as published by *
7 * the Free Software Foundation; either version 2 of the License, or *
8 * (at your option) any later version. *
10 * This program is distributed in the hope that it will be useful, *
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
13 * GNU General Public License for more details. *
15 * You should have received a copy of the GNU General Public License *
16 * along with this program. If not, see <http://www.gnu.org/licenses/>. *
17 ***************************************************************************/
23 #include <jtag/interface.h>
24 #include <jtag/commands.h>
25 #include <transport/transport.h>
26 #include <target/target.h>
27 #include <jtag/aice/aice_transport.h>
28 #include <jtag/drivers/libusb_common.h>
31 #define AICE_KHZ_TO_SPEED_MAP_SIZE 16
32 static const int aice_khz_to_speed_map
[AICE_KHZ_TO_SPEED_MAP_SIZE
] = {
51 static const struct aice_port
*aice_port
;
52 static struct aice_port_param_s param
;
53 static uint32_t retry_times
;
54 static uint32_t count_to_check_dbger
;
56 /***************************************************************************/
57 /* External interface implementation */
58 static uint32_t aice_target_id_codes
[AICE_MAX_NUM_CORE
];
59 static uint8_t aice_num_of_target_id_codes
;
61 /***************************************************************************/
63 int aice_init_targets(void)
66 struct target
*target
;
67 struct aice_port_s
*aice
;
69 LOG_DEBUG("aice_init_targets");
71 if (aice_num_of_target_id_codes
== 0) {
72 res
= aice_port
->api
->idcode(aice_target_id_codes
, &aice_num_of_target_id_codes
);
73 if (res
!= ERROR_OK
) {
74 LOG_ERROR("<-- TARGET ERROR! Failed to identify AndesCore "
75 "JTAG Manufacture ID in the JTAG scan chain. "
76 "Failed to access EDM registers. -->");
81 for (target
= all_targets
; target
; target
= target
->next
) {
82 target
->tap
->idcode
= aice_target_id_codes
[target
->tap
->abs_chain_position
];
84 unsigned ii
, limit
= target
->tap
->expected_ids_cnt
;
87 for (ii
= 0; ii
< limit
; ii
++) {
88 uint32_t expected
= target
->tap
->expected_ids
[ii
];
90 /* treat "-expected-id 0" as a "don't-warn" wildcard */
91 if (!expected
|| (target
->tap
->idcode
== expected
)) {
99 ("aice_init_targets: target not found: idcode: %" PRIx32
,
100 target
->tap
->idcode
);
104 aice
= calloc(1, sizeof(struct aice_port_s
));
105 aice
->port
= aice_port
;
106 aice
->coreid
= target
->tap
->abs_chain_position
;
108 target
->tap
->priv
= aice
;
109 target
->tap
->hasidcode
= 1;
115 /***************************************************************************/
116 /* End of External interface implementation */
120 * 2. get/show version number
123 static int aice_init(void)
125 if (ERROR_OK
!= aice_port
->api
->open(¶m
)) {
126 LOG_ERROR("Cannot find AICE Interface! Please check "
127 "connection and permissions.");
128 return ERROR_JTAG_INIT_FAILED
;
131 aice_port
->api
->set_retry_times(retry_times
);
132 aice_port
->api
->set_count_to_check_dbger(count_to_check_dbger
);
134 LOG_INFO("AICE JTAG Interface ready");
139 /* cleanup aice resource
142 static int aice_quit(void)
144 aice_port
->api
->close();
148 static int aice_execute_reset(struct jtag_command
*cmd
)
150 static int last_trst
;
151 int retval
= ERROR_OK
;
153 DEBUG_JTAG_IO("reset trst: %d", cmd
->cmd
.reset
->trst
);
155 if (cmd
->cmd
.reset
->trst
!= last_trst
) {
156 if (cmd
->cmd
.reset
->trst
)
157 retval
= aice_port
->api
->reset();
159 last_trst
= cmd
->cmd
.reset
->trst
;
165 static int aice_execute_command(struct jtag_command
*cmd
)
171 retval
= aice_execute_reset(cmd
);
180 /* aice has no need to implement jtag execution model
182 static int aice_execute_queue(void)
184 struct jtag_command
*cmd
= jtag_command_queue
; /* currently processed command */
190 if (aice_execute_command(cmd
) != ERROR_OK
)
191 retval
= ERROR_JTAG_QUEUE_FAILED
;
199 /* set jtag frequency(base frequency/frequency divider) to your jtag adapter */
200 static int aice_speed(int speed
)
202 return aice_port
->api
->set_jtag_clock(speed
);
205 /* convert jtag adapter frequency(base frequency/frequency divider) to
206 * human readable KHz value */
207 static int aice_speed_div(int speed
, int *khz
)
209 *khz
= aice_khz_to_speed_map
[speed
];
214 /* convert human readable KHz value to jtag adapter frequency
215 * (base frequency/frequency divider) */
216 static int aice_khz(int khz
, int *jtag_speed
)
219 for (i
= 0 ; i
< AICE_KHZ_TO_SPEED_MAP_SIZE
; i
++) {
220 if (khz
== aice_khz_to_speed_map
[i
]) {
222 *jtag_speed
= i
| AICE_TCK_CONTROL_TCK3048
;
229 if (i
== AICE_KHZ_TO_SPEED_MAP_SIZE
) {
230 LOG_INFO("No support the jtag clock: %d", khz
);
231 LOG_INFO("Supported jtag clocks are:");
233 for (i
= 0 ; i
< AICE_KHZ_TO_SPEED_MAP_SIZE
; i
++)
234 LOG_INFO("* %d", aice_khz_to_speed_map
[i
]);
242 /***************************************************************************/
243 /* Command handlers */
244 COMMAND_HANDLER(aice_handle_aice_info_command
)
246 LOG_DEBUG("aice_handle_aice_info_command");
248 command_print(CMD_CTX
, "Description: %s", param
.device_desc
);
249 command_print(CMD_CTX
, "Serial number: %s", param
.serial
);
250 if (strncmp(aice_port
->name
, "aice_pipe", 9) == 0)
251 command_print(CMD_CTX
, "Adapter: %s", param
.adapter_name
);
256 COMMAND_HANDLER(aice_handle_aice_port_command
)
258 LOG_DEBUG("aice_handle_aice_port_command");
261 LOG_ERROR("Need exactly one argument to 'aice port'");
262 return ERROR_COMMAND_SYNTAX_ERROR
;
265 for (const struct aice_port
*l
= aice_port_get_list(); l
->name
; l
++) {
266 if (strcmp(l
->name
, CMD_ARGV
[0]) == 0) {
272 LOG_ERROR("No AICE port '%s' found", CMD_ARGV
[0]);
276 COMMAND_HANDLER(aice_handle_aice_desc_command
)
278 LOG_DEBUG("aice_handle_aice_desc_command");
281 param
.device_desc
= strdup(CMD_ARGV
[0]);
283 LOG_ERROR("expected exactly one argument to aice desc <description>");
288 COMMAND_HANDLER(aice_handle_aice_serial_command
)
290 LOG_DEBUG("aice_handle_aice_serial_command");
293 param
.serial
= strdup(CMD_ARGV
[0]);
295 LOG_ERROR("expected exactly one argument to aice serial <serial-number>");
300 COMMAND_HANDLER(aice_handle_aice_vid_pid_command
)
302 LOG_DEBUG("aice_handle_aice_vid_pid_command");
305 LOG_WARNING("ignoring extra IDs in aice vid_pid (maximum is 1 pair)");
306 return ERROR_COMMAND_SYNTAX_ERROR
;
309 COMMAND_PARSE_NUMBER(u16
, CMD_ARGV
[0], param
.vid
);
310 COMMAND_PARSE_NUMBER(u16
, CMD_ARGV
[1], param
.pid
);
315 COMMAND_HANDLER(aice_handle_aice_adapter_command
)
317 LOG_DEBUG("aice_handle_aice_adapter_command");
320 param
.adapter_name
= strdup(CMD_ARGV
[0]);
322 LOG_ERROR("expected exactly one argument to aice adapter <adapter-name>");
327 COMMAND_HANDLER(aice_handle_aice_retry_times_command
)
329 LOG_DEBUG("aice_handle_aice_retry_times_command");
332 COMMAND_PARSE_NUMBER(u32
, CMD_ARGV
[0], retry_times
);
334 LOG_ERROR("expected exactly one argument to aice retry_times <num_of_retry>");
339 COMMAND_HANDLER(aice_handle_aice_count_to_check_dbger_command
)
341 LOG_DEBUG("aice_handle_aice_count_to_check_dbger_command");
344 COMMAND_PARSE_NUMBER(u32
, CMD_ARGV
[0], count_to_check_dbger
);
346 LOG_ERROR("expected exactly one argument to aice count_to_check_dbger "
347 "<count_of_checking>");
352 COMMAND_HANDLER(aice_handle_aice_custom_srst_script_command
)
354 LOG_DEBUG("aice_handle_aice_custom_srst_script_command");
357 aice_port
->api
->set_custom_srst_script(CMD_ARGV
[0]);
364 COMMAND_HANDLER(aice_handle_aice_custom_trst_script_command
)
366 LOG_DEBUG("aice_handle_aice_custom_trst_script_command");
369 aice_port
->api
->set_custom_trst_script(CMD_ARGV
[0]);
376 COMMAND_HANDLER(aice_handle_aice_custom_restart_script_command
)
378 LOG_DEBUG("aice_handle_aice_custom_restart_script_command");
381 aice_port
->api
->set_custom_restart_script(CMD_ARGV
[0]);
388 COMMAND_HANDLER(aice_handle_aice_reset_command
)
390 LOG_DEBUG("aice_handle_aice_reset_command");
392 return aice_port
->api
->reset();
396 static const struct command_registration aice_subcommand_handlers
[] = {
399 .handler
= &aice_handle_aice_info_command
,
400 .mode
= COMMAND_EXEC
,
401 .help
= "show aice info",
402 .usage
= "aice info",
406 .handler
= &aice_handle_aice_port_command
,
407 .mode
= COMMAND_CONFIG
,
408 .help
= "set the port of the AICE",
409 .usage
= "aice port ['aice_pipe'|'aice_usb']",
413 .handler
= &aice_handle_aice_desc_command
,
414 .mode
= COMMAND_CONFIG
,
415 .help
= "set the aice device description",
416 .usage
= "aice desc [desciption string]",
420 .handler
= &aice_handle_aice_serial_command
,
421 .mode
= COMMAND_CONFIG
,
422 .help
= "set the serial number of the AICE device",
423 .usage
= "aice serial [serial string]",
427 .handler
= &aice_handle_aice_vid_pid_command
,
428 .mode
= COMMAND_CONFIG
,
429 .help
= "the vendor and product ID of the AICE device",
430 .usage
= "aice vid_pid (vid pid)*",
434 .handler
= &aice_handle_aice_adapter_command
,
435 .mode
= COMMAND_CONFIG
,
436 .help
= "set the file name of adapter",
437 .usage
= "aice adapter [adapter name]",
440 .name
= "retry_times",
441 .handler
= &aice_handle_aice_retry_times_command
,
442 .mode
= COMMAND_CONFIG
,
443 .help
= "set retry times as AICE timeout",
444 .usage
= "aice retry_times num_of_retry",
447 .name
= "count_to_check_dbger",
448 .handler
= &aice_handle_aice_count_to_check_dbger_command
,
449 .mode
= COMMAND_CONFIG
,
450 .help
= "set retry times as checking $DBGER status",
451 .usage
= "aice count_to_check_dbger count_of_checking",
454 .name
= "custom_srst_script",
455 .handler
= &aice_handle_aice_custom_srst_script_command
,
456 .mode
= COMMAND_CONFIG
,
457 .usage
= "custom_srst_script script_file_name",
458 .help
= "set custom srst script",
461 .name
= "custom_trst_script",
462 .handler
= &aice_handle_aice_custom_trst_script_command
,
463 .mode
= COMMAND_CONFIG
,
464 .usage
= "custom_trst_script script_file_name",
465 .help
= "set custom trst script",
468 .name
= "custom_restart_script",
469 .handler
= &aice_handle_aice_custom_restart_script_command
,
470 .mode
= COMMAND_CONFIG
,
471 .usage
= "custom_restart_script script_file_name",
472 .help
= "set custom restart script",
476 .handler
= &aice_handle_aice_reset_command
,
477 .mode
= COMMAND_EXEC
,
478 .usage
= "aice reset",
479 .help
= "reset AICE",
481 COMMAND_REGISTRATION_DONE
484 static const struct command_registration aice_command_handlers
[] = {
488 .help
= "perform aice management",
489 .usage
= "aice [subcommand]",
490 .chain
= aice_subcommand_handlers
,
492 COMMAND_REGISTRATION_DONE
494 /***************************************************************************/
495 /* End of Command handlers */
497 struct jtag_interface aice_interface
= {
499 .commands
= aice_command_handlers
,
500 .transports
= aice_transports
,
503 .execute_queue
= aice_execute_queue
,
504 .speed
= aice_speed
, /* set interface speed */
505 .speed_div
= aice_speed_div
, /* return readable value */
506 .khz
= aice_khz
, /* convert khz to interface speed value */
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)