1 /***************************************************************************
2 * Copyright (C) 2005 by Dominic Rath *
3 * Dominic.Rath@gmx.de *
5 * Copyright (C) 2007,2008 Øyvind Harboe *
6 * oyvind.harboe@zylin.com *
8 * Copyright (C) 2008, Duane Ellis *
9 * openocd@duaneeellis.com *
11 * Copyright (C) 2008 by Spencer Oliver *
12 * spen@spen-soft.co.uk *
14 * Copyright (C) 2008 by Rick Altherr *
15 * kc8apf@kc8apf.net> *
17 * This program is free software; you can redistribute it and/or modify *
18 * it under the terms of the GNU General Public License as published by *
19 * the Free Software Foundation; either version 2 of the License, or *
20 * (at your option) any later version. *
22 * This program is distributed in the hope that it will be useful, *
23 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
24 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
25 * GNU General Public License for more details. *
27 * You should have received a copy of the GNU General Public License *
28 * along with this program; if not, write to the *
29 * Free Software Foundation, Inc., *
30 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
31 ***************************************************************************/
37 #include "target_type.h"
38 #include "target_request.h"
39 #include "time_support.h"
46 static int handle_targets_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
48 static int handle_reg_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
49 static int handle_poll_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
50 static int handle_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
51 static int handle_wait_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
52 static int handle_reset_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
53 static int handle_soft_reset_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
54 static int handle_resume_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
55 static int handle_step_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
56 static int handle_md_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
57 static int handle_mw_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
58 static int handle_load_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
59 static int handle_dump_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
60 static int handle_verify_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
61 static int handle_test_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
62 static int handle_bp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
63 static int handle_rbp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
64 static int handle_wp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
65 static int handle_rwp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
66 static int handle_virt2phys_command(command_context_t
*cmd_ctx
, char *cmd
, char **args
, int argc
);
67 static int handle_profile_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
68 static int handle_fast_load_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
69 static int handle_fast_load_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
71 static int jim_array2mem(Jim_Interp
*interp
, int argc
, Jim_Obj
*const *argv
);
72 static int jim_mem2array(Jim_Interp
*interp
, int argc
, Jim_Obj
*const *argv
);
73 static int jim_target( Jim_Interp
*interp
, int argc
, Jim_Obj
*const *argv
);
75 static int target_array2mem(Jim_Interp
*interp
, target_t
*target
, int argc
, Jim_Obj
*const *argv
);
76 static int target_mem2array(Jim_Interp
*interp
, target_t
*target
, int argc
, Jim_Obj
*const *argv
);
79 extern target_type_t arm7tdmi_target
;
80 extern target_type_t arm720t_target
;
81 extern target_type_t arm9tdmi_target
;
82 extern target_type_t arm920t_target
;
83 extern target_type_t arm966e_target
;
84 extern target_type_t arm926ejs_target
;
85 extern target_type_t feroceon_target
;
86 extern target_type_t xscale_target
;
87 extern target_type_t cortexm3_target
;
88 extern target_type_t cortexa8_target
;
89 extern target_type_t arm11_target
;
90 extern target_type_t mips_m4k_target
;
91 extern target_type_t avr_target
;
93 target_type_t
*target_types
[] =
111 target_t
*all_targets
= NULL
;
112 target_event_callback_t
*target_event_callbacks
= NULL
;
113 target_timer_callback_t
*target_timer_callbacks
= NULL
;
115 const Jim_Nvp nvp_assert
[] = {
116 { .name
= "assert", NVP_ASSERT
},
117 { .name
= "deassert", NVP_DEASSERT
},
118 { .name
= "T", NVP_ASSERT
},
119 { .name
= "F", NVP_DEASSERT
},
120 { .name
= "t", NVP_ASSERT
},
121 { .name
= "f", NVP_DEASSERT
},
122 { .name
= NULL
, .value
= -1 }
125 const Jim_Nvp nvp_error_target
[] = {
126 { .value
= ERROR_TARGET_INVALID
, .name
= "err-invalid" },
127 { .value
= ERROR_TARGET_INIT_FAILED
, .name
= "err-init-failed" },
128 { .value
= ERROR_TARGET_TIMEOUT
, .name
= "err-timeout" },
129 { .value
= ERROR_TARGET_NOT_HALTED
, .name
= "err-not-halted" },
130 { .value
= ERROR_TARGET_FAILURE
, .name
= "err-failure" },
131 { .value
= ERROR_TARGET_UNALIGNED_ACCESS
, .name
= "err-unaligned-access" },
132 { .value
= ERROR_TARGET_DATA_ABORT
, .name
= "err-data-abort" },
133 { .value
= ERROR_TARGET_RESOURCE_NOT_AVAILABLE
, .name
= "err-resource-not-available" },
134 { .value
= ERROR_TARGET_TRANSLATION_FAULT
, .name
= "err-translation-fault" },
135 { .value
= ERROR_TARGET_NOT_RUNNING
, .name
= "err-not-running" },
136 { .value
= ERROR_TARGET_NOT_EXAMINED
, .name
= "err-not-examined" },
137 { .value
= -1, .name
= NULL
}
140 const char *target_strerror_safe( int err
)
144 n
= Jim_Nvp_value2name_simple( nvp_error_target
, err
);
145 if( n
->name
== NULL
){
152 static const Jim_Nvp nvp_target_event
[] = {
153 { .value
= TARGET_EVENT_OLD_gdb_program_config
, .name
= "old-gdb_program_config" },
154 { .value
= TARGET_EVENT_OLD_pre_resume
, .name
= "old-pre_resume" },
156 { .value
= TARGET_EVENT_EARLY_HALTED
, .name
= "early-halted" },
157 { .value
= TARGET_EVENT_HALTED
, .name
= "halted" },
158 { .value
= TARGET_EVENT_RESUMED
, .name
= "resumed" },
159 { .value
= TARGET_EVENT_RESUME_START
, .name
= "resume-start" },
160 { .value
= TARGET_EVENT_RESUME_END
, .name
= "resume-end" },
162 { .name
= "gdb-start", .value
= TARGET_EVENT_GDB_START
},
163 { .name
= "gdb-end", .value
= TARGET_EVENT_GDB_END
},
165 /* historical name */
167 { .value
= TARGET_EVENT_RESET_START
, .name
= "reset-start" },
169 { .value
= TARGET_EVENT_RESET_ASSERT_PRE
, .name
= "reset-assert-pre" },
170 { .value
= TARGET_EVENT_RESET_ASSERT_POST
, .name
= "reset-assert-post" },
171 { .value
= TARGET_EVENT_RESET_DEASSERT_PRE
, .name
= "reset-deassert-pre" },
172 { .value
= TARGET_EVENT_RESET_DEASSERT_POST
, .name
= "reset-deassert-post" },
173 { .value
= TARGET_EVENT_RESET_HALT_PRE
, .name
= "reset-halt-pre" },
174 { .value
= TARGET_EVENT_RESET_HALT_POST
, .name
= "reset-halt-post" },
175 { .value
= TARGET_EVENT_RESET_WAIT_PRE
, .name
= "reset-wait-pre" },
176 { .value
= TARGET_EVENT_RESET_WAIT_POST
, .name
= "reset-wait-post" },
177 { .value
= TARGET_EVENT_RESET_INIT
, .name
= "reset-init" },
178 { .value
= TARGET_EVENT_RESET_END
, .name
= "reset-end" },
180 { .value
= TARGET_EVENT_EXAMINE_START
, .name
= "examine-start" },
181 { .value
= TARGET_EVENT_EXAMINE_END
, .name
= "examine-end" },
183 { .value
= TARGET_EVENT_DEBUG_HALTED
, .name
= "debug-halted" },
184 { .value
= TARGET_EVENT_DEBUG_RESUMED
, .name
= "debug-resumed" },
186 { .value
= TARGET_EVENT_GDB_ATTACH
, .name
= "gdb-attach" },
187 { .value
= TARGET_EVENT_GDB_DETACH
, .name
= "gdb-detach" },
189 { .value
= TARGET_EVENT_GDB_FLASH_WRITE_START
, .name
= "gdb-flash-write-start" },
190 { .value
= TARGET_EVENT_GDB_FLASH_WRITE_END
, .name
= "gdb-flash-write-end" },
192 { .value
= TARGET_EVENT_GDB_FLASH_ERASE_START
, .name
= "gdb-flash-erase-start" },
193 { .value
= TARGET_EVENT_GDB_FLASH_ERASE_END
, .name
= "gdb-flash-erase-end" },
195 { .value
= TARGET_EVENT_RESUME_START
, .name
= "resume-start" },
196 { .value
= TARGET_EVENT_RESUMED
, .name
= "resume-ok" },
197 { .value
= TARGET_EVENT_RESUME_END
, .name
= "resume-end" },
199 { .name
= NULL
, .value
= -1 }
202 const Jim_Nvp nvp_target_state
[] = {
203 { .name
= "unknown", .value
= TARGET_UNKNOWN
},
204 { .name
= "running", .value
= TARGET_RUNNING
},
205 { .name
= "halted", .value
= TARGET_HALTED
},
206 { .name
= "reset", .value
= TARGET_RESET
},
207 { .name
= "debug-running", .value
= TARGET_DEBUG_RUNNING
},
208 { .name
= NULL
, .value
= -1 },
211 const Jim_Nvp nvp_target_debug_reason
[] = {
212 { .name
= "debug-request" , .value
= DBG_REASON_DBGRQ
},
213 { .name
= "breakpoint" , .value
= DBG_REASON_BREAKPOINT
},
214 { .name
= "watchpoint" , .value
= DBG_REASON_WATCHPOINT
},
215 { .name
= "watchpoint-and-breakpoint", .value
= DBG_REASON_WPTANDBKPT
},
216 { .name
= "single-step" , .value
= DBG_REASON_SINGLESTEP
},
217 { .name
= "target-not-halted" , .value
= DBG_REASON_NOTHALTED
},
218 { .name
= "undefined" , .value
= DBG_REASON_UNDEFINED
},
219 { .name
= NULL
, .value
= -1 },
222 const Jim_Nvp nvp_target_endian
[] = {
223 { .name
= "big", .value
= TARGET_BIG_ENDIAN
},
224 { .name
= "little", .value
= TARGET_LITTLE_ENDIAN
},
225 { .name
= "be", .value
= TARGET_BIG_ENDIAN
},
226 { .name
= "le", .value
= TARGET_LITTLE_ENDIAN
},
227 { .name
= NULL
, .value
= -1 },
230 const Jim_Nvp nvp_reset_modes
[] = {
231 { .name
= "unknown", .value
= RESET_UNKNOWN
},
232 { .name
= "run" , .value
= RESET_RUN
},
233 { .name
= "halt" , .value
= RESET_HALT
},
234 { .name
= "init" , .value
= RESET_INIT
},
235 { .name
= NULL
, .value
= -1 },
238 static int max_target_number(void)
246 if( x
< t
->target_number
){
247 x
= (t
->target_number
)+1;
254 /* determine the number of the new target */
255 static int new_target_number(void)
260 /* number is 0 based */
264 if( x
< t
->target_number
){
265 x
= t
->target_number
;
272 static int target_continous_poll
= 1;
274 /* read a u32 from a buffer in target memory endianness */
275 u32
target_buffer_get_u32(target_t
*target
, const u8
*buffer
)
277 if (target
->endianness
== TARGET_LITTLE_ENDIAN
)
278 return le_to_h_u32(buffer
);
280 return be_to_h_u32(buffer
);
283 /* read a u16 from a buffer in target memory endianness */
284 u16
target_buffer_get_u16(target_t
*target
, const u8
*buffer
)
286 if (target
->endianness
== TARGET_LITTLE_ENDIAN
)
287 return le_to_h_u16(buffer
);
289 return be_to_h_u16(buffer
);
292 /* read a u8 from a buffer in target memory endianness */
293 u8
target_buffer_get_u8(target_t
*target
, const u8
*buffer
)
295 return *buffer
& 0x0ff;
298 /* write a u32 to a buffer in target memory endianness */
299 void target_buffer_set_u32(target_t
*target
, u8
*buffer
, u32 value
)
301 if (target
->endianness
== TARGET_LITTLE_ENDIAN
)
302 h_u32_to_le(buffer
, value
);
304 h_u32_to_be(buffer
, value
);
307 /* write a u16 to a buffer in target memory endianness */
308 void target_buffer_set_u16(target_t
*target
, u8
*buffer
, u16 value
)
310 if (target
->endianness
== TARGET_LITTLE_ENDIAN
)
311 h_u16_to_le(buffer
, value
);
313 h_u16_to_be(buffer
, value
);
316 /* write a u8 to a buffer in target memory endianness */
317 void target_buffer_set_u8(target_t
*target
, u8
*buffer
, u8 value
)
322 /* return a pointer to a configured target; id is name or number */
323 target_t
*get_target(const char *id
)
327 /* try as tcltarget name */
328 for (target
= all_targets
; target
; target
= target
->next
) {
329 if (target
->cmd_name
== NULL
)
331 if (strcmp(id
, target
->cmd_name
) == 0)
335 /* no match, try as number */
337 if (parse_uint(id
, &num
) != ERROR_OK
)
340 for (target
= all_targets
; target
; target
= target
->next
) {
341 if (target
->target_number
== (int)num
)
348 /* returns a pointer to the n-th configured target */
349 static target_t
*get_target_by_num(int num
)
351 target_t
*target
= all_targets
;
354 if( target
->target_number
== num
){
357 target
= target
->next
;
363 int get_num_by_target(target_t
*query_target
)
365 return query_target
->target_number
;
368 target_t
* get_current_target(command_context_t
*cmd_ctx
)
370 target_t
*target
= get_target_by_num(cmd_ctx
->current_target
);
374 LOG_ERROR("BUG: current_target out of bounds");
381 int target_poll(struct target_s
*target
)
383 /* We can't poll until after examine */
384 if (!target_was_examined(target
))
386 /* Fail silently lest we pollute the log */
389 return target
->type
->poll(target
);
392 int target_halt(struct target_s
*target
)
394 /* We can't poll until after examine */
395 if (!target_was_examined(target
))
397 LOG_ERROR("Target not examined yet");
400 return target
->type
->halt(target
);
403 int target_resume(struct target_s
*target
, int current
, u32 address
, int handle_breakpoints
, int debug_execution
)
407 /* We can't poll until after examine */
408 if (!target_was_examined(target
))
410 LOG_ERROR("Target not examined yet");
414 /* note that resume *must* be asynchronous. The CPU can halt before we poll. The CPU can
415 * even halt at the current PC as a result of a software breakpoint being inserted by (a bug?)
418 if ((retval
= target
->type
->resume(target
, current
, address
, handle_breakpoints
, debug_execution
)) != ERROR_OK
)
424 int target_process_reset(struct command_context_s
*cmd_ctx
, enum target_reset_mode reset_mode
)
429 n
= Jim_Nvp_value2name_simple( nvp_reset_modes
, reset_mode
);
430 if( n
->name
== NULL
){
431 LOG_ERROR("invalid reset mode");
435 /* disable polling during reset to make reset event scripts
436 * more predictable, i.e. dr/irscan & pathmove in events will
437 * not have JTAG operations injected into the middle of a sequence.
439 int save_poll
= target_continous_poll
;
440 target_continous_poll
= 0;
442 sprintf( buf
, "ocd_process_reset %s", n
->name
);
443 retval
= Jim_Eval( interp
, buf
);
445 target_continous_poll
= save_poll
;
447 if(retval
!= JIM_OK
) {
448 Jim_PrintErrorMessage(interp
);
452 /* We want any events to be processed before the prompt */
453 retval
= target_call_timer_callbacks_now();
458 static int default_virt2phys(struct target_s
*target
, u32
virtual, u32
*physical
)
464 static int default_mmu(struct target_s
*target
, int *enabled
)
470 static int default_examine(struct target_s
*target
)
472 target_set_examined(target
);
476 int target_examine_one(struct target_s
*target
)
478 return target
->type
->examine(target
);
481 /* Targets that correctly implement init+examine, i.e.
482 * no communication with target during init:
486 int target_examine(void)
488 int retval
= ERROR_OK
;
491 for (target
= all_targets
; target
; target
= target
->next
)
493 if (!target
->tap
->enabled
)
495 if ((retval
= target_examine_one(target
)) != ERROR_OK
)
500 const char *target_get_name(struct target_s
*target
)
502 return target
->type
->name
;
505 static int target_write_memory_imp(struct target_s
*target
, u32 address
, u32 size
, u32 count
, u8
*buffer
)
507 if (!target_was_examined(target
))
509 LOG_ERROR("Target not examined yet");
512 return target
->type
->write_memory_imp(target
, address
, size
, count
, buffer
);
515 static int target_read_memory_imp(struct target_s
*target
, u32 address
, u32 size
, u32 count
, u8
*buffer
)
517 if (!target_was_examined(target
))
519 LOG_ERROR("Target not examined yet");
522 return target
->type
->read_memory_imp(target
, address
, size
, count
, buffer
);
525 static int target_soft_reset_halt_imp(struct target_s
*target
)
527 if (!target_was_examined(target
))
529 LOG_ERROR("Target not examined yet");
532 return target
->type
->soft_reset_halt_imp(target
);
535 static int target_run_algorithm_imp(struct target_s
*target
, int num_mem_params
, mem_param_t
*mem_params
, int num_reg_params
, reg_param_t
*reg_param
, u32 entry_point
, u32 exit_point
, int timeout_ms
, void *arch_info
)
537 if (!target_was_examined(target
))
539 LOG_ERROR("Target not examined yet");
542 return target
->type
->run_algorithm_imp(target
, num_mem_params
, mem_params
, num_reg_params
, reg_param
, entry_point
, exit_point
, timeout_ms
, arch_info
);
545 int target_read_memory(struct target_s
*target
,
546 u32 address
, u32 size
, u32 count
, u8
*buffer
)
548 return target
->type
->read_memory(target
, address
, size
, count
, buffer
);
551 int target_write_memory(struct target_s
*target
,
552 u32 address
, u32 size
, u32 count
, u8
*buffer
)
554 return target
->type
->write_memory(target
, address
, size
, count
, buffer
);
556 int target_bulk_write_memory(struct target_s
*target
,
557 u32 address
, u32 count
, u8
*buffer
)
559 return target
->type
->bulk_write_memory(target
, address
, count
, buffer
);
562 int target_add_breakpoint(struct target_s
*target
,
563 struct breakpoint_s
*breakpoint
)
565 return target
->type
->add_breakpoint(target
, breakpoint
);
567 int target_remove_breakpoint(struct target_s
*target
,
568 struct breakpoint_s
*breakpoint
)
570 return target
->type
->remove_breakpoint(target
, breakpoint
);
573 int target_add_watchpoint(struct target_s
*target
,
574 struct watchpoint_s
*watchpoint
)
576 return target
->type
->add_watchpoint(target
, watchpoint
);
578 int target_remove_watchpoint(struct target_s
*target
,
579 struct watchpoint_s
*watchpoint
)
581 return target
->type
->remove_watchpoint(target
, watchpoint
);
584 int target_get_gdb_reg_list(struct target_s
*target
,
585 struct reg_s
**reg_list
[], int *reg_list_size
)
587 return target
->type
->get_gdb_reg_list(target
, reg_list
, reg_list_size
);
589 int target_step(struct target_s
*target
,
590 int current
, u32 address
, int handle_breakpoints
)
592 return target
->type
->step(target
, current
, address
, handle_breakpoints
);
596 int target_run_algorithm(struct target_s
*target
,
597 int num_mem_params
, mem_param_t
*mem_params
,
598 int num_reg_params
, reg_param_t
*reg_param
,
599 u32 entry_point
, u32 exit_point
,
600 int timeout_ms
, void *arch_info
)
602 return target
->type
->run_algorithm(target
,
603 num_mem_params
, mem_params
, num_reg_params
, reg_param
,
604 entry_point
, exit_point
, timeout_ms
, arch_info
);
607 /// @returns @c true if the target has been examined.
608 bool target_was_examined(struct target_s
*target
)
610 return target
->type
->examined
;
612 /// Sets the @c examined flag for the given target.
613 void target_set_examined(struct target_s
*target
)
615 target
->type
->examined
= true;
617 // Reset the @c examined flag for the given target.
618 void target_reset_examined(struct target_s
*target
)
620 target
->type
->examined
= false;
624 int target_init(struct command_context_s
*cmd_ctx
)
626 target_t
*target
= all_targets
;
631 target_reset_examined(target
);
632 if (target
->type
->examine
== NULL
)
634 target
->type
->examine
= default_examine
;
637 if ((retval
= target
->type
->init_target(cmd_ctx
, target
)) != ERROR_OK
)
639 LOG_ERROR("target '%s' init failed", target_get_name(target
));
643 /* Set up default functions if none are provided by target */
644 if (target
->type
->virt2phys
== NULL
)
646 target
->type
->virt2phys
= default_virt2phys
;
648 target
->type
->virt2phys
= default_virt2phys
;
649 /* a non-invasive way(in terms of patches) to add some code that
650 * runs before the type->write/read_memory implementation
652 target
->type
->write_memory_imp
= target
->type
->write_memory
;
653 target
->type
->write_memory
= target_write_memory_imp
;
654 target
->type
->read_memory_imp
= target
->type
->read_memory
;
655 target
->type
->read_memory
= target_read_memory_imp
;
656 target
->type
->soft_reset_halt_imp
= target
->type
->soft_reset_halt
;
657 target
->type
->soft_reset_halt
= target_soft_reset_halt_imp
;
658 target
->type
->run_algorithm_imp
= target
->type
->run_algorithm
;
659 target
->type
->run_algorithm
= target_run_algorithm_imp
;
661 if (target
->type
->mmu
== NULL
)
663 target
->type
->mmu
= default_mmu
;
665 target
= target
->next
;
670 if((retval
= target_register_user_commands(cmd_ctx
)) != ERROR_OK
)
672 if((retval
= target_register_timer_callback(handle_target
, 100, 1, NULL
)) != ERROR_OK
)
679 int target_register_event_callback(int (*callback
)(struct target_s
*target
, enum target_event event
, void *priv
), void *priv
)
681 target_event_callback_t
**callbacks_p
= &target_event_callbacks
;
683 if (callback
== NULL
)
685 return ERROR_INVALID_ARGUMENTS
;
690 while ((*callbacks_p
)->next
)
691 callbacks_p
= &((*callbacks_p
)->next
);
692 callbacks_p
= &((*callbacks_p
)->next
);
695 (*callbacks_p
) = malloc(sizeof(target_event_callback_t
));
696 (*callbacks_p
)->callback
= callback
;
697 (*callbacks_p
)->priv
= priv
;
698 (*callbacks_p
)->next
= NULL
;
703 int target_register_timer_callback(int (*callback
)(void *priv
), int time_ms
, int periodic
, void *priv
)
705 target_timer_callback_t
**callbacks_p
= &target_timer_callbacks
;
708 if (callback
== NULL
)
710 return ERROR_INVALID_ARGUMENTS
;
715 while ((*callbacks_p
)->next
)
716 callbacks_p
= &((*callbacks_p
)->next
);
717 callbacks_p
= &((*callbacks_p
)->next
);
720 (*callbacks_p
) = malloc(sizeof(target_timer_callback_t
));
721 (*callbacks_p
)->callback
= callback
;
722 (*callbacks_p
)->periodic
= periodic
;
723 (*callbacks_p
)->time_ms
= time_ms
;
725 gettimeofday(&now
, NULL
);
726 (*callbacks_p
)->when
.tv_usec
= now
.tv_usec
+ (time_ms
% 1000) * 1000;
727 time_ms
-= (time_ms
% 1000);
728 (*callbacks_p
)->when
.tv_sec
= now
.tv_sec
+ (time_ms
/ 1000);
729 if ((*callbacks_p
)->when
.tv_usec
> 1000000)
731 (*callbacks_p
)->when
.tv_usec
= (*callbacks_p
)->when
.tv_usec
- 1000000;
732 (*callbacks_p
)->when
.tv_sec
+= 1;
735 (*callbacks_p
)->priv
= priv
;
736 (*callbacks_p
)->next
= NULL
;
741 int target_unregister_event_callback(int (*callback
)(struct target_s
*target
, enum target_event event
, void *priv
), void *priv
)
743 target_event_callback_t
**p
= &target_event_callbacks
;
744 target_event_callback_t
*c
= target_event_callbacks
;
746 if (callback
== NULL
)
748 return ERROR_INVALID_ARGUMENTS
;
753 target_event_callback_t
*next
= c
->next
;
754 if ((c
->callback
== callback
) && (c
->priv
== priv
))
768 int target_unregister_timer_callback(int (*callback
)(void *priv
), void *priv
)
770 target_timer_callback_t
**p
= &target_timer_callbacks
;
771 target_timer_callback_t
*c
= target_timer_callbacks
;
773 if (callback
== NULL
)
775 return ERROR_INVALID_ARGUMENTS
;
780 target_timer_callback_t
*next
= c
->next
;
781 if ((c
->callback
== callback
) && (c
->priv
== priv
))
795 int target_call_event_callbacks(target_t
*target
, enum target_event event
)
797 target_event_callback_t
*callback
= target_event_callbacks
;
798 target_event_callback_t
*next_callback
;
800 if (event
== TARGET_EVENT_HALTED
)
802 /* execute early halted first */
803 target_call_event_callbacks(target
, TARGET_EVENT_EARLY_HALTED
);
806 LOG_DEBUG("target event %i (%s)",
808 Jim_Nvp_value2name_simple( nvp_target_event
, event
)->name
);
810 target_handle_event( target
, event
);
814 next_callback
= callback
->next
;
815 callback
->callback(target
, event
, callback
->priv
);
816 callback
= next_callback
;
822 static int target_timer_callback_periodic_restart(
823 target_timer_callback_t
*cb
, struct timeval
*now
)
825 int time_ms
= cb
->time_ms
;
826 cb
->when
.tv_usec
= now
->tv_usec
+ (time_ms
% 1000) * 1000;
827 time_ms
-= (time_ms
% 1000);
828 cb
->when
.tv_sec
= now
->tv_sec
+ time_ms
/ 1000;
829 if (cb
->when
.tv_usec
> 1000000)
831 cb
->when
.tv_usec
= cb
->when
.tv_usec
- 1000000;
832 cb
->when
.tv_sec
+= 1;
837 static int target_call_timer_callback(target_timer_callback_t
*cb
,
840 cb
->callback(cb
->priv
);
843 return target_timer_callback_periodic_restart(cb
, now
);
845 return target_unregister_timer_callback(cb
->callback
, cb
->priv
);
848 static int target_call_timer_callbacks_check_time(int checktime
)
853 gettimeofday(&now
, NULL
);
855 target_timer_callback_t
*callback
= target_timer_callbacks
;
858 // cleaning up may unregister and free this callback
859 target_timer_callback_t
*next_callback
= callback
->next
;
861 bool call_it
= callback
->callback
&&
862 ((!checktime
&& callback
->periodic
) ||
863 now
.tv_sec
> callback
->when
.tv_sec
||
864 (now
.tv_sec
== callback
->when
.tv_sec
&&
865 now
.tv_usec
>= callback
->when
.tv_usec
));
869 int retval
= target_call_timer_callback(callback
, &now
);
870 if (retval
!= ERROR_OK
)
874 callback
= next_callback
;
880 int target_call_timer_callbacks(void)
882 return target_call_timer_callbacks_check_time(1);
885 /* invoke periodic callbacks immediately */
886 int target_call_timer_callbacks_now(void)
888 return target_call_timer_callbacks_check_time(0);
891 int target_alloc_working_area(struct target_s
*target
, u32 size
, working_area_t
**area
)
893 working_area_t
*c
= target
->working_areas
;
894 working_area_t
*new_wa
= NULL
;
896 /* Reevaluate working area address based on MMU state*/
897 if (target
->working_areas
== NULL
)
901 retval
= target
->type
->mmu(target
, &enabled
);
902 if (retval
!= ERROR_OK
)
908 target
->working_area
= target
->working_area_virt
;
912 target
->working_area
= target
->working_area_phys
;
916 /* only allocate multiples of 4 byte */
919 LOG_ERROR("BUG: code tried to allocate unaligned number of bytes, padding");
920 size
= CEIL(size
, 4);
923 /* see if there's already a matching working area */
926 if ((c
->free
) && (c
->size
== size
))
934 /* if not, allocate a new one */
937 working_area_t
**p
= &target
->working_areas
;
938 u32 first_free
= target
->working_area
;
939 u32 free_size
= target
->working_area_size
;
941 LOG_DEBUG("allocating new working area");
943 c
= target
->working_areas
;
946 first_free
+= c
->size
;
947 free_size
-= c
->size
;
952 if (free_size
< size
)
954 LOG_WARNING("not enough working area available(requested %d, free %d)", size
, free_size
);
955 return ERROR_TARGET_RESOURCE_NOT_AVAILABLE
;
958 new_wa
= malloc(sizeof(working_area_t
));
961 new_wa
->address
= first_free
;
963 if (target
->backup_working_area
)
966 new_wa
->backup
= malloc(new_wa
->size
);
967 if((retval
= target_read_memory(target
, new_wa
->address
, 4, new_wa
->size
/ 4, new_wa
->backup
)) != ERROR_OK
)
969 free(new_wa
->backup
);
976 new_wa
->backup
= NULL
;
979 /* put new entry in list */
983 /* mark as used, and return the new (reused) area */
993 int target_free_working_area_restore(struct target_s
*target
, working_area_t
*area
, int restore
)
998 if (restore
&&target
->backup_working_area
)
1001 if((retval
= target_write_memory(target
, area
->address
, 4, area
->size
/ 4, area
->backup
)) != ERROR_OK
)
1007 /* mark user pointer invalid */
1014 int target_free_working_area(struct target_s
*target
, working_area_t
*area
)
1016 return target_free_working_area_restore(target
, area
, 1);
1019 /* free resources and restore memory, if restoring memory fails,
1020 * free up resources anyway
1022 void target_free_all_working_areas_restore(struct target_s
*target
, int restore
)
1024 working_area_t
*c
= target
->working_areas
;
1028 working_area_t
*next
= c
->next
;
1029 target_free_working_area_restore(target
, c
, restore
);
1039 target
->working_areas
= NULL
;
1042 void target_free_all_working_areas(struct target_s
*target
)
1044 target_free_all_working_areas_restore(target
, 1);
1047 int target_register_commands(struct command_context_s
*cmd_ctx
)
1050 register_command(cmd_ctx
, NULL
, "targets", handle_targets_command
, COMMAND_EXEC
, "change the current command line target (one parameter) or lists targets (with no parameter)");
1055 register_jim(cmd_ctx
, "target", jim_target
, "configure target" );
1060 int target_arch_state(struct target_s
*target
)
1065 LOG_USER("No target has been configured");
1069 LOG_USER("target state: %s",
1070 Jim_Nvp_value2name_simple(nvp_target_state
,target
->state
)->name
);
1072 if (target
->state
!=TARGET_HALTED
)
1075 retval
=target
->type
->arch_state(target
);
1079 /* Single aligned words are guaranteed to use 16 or 32 bit access
1080 * mode respectively, otherwise data is handled as quickly as
1083 int target_write_buffer(struct target_s
*target
, u32 address
, u32 size
, u8
*buffer
)
1086 LOG_DEBUG("writing buffer of %i byte at 0x%8.8x", size
, address
);
1088 if (!target_was_examined(target
))
1090 LOG_ERROR("Target not examined yet");
1098 if ((address
+ size
- 1) < address
)
1100 /* GDB can request this when e.g. PC is 0xfffffffc*/
1101 LOG_ERROR("address+size wrapped(0x%08x, 0x%08x)", address
, size
);
1105 if (((address
% 2) == 0) && (size
== 2))
1107 return target_write_memory(target
, address
, 2, 1, buffer
);
1110 /* handle unaligned head bytes */
1113 u32 unaligned
= 4 - (address
% 4);
1115 if (unaligned
> size
)
1118 if ((retval
= target_write_memory(target
, address
, 1, unaligned
, buffer
)) != ERROR_OK
)
1121 buffer
+= unaligned
;
1122 address
+= unaligned
;
1126 /* handle aligned words */
1129 int aligned
= size
- (size
% 4);
1131 /* use bulk writes above a certain limit. This may have to be changed */
1134 if ((retval
= target
->type
->bulk_write_memory(target
, address
, aligned
/ 4, buffer
)) != ERROR_OK
)
1139 if ((retval
= target_write_memory(target
, address
, 4, aligned
/ 4, buffer
)) != ERROR_OK
)
1148 /* handle tail writes of less than 4 bytes */
1151 if ((retval
= target_write_memory(target
, address
, 1, size
, buffer
)) != ERROR_OK
)
1158 /* Single aligned words are guaranteed to use 16 or 32 bit access
1159 * mode respectively, otherwise data is handled as quickly as
1162 int target_read_buffer(struct target_s
*target
, u32 address
, u32 size
, u8
*buffer
)
1165 LOG_DEBUG("reading buffer of %i byte at 0x%8.8x", size
, address
);
1167 if (!target_was_examined(target
))
1169 LOG_ERROR("Target not examined yet");
1177 if ((address
+ size
- 1) < address
)
1179 /* GDB can request this when e.g. PC is 0xfffffffc*/
1180 LOG_ERROR("address+size wrapped(0x%08x, 0x%08x)", address
, size
);
1184 if (((address
% 2) == 0) && (size
== 2))
1186 return target_read_memory(target
, address
, 2, 1, buffer
);
1189 /* handle unaligned head bytes */
1192 u32 unaligned
= 4 - (address
% 4);
1194 if (unaligned
> size
)
1197 if ((retval
= target_read_memory(target
, address
, 1, unaligned
, buffer
)) != ERROR_OK
)
1200 buffer
+= unaligned
;
1201 address
+= unaligned
;
1205 /* handle aligned words */
1208 int aligned
= size
- (size
% 4);
1210 if ((retval
= target_read_memory(target
, address
, 4, aligned
/ 4, buffer
)) != ERROR_OK
)
1218 /* handle tail writes of less than 4 bytes */
1221 if ((retval
= target_read_memory(target
, address
, 1, size
, buffer
)) != ERROR_OK
)
1228 int target_checksum_memory(struct target_s
*target
, u32 address
, u32 size
, u32
* crc
)
1234 if (!target_was_examined(target
))
1236 LOG_ERROR("Target not examined yet");
1240 if ((retval
= target
->type
->checksum_memory(target
, address
,
1241 size
, &checksum
)) != ERROR_OK
)
1243 buffer
= malloc(size
);
1246 LOG_ERROR("error allocating buffer for section (%d bytes)", size
);
1247 return ERROR_INVALID_ARGUMENTS
;
1249 retval
= target_read_buffer(target
, address
, size
, buffer
);
1250 if (retval
!= ERROR_OK
)
1256 /* convert to target endianess */
1257 for (i
= 0; i
< (size
/sizeof(u32
)); i
++)
1260 target_data
= target_buffer_get_u32(target
, &buffer
[i
*sizeof(u32
)]);
1261 target_buffer_set_u32(target
, &buffer
[i
*sizeof(u32
)], target_data
);
1264 retval
= image_calculate_checksum( buffer
, size
, &checksum
);
1273 int target_blank_check_memory(struct target_s
*target
, u32 address
, u32 size
, u32
* blank
)
1276 if (!target_was_examined(target
))
1278 LOG_ERROR("Target not examined yet");
1282 if (target
->type
->blank_check_memory
== 0)
1283 return ERROR_TARGET_RESOURCE_NOT_AVAILABLE
;
1285 retval
= target
->type
->blank_check_memory(target
, address
, size
, blank
);
1290 int target_read_u32(struct target_s
*target
, u32 address
, u32
*value
)
1293 if (!target_was_examined(target
))
1295 LOG_ERROR("Target not examined yet");
1299 int retval
= target_read_memory(target
, address
, 4, 1, value_buf
);
1301 if (retval
== ERROR_OK
)
1303 *value
= target_buffer_get_u32(target
, value_buf
);
1304 LOG_DEBUG("address: 0x%8.8x, value: 0x%8.8x", address
, *value
);
1309 LOG_DEBUG("address: 0x%8.8x failed", address
);
1315 int target_read_u16(struct target_s
*target
, u32 address
, u16
*value
)
1318 if (!target_was_examined(target
))
1320 LOG_ERROR("Target not examined yet");
1324 int retval
= target_read_memory(target
, address
, 2, 1, value_buf
);
1326 if (retval
== ERROR_OK
)
1328 *value
= target_buffer_get_u16(target
, value_buf
);
1329 LOG_DEBUG("address: 0x%8.8x, value: 0x%4.4x", address
, *value
);
1334 LOG_DEBUG("address: 0x%8.8x failed", address
);
1340 int target_read_u8(struct target_s
*target
, u32 address
, u8
*value
)
1342 int retval
= target_read_memory(target
, address
, 1, 1, value
);
1343 if (!target_was_examined(target
))
1345 LOG_ERROR("Target not examined yet");
1349 if (retval
== ERROR_OK
)
1351 LOG_DEBUG("address: 0x%8.8x, value: 0x%2.2x", address
, *value
);
1356 LOG_DEBUG("address: 0x%8.8x failed", address
);
1362 int target_write_u32(struct target_s
*target
, u32 address
, u32 value
)
1366 if (!target_was_examined(target
))
1368 LOG_ERROR("Target not examined yet");
1372 LOG_DEBUG("address: 0x%8.8x, value: 0x%8.8x", address
, value
);
1374 target_buffer_set_u32(target
, value_buf
, value
);
1375 if ((retval
= target_write_memory(target
, address
, 4, 1, value_buf
)) != ERROR_OK
)
1377 LOG_DEBUG("failed: %i", retval
);
1383 int target_write_u16(struct target_s
*target
, u32 address
, u16 value
)
1387 if (!target_was_examined(target
))
1389 LOG_ERROR("Target not examined yet");
1393 LOG_DEBUG("address: 0x%8.8x, value: 0x%8.8x", address
, value
);
1395 target_buffer_set_u16(target
, value_buf
, value
);
1396 if ((retval
= target_write_memory(target
, address
, 2, 1, value_buf
)) != ERROR_OK
)
1398 LOG_DEBUG("failed: %i", retval
);
1404 int target_write_u8(struct target_s
*target
, u32 address
, u8 value
)
1407 if (!target_was_examined(target
))
1409 LOG_ERROR("Target not examined yet");
1413 LOG_DEBUG("address: 0x%8.8x, value: 0x%2.2x", address
, value
);
1415 if ((retval
= target_write_memory(target
, address
, 1, 1, &value
)) != ERROR_OK
)
1417 LOG_DEBUG("failed: %i", retval
);
1423 int target_register_user_commands(struct command_context_s
*cmd_ctx
)
1425 int retval
= ERROR_OK
;
1428 /* script procedures */
1429 register_command(cmd_ctx
, NULL
, "profile", handle_profile_command
, COMMAND_EXEC
, "profiling samples the CPU PC");
1430 register_jim(cmd_ctx
, "ocd_mem2array", jim_mem2array
, "read memory and return as a TCL array for script processing <ARRAYNAME> <WIDTH=32/16/8> <ADDRESS> <COUNT>");
1431 register_jim(cmd_ctx
, "ocd_array2mem", jim_array2mem
, "convert a TCL array to memory locations and write the values <ARRAYNAME> <WIDTH=32/16/8> <ADDRESS> <COUNT>");
1433 register_command(cmd_ctx
, NULL
, "fast_load_image", handle_fast_load_image_command
, COMMAND_ANY
,
1434 "same args as load_image, image stored in memory - mainly for profiling purposes");
1436 register_command(cmd_ctx
, NULL
, "fast_load", handle_fast_load_command
, COMMAND_ANY
,
1437 "loads active fast load image to current target - mainly for profiling purposes");
1440 register_command(cmd_ctx
, NULL
, "virt2phys", handle_virt2phys_command
, COMMAND_ANY
, "translate a virtual address into a physical address");
1441 register_command(cmd_ctx
, NULL
, "reg", handle_reg_command
, COMMAND_EXEC
, "display or set a register");
1442 register_command(cmd_ctx
, NULL
, "poll", handle_poll_command
, COMMAND_EXEC
, "poll target state");
1443 register_command(cmd_ctx
, NULL
, "wait_halt", handle_wait_halt_command
, COMMAND_EXEC
, "wait for target halt [time (s)]");
1444 register_command(cmd_ctx
, NULL
, "halt", handle_halt_command
, COMMAND_EXEC
, "halt target");
1445 register_command(cmd_ctx
, NULL
, "resume", handle_resume_command
, COMMAND_EXEC
, "resume target [addr]");
1446 register_command(cmd_ctx
, NULL
, "step", handle_step_command
, COMMAND_EXEC
, "step one instruction from current PC or [addr]");
1447 register_command(cmd_ctx
, NULL
, "reset", handle_reset_command
, COMMAND_EXEC
, "reset target [run|halt|init] - default is run");
1448 register_command(cmd_ctx
, NULL
, "soft_reset_halt", handle_soft_reset_halt_command
, COMMAND_EXEC
, "halt the target and do a soft reset");
1450 register_command(cmd_ctx
, NULL
, "mdw", handle_md_command
, COMMAND_EXEC
, "display memory words <addr> [count]");
1451 register_command(cmd_ctx
, NULL
, "mdh", handle_md_command
, COMMAND_EXEC
, "display memory half-words <addr> [count]");
1452 register_command(cmd_ctx
, NULL
, "mdb", handle_md_command
, COMMAND_EXEC
, "display memory bytes <addr> [count]");
1454 register_command(cmd_ctx
, NULL
, "mww", handle_mw_command
, COMMAND_EXEC
, "write memory word <addr> <value> [count]");
1455 register_command(cmd_ctx
, NULL
, "mwh", handle_mw_command
, COMMAND_EXEC
, "write memory half-word <addr> <value> [count]");
1456 register_command(cmd_ctx
, NULL
, "mwb", handle_mw_command
, COMMAND_EXEC
, "write memory byte <addr> <value> [count]");
1458 register_command(cmd_ctx
, NULL
, "bp", handle_bp_command
, COMMAND_EXEC
, "set breakpoint <address> <length> [hw]");
1459 register_command(cmd_ctx
, NULL
, "rbp", handle_rbp_command
, COMMAND_EXEC
, "remove breakpoint <adress>");
1460 register_command(cmd_ctx
, NULL
, "wp", handle_wp_command
, COMMAND_EXEC
, "set watchpoint <address> <length> <r/w/a> [value] [mask]");
1461 register_command(cmd_ctx
, NULL
, "rwp", handle_rwp_command
, COMMAND_EXEC
, "remove watchpoint <adress>");
1463 register_command(cmd_ctx
, NULL
, "load_image", handle_load_image_command
, COMMAND_EXEC
, "load_image <file> <address> ['bin'|'ihex'|'elf'|'s19'] [min_address] [max_length]");
1464 register_command(cmd_ctx
, NULL
, "dump_image", handle_dump_image_command
, COMMAND_EXEC
, "dump_image <file> <address> <size>");
1465 register_command(cmd_ctx
, NULL
, "verify_image", handle_verify_image_command
, COMMAND_EXEC
, "verify_image <file> [offset] [type]");
1466 register_command(cmd_ctx
, NULL
, "test_image", handle_test_image_command
, COMMAND_EXEC
, "test_image <file> [offset] [type]");
1468 if((retval
= target_request_register_commands(cmd_ctx
)) != ERROR_OK
)
1470 if((retval
= trace_register_commands(cmd_ctx
)) != ERROR_OK
)
1476 static int handle_targets_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1478 target_t
*target
= all_targets
;
1482 target
= get_target(args
[0]);
1483 if (target
== NULL
) {
1484 command_print(cmd_ctx
,"Target: %s is unknown, try one of:\n", args
[0] );
1487 if (!target
->tap
->enabled
) {
1488 command_print(cmd_ctx
,"Target: TAP %s is disabled, "
1489 "can't be the current target\n",
1490 target
->tap
->dotted_name
);
1494 cmd_ctx
->current_target
= target
->target_number
;
1499 target
= all_targets
;
1500 command_print(cmd_ctx
, " TargetName Type Endian TapName State ");
1501 command_print(cmd_ctx
, "-- ------------------ ---------- ------ ------------------ ------------");
1507 if (target
->tap
->enabled
)
1508 state
= Jim_Nvp_value2name_simple(nvp_target_state
,
1509 target
->state
)->name
;
1511 state
= "tap-disabled";
1513 if (cmd_ctx
->current_target
== target
->target_number
)
1516 /* keep columns lined up to match the headers above */
1517 command_print(cmd_ctx
, "%2d%c %-18s %-10s %-6s %-18s %s",
1518 target
->target_number
,
1521 target_get_name(target
),
1522 Jim_Nvp_value2name_simple(nvp_target_endian
,
1523 target
->endianness
)->name
,
1524 target
->tap
->dotted_name
,
1526 target
= target
->next
;
1532 /* every 300ms we check for reset & powerdropout and issue a "reset halt" if so. */
1534 static int powerDropout
;
1535 static int srstAsserted
;
1537 static int runPowerRestore
;
1538 static int runPowerDropout
;
1539 static int runSrstAsserted
;
1540 static int runSrstDeasserted
;
1542 static int sense_handler(void)
1544 static int prevSrstAsserted
= 0;
1545 static int prevPowerdropout
= 0;
1548 if ((retval
=jtag_power_dropout(&powerDropout
))!=ERROR_OK
)
1552 powerRestored
= prevPowerdropout
&& !powerDropout
;
1555 runPowerRestore
= 1;
1558 long long current
= timeval_ms();
1559 static long long lastPower
= 0;
1560 int waitMore
= lastPower
+ 2000 > current
;
1561 if (powerDropout
&& !waitMore
)
1563 runPowerDropout
= 1;
1564 lastPower
= current
;
1567 if ((retval
=jtag_srst_asserted(&srstAsserted
))!=ERROR_OK
)
1571 srstDeasserted
= prevSrstAsserted
&& !srstAsserted
;
1573 static long long lastSrst
= 0;
1574 waitMore
= lastSrst
+ 2000 > current
;
1575 if (srstDeasserted
&& !waitMore
)
1577 runSrstDeasserted
= 1;
1581 if (!prevSrstAsserted
&& srstAsserted
)
1583 runSrstAsserted
= 1;
1586 prevSrstAsserted
= srstAsserted
;
1587 prevPowerdropout
= powerDropout
;
1589 if (srstDeasserted
|| powerRestored
)
1591 /* Other than logging the event we can't do anything here.
1592 * Issuing a reset is a particularly bad idea as we might
1593 * be inside a reset already.
1600 /* process target state changes */
1601 int handle_target(void *priv
)
1603 int retval
= ERROR_OK
;
1605 /* we do not want to recurse here... */
1606 static int recursive
= 0;
1611 /* danger! running these procedures can trigger srst assertions and power dropouts.
1612 * We need to avoid an infinite loop/recursion here and we do that by
1613 * clearing the flags after running these events.
1615 int did_something
= 0;
1616 if (runSrstAsserted
)
1618 Jim_Eval( interp
, "srst_asserted");
1621 if (runSrstDeasserted
)
1623 Jim_Eval( interp
, "srst_deasserted");
1626 if (runPowerDropout
)
1628 Jim_Eval( interp
, "power_dropout");
1631 if (runPowerRestore
)
1633 Jim_Eval( interp
, "power_restore");
1639 /* clear detect flags */
1643 /* clear action flags */
1646 runSrstDeasserted
=0;
1653 target_t
*target
= all_targets
;
1658 /* only poll target if we've got power and srst isn't asserted */
1659 if (target_continous_poll
&&!powerDropout
&&!srstAsserted
)
1661 /* polling may fail silently until the target has been examined */
1662 if((retval
= target_poll(target
)) != ERROR_OK
)
1666 target
= target
->next
;
1672 static int handle_reg_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1681 target
= get_current_target(cmd_ctx
);
1683 /* list all available registers for the current target */
1686 reg_cache_t
*cache
= target
->reg_cache
;
1692 for (i
= 0; i
< cache
->num_regs
; i
++)
1694 value
= buf_to_str(cache
->reg_list
[i
].value
, cache
->reg_list
[i
].size
, 16);
1695 command_print(cmd_ctx
, "(%i) %s (/%i): 0x%s (dirty: %i, valid: %i)", count
++, cache
->reg_list
[i
].name
, cache
->reg_list
[i
].size
, value
, cache
->reg_list
[i
].dirty
, cache
->reg_list
[i
].valid
);
1698 cache
= cache
->next
;
1704 /* access a single register by its ordinal number */
1705 if ((args
[0][0] >= '0') && (args
[0][0] <= '9'))
1708 int retval
= parse_uint(args
[0], &num
);
1709 if (ERROR_OK
!= retval
)
1710 return ERROR_COMMAND_SYNTAX_ERROR
;
1712 reg_cache_t
*cache
= target
->reg_cache
;
1717 for (i
= 0; i
< cache
->num_regs
; i
++)
1719 if (count
++ == (int)num
)
1721 reg
= &cache
->reg_list
[i
];
1727 cache
= cache
->next
;
1732 command_print(cmd_ctx
, "%i is out of bounds, the current target has only %i registers (0 - %i)", num
, count
, count
- 1);
1735 } else /* access a single register by its name */
1737 reg
= register_get_by_name(target
->reg_cache
, args
[0], 1);
1741 command_print(cmd_ctx
, "register %s not found in current target", args
[0]);
1746 /* display a register */
1747 if ((argc
== 1) || ((argc
== 2) && !((args
[1][0] >= '0') && (args
[1][0] <= '9'))))
1749 if ((argc
== 2) && (strcmp(args
[1], "force") == 0))
1752 if (reg
->valid
== 0)
1754 reg_arch_type_t
*arch_type
= register_get_arch_type(reg
->arch_type
);
1755 arch_type
->get(reg
);
1757 value
= buf_to_str(reg
->value
, reg
->size
, 16);
1758 command_print(cmd_ctx
, "%s (/%i): 0x%s", reg
->name
, reg
->size
, value
);
1763 /* set register value */
1766 u8
*buf
= malloc(CEIL(reg
->size
, 8));
1767 str_to_buf(args
[1], strlen(args
[1]), buf
, reg
->size
, 0);
1769 reg_arch_type_t
*arch_type
= register_get_arch_type(reg
->arch_type
);
1770 arch_type
->set(reg
, buf
);
1772 value
= buf_to_str(reg
->value
, reg
->size
, 16);
1773 command_print(cmd_ctx
, "%s (/%i): 0x%s", reg
->name
, reg
->size
, value
);
1781 command_print(cmd_ctx
, "usage: reg <#|name> [value]");
1786 static int handle_poll_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1788 int retval
= ERROR_OK
;
1789 target_t
*target
= get_current_target(cmd_ctx
);
1793 command_print(cmd_ctx
, "background polling: %s",
1794 target_continous_poll
? "on" : "off");
1795 if ((retval
= target_poll(target
)) != ERROR_OK
)
1797 if ((retval
= target_arch_state(target
)) != ERROR_OK
)
1803 if (strcmp(args
[0], "on") == 0)
1805 target_continous_poll
= 1;
1807 else if (strcmp(args
[0], "off") == 0)
1809 target_continous_poll
= 0;
1813 command_print(cmd_ctx
, "arg is \"on\" or \"off\"");
1817 return ERROR_COMMAND_SYNTAX_ERROR
;
1823 static int handle_wait_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1826 return ERROR_COMMAND_SYNTAX_ERROR
;
1831 int retval
= parse_uint(args
[0], &ms
);
1832 if (ERROR_OK
!= retval
)
1834 command_print(cmd_ctx
, "usage: %s [seconds]", cmd
);
1835 return ERROR_COMMAND_SYNTAX_ERROR
;
1837 // convert seconds (given) to milliseconds (needed)
1841 target_t
*target
= get_current_target(cmd_ctx
);
1842 return target_wait_state(target
, TARGET_HALTED
, ms
);
1845 /* wait for target state to change. The trick here is to have a low
1846 * latency for short waits and not to suck up all the CPU time
1849 * After 500ms, keep_alive() is invoked
1851 int target_wait_state(target_t
*target
, enum target_state state
, int ms
)
1854 long long then
=0, cur
;
1859 if ((retval
=target_poll(target
))!=ERROR_OK
)
1861 if (target
->state
== state
)
1869 then
= timeval_ms();
1870 LOG_DEBUG("waiting for target %s...",
1871 Jim_Nvp_value2name_simple(nvp_target_state
,state
)->name
);
1881 LOG_ERROR("timed out while waiting for target %s",
1882 Jim_Nvp_value2name_simple(nvp_target_state
,state
)->name
);
1890 static int handle_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1894 target_t
*target
= get_current_target(cmd_ctx
);
1895 int retval
= target_halt(target
);
1896 if (ERROR_OK
!= retval
)
1902 retval
= parse_uint(args
[0], &wait
);
1903 if (ERROR_OK
!= retval
)
1904 return ERROR_COMMAND_SYNTAX_ERROR
;
1909 return handle_wait_halt_command(cmd_ctx
, cmd
, args
, argc
);
1912 static int handle_soft_reset_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1914 target_t
*target
= get_current_target(cmd_ctx
);
1916 LOG_USER("requesting target halt and executing a soft reset");
1918 target
->type
->soft_reset_halt(target
);
1923 static int handle_reset_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1926 return ERROR_COMMAND_SYNTAX_ERROR
;
1928 enum target_reset_mode reset_mode
= RESET_RUN
;
1932 n
= Jim_Nvp_name2value_simple( nvp_reset_modes
, args
[0] );
1933 if( (n
->name
== NULL
) || (n
->value
== RESET_UNKNOWN
) ){
1934 return ERROR_COMMAND_SYNTAX_ERROR
;
1936 reset_mode
= n
->value
;
1939 /* reset *all* targets */
1940 return target_process_reset(cmd_ctx
, reset_mode
);
1944 static int handle_resume_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1947 return ERROR_COMMAND_SYNTAX_ERROR
;
1949 target_t
*target
= get_current_target(cmd_ctx
);
1950 target_handle_event(target
, TARGET_EVENT_OLD_pre_resume
);
1952 /* with no args, resume from current pc, addr = 0,
1953 * with one arguments, addr = args[0],
1954 * handle breakpoints, not debugging */
1958 int retval
= parse_u32(args
[0], &addr
);
1959 if (ERROR_OK
!= retval
)
1963 return target_resume(target
, 0, addr
, 1, 0);
1966 static int handle_step_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1969 return ERROR_COMMAND_SYNTAX_ERROR
;
1973 /* with no args, step from current pc, addr = 0,
1974 * with one argument addr = args[0],
1975 * handle breakpoints, debugging */
1979 int retval
= parse_u32(args
[0], &addr
);
1980 if (ERROR_OK
!= retval
)
1984 target_t
*target
= get_current_target(cmd_ctx
);
1985 return target
->type
->step(target
, 0, addr
, 1);
1988 static void handle_md_output(struct command_context_s
*cmd_ctx
,
1989 struct target_s
*target
, u32 address
, unsigned size
,
1990 unsigned count
, const u8
*buffer
)
1992 const unsigned line_bytecnt
= 32;
1993 unsigned line_modulo
= line_bytecnt
/ size
;
1995 char output
[line_bytecnt
* 4 + 1];
1996 unsigned output_len
= 0;
1998 const char *value_fmt
;
2000 case 4: value_fmt
= "%8.8x "; break;
2001 case 2: value_fmt
= "%4.2x "; break;
2002 case 1: value_fmt
= "%2.2x "; break;
2004 LOG_ERROR("invalid memory read size: %u", size
);
2008 for (unsigned i
= 0; i
< count
; i
++)
2010 if (i
% line_modulo
== 0)
2012 output_len
+= snprintf(output
+ output_len
,
2013 sizeof(output
) - output_len
,
2014 "0x%8.8x: ", address
+ (i
*size
));
2018 const u8
*value_ptr
= buffer
+ i
* size
;
2020 case 4: value
= target_buffer_get_u32(target
, value_ptr
); break;
2021 case 2: value
= target_buffer_get_u16(target
, value_ptr
); break;
2022 case 1: value
= *value_ptr
;
2024 output_len
+= snprintf(output
+ output_len
,
2025 sizeof(output
) - output_len
,
2028 if ((i
% line_modulo
== line_modulo
- 1) || (i
== count
- 1))
2030 command_print(cmd_ctx
, "%s", output
);
2036 static int handle_md_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2039 return ERROR_COMMAND_SYNTAX_ERROR
;
2043 case 'w': size
= 4; break;
2044 case 'h': size
= 2; break;
2045 case 'b': size
= 1; break;
2046 default: return ERROR_COMMAND_SYNTAX_ERROR
;
2050 int retval
= parse_u32(args
[0], &address
);
2051 if (ERROR_OK
!= retval
)
2057 retval
= parse_uint(args
[1], &count
);
2058 if (ERROR_OK
!= retval
)
2062 u8
*buffer
= calloc(count
, size
);
2064 target_t
*target
= get_current_target(cmd_ctx
);
2065 retval
= target_read_memory(target
,
2066 address
, size
, count
, buffer
);
2067 if (ERROR_OK
== retval
)
2068 handle_md_output(cmd_ctx
, target
, address
, size
, count
, buffer
);
2075 static int handle_mw_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2077 if ((argc
< 2) || (argc
> 3))
2078 return ERROR_COMMAND_SYNTAX_ERROR
;
2081 int retval
= parse_u32(args
[0], &address
);
2082 if (ERROR_OK
!= retval
)
2086 retval
= parse_u32(args
[1], &value
);
2087 if (ERROR_OK
!= retval
)
2093 retval
= parse_uint(args
[2], &count
);
2094 if (ERROR_OK
!= retval
)
2098 target_t
*target
= get_current_target(cmd_ctx
);
2105 target_buffer_set_u32(target
, value_buf
, value
);
2109 target_buffer_set_u16(target
, value_buf
, value
);
2113 value_buf
[0] = value
;
2116 return ERROR_COMMAND_SYNTAX_ERROR
;
2118 for (unsigned i
= 0; i
< count
; i
++)
2120 retval
= target_write_memory(target
,
2121 address
+ i
* wordsize
, wordsize
, 1, value_buf
);
2122 if (ERROR_OK
!= retval
)
2131 static int handle_load_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2137 u32 max_address
=0xffffffff;
2139 int retval
, retvaltemp
;
2143 duration_t duration
;
2144 char *duration_text
;
2146 target_t
*target
= get_current_target(cmd_ctx
);
2148 if ((argc
< 1)||(argc
> 5))
2150 return ERROR_COMMAND_SYNTAX_ERROR
;
2153 /* a base address isn't always necessary, default to 0x0 (i.e. don't relocate) */
2157 retval
= parse_u32(args
[1], &addr
);
2158 if (ERROR_OK
!= retval
)
2159 return ERROR_COMMAND_SYNTAX_ERROR
;
2160 image
.base_address
= addr
;
2161 image
.base_address_set
= 1;
2165 image
.base_address_set
= 0;
2169 image
.start_address_set
= 0;
2173 retval
= parse_u32(args
[3], &min_address
);
2174 if (ERROR_OK
!= retval
)
2175 return ERROR_COMMAND_SYNTAX_ERROR
;
2179 retval
= parse_u32(args
[4], &max_address
);
2180 if (ERROR_OK
!= retval
)
2181 return ERROR_COMMAND_SYNTAX_ERROR
;
2182 // use size (given) to find max (required)
2183 max_address
+= min_address
;
2186 if (min_address
>max_address
)
2188 return ERROR_COMMAND_SYNTAX_ERROR
;
2191 duration_start_measure(&duration
);
2193 if (image_open(&image
, args
[0], (argc
>= 3) ? args
[2] : NULL
) != ERROR_OK
)
2200 for (i
= 0; i
< image
.num_sections
; i
++)
2202 buffer
= malloc(image
.sections
[i
].size
);
2205 command_print(cmd_ctx
, "error allocating buffer for section (%d bytes)", image
.sections
[i
].size
);
2209 if ((retval
= image_read_section(&image
, i
, 0x0, image
.sections
[i
].size
, buffer
, &buf_cnt
)) != ERROR_OK
)
2218 /* DANGER!!! beware of unsigned comparision here!!! */
2220 if ((image
.sections
[i
].base_address
+buf_cnt
>=min_address
)&&
2221 (image
.sections
[i
].base_address
<max_address
))
2223 if (image
.sections
[i
].base_address
<min_address
)
2225 /* clip addresses below */
2226 offset
+=min_address
-image
.sections
[i
].base_address
;
2230 if (image
.sections
[i
].base_address
+buf_cnt
>max_address
)
2232 length
-=(image
.sections
[i
].base_address
+buf_cnt
)-max_address
;
2235 if ((retval
= target_write_buffer(target
, image
.sections
[i
].base_address
+offset
, length
, buffer
+offset
)) != ERROR_OK
)
2240 image_size
+= length
;
2241 command_print(cmd_ctx
, "%u byte written at address 0x%8.8x", length
, image
.sections
[i
].base_address
+offset
);
2247 if((retvaltemp
= duration_stop_measure(&duration
, &duration_text
)) != ERROR_OK
)
2249 image_close(&image
);
2253 if (retval
==ERROR_OK
)
2255 command_print(cmd_ctx
, "downloaded %u byte in %s", image_size
, duration_text
);
2257 free(duration_text
);
2259 image_close(&image
);
2265 static int handle_dump_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2272 duration_t duration
;
2273 char *duration_text
;
2275 target_t
*target
= get_current_target(cmd_ctx
);
2279 command_print(cmd_ctx
, "usage: dump_image <filename> <address> <size>");
2284 int retval
= parse_u32(args
[1], &address
);
2285 if (ERROR_OK
!= retval
)
2289 retval
= parse_u32(args
[2], &size
);
2290 if (ERROR_OK
!= retval
)
2293 if (fileio_open(&fileio
, args
[0], FILEIO_WRITE
, FILEIO_BINARY
) != ERROR_OK
)
2298 duration_start_measure(&duration
);
2303 u32 this_run_size
= (size
> 560) ? 560 : size
;
2305 retval
= target_read_buffer(target
, address
, this_run_size
, buffer
);
2306 if (retval
!= ERROR_OK
)
2311 retval
= fileio_write(&fileio
, this_run_size
, buffer
, &size_written
);
2312 if (retval
!= ERROR_OK
)
2317 size
-= this_run_size
;
2318 address
+= this_run_size
;
2321 if((retvaltemp
= fileio_close(&fileio
)) != ERROR_OK
)
2324 if((retvaltemp
= duration_stop_measure(&duration
, &duration_text
)) != ERROR_OK
)
2327 if (retval
==ERROR_OK
)
2329 command_print(cmd_ctx
, "dumped %lld byte in %s",
2330 fileio
.size
, duration_text
);
2331 free(duration_text
);
2337 static int handle_verify_image_command_internal(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
, int verify
)
2343 int retval
, retvaltemp
;
2345 u32 mem_checksum
= 0;
2349 duration_t duration
;
2350 char *duration_text
;
2352 target_t
*target
= get_current_target(cmd_ctx
);
2356 return ERROR_COMMAND_SYNTAX_ERROR
;
2361 LOG_ERROR("no target selected");
2365 duration_start_measure(&duration
);
2370 retval
= parse_u32(args
[1], &addr
);
2371 if (ERROR_OK
!= retval
)
2372 return ERROR_COMMAND_SYNTAX_ERROR
;
2373 image
.base_address
= addr
;
2374 image
.base_address_set
= 1;
2378 image
.base_address_set
= 0;
2379 image
.base_address
= 0x0;
2382 image
.start_address_set
= 0;
2384 if ((retval
=image_open(&image
, args
[0], (argc
== 3) ? args
[2] : NULL
)) != ERROR_OK
)
2391 for (i
= 0; i
< image
.num_sections
; i
++)
2393 buffer
= malloc(image
.sections
[i
].size
);
2396 command_print(cmd_ctx
, "error allocating buffer for section (%d bytes)", image
.sections
[i
].size
);
2399 if ((retval
= image_read_section(&image
, i
, 0x0, image
.sections
[i
].size
, buffer
, &buf_cnt
)) != ERROR_OK
)
2407 /* calculate checksum of image */
2408 image_calculate_checksum( buffer
, buf_cnt
, &checksum
);
2410 retval
= target_checksum_memory(target
, image
.sections
[i
].base_address
, buf_cnt
, &mem_checksum
);
2411 if( retval
!= ERROR_OK
)
2417 if( checksum
!= mem_checksum
)
2419 /* failed crc checksum, fall back to a binary compare */
2422 command_print(cmd_ctx
, "checksum mismatch - attempting binary compare");
2424 data
= (u8
*)malloc(buf_cnt
);
2426 /* Can we use 32bit word accesses? */
2428 int count
= buf_cnt
;
2429 if ((count
% 4) == 0)
2434 retval
= target_read_memory(target
, image
.sections
[i
].base_address
, size
, count
, data
);
2435 if (retval
== ERROR_OK
)
2438 for (t
= 0; t
< buf_cnt
; t
++)
2440 if (data
[t
] != buffer
[t
])
2442 command_print(cmd_ctx
, "Verify operation failed address 0x%08x. Was 0x%02x instead of 0x%02x\n", t
+ image
.sections
[i
].base_address
, data
[t
], buffer
[t
]);
2459 command_print(cmd_ctx
, "address 0x%08x length 0x%08x", image
.sections
[i
].base_address
, buf_cnt
);
2463 image_size
+= buf_cnt
;
2467 if((retvaltemp
= duration_stop_measure(&duration
, &duration_text
)) != ERROR_OK
)
2469 image_close(&image
);
2473 if (retval
==ERROR_OK
)
2475 command_print(cmd_ctx
, "verified %u bytes in %s", image_size
, duration_text
);
2477 free(duration_text
);
2479 image_close(&image
);
2484 static int handle_verify_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2486 return handle_verify_image_command_internal(cmd_ctx
, cmd
, args
, argc
, 1);
2489 static int handle_test_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2491 return handle_verify_image_command_internal(cmd_ctx
, cmd
, args
, argc
, 0);
2494 static int handle_bp_command_list(struct command_context_s
*cmd_ctx
)
2496 target_t
*target
= get_current_target(cmd_ctx
);
2497 breakpoint_t
*breakpoint
= target
->breakpoints
;
2500 if (breakpoint
->type
== BKPT_SOFT
)
2502 char* buf
= buf_to_str(breakpoint
->orig_instr
,
2503 breakpoint
->length
, 16);
2504 command_print(cmd_ctx
, "0x%8.8x, 0x%x, %i, 0x%s",
2505 breakpoint
->address
, breakpoint
->length
,
2506 breakpoint
->set
, buf
);
2511 command_print(cmd_ctx
, "0x%8.8x, 0x%x, %i",
2512 breakpoint
->address
, breakpoint
->length
, breakpoint
->set
);
2515 breakpoint
= breakpoint
->next
;
2520 static int handle_bp_command_set(struct command_context_s
*cmd_ctx
,
2521 u32 addr
, u32 length
, int hw
)
2523 target_t
*target
= get_current_target(cmd_ctx
);
2524 int retval
= breakpoint_add(target
, addr
, length
, hw
);
2525 if (ERROR_OK
== retval
)
2526 command_print(cmd_ctx
, "breakpoint set at 0x%8.8x", addr
);
2528 LOG_ERROR("Failure setting breakpoint");
2532 static int handle_bp_command(struct command_context_s
*cmd_ctx
,
2533 char *cmd
, char **args
, int argc
)
2536 return handle_bp_command_list(cmd_ctx
);
2538 if (argc
< 2 || argc
> 3)
2540 command_print(cmd_ctx
, "usage: bp <address> <length> ['hw']");
2541 return ERROR_COMMAND_SYNTAX_ERROR
;
2545 int retval
= parse_u32(args
[0], &addr
);
2546 if (ERROR_OK
!= retval
)
2550 retval
= parse_u32(args
[1], &length
);
2551 if (ERROR_OK
!= retval
)
2557 if (strcmp(args
[2], "hw") == 0)
2560 return ERROR_COMMAND_SYNTAX_ERROR
;
2563 return handle_bp_command_set(cmd_ctx
, addr
, length
, hw
);
2566 static int handle_rbp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2569 return ERROR_COMMAND_SYNTAX_ERROR
;
2572 int retval
= parse_u32(args
[0], &addr
);
2573 if (ERROR_OK
!= retval
)
2576 target_t
*target
= get_current_target(cmd_ctx
);
2577 breakpoint_remove(target
, addr
);
2582 static int handle_wp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2584 target_t
*target
= get_current_target(cmd_ctx
);
2588 watchpoint_t
*watchpoint
= target
->watchpoints
;
2592 command_print(cmd_ctx
, "address: 0x%8.8x, len: 0x%8.8x, r/w/a: %i, value: 0x%8.8x, mask: 0x%8.8x", watchpoint
->address
, watchpoint
->length
, watchpoint
->rw
, watchpoint
->value
, watchpoint
->mask
);
2593 watchpoint
= watchpoint
->next
;
2598 enum watchpoint_rw type
= WPT_ACCESS
;
2601 u32 data_value
= 0x0;
2602 u32 data_mask
= 0xffffffff;
2608 retval
= parse_u32(args
[4], &data_mask
);
2609 if (ERROR_OK
!= retval
)
2613 retval
= parse_u32(args
[3], &data_value
);
2614 if (ERROR_OK
!= retval
)
2630 LOG_ERROR("invalid watchpoint mode ('%c')", args
[2][0]);
2631 return ERROR_COMMAND_SYNTAX_ERROR
;
2635 retval
= parse_u32(args
[1], &length
);
2636 if (ERROR_OK
!= retval
)
2638 retval
= parse_u32(args
[0], &addr
);
2639 if (ERROR_OK
!= retval
)
2644 command_print(cmd_ctx
, "usage: wp <address> <length> [r/w/a] [value] [mask]");
2645 return ERROR_COMMAND_SYNTAX_ERROR
;
2648 retval
= watchpoint_add(target
, addr
, length
, type
,
2649 data_value
, data_mask
);
2650 if (ERROR_OK
!= retval
)
2651 LOG_ERROR("Failure setting watchpoints");
2656 static int handle_rwp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2659 return ERROR_COMMAND_SYNTAX_ERROR
;
2662 int retval
= parse_u32(args
[0], &addr
);
2663 if (ERROR_OK
!= retval
)
2666 target_t
*target
= get_current_target(cmd_ctx
);
2667 watchpoint_remove(target
, addr
);
2674 * Translate a virtual address to a physical address.
2676 * The low-level target implementation must have logged a detailed error
2677 * which is forwarded to telnet/GDB session.
2679 static int handle_virt2phys_command(command_context_t
*cmd_ctx
,
2680 char *cmd
, char **args
, int argc
)
2683 return ERROR_COMMAND_SYNTAX_ERROR
;
2685 target_t
*target
= get_current_target(cmd_ctx
);
2686 u32 va
= strtoul(args
[0], NULL
, 0);
2689 int retval
= target
->type
->virt2phys(target
, va
, &pa
);
2690 if (retval
== ERROR_OK
)
2691 command_print(cmd_ctx
, "Physical address 0x%08x", pa
);
2696 static void writeData(FILE *f
, const void *data
, size_t len
)
2698 size_t written
= fwrite(data
, 1, len
, f
);
2700 LOG_ERROR("failed to write %zu bytes: %s", len
, strerror(errno
));
2703 static void writeLong(FILE *f
, int l
)
2708 char c
=(l
>>(i
*8))&0xff;
2709 writeData(f
, &c
, 1);
2714 static void writeString(FILE *f
, char *s
)
2716 writeData(f
, s
, strlen(s
));
2719 /* Dump a gmon.out histogram file. */
2720 static void writeGmon(u32
*samples
, u32 sampleNum
, char *filename
)
2723 FILE *f
=fopen(filename
, "w");
2726 writeString(f
, "gmon");
2727 writeLong(f
, 0x00000001); /* Version */
2728 writeLong(f
, 0); /* padding */
2729 writeLong(f
, 0); /* padding */
2730 writeLong(f
, 0); /* padding */
2732 u8 zero
= 0; /* GMON_TAG_TIME_HIST */
2733 writeData(f
, &zero
, 1);
2735 /* figure out bucket size */
2738 for (i
=0; i
<sampleNum
; i
++)
2750 int addressSpace
=(max
-min
+1);
2752 static const u32 maxBuckets
= 256 * 1024; /* maximum buckets. */
2753 u32 length
= addressSpace
;
2754 if (length
> maxBuckets
)
2758 int *buckets
=malloc(sizeof(int)*length
);
2764 memset(buckets
, 0, sizeof(int)*length
);
2765 for (i
=0; i
<sampleNum
;i
++)
2767 u32 address
=samples
[i
];
2768 long long a
=address
-min
;
2769 long long b
=length
-1;
2770 long long c
=addressSpace
-1;
2771 int index
=(a
*b
)/c
; /* danger!!!! int32 overflows */
2775 /* append binary memory gmon.out &profile_hist_hdr ((char*)&profile_hist_hdr + sizeof(struct gmon_hist_hdr)) */
2776 writeLong(f
, min
); /* low_pc */
2777 writeLong(f
, max
); /* high_pc */
2778 writeLong(f
, length
); /* # of samples */
2779 writeLong(f
, 64000000); /* 64MHz */
2780 writeString(f
, "seconds");
2781 for (i
=0; i
<(15-strlen("seconds")); i
++)
2782 writeData(f
, &zero
, 1);
2783 writeString(f
, "s");
2785 /*append binary memory gmon.out profile_hist_data (profile_hist_data + profile_hist_hdr.hist_size) */
2787 char *data
=malloc(2*length
);
2790 for (i
=0; i
<length
;i
++)
2799 data
[i
*2+1]=(val
>>8)&0xff;
2802 writeData(f
, data
, length
* 2);
2812 /* profiling samples the CPU PC as quickly as OpenOCD is able, which will be used as a random sampling of PC */
2813 static int handle_profile_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2815 target_t
*target
= get_current_target(cmd_ctx
);
2816 struct timeval timeout
, now
;
2818 gettimeofday(&timeout
, NULL
);
2821 return ERROR_COMMAND_SYNTAX_ERROR
;
2824 timeval_add_time(&timeout
, strtoul(args
[0], &end
, 0), 0);
2830 command_print(cmd_ctx
, "Starting profiling. Halting and resuming the target as often as we can...");
2832 static const int maxSample
=10000;
2833 u32
*samples
=malloc(sizeof(u32
)*maxSample
);
2838 int retval
=ERROR_OK
;
2839 /* hopefully it is safe to cache! We want to stop/restart as quickly as possible. */
2840 reg_t
*reg
= register_get_by_name(target
->reg_cache
, "pc", 1);
2844 target_poll(target
);
2845 if (target
->state
== TARGET_HALTED
)
2847 u32 t
=*((u32
*)reg
->value
);
2848 samples
[numSamples
++]=t
;
2849 retval
= target_resume(target
, 1, 0, 0, 0); /* current pc, addr = 0, do not handle breakpoints, not debugging */
2850 target_poll(target
);
2851 alive_sleep(10); /* sleep 10ms, i.e. <100 samples/second. */
2852 } else if (target
->state
== TARGET_RUNNING
)
2854 /* We want to quickly sample the PC. */
2855 if((retval
= target_halt(target
)) != ERROR_OK
)
2862 command_print(cmd_ctx
, "Target not halted or running");
2866 if (retval
!=ERROR_OK
)
2871 gettimeofday(&now
, NULL
);
2872 if ((numSamples
>=maxSample
) || ((now
.tv_sec
>= timeout
.tv_sec
) && (now
.tv_usec
>= timeout
.tv_usec
)))
2874 command_print(cmd_ctx
, "Profiling completed. %d samples.", numSamples
);
2875 if((retval
= target_poll(target
)) != ERROR_OK
)
2880 if (target
->state
== TARGET_HALTED
)
2882 target_resume(target
, 1, 0, 0, 0); /* current pc, addr = 0, do not handle breakpoints, not debugging */
2884 if((retval
= target_poll(target
)) != ERROR_OK
)
2889 writeGmon(samples
, numSamples
, args
[1]);
2890 command_print(cmd_ctx
, "Wrote %s", args
[1]);
2899 static int new_int_array_element(Jim_Interp
* interp
, const char *varname
, int idx
, u32 val
)
2902 Jim_Obj
*nameObjPtr
, *valObjPtr
;
2905 namebuf
= alloc_printf("%s(%d)", varname
, idx
);
2909 nameObjPtr
= Jim_NewStringObj(interp
, namebuf
, -1);
2910 valObjPtr
= Jim_NewIntObj(interp
, val
);
2911 if (!nameObjPtr
|| !valObjPtr
)
2917 Jim_IncrRefCount(nameObjPtr
);
2918 Jim_IncrRefCount(valObjPtr
);
2919 result
= Jim_SetVariable(interp
, nameObjPtr
, valObjPtr
);
2920 Jim_DecrRefCount(interp
, nameObjPtr
);
2921 Jim_DecrRefCount(interp
, valObjPtr
);
2923 /* printf("%s(%d) <= 0%08x\n", varname, idx, val); */
2927 static int jim_mem2array(Jim_Interp
*interp
, int argc
, Jim_Obj
*const *argv
)
2929 command_context_t
*context
;
2932 context
= Jim_GetAssocData(interp
, "context");
2933 if (context
== NULL
)
2935 LOG_ERROR("mem2array: no command context");
2938 target
= get_current_target(context
);
2941 LOG_ERROR("mem2array: no current target");
2945 return target_mem2array(interp
, target
, argc
-1, argv
+1);
2948 static int target_mem2array(Jim_Interp
*interp
, target_t
*target
, int argc
, Jim_Obj
*const *argv
)
2956 const char *varname
;
2961 /* argv[1] = name of array to receive the data
2962 * argv[2] = desired width
2963 * argv[3] = memory address
2964 * argv[4] = count of times to read
2967 Jim_WrongNumArgs(interp
, 1, argv
, "varname width addr nelems");
2970 varname
= Jim_GetString(argv
[0], &len
);
2971 /* given "foo" get space for worse case "foo(%d)" .. add 20 */
2973 e
= Jim_GetLong(interp
, argv
[1], &l
);
2979 e
= Jim_GetLong(interp
, argv
[2], &l
);
2984 e
= Jim_GetLong(interp
, argv
[3], &l
);
3000 Jim_SetResult(interp
, Jim_NewEmptyStringObj(interp
));
3001 Jim_AppendStrings( interp
, Jim_GetResult(interp
), "Invalid width param, must be 8/16/32", NULL
);
3005 Jim_SetResult(interp
, Jim_NewEmptyStringObj(interp
));
3006 Jim_AppendStrings(interp
, Jim_GetResult(interp
), "mem2array: zero width read?", NULL
);
3009 if ((addr
+ (len
* width
)) < addr
) {
3010 Jim_SetResult(interp
, Jim_NewEmptyStringObj(interp
));
3011 Jim_AppendStrings(interp
, Jim_GetResult(interp
), "mem2array: addr + len - wraps to zero?", NULL
);
3014 /* absurd transfer size? */
3016 Jim_SetResult(interp
, Jim_NewEmptyStringObj(interp
));
3017 Jim_AppendStrings(interp
, Jim_GetResult(interp
), "mem2array: absurd > 64K item request", NULL
);
3022 ((width
== 2) && ((addr
& 1) == 0)) ||
3023 ((width
== 4) && ((addr
& 3) == 0))) {
3027 Jim_SetResult(interp
, Jim_NewEmptyStringObj(interp
));
3028 sprintf(buf
, "mem2array address: 0x%08x is not aligned for %d byte reads", addr
, width
);
3029 Jim_AppendStrings(interp
, Jim_GetResult(interp
), buf
, NULL
);
3040 /* Slurp... in buffer size chunks */
3042 count
= len
; /* in objects.. */
3043 if (count
> (sizeof(buffer
)/width
)) {
3044 count
= (sizeof(buffer
)/width
);
3047 retval
= target_read_memory( target
, addr
, width
, count
, buffer
);
3048 if (retval
!= ERROR_OK
) {
3050 LOG_ERROR("mem2array: Read @ 0x%08x, w=%d, cnt=%d, failed", addr
, width
, count
);
3051 Jim_SetResult(interp
, Jim_NewEmptyStringObj(interp
));
3052 Jim_AppendStrings(interp
, Jim_GetResult(interp
), "mem2array: cannot read memory", NULL
);
3056 v
= 0; /* shut up gcc */
3057 for (i
= 0 ;i
< count
;i
++, n
++) {
3060 v
= target_buffer_get_u32(target
, &buffer
[i
*width
]);
3063 v
= target_buffer_get_u16(target
, &buffer
[i
*width
]);
3066 v
= buffer
[i
] & 0x0ff;
3069 new_int_array_element(interp
, varname
, n
, v
);
3075 Jim_SetResult(interp
, Jim_NewEmptyStringObj(interp
));
3080 static int get_int_array_element(Jim_Interp
* interp
, const char *varname
, int idx
, u32
*val
)
3083 Jim_Obj
*nameObjPtr
, *valObjPtr
;
3087 namebuf
= alloc_printf("%s(%d)", varname
, idx
);
3091 nameObjPtr
= Jim_NewStringObj(interp
, namebuf
, -1);
3098 Jim_IncrRefCount(nameObjPtr
);
3099 valObjPtr
= Jim_GetVariable(interp
, nameObjPtr
, JIM_ERRMSG
);
3100 Jim_DecrRefCount(interp
, nameObjPtr
);
3102 if (valObjPtr
== NULL
)
3105 result
= Jim_GetLong(interp
, valObjPtr
, &l
);
3106 /* printf("%s(%d) => 0%08x\n", varname, idx, val); */
3111 static int jim_array2mem(Jim_Interp
*interp
, int argc
, Jim_Obj
*const *argv
)
3113 command_context_t
*context
;
3116 context
= Jim_GetAssocData(interp
, "context");
3117 if (context
== NULL
){
3118 LOG_ERROR("array2mem: no command context");
3121 target
= get_current_target(context
);
3122 if (target
== NULL
){
3123 LOG_ERROR("array2mem: no current target");
3127 return target_array2mem( interp
,target
, argc
-1, argv
+1 );
3130 static int target_array2mem(Jim_Interp
*interp
, target_t
*target
, int argc
, Jim_Obj
*const *argv
)
3138 const char *varname
;
3143 /* argv[1] = name of array to get the data
3144 * argv[2] = desired width
3145 * argv[3] = memory address
3146 * argv[4] = count to write
3149 Jim_WrongNumArgs(interp
, 1, argv
, "varname width addr nelems");
3152 varname
= Jim_GetString(argv
[0], &len
);
3153 /* given "foo" get space for worse case "foo(%d)" .. add 20 */
3155 e
= Jim_GetLong(interp
, argv
[1], &l
);
3161 e
= Jim_GetLong(interp
, argv
[2], &l
);
3166 e
= Jim_GetLong(interp
, argv
[3], &l
);
3182 Jim_SetResult(interp
, Jim_NewEmptyStringObj(interp
));
3183 Jim_AppendStrings( interp
, Jim_GetResult(interp
), "Invalid width param, must be 8/16/32", NULL
);
3187 Jim_SetResult(interp
, Jim_NewEmptyStringObj(interp
));
3188 Jim_AppendStrings(interp
, Jim_GetResult(interp
), "array2mem: zero width read?", NULL
);
3191 if ((addr
+ (len
* width
)) < addr
) {
3192 Jim_SetResult(interp
, Jim_NewEmptyStringObj(interp
));
3193 Jim_AppendStrings(interp
, Jim_GetResult(interp
), "array2mem: addr + len - wraps to zero?", NULL
);
3196 /* absurd transfer size? */
3198 Jim_SetResult(interp
, Jim_NewEmptyStringObj(interp
));
3199 Jim_AppendStrings(interp
, Jim_GetResult(interp
), "array2mem: absurd > 64K item request", NULL
);
3204 ((width
== 2) && ((addr
& 1) == 0)) ||
3205 ((width
== 4) && ((addr
& 3) == 0))) {
3209 Jim_SetResult(interp
, Jim_NewEmptyStringObj(interp
));
3210 sprintf(buf
, "array2mem address: 0x%08x is not aligned for %d byte reads", addr
, width
);
3211 Jim_AppendStrings(interp
, Jim_GetResult(interp
), buf
, NULL
);
3222 /* Slurp... in buffer size chunks */
3224 count
= len
; /* in objects.. */
3225 if (count
> (sizeof(buffer
)/width
)) {
3226 count
= (sizeof(buffer
)/width
);
3229 v
= 0; /* shut up gcc */
3230 for (i
= 0 ;i
< count
;i
++, n
++) {
3231 get_int_array_element(interp
, varname
, n
, &v
);
3234 target_buffer_set_u32(target
, &buffer
[i
*width
], v
);
3237 target_buffer_set_u16(target
, &buffer
[i
*width
], v
);
3240 buffer
[i
] = v
& 0x0ff;
3246 retval
= target_write_memory(target
, addr
, width
, count
, buffer
);
3247 if (retval
!= ERROR_OK
) {
3249 LOG_ERROR("array2mem: Write @ 0x%08x, w=%d, cnt=%d, failed", addr
, width
, count
);
3250 Jim_SetResult(interp
, Jim_NewEmptyStringObj(interp
));
3251 Jim_AppendStrings(interp
, Jim_GetResult(interp
), "array2mem: cannot read memory", NULL
);
3257 Jim_SetResult(interp
, Jim_NewEmptyStringObj(interp
));
3262 void target_all_handle_event( enum target_event e
)
3266 LOG_DEBUG( "**all*targets: event: %d, %s",
3268 Jim_Nvp_value2name_simple( nvp_target_event
, e
)->name
);
3270 target
= all_targets
;
3272 target_handle_event( target
, e
);
3273 target
= target
->next
;
3277 void target_handle_event( target_t
*target
, enum target_event e
)
3279 target_event_action_t
*teap
;
3282 teap
= target
->event_action
;
3286 if( teap
->event
== e
){
3288 LOG_DEBUG( "target: (%d) %s (%s) event: %d (%s) action: %s\n",
3289 target
->target_number
,
3291 target_get_name(target
),
3293 Jim_Nvp_value2name_simple( nvp_target_event
, e
)->name
,
3294 Jim_GetString( teap
->body
, NULL
) );
3295 if (Jim_EvalObj( interp
, teap
->body
)!=JIM_OK
)
3297 Jim_PrintErrorMessage(interp
);
3303 LOG_DEBUG( "event: %d %s - no action",
3305 Jim_Nvp_value2name_simple( nvp_target_event
, e
)->name
);
3309 enum target_cfg_param
{
3312 TCFG_WORK_AREA_VIRT
,
3313 TCFG_WORK_AREA_PHYS
,
3314 TCFG_WORK_AREA_SIZE
,
3315 TCFG_WORK_AREA_BACKUP
,
3318 TCFG_CHAIN_POSITION
,
3321 static Jim_Nvp nvp_config_opts
[] = {
3322 { .name
= "-type", .value
= TCFG_TYPE
},
3323 { .name
= "-event", .value
= TCFG_EVENT
},
3324 { .name
= "-work-area-virt", .value
= TCFG_WORK_AREA_VIRT
},
3325 { .name
= "-work-area-phys", .value
= TCFG_WORK_AREA_PHYS
},
3326 { .name
= "-work-area-size", .value
= TCFG_WORK_AREA_SIZE
},
3327 { .name
= "-work-area-backup", .value
= TCFG_WORK_AREA_BACKUP
},
3328 { .name
= "-endian" , .value
= TCFG_ENDIAN
},
3329 { .name
= "-variant", .value
= TCFG_VARIANT
},
3330 { .name
= "-chain-position", .value
= TCFG_CHAIN_POSITION
},
3332 { .name
= NULL
, .value
= -1 }
3335 static int target_configure( Jim_GetOptInfo
*goi
, target_t
*target
)
3343 /* parse config or cget options ... */
3344 while( goi
->argc
> 0 ){
3345 Jim_SetEmptyResult( goi
->interp
);
3346 /* Jim_GetOpt_Debug( goi ); */
3348 if( target
->type
->target_jim_configure
){
3349 /* target defines a configure function */
3350 /* target gets first dibs on parameters */
3351 e
= (*(target
->type
->target_jim_configure
))( target
, goi
);
3360 /* otherwise we 'continue' below */
3362 e
= Jim_GetOpt_Nvp( goi
, nvp_config_opts
, &n
);
3364 Jim_GetOpt_NvpUnknown( goi
, nvp_config_opts
, 0 );
3370 if( goi
->isconfigure
){
3371 Jim_SetResult_sprintf( goi
->interp
, "not setable: %s", n
->name
);
3375 if( goi
->argc
!= 0 ){
3376 Jim_WrongNumArgs( goi
->interp
, goi
->argc
, goi
->argv
, "NO PARAMS");
3380 Jim_SetResultString( goi
->interp
, target_get_name(target
), -1 );
3384 if( goi
->argc
== 0 ){
3385 Jim_WrongNumArgs( goi
->interp
, goi
->argc
, goi
->argv
, "-event ?event-name? ...");
3389 e
= Jim_GetOpt_Nvp( goi
, nvp_target_event
, &n
);
3391 Jim_GetOpt_NvpUnknown( goi
, nvp_target_event
, 1 );
3395 if( goi
->isconfigure
){
3396 if( goi
->argc
!= 1 ){
3397 Jim_WrongNumArgs( goi
->interp
, goi
->argc
, goi
->argv
, "-event ?event-name? ?EVENT-BODY?");
3401 if( goi
->argc
!= 0 ){
3402 Jim_WrongNumArgs(goi
->interp
, goi
->argc
, goi
->argv
, "-event ?event-name?");
3408 target_event_action_t
*teap
;
3410 teap
= target
->event_action
;
3411 /* replace existing? */
3413 if( teap
->event
== (enum target_event
)n
->value
){
3419 if( goi
->isconfigure
){
3422 teap
= calloc( 1, sizeof(*teap
) );
3424 teap
->event
= n
->value
;
3425 Jim_GetOpt_Obj( goi
, &o
);
3427 Jim_DecrRefCount( interp
, teap
->body
);
3429 teap
->body
= Jim_DuplicateObj( goi
->interp
, o
);
3432 * Tcl/TK - "tk events" have a nice feature.
3433 * See the "BIND" command.
3434 * We should support that here.
3435 * You can specify %X and %Y in the event code.
3436 * The idea is: %T - target name.
3437 * The idea is: %N - target number
3438 * The idea is: %E - event name.
3440 Jim_IncrRefCount( teap
->body
);
3442 /* add to head of event list */
3443 teap
->next
= target
->event_action
;
3444 target
->event_action
= teap
;
3445 Jim_SetEmptyResult(goi
->interp
);
3449 Jim_SetEmptyResult( goi
->interp
);
3451 Jim_SetResult( goi
->interp
, Jim_DuplicateObj( goi
->interp
, teap
->body
) );
3458 case TCFG_WORK_AREA_VIRT
:
3459 if( goi
->isconfigure
){
3460 target_free_all_working_areas(target
);
3461 e
= Jim_GetOpt_Wide( goi
, &w
);
3465 target
->working_area_virt
= w
;
3467 if( goi
->argc
!= 0 ){
3471 Jim_SetResult( interp
, Jim_NewIntObj( goi
->interp
, target
->working_area_virt
) );
3475 case TCFG_WORK_AREA_PHYS
:
3476 if( goi
->isconfigure
){
3477 target_free_all_working_areas(target
);
3478 e
= Jim_GetOpt_Wide( goi
, &w
);
3482 target
->working_area_phys
= w
;
3484 if( goi
->argc
!= 0 ){
3488 Jim_SetResult( interp
, Jim_NewIntObj( goi
->interp
, target
->working_area_phys
) );
3492 case TCFG_WORK_AREA_SIZE
:
3493 if( goi
->isconfigure
){
3494 target_free_all_working_areas(target
);
3495 e
= Jim_GetOpt_Wide( goi
, &w
);
3499 target
->working_area_size
= w
;
3501 if( goi
->argc
!= 0 ){
3505 Jim_SetResult( interp
, Jim_NewIntObj( goi
->interp
, target
->working_area_size
) );
3509 case TCFG_WORK_AREA_BACKUP
:
3510 if( goi
->isconfigure
){
3511 target_free_all_working_areas(target
);
3512 e
= Jim_GetOpt_Wide( goi
, &w
);
3516 /* make this exactly 1 or 0 */
3517 target
->backup_working_area
= (!!w
);
3519 if( goi
->argc
!= 0 ){
3523 Jim_SetResult(interp
, Jim_NewIntObj(goi
->interp
, target
->backup_working_area
));
3524 /* loop for more e*/
3528 if( goi
->isconfigure
){
3529 e
= Jim_GetOpt_Nvp( goi
, nvp_target_endian
, &n
);
3531 Jim_GetOpt_NvpUnknown( goi
, nvp_target_endian
, 1 );
3534 target
->endianness
= n
->value
;
3536 if( goi
->argc
!= 0 ){
3540 n
= Jim_Nvp_value2name_simple( nvp_target_endian
, target
->endianness
);
3541 if( n
->name
== NULL
){
3542 target
->endianness
= TARGET_LITTLE_ENDIAN
;
3543 n
= Jim_Nvp_value2name_simple( nvp_target_endian
, target
->endianness
);
3545 Jim_SetResultString( goi
->interp
, n
->name
, -1 );
3550 if( goi
->isconfigure
){
3551 if( goi
->argc
< 1 ){
3552 Jim_SetResult_sprintf( goi
->interp
,
3557 if( target
->variant
){
3558 free((void *)(target
->variant
));
3560 e
= Jim_GetOpt_String( goi
, &cp
, NULL
);
3561 target
->variant
= strdup(cp
);
3563 if( goi
->argc
!= 0 ){
3567 Jim_SetResultString( goi
->interp
, target
->variant
,-1 );
3570 case TCFG_CHAIN_POSITION
:
3571 if( goi
->isconfigure
){
3574 target_free_all_working_areas(target
);
3575 e
= Jim_GetOpt_Obj( goi
, &o
);
3579 tap
= jtag_tap_by_jim_obj( goi
->interp
, o
);
3583 /* make this exactly 1 or 0 */
3586 if( goi
->argc
!= 0 ){
3590 Jim_SetResultString( interp
, target
->tap
->dotted_name
, -1 );
3591 /* loop for more e*/
3594 } /* while( goi->argc ) */
3597 /* done - we return */
3601 /** this is the 'tcl' handler for the target specific command */
3602 static int tcl_target_func( Jim_Interp
*interp
, int argc
, Jim_Obj
*const *argv
)
3610 struct command_context_s
*cmd_ctx
;
3617 TS_CMD_MWW
, TS_CMD_MWH
, TS_CMD_MWB
,
3618 TS_CMD_MDW
, TS_CMD_MDH
, TS_CMD_MDB
,
3619 TS_CMD_MRW
, TS_CMD_MRH
, TS_CMD_MRB
,
3620 TS_CMD_MEM2ARRAY
, TS_CMD_ARRAY2MEM
,
3628 TS_CMD_INVOKE_EVENT
,
3631 static const Jim_Nvp target_options
[] = {
3632 { .name
= "configure", .value
= TS_CMD_CONFIGURE
},
3633 { .name
= "cget", .value
= TS_CMD_CGET
},
3634 { .name
= "mww", .value
= TS_CMD_MWW
},
3635 { .name
= "mwh", .value
= TS_CMD_MWH
},
3636 { .name
= "mwb", .value
= TS_CMD_MWB
},
3637 { .name
= "mdw", .value
= TS_CMD_MDW
},
3638 { .name
= "mdh", .value
= TS_CMD_MDH
},
3639 { .name
= "mdb", .value
= TS_CMD_MDB
},
3640 { .name
= "mem2array", .value
= TS_CMD_MEM2ARRAY
},
3641 { .name
= "array2mem", .value
= TS_CMD_ARRAY2MEM
},
3642 { .name
= "eventlist", .value
= TS_CMD_EVENTLIST
},
3643 { .name
= "curstate", .value
= TS_CMD_CURSTATE
},
3645 { .name
= "arp_examine", .value
= TS_CMD_EXAMINE
},
3646 { .name
= "arp_poll", .value
= TS_CMD_POLL
},
3647 { .name
= "arp_reset", .value
= TS_CMD_RESET
},
3648 { .name
= "arp_halt", .value
= TS_CMD_HALT
},
3649 { .name
= "arp_waitstate", .value
= TS_CMD_WAITSTATE
},
3650 { .name
= "invoke-event", .value
= TS_CMD_INVOKE_EVENT
},
3652 { .name
= NULL
, .value
= -1 },
3655 /* go past the "command" */
3656 Jim_GetOpt_Setup( &goi
, interp
, argc
-1, argv
+1 );
3658 target
= Jim_CmdPrivData( goi
.interp
);
3659 cmd_ctx
= Jim_GetAssocData(goi
.interp
, "context");
3661 /* commands here are in an NVP table */
3662 e
= Jim_GetOpt_Nvp( &goi
, target_options
, &n
);
3664 Jim_GetOpt_NvpUnknown( &goi
, target_options
, 0 );
3667 /* Assume blank result */
3668 Jim_SetEmptyResult( goi
.interp
);
3671 case TS_CMD_CONFIGURE
:
3673 Jim_WrongNumArgs( goi
.interp
, goi
.argc
, goi
.argv
, "missing: -option VALUE ...");
3676 goi
.isconfigure
= 1;
3677 return target_configure( &goi
, target
);
3679 // some things take params
3681 Jim_WrongNumArgs( goi
.interp
, 0, goi
.argv
, "missing: ?-option?");
3684 goi
.isconfigure
= 0;
3685 return target_configure( &goi
, target
);
3693 * argv[3] = optional count.
3696 if( (goi
.argc
== 3) || (goi
.argc
== 4) ){
3700 Jim_SetResult_sprintf( goi
.interp
, "expected: %s ADDR DATA [COUNT]", n
->name
);
3704 e
= Jim_GetOpt_Wide( &goi
, &a
);
3709 e
= Jim_GetOpt_Wide( &goi
, &b
);
3714 e
= Jim_GetOpt_Wide( &goi
, &c
);
3724 target_buffer_set_u32( target
, target_buf
, b
);
3728 target_buffer_set_u16( target
, target_buf
, b
);
3732 target_buffer_set_u8( target
, target_buf
, b
);
3736 for( x
= 0 ; x
< c
; x
++ ){
3737 e
= target_write_memory( target
, a
, b
, 1, target_buf
);
3738 if( e
!= ERROR_OK
){
3739 Jim_SetResult_sprintf( interp
, "Error writing @ 0x%08x: %d\n", (int)(a
), e
);
3752 /* argv[0] = command
3754 * argv[2] = optional count
3756 if( (goi
.argc
== 2) || (goi
.argc
== 3) ){
3757 Jim_SetResult_sprintf( goi
.interp
, "expected: %s ADDR [COUNT]", n
->name
);
3760 e
= Jim_GetOpt_Wide( &goi
, &a
);
3765 e
= Jim_GetOpt_Wide( &goi
, &c
);
3772 b
= 1; /* shut up gcc */
3785 /* convert to "bytes" */
3787 /* count is now in 'BYTES' */
3793 e
= target_read_memory( target
, a
, b
, y
/ b
, target_buf
);
3794 if( e
!= ERROR_OK
){
3795 Jim_SetResult_sprintf( interp
, "error reading target @ 0x%08lx", (int)(a
) );
3799 Jim_fprintf( interp
, interp
->cookie_stdout
, "0x%08x ", (int)(a
) );
3802 for( x
= 0 ; (x
< 16) && (x
< y
) ; x
+= 4 ){
3803 z
= target_buffer_get_u32( target
, &(target_buf
[ x
* 4 ]) );
3804 Jim_fprintf( interp
, interp
->cookie_stdout
, "%08x ", (int)(z
) );
3806 for( ; (x
< 16) ; x
+= 4 ){
3807 Jim_fprintf( interp
, interp
->cookie_stdout
, " " );
3811 for( x
= 0 ; (x
< 16) && (x
< y
) ; x
+= 2 ){
3812 z
= target_buffer_get_u16( target
, &(target_buf
[ x
* 2 ]) );
3813 Jim_fprintf( interp
, interp
->cookie_stdout
, "%04x ", (int)(z
) );
3815 for( ; (x
< 16) ; x
+= 2 ){
3816 Jim_fprintf( interp
, interp
->cookie_stdout
, " " );
3821 for( x
= 0 ; (x
< 16) && (x
< y
) ; x
+= 1 ){
3822 z
= target_buffer_get_u8( target
, &(target_buf
[ x
* 4 ]) );
3823 Jim_fprintf( interp
, interp
->cookie_stdout
, "%02x ", (int)(z
) );
3825 for( ; (x
< 16) ; x
+= 1 ){
3826 Jim_fprintf( interp
, interp
->cookie_stdout
, " " );
3830 /* ascii-ify the bytes */
3831 for( x
= 0 ; x
< y
; x
++ ){
3832 if( (target_buf
[x
] >= 0x20) &&
3833 (target_buf
[x
] <= 0x7e) ){
3837 target_buf
[x
] = '.';
3842 target_buf
[x
] = ' ';
3847 /* print - with a newline */
3848 Jim_fprintf( interp
, interp
->cookie_stdout
, "%s\n", target_buf
);
3854 case TS_CMD_MEM2ARRAY
:
3855 return target_mem2array( goi
.interp
, target
, goi
.argc
, goi
.argv
);
3857 case TS_CMD_ARRAY2MEM
:
3858 return target_array2mem( goi
.interp
, target
, goi
.argc
, goi
.argv
);
3860 case TS_CMD_EXAMINE
:
3862 Jim_WrongNumArgs( goi
.interp
, 2, argv
, "[no parameters]");
3865 if (!target
->tap
->enabled
)
3866 goto err_tap_disabled
;
3867 e
= target
->type
->examine( target
);
3868 if( e
!= ERROR_OK
){
3869 Jim_SetResult_sprintf( interp
, "examine-fails: %d", e
);
3875 Jim_WrongNumArgs( goi
.interp
, 2, argv
, "[no parameters]");
3878 if (!target
->tap
->enabled
)
3879 goto err_tap_disabled
;
3880 if( !(target_was_examined(target
)) ){
3881 e
= ERROR_TARGET_NOT_EXAMINED
;
3883 e
= target
->type
->poll( target
);
3885 if( e
!= ERROR_OK
){
3886 Jim_SetResult_sprintf( interp
, "poll-fails: %d", e
);
3893 if( goi
.argc
!= 2 ){
3894 Jim_WrongNumArgs( interp
, 2, argv
, "t|f|assert|deassert BOOL");
3897 e
= Jim_GetOpt_Nvp( &goi
, nvp_assert
, &n
);
3899 Jim_GetOpt_NvpUnknown( &goi
, nvp_assert
, 1 );
3902 /* the halt or not param */
3903 e
= Jim_GetOpt_Wide( &goi
, &a
);
3907 if (!target
->tap
->enabled
)
3908 goto err_tap_disabled
;
3909 /* determine if we should halt or not. */
3910 target
->reset_halt
= !!a
;
3911 /* When this happens - all workareas are invalid. */
3912 target_free_all_working_areas_restore(target
, 0);
3915 if( n
->value
== NVP_ASSERT
){
3916 target
->type
->assert_reset( target
);
3918 target
->type
->deassert_reset( target
);
3923 Jim_WrongNumArgs( goi
.interp
, 0, argv
, "halt [no parameters]");
3926 if (!target
->tap
->enabled
)
3927 goto err_tap_disabled
;
3928 target
->type
->halt( target
);
3930 case TS_CMD_WAITSTATE
:
3931 /* params: <name> statename timeoutmsecs */
3932 if( goi
.argc
!= 2 ){
3933 Jim_SetResult_sprintf( goi
.interp
, "%s STATENAME TIMEOUTMSECS", n
->name
);
3936 e
= Jim_GetOpt_Nvp( &goi
, nvp_target_state
, &n
);
3938 Jim_GetOpt_NvpUnknown( &goi
, nvp_target_state
,1 );
3941 e
= Jim_GetOpt_Wide( &goi
, &a
);
3945 if (!target
->tap
->enabled
)
3946 goto err_tap_disabled
;
3947 e
= target_wait_state( target
, n
->value
, a
);
3948 if( e
!= ERROR_OK
){
3949 Jim_SetResult_sprintf( goi
.interp
,
3950 "target: %s wait %s fails (%d) %s",
3953 e
, target_strerror_safe(e
) );
3958 case TS_CMD_EVENTLIST
:
3959 /* List for human, Events defined for this target.
3960 * scripts/programs should use 'name cget -event NAME'
3963 target_event_action_t
*teap
;
3964 teap
= target
->event_action
;
3965 command_print( cmd_ctx
, "Event actions for target (%d) %s\n",
3966 target
->target_number
,
3968 command_print( cmd_ctx
, "%-25s | Body", "Event");
3969 command_print( cmd_ctx
, "------------------------- | ----------------------------------------");
3971 command_print( cmd_ctx
,
3973 Jim_Nvp_value2name_simple( nvp_target_event
, teap
->event
)->name
,
3974 Jim_GetString( teap
->body
, NULL
) );
3977 command_print( cmd_ctx
, "***END***");
3980 case TS_CMD_CURSTATE
:
3981 if( goi
.argc
!= 0 ){
3982 Jim_WrongNumArgs( goi
.interp
, 0, argv
, "[no parameters]");
3985 Jim_SetResultString( goi
.interp
,
3986 Jim_Nvp_value2name_simple(nvp_target_state
,target
->state
)->name
,-1);
3988 case TS_CMD_INVOKE_EVENT
:
3989 if( goi
.argc
!= 1 ){
3990 Jim_SetResult_sprintf( goi
.interp
, "%s ?EVENTNAME?",n
->name
);
3993 e
= Jim_GetOpt_Nvp( &goi
, nvp_target_event
, &n
);
3995 Jim_GetOpt_NvpUnknown( &goi
, nvp_target_event
, 1 );
3998 target_handle_event( target
, n
->value
);
4004 Jim_SetResult_sprintf(interp
, "[TAP is disabled]");
4008 static int target_create( Jim_GetOptInfo
*goi
)
4017 struct command_context_s
*cmd_ctx
;
4019 cmd_ctx
= Jim_GetAssocData(goi
->interp
, "context");
4020 if( goi
->argc
< 3 ){
4021 Jim_WrongNumArgs( goi
->interp
, 1, goi
->argv
, "?name? ?type? ..options...");
4026 Jim_GetOpt_Obj( goi
, &new_cmd
);
4027 /* does this command exist? */
4028 cmd
= Jim_GetCommand( goi
->interp
, new_cmd
, JIM_ERRMSG
);
4030 cp
= Jim_GetString( new_cmd
, NULL
);
4031 Jim_SetResult_sprintf(goi
->interp
, "Command/target: %s Exists", cp
);
4036 e
= Jim_GetOpt_String( goi
, &cp2
, NULL
);
4038 /* now does target type exist */
4039 for( x
= 0 ; target_types
[x
] ; x
++ ){
4040 if( 0 == strcmp( cp
, target_types
[x
]->name
) ){
4045 if( target_types
[x
] == NULL
){
4046 Jim_SetResult_sprintf( goi
->interp
, "Unknown target type %s, try one of ", cp
);
4047 for( x
= 0 ; target_types
[x
] ; x
++ ){
4048 if( target_types
[x
+1] ){
4049 Jim_AppendStrings( goi
->interp
,
4050 Jim_GetResult(goi
->interp
),
4051 target_types
[x
]->name
,
4054 Jim_AppendStrings( goi
->interp
,
4055 Jim_GetResult(goi
->interp
),
4057 target_types
[x
]->name
,NULL
);
4064 target
= calloc(1,sizeof(target_t
));
4065 /* set target number */
4066 target
->target_number
= new_target_number();
4068 /* allocate memory for each unique target type */
4069 target
->type
= (target_type_t
*)calloc(1,sizeof(target_type_t
));
4071 memcpy( target
->type
, target_types
[x
], sizeof(target_type_t
));
4073 /* will be set by "-endian" */
4074 target
->endianness
= TARGET_ENDIAN_UNKNOWN
;
4076 target
->working_area
= 0x0;
4077 target
->working_area_size
= 0x0;
4078 target
->working_areas
= NULL
;
4079 target
->backup_working_area
= 0;
4081 target
->state
= TARGET_UNKNOWN
;
4082 target
->debug_reason
= DBG_REASON_UNDEFINED
;
4083 target
->reg_cache
= NULL
;
4084 target
->breakpoints
= NULL
;
4085 target
->watchpoints
= NULL
;
4086 target
->next
= NULL
;
4087 target
->arch_info
= NULL
;
4089 target
->display
= 1;
4091 /* initialize trace information */
4092 target
->trace_info
= malloc(sizeof(trace_t
));
4093 target
->trace_info
->num_trace_points
= 0;
4094 target
->trace_info
->trace_points_size
= 0;
4095 target
->trace_info
->trace_points
= NULL
;
4096 target
->trace_info
->trace_history_size
= 0;
4097 target
->trace_info
->trace_history
= NULL
;
4098 target
->trace_info
->trace_history_pos
= 0;
4099 target
->trace_info
->trace_history_overflowed
= 0;
4101 target
->dbgmsg
= NULL
;
4102 target
->dbg_msg_enabled
= 0;
4104 target
->endianness
= TARGET_ENDIAN_UNKNOWN
;
4106 /* Do the rest as "configure" options */
4107 goi
->isconfigure
= 1;
4108 e
= target_configure( goi
, target
);
4110 if (target
->tap
== NULL
)
4112 Jim_SetResultString( interp
, "-chain-position required when creating target", -1);
4117 free( target
->type
);
4122 if( target
->endianness
== TARGET_ENDIAN_UNKNOWN
){
4123 /* default endian to little if not specified */
4124 target
->endianness
= TARGET_LITTLE_ENDIAN
;
4127 /* incase variant is not set */
4128 if (!target
->variant
)
4129 target
->variant
= strdup("");
4131 /* create the target specific commands */
4132 if( target
->type
->register_commands
){
4133 (*(target
->type
->register_commands
))( cmd_ctx
);
4135 if( target
->type
->target_create
){
4136 (*(target
->type
->target_create
))( target
, goi
->interp
);
4139 /* append to end of list */
4142 tpp
= &(all_targets
);
4144 tpp
= &( (*tpp
)->next
);
4149 cp
= Jim_GetString( new_cmd
, NULL
);
4150 target
->cmd_name
= strdup(cp
);
4152 /* now - create the new target name command */
4153 e
= Jim_CreateCommand( goi
->interp
,
4156 tcl_target_func
, /* C function */
4157 target
, /* private data */
4158 NULL
); /* no del proc */
4163 static int jim_target( Jim_Interp
*interp
, int argc
, Jim_Obj
*const *argv
)
4167 struct command_context_s
*cmd_ctx
;
4171 /* TG = target generic */
4179 const char *target_cmds
[] = {
4180 "create", "types", "names", "current", "number",
4182 NULL
/* terminate */
4185 LOG_DEBUG("Target command params:");
4186 LOG_DEBUG("%s", Jim_Debug_ArgvString(interp
, argc
, argv
));
4188 cmd_ctx
= Jim_GetAssocData( interp
, "context" );
4190 Jim_GetOpt_Setup( &goi
, interp
, argc
-1, argv
+1 );
4192 if( goi
.argc
== 0 ){
4193 Jim_WrongNumArgs(interp
, 1, argv
, "missing: command ...");
4197 /* Jim_GetOpt_Debug( &goi ); */
4198 r
= Jim_GetOpt_Enum( &goi
, target_cmds
, &x
);
4205 Jim_Panic(goi
.interp
,"Why am I here?");
4207 case TG_CMD_CURRENT
:
4208 if( goi
.argc
!= 0 ){
4209 Jim_WrongNumArgs( goi
.interp
, 1, goi
.argv
, "Too many parameters");
4212 Jim_SetResultString( goi
.interp
, get_current_target( cmd_ctx
)->cmd_name
, -1 );
4215 if( goi
.argc
!= 0 ){
4216 Jim_WrongNumArgs( goi
.interp
, 1, goi
.argv
, "Too many parameters" );
4219 Jim_SetResult( goi
.interp
, Jim_NewListObj( goi
.interp
, NULL
, 0 ) );
4220 for( x
= 0 ; target_types
[x
] ; x
++ ){
4221 Jim_ListAppendElement( goi
.interp
,
4222 Jim_GetResult(goi
.interp
),
4223 Jim_NewStringObj( goi
.interp
, target_types
[x
]->name
, -1 ) );
4227 if( goi
.argc
!= 0 ){
4228 Jim_WrongNumArgs( goi
.interp
, 1, goi
.argv
, "Too many parameters" );
4231 Jim_SetResult( goi
.interp
, Jim_NewListObj( goi
.interp
, NULL
, 0 ) );
4232 target
= all_targets
;
4234 Jim_ListAppendElement( goi
.interp
,
4235 Jim_GetResult(goi
.interp
),
4236 Jim_NewStringObj( goi
.interp
, target
->cmd_name
, -1 ) );
4237 target
= target
->next
;
4242 Jim_WrongNumArgs( goi
.interp
, goi
.argc
, goi
.argv
, "?name ... config options ...");
4245 return target_create( &goi
);
4248 if( goi
.argc
!= 1 ){
4249 Jim_SetResult_sprintf( goi
.interp
, "expected: target number ?NUMBER?");
4252 e
= Jim_GetOpt_Wide( &goi
, &w
);
4258 t
= get_target_by_num(w
);
4260 Jim_SetResult_sprintf( goi
.interp
,"Target: number %d does not exist", (int)(w
));
4263 Jim_SetResultString( goi
.interp
, t
->cmd_name
, -1 );
4267 if( goi
.argc
!= 0 ){
4268 Jim_WrongNumArgs( goi
.interp
, 0, goi
.argv
, "<no parameters>");
4271 Jim_SetResult( goi
.interp
,
4272 Jim_NewIntObj( goi
.interp
, max_target_number()));
4288 static int fastload_num
;
4289 static struct FastLoad
*fastload
;
4291 static void free_fastload(void)
4296 for (i
=0; i
<fastload_num
; i
++)
4298 if (fastload
[i
].data
)
4299 free(fastload
[i
].data
);
4309 static int handle_fast_load_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
4315 u32 max_address
=0xffffffff;
4321 duration_t duration
;
4322 char *duration_text
;
4324 if ((argc
< 1)||(argc
> 5))
4326 return ERROR_COMMAND_SYNTAX_ERROR
;
4329 /* a base address isn't always necessary, default to 0x0 (i.e. don't relocate) */
4332 image
.base_address_set
= 1;
4333 image
.base_address
= strtoul(args
[1], NULL
, 0);
4337 image
.base_address_set
= 0;
4341 image
.start_address_set
= 0;
4345 min_address
=strtoul(args
[3], NULL
, 0);
4349 max_address
=strtoul(args
[4], NULL
, 0)+min_address
;
4352 if (min_address
>max_address
)
4354 return ERROR_COMMAND_SYNTAX_ERROR
;
4357 duration_start_measure(&duration
);
4359 if (image_open(&image
, args
[0], (argc
>= 3) ? args
[2] : NULL
) != ERROR_OK
)
4366 fastload_num
=image
.num_sections
;
4367 fastload
=(struct FastLoad
*)malloc(sizeof(struct FastLoad
)*image
.num_sections
);
4370 image_close(&image
);
4373 memset(fastload
, 0, sizeof(struct FastLoad
)*image
.num_sections
);
4374 for (i
= 0; i
< image
.num_sections
; i
++)
4376 buffer
= malloc(image
.sections
[i
].size
);
4379 command_print(cmd_ctx
, "error allocating buffer for section (%d bytes)", image
.sections
[i
].size
);
4383 if ((retval
= image_read_section(&image
, i
, 0x0, image
.sections
[i
].size
, buffer
, &buf_cnt
)) != ERROR_OK
)
4393 /* DANGER!!! beware of unsigned comparision here!!! */
4395 if ((image
.sections
[i
].base_address
+buf_cnt
>=min_address
)&&
4396 (image
.sections
[i
].base_address
<max_address
))
4398 if (image
.sections
[i
].base_address
<min_address
)
4400 /* clip addresses below */
4401 offset
+=min_address
-image
.sections
[i
].base_address
;
4405 if (image
.sections
[i
].base_address
+buf_cnt
>max_address
)
4407 length
-=(image
.sections
[i
].base_address
+buf_cnt
)-max_address
;
4410 fastload
[i
].address
=image
.sections
[i
].base_address
+offset
;
4411 fastload
[i
].data
=malloc(length
);
4412 if (fastload
[i
].data
==NULL
)
4417 memcpy(fastload
[i
].data
, buffer
+offset
, length
);
4418 fastload
[i
].length
=length
;
4420 image_size
+= length
;
4421 command_print(cmd_ctx
, "%u byte written at address 0x%8.8x", length
, image
.sections
[i
].base_address
+offset
);
4427 duration_stop_measure(&duration
, &duration_text
);
4428 if (retval
==ERROR_OK
)
4430 command_print(cmd_ctx
, "Loaded %u bytes in %s", image_size
, duration_text
);
4431 command_print(cmd_ctx
, "NB!!! image has not been loaded to target, issue a subsequent 'fast_load' to do so.");
4433 free(duration_text
);
4435 image_close(&image
);
4437 if (retval
!=ERROR_OK
)
4445 static int handle_fast_load_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
4448 return ERROR_COMMAND_SYNTAX_ERROR
;
4451 LOG_ERROR("No image in memory");
4455 int ms
=timeval_ms();
4457 int retval
=ERROR_OK
;
4458 for (i
=0; i
<fastload_num
;i
++)
4460 target_t
*target
= get_current_target(cmd_ctx
);
4461 command_print(cmd_ctx
, "Write to 0x%08x, length 0x%08x", fastload
[i
].address
, fastload
[i
].length
);
4462 if (retval
==ERROR_OK
)
4464 retval
= target_write_buffer(target
, fastload
[i
].address
, fastload
[i
].length
, fastload
[i
].data
);
4466 size
+=fastload
[i
].length
;
4468 int after
=timeval_ms();
4469 command_print(cmd_ctx
, "Loaded image %f kBytes/s", (float)(size
/1024.0)/((float)(after
-ms
)/1000.0));