1 /***************************************************************************
2 * Copyright (C) 2005 by Dominic Rath *
3 * Dominic.Rath@gmx.de *
5 * This program is free software; you can redistribute it and/or modify *
6 * it under the terms of the GNU General Public License as published by *
7 * the Free Software Foundation; either version 2 of the License, or *
8 * (at your option) any later version. *
10 * This program is distributed in the hope that it will be useful, *
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
13 * GNU General Public License for more details. *
15 * You should have received a copy of the GNU General Public License *
16 * along with this program; if not, write to the *
17 * Free Software Foundation, Inc., *
18 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
19 ***************************************************************************/
24 #include "replacements.h"
26 #include "target_request.h"
29 #include "configuration.h"
30 #include "binarybuffer.h"
37 #include <sys/types.h>
45 #include <time_support.h>
50 int cli_target_callback_event_handler(struct target_s
*target
, enum target_event event
, void *priv
);
53 int handle_target_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
54 int handle_targets_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
56 int handle_target_script_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
57 int handle_run_and_halt_time_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
58 int handle_working_area_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
60 int handle_reg_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
61 int handle_poll_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
62 int handle_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
63 int handle_wait_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
64 int handle_reset_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
65 int handle_soft_reset_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
66 int handle_resume_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
67 int handle_step_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
68 int handle_md_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
69 int handle_mw_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
70 int handle_load_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
71 int handle_dump_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
72 int handle_verify_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
73 int handle_bp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
74 int handle_rbp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
75 int handle_wp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
76 int handle_rwp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
77 int handle_virt2phys_command(command_context_t
*cmd_ctx
, char *cmd
, char **args
, int argc
);
78 int handle_profile_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
82 extern target_type_t arm7tdmi_target
;
83 extern target_type_t arm720t_target
;
84 extern target_type_t arm9tdmi_target
;
85 extern target_type_t arm920t_target
;
86 extern target_type_t arm966e_target
;
87 extern target_type_t arm926ejs_target
;
88 extern target_type_t feroceon_target
;
89 extern target_type_t xscale_target
;
90 extern target_type_t cortexm3_target
;
91 extern target_type_t arm11_target
;
93 target_type_t
*target_types
[] =
108 target_t
*targets
= NULL
;
109 target_event_callback_t
*target_event_callbacks
= NULL
;
110 target_timer_callback_t
*target_timer_callbacks
= NULL
;
112 char *target_state_strings
[] =
121 char *target_debug_reason_strings
[] =
123 "debug request", "breakpoint", "watchpoint",
124 "watchpoint and breakpoint", "single step",
125 "target not halted", "undefined"
128 char *target_endianess_strings
[] =
134 static int target_continous_poll
= 1;
136 /* read a u32 from a buffer in target memory endianness */
137 u32
target_buffer_get_u32(target_t
*target
, u8
*buffer
)
139 if (target
->endianness
== TARGET_LITTLE_ENDIAN
)
140 return le_to_h_u32(buffer
);
142 return be_to_h_u32(buffer
);
145 /* read a u16 from a buffer in target memory endianness */
146 u16
target_buffer_get_u16(target_t
*target
, u8
*buffer
)
148 if (target
->endianness
== TARGET_LITTLE_ENDIAN
)
149 return le_to_h_u16(buffer
);
151 return be_to_h_u16(buffer
);
154 /* write a u32 to a buffer in target memory endianness */
155 void target_buffer_set_u32(target_t
*target
, u8
*buffer
, u32 value
)
157 if (target
->endianness
== TARGET_LITTLE_ENDIAN
)
158 h_u32_to_le(buffer
, value
);
160 h_u32_to_be(buffer
, value
);
163 /* write a u16 to a buffer in target memory endianness */
164 void target_buffer_set_u16(target_t
*target
, u8
*buffer
, u16 value
)
166 if (target
->endianness
== TARGET_LITTLE_ENDIAN
)
167 h_u16_to_le(buffer
, value
);
169 h_u16_to_be(buffer
, value
);
172 /* returns a pointer to the n-th configured target */
173 target_t
* get_target_by_num(int num
)
175 target_t
*target
= targets
;
182 target
= target
->next
;
189 int get_num_by_target(target_t
*query_target
)
191 target_t
*target
= targets
;
196 if (target
== query_target
)
198 target
= target
->next
;
205 target_t
* get_current_target(command_context_t
*cmd_ctx
)
207 target_t
*target
= get_target_by_num(cmd_ctx
->current_target
);
211 LOG_ERROR("BUG: current_target out of bounds");
218 /* Process target initialization, when target entered debug out of reset
219 * the handler is unregistered at the end of this function, so it's only called once
221 int target_init_handler(struct target_s
*target
, enum target_event event
, void *priv
)
224 struct command_context_s
*cmd_ctx
= priv
;
226 if ((event
== TARGET_EVENT_HALTED
) && (target
->reset_script
))
228 target_unregister_event_callback(target_init_handler
, priv
);
230 script
= open_file_from_path(target
->reset_script
, "r");
233 LOG_ERROR("couldn't open script file %s", target
->reset_script
);
237 LOG_INFO("executing reset script '%s'", target
->reset_script
);
238 command_run_file(cmd_ctx
, script
, COMMAND_EXEC
);
241 jtag_execute_queue();
247 int target_run_and_halt_handler(void *priv
)
249 target_t
*target
= priv
;
256 int target_poll(struct target_s
*target
)
258 /* We can't poll until after examine */
259 if (!target
->type
->examined
)
261 /* Fail silently lest we pollute the log */
264 return target
->type
->poll(target
);
267 int target_halt(struct target_s
*target
)
269 /* We can't poll until after examine */
270 if (!target
->type
->examined
)
272 LOG_ERROR("Target not examined yet");
275 return target
->type
->halt(target
);
278 int target_resume(struct target_s
*target
, int current
, u32 address
, int handle_breakpoints
, int debug_execution
)
280 /* We can't poll until after examine */
281 if (!target
->type
->examined
)
283 LOG_ERROR("Target not examined yet");
286 return target
->type
->resume(target
, current
, address
, handle_breakpoints
, debug_execution
);
290 int target_process_reset(struct command_context_s
*cmd_ctx
)
292 int retval
= ERROR_OK
;
294 struct timeval timeout
, now
;
296 jtag
->speed(jtag_speed
);
298 if ((retval
= jtag_init_reset(cmd_ctx
)) != ERROR_OK
)
301 /* First time this is executed after launching OpenOCD, it will read out
302 * the type of CPU, etc. and init Embedded ICE registers in host
305 * It will also set up ICE registers in the target.
307 * However, if we assert TRST later, we need to set up the registers again.
309 * For the "reset halt/init" case we must only set up the registers here.
311 if ((retval
= target_examine(cmd_ctx
)) != ERROR_OK
)
314 /* prepare reset_halt where necessary */
318 if (jtag_reset_config
& RESET_SRST_PULLS_TRST
)
320 switch (target
->reset_mode
)
323 command_print(cmd_ctx
, "nSRST pulls nTRST, falling back to \"reset run_and_halt\"");
324 target
->reset_mode
= RESET_RUN_AND_HALT
;
327 command_print(cmd_ctx
, "nSRST pulls nTRST, falling back to \"reset run_and_init\"");
328 target
->reset_mode
= RESET_RUN_AND_INIT
;
334 target
= target
->next
;
340 /* we have no idea what state the target is in, so we
341 * have to drop working areas
343 target_free_all_working_areas_restore(target
, 0);
344 target
->type
->assert_reset(target
);
345 target
= target
->next
;
347 if ((retval
= jtag_execute_queue()) != ERROR_OK
)
349 LOG_WARNING("JTAG communication failed asserting reset.");
353 /* request target halt if necessary, and schedule further action */
357 switch (target
->reset_mode
)
360 /* nothing to do if target just wants to be run */
362 case RESET_RUN_AND_HALT
:
364 target_register_timer_callback(target_run_and_halt_handler
, target
->run_and_halt_time
, 0, target
);
366 case RESET_RUN_AND_INIT
:
368 target_register_timer_callback(target_run_and_halt_handler
, target
->run_and_halt_time
, 0, target
);
369 target_register_event_callback(target_init_handler
, cmd_ctx
);
376 target_register_event_callback(target_init_handler
, cmd_ctx
);
379 LOG_ERROR("BUG: unknown target->reset_mode");
381 target
= target
->next
;
384 if ((retval
= jtag_execute_queue()) != ERROR_OK
)
386 LOG_WARNING("JTAG communication failed while reset was asserted. Consider using srst_only for reset_config.");
393 target
->type
->deassert_reset(target
);
394 target
= target
->next
;
397 if (jtag_reset_config
& RESET_SRST_PULLS_TRST
)
399 /* If TRST was asserted we need to set up registers again */
400 if ((retval
= target_examine(cmd_ctx
)) != ERROR_OK
)
404 if ((retval
= jtag_execute_queue()) != ERROR_OK
)
406 LOG_WARNING("JTAG communication failed while deasserting reset.");
410 LOG_DEBUG("Waiting for halted stated as approperiate");
412 /* Wait for reset to complete, maximum 5 seconds. */
413 gettimeofday(&timeout
, NULL
);
414 timeval_add_time(&timeout
, 5, 0);
417 gettimeofday(&now
, NULL
);
419 target_call_timer_callbacks_now();
424 LOG_DEBUG("Polling target");
426 if ((target
->reset_mode
== RESET_RUN_AND_INIT
) ||
427 (target
->reset_mode
== RESET_RUN_AND_HALT
) ||
428 (target
->reset_mode
== RESET_HALT
) ||
429 (target
->reset_mode
== RESET_INIT
))
431 if (target
->state
!= TARGET_HALTED
)
433 if ((now
.tv_sec
> timeout
.tv_sec
) || ((now
.tv_sec
== timeout
.tv_sec
) && (now
.tv_usec
>= timeout
.tv_usec
)))
435 LOG_USER("Timed out waiting for halt after reset");
438 /* this will send alive messages on e.g. GDB remote protocol. */
440 LOG_USER_N("%s", ""); /* avoid warning about zero length formatting message*/
444 target
= target
->next
;
446 /* All targets we're waiting for are halted */
454 /* We want any events to be processed before the prompt */
455 target_call_timer_callbacks_now();
457 /* if we timed out we need to unregister these handlers */
461 target_unregister_timer_callback(target_run_and_halt_handler
, target
);
462 target
= target
->next
;
464 target_unregister_event_callback(target_init_handler
, cmd_ctx
);
467 jtag
->speed(jtag_speed_post_reset
);
472 static int default_virt2phys(struct target_s
*target
, u32
virtual, u32
*physical
)
478 static int default_mmu(struct target_s
*target
, int *enabled
)
484 static int default_examine(struct command_context_s
*cmd_ctx
, struct target_s
*target
)
486 target
->type
->examined
= 1;
491 /* Targets that correctly implement init+examine, i.e.
492 * no communication with target during init:
496 int target_examine(struct command_context_s
*cmd_ctx
)
498 int retval
= ERROR_OK
;
499 target_t
*target
= targets
;
502 if ((retval
= target
->type
->examine(cmd_ctx
, target
))!=ERROR_OK
)
504 target
= target
->next
;
509 static int target_write_memory_imp(struct target_s
*target
, u32 address
, u32 size
, u32 count
, u8
*buffer
)
511 if (!target
->type
->examined
)
513 LOG_ERROR("Target not examined yet");
516 return target
->type
->write_memory_imp(target
, address
, size
, count
, buffer
);
519 static int target_read_memory_imp(struct target_s
*target
, u32 address
, u32 size
, u32 count
, u8
*buffer
)
521 if (!target
->type
->examined
)
523 LOG_ERROR("Target not examined yet");
526 return target
->type
->read_memory_imp(target
, address
, size
, count
, buffer
);
529 static int target_soft_reset_halt_imp(struct target_s
*target
)
531 if (!target
->type
->examined
)
533 LOG_ERROR("Target not examined yet");
536 return target
->type
->soft_reset_halt_imp(target
);
539 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
)
541 if (!target
->type
->examined
)
543 LOG_ERROR("Target not examined yet");
546 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
);
549 int target_init(struct command_context_s
*cmd_ctx
)
551 target_t
*target
= targets
;
555 target
->type
->examined
= 0;
556 if (target
->type
->examine
== NULL
)
558 target
->type
->examine
= default_examine
;
561 if (target
->type
->init_target(cmd_ctx
, target
) != ERROR_OK
)
563 LOG_ERROR("target '%s' init failed", target
->type
->name
);
567 /* Set up default functions if none are provided by target */
568 if (target
->type
->virt2phys
== NULL
)
570 target
->type
->virt2phys
= default_virt2phys
;
572 target
->type
->virt2phys
= default_virt2phys
;
573 /* a non-invasive way(in terms of patches) to add some code that
574 * runs before the type->write/read_memory implementation
576 target
->type
->write_memory_imp
= target
->type
->write_memory
;
577 target
->type
->write_memory
= target_write_memory_imp
;
578 target
->type
->read_memory_imp
= target
->type
->read_memory
;
579 target
->type
->read_memory
= target_read_memory_imp
;
580 target
->type
->soft_reset_halt_imp
= target
->type
->soft_reset_halt
;
581 target
->type
->soft_reset_halt
= target_soft_reset_halt_imp
;
582 target
->type
->run_algorithm_imp
= target
->type
->run_algorithm
;
583 target
->type
->run_algorithm
= target_run_algorithm_imp
;
586 if (target
->type
->mmu
== NULL
)
588 target
->type
->mmu
= default_mmu
;
590 target
= target
->next
;
595 target_register_user_commands(cmd_ctx
);
596 target_register_timer_callback(handle_target
, 100, 1, NULL
);
602 int target_register_event_callback(int (*callback
)(struct target_s
*target
, enum target_event event
, void *priv
), void *priv
)
604 target_event_callback_t
**callbacks_p
= &target_event_callbacks
;
606 if (callback
== NULL
)
608 return ERROR_INVALID_ARGUMENTS
;
613 while ((*callbacks_p
)->next
)
614 callbacks_p
= &((*callbacks_p
)->next
);
615 callbacks_p
= &((*callbacks_p
)->next
);
618 (*callbacks_p
) = malloc(sizeof(target_event_callback_t
));
619 (*callbacks_p
)->callback
= callback
;
620 (*callbacks_p
)->priv
= priv
;
621 (*callbacks_p
)->next
= NULL
;
626 int target_register_timer_callback(int (*callback
)(void *priv
), int time_ms
, int periodic
, void *priv
)
628 target_timer_callback_t
**callbacks_p
= &target_timer_callbacks
;
631 if (callback
== NULL
)
633 return ERROR_INVALID_ARGUMENTS
;
638 while ((*callbacks_p
)->next
)
639 callbacks_p
= &((*callbacks_p
)->next
);
640 callbacks_p
= &((*callbacks_p
)->next
);
643 (*callbacks_p
) = malloc(sizeof(target_timer_callback_t
));
644 (*callbacks_p
)->callback
= callback
;
645 (*callbacks_p
)->periodic
= periodic
;
646 (*callbacks_p
)->time_ms
= time_ms
;
648 gettimeofday(&now
, NULL
);
649 (*callbacks_p
)->when
.tv_usec
= now
.tv_usec
+ (time_ms
% 1000) * 1000;
650 time_ms
-= (time_ms
% 1000);
651 (*callbacks_p
)->when
.tv_sec
= now
.tv_sec
+ (time_ms
/ 1000);
652 if ((*callbacks_p
)->when
.tv_usec
> 1000000)
654 (*callbacks_p
)->when
.tv_usec
= (*callbacks_p
)->when
.tv_usec
- 1000000;
655 (*callbacks_p
)->when
.tv_sec
+= 1;
658 (*callbacks_p
)->priv
= priv
;
659 (*callbacks_p
)->next
= NULL
;
664 int target_unregister_event_callback(int (*callback
)(struct target_s
*target
, enum target_event event
, void *priv
), void *priv
)
666 target_event_callback_t
**p
= &target_event_callbacks
;
667 target_event_callback_t
*c
= target_event_callbacks
;
669 if (callback
== NULL
)
671 return ERROR_INVALID_ARGUMENTS
;
676 target_event_callback_t
*next
= c
->next
;
677 if ((c
->callback
== callback
) && (c
->priv
== priv
))
691 int target_unregister_timer_callback(int (*callback
)(void *priv
), void *priv
)
693 target_timer_callback_t
**p
= &target_timer_callbacks
;
694 target_timer_callback_t
*c
= target_timer_callbacks
;
696 if (callback
== NULL
)
698 return ERROR_INVALID_ARGUMENTS
;
703 target_timer_callback_t
*next
= c
->next
;
704 if ((c
->callback
== callback
) && (c
->priv
== priv
))
718 int target_call_event_callbacks(target_t
*target
, enum target_event event
)
720 target_event_callback_t
*callback
= target_event_callbacks
;
721 target_event_callback_t
*next_callback
;
723 LOG_DEBUG("target event %i", event
);
727 next_callback
= callback
->next
;
728 callback
->callback(target
, event
, callback
->priv
);
729 callback
= next_callback
;
735 static int target_call_timer_callbacks_check_time(int checktime
)
737 target_timer_callback_t
*callback
= target_timer_callbacks
;
738 target_timer_callback_t
*next_callback
;
741 gettimeofday(&now
, NULL
);
745 next_callback
= callback
->next
;
747 if ((!checktime
&&callback
->periodic
)||
748 (((now
.tv_sec
>= callback
->when
.tv_sec
) && (now
.tv_usec
>= callback
->when
.tv_usec
))
749 || (now
.tv_sec
> callback
->when
.tv_sec
)))
751 callback
->callback(callback
->priv
);
752 if (callback
->periodic
)
754 int time_ms
= callback
->time_ms
;
755 callback
->when
.tv_usec
= now
.tv_usec
+ (time_ms
% 1000) * 1000;
756 time_ms
-= (time_ms
% 1000);
757 callback
->when
.tv_sec
= now
.tv_sec
+ time_ms
/ 1000;
758 if (callback
->when
.tv_usec
> 1000000)
760 callback
->when
.tv_usec
= callback
->when
.tv_usec
- 1000000;
761 callback
->when
.tv_sec
+= 1;
765 target_unregister_timer_callback(callback
->callback
, callback
->priv
);
768 callback
= next_callback
;
774 int target_call_timer_callbacks()
776 return target_call_timer_callbacks_check_time(1);
779 /* invoke periodic callbacks immediately */
780 int target_call_timer_callbacks_now()
782 return target_call_timer_callbacks(0);
786 int target_alloc_working_area(struct target_s
*target
, u32 size
, working_area_t
**area
)
788 working_area_t
*c
= target
->working_areas
;
789 working_area_t
*new_wa
= NULL
;
791 /* Reevaluate working area address based on MMU state*/
792 if (target
->working_areas
== NULL
)
796 retval
= target
->type
->mmu(target
, &enabled
);
797 if (retval
!= ERROR_OK
)
803 target
->working_area
= target
->working_area_virt
;
807 target
->working_area
= target
->working_area_phys
;
811 /* only allocate multiples of 4 byte */
814 LOG_ERROR("BUG: code tried to allocate unaligned number of bytes, padding");
815 size
= CEIL(size
, 4);
818 /* see if there's already a matching working area */
821 if ((c
->free
) && (c
->size
== size
))
829 /* if not, allocate a new one */
832 working_area_t
**p
= &target
->working_areas
;
833 u32 first_free
= target
->working_area
;
834 u32 free_size
= target
->working_area_size
;
836 LOG_DEBUG("allocating new working area");
838 c
= target
->working_areas
;
841 first_free
+= c
->size
;
842 free_size
-= c
->size
;
847 if (free_size
< size
)
849 LOG_WARNING("not enough working area available(requested %d, free %d)", size
, free_size
);
850 return ERROR_TARGET_RESOURCE_NOT_AVAILABLE
;
853 new_wa
= malloc(sizeof(working_area_t
));
856 new_wa
->address
= first_free
;
858 if (target
->backup_working_area
)
860 new_wa
->backup
= malloc(new_wa
->size
);
861 target
->type
->read_memory(target
, new_wa
->address
, 4, new_wa
->size
/ 4, new_wa
->backup
);
865 new_wa
->backup
= NULL
;
868 /* put new entry in list */
872 /* mark as used, and return the new (reused) area */
882 int target_free_working_area_restore(struct target_s
*target
, working_area_t
*area
, int restore
)
887 if (restore
&&target
->backup_working_area
)
888 target
->type
->write_memory(target
, area
->address
, 4, area
->size
/ 4, area
->backup
);
892 /* mark user pointer invalid */
899 int target_free_working_area(struct target_s
*target
, working_area_t
*area
)
901 return target_free_working_area_restore(target
, area
, 1);
904 int target_free_all_working_areas_restore(struct target_s
*target
, int restore
)
906 working_area_t
*c
= target
->working_areas
;
910 working_area_t
*next
= c
->next
;
911 target_free_working_area_restore(target
, c
, restore
);
921 target
->working_areas
= NULL
;
926 int target_free_all_working_areas(struct target_s
*target
)
928 return target_free_all_working_areas_restore(target
, 1);
931 int target_register_commands(struct command_context_s
*cmd_ctx
)
933 register_command(cmd_ctx
, NULL
, "target", handle_target_command
, COMMAND_CONFIG
, "target <cpu> [reset_init default - DEPRECATED] <chainpos> <endianness> <variant> [cpu type specifc args]");
934 register_command(cmd_ctx
, NULL
, "targets", handle_targets_command
, COMMAND_EXEC
, NULL
);
935 register_command(cmd_ctx
, NULL
, "target_script", handle_target_script_command
, COMMAND_CONFIG
, NULL
);
936 register_command(cmd_ctx
, NULL
, "run_and_halt_time", handle_run_and_halt_time_command
, COMMAND_CONFIG
, "<target> <run time ms>");
937 register_command(cmd_ctx
, NULL
, "working_area", handle_working_area_command
, COMMAND_ANY
, "working_area <target#> <address> <size> <'backup'|'nobackup'> [virtual address]");
938 register_command(cmd_ctx
, NULL
, "virt2phys", handle_virt2phys_command
, COMMAND_ANY
, "virt2phys <virtual address>");
939 register_command(cmd_ctx
, NULL
, "profile", handle_profile_command
, COMMAND_EXEC
, "PRELIMINARY! - profile <seconds> <gmon.out>");
944 int target_arch_state(struct target_s
*target
)
949 LOG_USER("No target has been configured");
953 LOG_USER("target state: %s", target_state_strings
[target
->state
]);
955 if (target
->state
!=TARGET_HALTED
)
958 retval
=target
->type
->arch_state(target
);
962 /* Single aligned words are guaranteed to use 16 or 32 bit access
963 * mode respectively, otherwise data is handled as quickly as
966 int target_write_buffer(struct target_s
*target
, u32 address
, u32 size
, u8
*buffer
)
969 if (!target
->type
->examined
)
971 LOG_ERROR("Target not examined yet");
975 LOG_DEBUG("writing buffer of %i byte at 0x%8.8x", size
, address
);
977 if (((address
% 2) == 0) && (size
== 2))
979 return target
->type
->write_memory(target
, address
, 2, 1, buffer
);
982 /* handle unaligned head bytes */
985 int unaligned
= 4 - (address
% 4);
987 if (unaligned
> size
)
990 if ((retval
= target
->type
->write_memory(target
, address
, 1, unaligned
, buffer
)) != ERROR_OK
)
994 address
+= unaligned
;
998 /* handle aligned words */
1001 int aligned
= size
- (size
% 4);
1003 /* use bulk writes above a certain limit. This may have to be changed */
1006 if ((retval
= target
->type
->bulk_write_memory(target
, address
, aligned
/ 4, buffer
)) != ERROR_OK
)
1011 if ((retval
= target
->type
->write_memory(target
, address
, 4, aligned
/ 4, buffer
)) != ERROR_OK
)
1020 /* handle tail writes of less than 4 bytes */
1023 if ((retval
= target
->type
->write_memory(target
, address
, 1, size
, buffer
)) != ERROR_OK
)
1031 /* Single aligned words are guaranteed to use 16 or 32 bit access
1032 * mode respectively, otherwise data is handled as quickly as
1035 int target_read_buffer(struct target_s
*target
, u32 address
, u32 size
, u8
*buffer
)
1038 if (!target
->type
->examined
)
1040 LOG_ERROR("Target not examined yet");
1044 LOG_DEBUG("reading buffer of %i byte at 0x%8.8x", size
, address
);
1046 if (((address
% 2) == 0) && (size
== 2))
1048 return target
->type
->read_memory(target
, address
, 2, 1, buffer
);
1051 /* handle unaligned head bytes */
1054 int unaligned
= 4 - (address
% 4);
1056 if (unaligned
> size
)
1059 if ((retval
= target
->type
->read_memory(target
, address
, 1, unaligned
, buffer
)) != ERROR_OK
)
1062 buffer
+= unaligned
;
1063 address
+= unaligned
;
1067 /* handle aligned words */
1070 int aligned
= size
- (size
% 4);
1072 if ((retval
= target
->type
->read_memory(target
, address
, 4, aligned
/ 4, buffer
)) != ERROR_OK
)
1080 /* handle tail writes of less than 4 bytes */
1083 if ((retval
= target
->type
->read_memory(target
, address
, 1, size
, buffer
)) != ERROR_OK
)
1090 int target_checksum_memory(struct target_s
*target
, u32 address
, u32 size
, u32
* crc
)
1096 if (!target
->type
->examined
)
1098 LOG_ERROR("Target not examined yet");
1102 if ((retval
= target
->type
->checksum_memory(target
, address
,
1103 size
, &checksum
)) == ERROR_TARGET_RESOURCE_NOT_AVAILABLE
)
1105 buffer
= malloc(size
);
1108 LOG_ERROR("error allocating buffer for section (%d bytes)", size
);
1109 return ERROR_INVALID_ARGUMENTS
;
1111 retval
= target_read_buffer(target
, address
, size
, buffer
);
1112 if (retval
!= ERROR_OK
)
1118 /* convert to target endianess */
1119 for (i
= 0; i
< (size
/sizeof(u32
)); i
++)
1122 target_data
= target_buffer_get_u32(target
, &buffer
[i
*sizeof(u32
)]);
1123 target_buffer_set_u32(target
, &buffer
[i
*sizeof(u32
)], target_data
);
1126 retval
= image_calculate_checksum( buffer
, size
, &checksum
);
1135 int target_read_u32(struct target_s
*target
, u32 address
, u32
*value
)
1138 if (!target
->type
->examined
)
1140 LOG_ERROR("Target not examined yet");
1144 int retval
= target
->type
->read_memory(target
, address
, 4, 1, value_buf
);
1146 if (retval
== ERROR_OK
)
1148 *value
= target_buffer_get_u32(target
, value_buf
);
1149 LOG_DEBUG("address: 0x%8.8x, value: 0x%8.8x", address
, *value
);
1154 LOG_DEBUG("address: 0x%8.8x failed", address
);
1160 int target_read_u16(struct target_s
*target
, u32 address
, u16
*value
)
1163 if (!target
->type
->examined
)
1165 LOG_ERROR("Target not examined yet");
1169 int retval
= target
->type
->read_memory(target
, address
, 2, 1, value_buf
);
1171 if (retval
== ERROR_OK
)
1173 *value
= target_buffer_get_u16(target
, value_buf
);
1174 LOG_DEBUG("address: 0x%8.8x, value: 0x%4.4x", address
, *value
);
1179 LOG_DEBUG("address: 0x%8.8x failed", address
);
1185 int target_read_u8(struct target_s
*target
, u32 address
, u8
*value
)
1187 int retval
= target
->type
->read_memory(target
, address
, 1, 1, value
);
1188 if (!target
->type
->examined
)
1190 LOG_ERROR("Target not examined yet");
1194 if (retval
== ERROR_OK
)
1196 LOG_DEBUG("address: 0x%8.8x, value: 0x%2.2x", address
, *value
);
1201 LOG_DEBUG("address: 0x%8.8x failed", address
);
1207 int target_write_u32(struct target_s
*target
, u32 address
, u32 value
)
1211 if (!target
->type
->examined
)
1213 LOG_ERROR("Target not examined yet");
1217 LOG_DEBUG("address: 0x%8.8x, value: 0x%8.8x", address
, value
);
1219 target_buffer_set_u32(target
, value_buf
, value
);
1220 if ((retval
= target
->type
->write_memory(target
, address
, 4, 1, value_buf
)) != ERROR_OK
)
1222 LOG_DEBUG("failed: %i", retval
);
1228 int target_write_u16(struct target_s
*target
, u32 address
, u16 value
)
1232 if (!target
->type
->examined
)
1234 LOG_ERROR("Target not examined yet");
1238 LOG_DEBUG("address: 0x%8.8x, value: 0x%8.8x", address
, value
);
1240 target_buffer_set_u16(target
, value_buf
, value
);
1241 if ((retval
= target
->type
->write_memory(target
, address
, 2, 1, value_buf
)) != ERROR_OK
)
1243 LOG_DEBUG("failed: %i", retval
);
1249 int target_write_u8(struct target_s
*target
, u32 address
, u8 value
)
1252 if (!target
->type
->examined
)
1254 LOG_ERROR("Target not examined yet");
1258 LOG_DEBUG("address: 0x%8.8x, value: 0x%2.2x", address
, value
);
1260 if ((retval
= target
->type
->read_memory(target
, address
, 1, 1, &value
)) != ERROR_OK
)
1262 LOG_DEBUG("failed: %i", retval
);
1268 int target_register_user_commands(struct command_context_s
*cmd_ctx
)
1270 register_command(cmd_ctx
, NULL
, "reg", handle_reg_command
, COMMAND_EXEC
, NULL
);
1271 register_command(cmd_ctx
, NULL
, "poll", handle_poll_command
, COMMAND_EXEC
, "poll target state");
1272 register_command(cmd_ctx
, NULL
, "wait_halt", handle_wait_halt_command
, COMMAND_EXEC
, "wait for target halt [time (s)]");
1273 register_command(cmd_ctx
, NULL
, "halt", handle_halt_command
, COMMAND_EXEC
, "halt target");
1274 register_command(cmd_ctx
, NULL
, "resume", handle_resume_command
, COMMAND_EXEC
, "resume target [addr]");
1275 register_command(cmd_ctx
, NULL
, "step", handle_step_command
, COMMAND_EXEC
, "step one instruction from current PC or [addr]");
1276 register_command(cmd_ctx
, NULL
, "reset", handle_reset_command
, COMMAND_EXEC
, "reset target [run|halt|init|run_and_halt|run_and_init]");
1277 register_command(cmd_ctx
, NULL
, "soft_reset_halt", handle_soft_reset_halt_command
, COMMAND_EXEC
, "halt the target and do a soft reset");
1279 register_command(cmd_ctx
, NULL
, "mdw", handle_md_command
, COMMAND_EXEC
, "display memory words <addr> [count]");
1280 register_command(cmd_ctx
, NULL
, "mdh", handle_md_command
, COMMAND_EXEC
, "display memory half-words <addr> [count]");
1281 register_command(cmd_ctx
, NULL
, "mdb", handle_md_command
, COMMAND_EXEC
, "display memory bytes <addr> [count]");
1283 register_command(cmd_ctx
, NULL
, "mww", handle_mw_command
, COMMAND_EXEC
, "write memory word <addr> <value> [count]");
1284 register_command(cmd_ctx
, NULL
, "mwh", handle_mw_command
, COMMAND_EXEC
, "write memory half-word <addr> <value> [count]");
1285 register_command(cmd_ctx
, NULL
, "mwb", handle_mw_command
, COMMAND_EXEC
, "write memory byte <addr> <value> [count]");
1287 register_command(cmd_ctx
, NULL
, "bp", handle_bp_command
, COMMAND_EXEC
, "set breakpoint <address> <length> [hw]");
1288 register_command(cmd_ctx
, NULL
, "rbp", handle_rbp_command
, COMMAND_EXEC
, "remove breakpoint <adress>");
1289 register_command(cmd_ctx
, NULL
, "wp", handle_wp_command
, COMMAND_EXEC
, "set watchpoint <address> <length> <r/w/a> [value] [mask]");
1290 register_command(cmd_ctx
, NULL
, "rwp", handle_rwp_command
, COMMAND_EXEC
, "remove watchpoint <adress>");
1292 register_command(cmd_ctx
, NULL
, "load_image", handle_load_image_command
, COMMAND_EXEC
, "load_image <file> <address> ['bin'|'ihex'|'elf'|'s19']");
1293 register_command(cmd_ctx
, NULL
, "dump_image", handle_dump_image_command
, COMMAND_EXEC
, "dump_image <file> <address> <size>");
1294 register_command(cmd_ctx
, NULL
, "verify_image", handle_verify_image_command
, COMMAND_EXEC
, "verify_image <file> [offset] [type]");
1295 register_command(cmd_ctx
, NULL
, "load_binary", handle_load_image_command
, COMMAND_EXEC
, "[DEPRECATED] load_binary <file> <address>");
1296 register_command(cmd_ctx
, NULL
, "dump_binary", handle_dump_image_command
, COMMAND_EXEC
, "[DEPRECATED] dump_binary <file> <address> <size>");
1298 target_request_register_commands(cmd_ctx
);
1299 trace_register_commands(cmd_ctx
);
1304 int handle_targets_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1306 target_t
*target
= targets
;
1311 int num
= strtoul(args
[0], NULL
, 0);
1316 target
= target
->next
;
1320 cmd_ctx
->current_target
= num
;
1322 command_print(cmd_ctx
, "%i is out of bounds, only %i targets are configured", num
, count
);
1329 command_print(cmd_ctx
, "%i: %s (%s), state: %s", count
++, target
->type
->name
, target_endianess_strings
[target
->endianness
], target_state_strings
[target
->state
]);
1330 target
= target
->next
;
1336 int handle_target_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1343 return ERROR_COMMAND_SYNTAX_ERROR
;
1346 /* search for the specified target */
1347 if (args
[0] && (args
[0][0] != 0))
1349 for (i
= 0; target_types
[i
]; i
++)
1351 if (strcmp(args
[0], target_types
[i
]->name
) == 0)
1353 target_t
**last_target_p
= &targets
;
1355 /* register target specific commands */
1356 if (target_types
[i
]->register_commands(cmd_ctx
) != ERROR_OK
)
1358 LOG_ERROR("couldn't register '%s' commands", args
[0]);
1364 while ((*last_target_p
)->next
)
1365 last_target_p
= &((*last_target_p
)->next
);
1366 last_target_p
= &((*last_target_p
)->next
);
1369 *last_target_p
= malloc(sizeof(target_t
));
1371 (*last_target_p
)->type
= target_types
[i
];
1373 if (strcmp(args
[1], "big") == 0)
1374 (*last_target_p
)->endianness
= TARGET_BIG_ENDIAN
;
1375 else if (strcmp(args
[1], "little") == 0)
1376 (*last_target_p
)->endianness
= TARGET_LITTLE_ENDIAN
;
1379 LOG_ERROR("endianness must be either 'little' or 'big', not '%s'", args
[1]);
1380 return ERROR_COMMAND_SYNTAX_ERROR
;
1383 /* what to do on a target reset */
1384 (*last_target_p
)->reset_mode
= RESET_INIT
; /* default */
1385 if (strcmp(args
[2], "reset_halt") == 0)
1386 (*last_target_p
)->reset_mode
= RESET_HALT
;
1387 else if (strcmp(args
[2], "reset_run") == 0)
1388 (*last_target_p
)->reset_mode
= RESET_RUN
;
1389 else if (strcmp(args
[2], "reset_init") == 0)
1390 (*last_target_p
)->reset_mode
= RESET_INIT
;
1391 else if (strcmp(args
[2], "run_and_halt") == 0)
1392 (*last_target_p
)->reset_mode
= RESET_RUN_AND_HALT
;
1393 else if (strcmp(args
[2], "run_and_init") == 0)
1394 (*last_target_p
)->reset_mode
= RESET_RUN_AND_INIT
;
1397 /* Kludge! we want to make this reset arg optional while remaining compatible! */
1401 (*last_target_p
)->run_and_halt_time
= 1000; /* default 1s */
1403 (*last_target_p
)->reset_script
= NULL
;
1404 (*last_target_p
)->post_halt_script
= NULL
;
1405 (*last_target_p
)->pre_resume_script
= NULL
;
1406 (*last_target_p
)->gdb_program_script
= NULL
;
1408 (*last_target_p
)->working_area
= 0x0;
1409 (*last_target_p
)->working_area_size
= 0x0;
1410 (*last_target_p
)->working_areas
= NULL
;
1411 (*last_target_p
)->backup_working_area
= 0;
1413 (*last_target_p
)->state
= TARGET_UNKNOWN
;
1414 (*last_target_p
)->debug_reason
= DBG_REASON_UNDEFINED
;
1415 (*last_target_p
)->reg_cache
= NULL
;
1416 (*last_target_p
)->breakpoints
= NULL
;
1417 (*last_target_p
)->watchpoints
= NULL
;
1418 (*last_target_p
)->next
= NULL
;
1419 (*last_target_p
)->arch_info
= NULL
;
1421 /* initialize trace information */
1422 (*last_target_p
)->trace_info
= malloc(sizeof(trace_t
));
1423 (*last_target_p
)->trace_info
->num_trace_points
= 0;
1424 (*last_target_p
)->trace_info
->trace_points_size
= 0;
1425 (*last_target_p
)->trace_info
->trace_points
= NULL
;
1426 (*last_target_p
)->trace_info
->trace_history_size
= 0;
1427 (*last_target_p
)->trace_info
->trace_history
= NULL
;
1428 (*last_target_p
)->trace_info
->trace_history_pos
= 0;
1429 (*last_target_p
)->trace_info
->trace_history_overflowed
= 0;
1431 (*last_target_p
)->dbgmsg
= NULL
;
1432 (*last_target_p
)->dbg_msg_enabled
= 0;
1434 (*last_target_p
)->type
->target_command(cmd_ctx
, cmd
, args
, argc
, *last_target_p
);
1442 /* no matching target found */
1445 LOG_ERROR("target '%s' not found", args
[0]);
1446 return ERROR_COMMAND_SYNTAX_ERROR
;
1452 /* usage: target_script <target#> <event> <script_file> */
1453 int handle_target_script_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1455 target_t
*target
= NULL
;
1459 LOG_ERROR("incomplete target_script command");
1460 return ERROR_COMMAND_SYNTAX_ERROR
;
1463 target
= get_target_by_num(strtoul(args
[0], NULL
, 0));
1467 return ERROR_COMMAND_SYNTAX_ERROR
;
1470 if (strcmp(args
[1], "reset") == 0)
1472 if (target
->reset_script
)
1473 free(target
->reset_script
);
1474 target
->reset_script
= strdup(args
[2]);
1476 else if (strcmp(args
[1], "post_halt") == 0)
1478 if (target
->post_halt_script
)
1479 free(target
->post_halt_script
);
1480 target
->post_halt_script
= strdup(args
[2]);
1482 else if (strcmp(args
[1], "pre_resume") == 0)
1484 if (target
->pre_resume_script
)
1485 free(target
->pre_resume_script
);
1486 target
->pre_resume_script
= strdup(args
[2]);
1488 else if (strcmp(args
[1], "gdb_program_config") == 0)
1490 if (target
->gdb_program_script
)
1491 free(target
->gdb_program_script
);
1492 target
->gdb_program_script
= strdup(args
[2]);
1496 LOG_ERROR("unknown event type: '%s", args
[1]);
1497 return ERROR_COMMAND_SYNTAX_ERROR
;
1503 int handle_run_and_halt_time_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1505 target_t
*target
= NULL
;
1509 return ERROR_COMMAND_SYNTAX_ERROR
;
1512 target
= get_target_by_num(strtoul(args
[0], NULL
, 0));
1515 return ERROR_COMMAND_SYNTAX_ERROR
;
1518 target
->run_and_halt_time
= strtoul(args
[1], NULL
, 0);
1523 int handle_working_area_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1525 target_t
*target
= NULL
;
1527 if ((argc
< 4) || (argc
> 5))
1529 return ERROR_COMMAND_SYNTAX_ERROR
;
1532 target
= get_target_by_num(strtoul(args
[0], NULL
, 0));
1535 return ERROR_COMMAND_SYNTAX_ERROR
;
1537 target_free_all_working_areas(target
);
1539 target
->working_area_phys
= target
->working_area_virt
= strtoul(args
[1], NULL
, 0);
1542 target
->working_area_virt
= strtoul(args
[4], NULL
, 0);
1544 target
->working_area_size
= strtoul(args
[2], NULL
, 0);
1546 if (strcmp(args
[3], "backup") == 0)
1548 target
->backup_working_area
= 1;
1550 else if (strcmp(args
[3], "nobackup") == 0)
1552 target
->backup_working_area
= 0;
1556 LOG_ERROR("unrecognized <backup|nobackup> argument (%s)", args
[3]);
1557 return ERROR_COMMAND_SYNTAX_ERROR
;
1564 /* process target state changes */
1565 int handle_target(void *priv
)
1567 target_t
*target
= targets
;
1571 if (target_continous_poll
)
1573 /* polling may fail silently until the target has been examined */
1574 target_poll(target
);
1577 target
= target
->next
;
1583 int handle_reg_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1592 target
= get_current_target(cmd_ctx
);
1594 /* list all available registers for the current target */
1597 reg_cache_t
*cache
= target
->reg_cache
;
1603 for (i
= 0; i
< cache
->num_regs
; i
++)
1605 value
= buf_to_str(cache
->reg_list
[i
].value
, cache
->reg_list
[i
].size
, 16);
1606 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
);
1609 cache
= cache
->next
;
1615 /* access a single register by its ordinal number */
1616 if ((args
[0][0] >= '0') && (args
[0][0] <= '9'))
1618 int num
= strtoul(args
[0], NULL
, 0);
1619 reg_cache_t
*cache
= target
->reg_cache
;
1625 for (i
= 0; i
< cache
->num_regs
; i
++)
1629 reg
= &cache
->reg_list
[i
];
1635 cache
= cache
->next
;
1640 command_print(cmd_ctx
, "%i is out of bounds, the current target has only %i registers (0 - %i)", num
, count
, count
- 1);
1643 } else /* access a single register by its name */
1645 reg
= register_get_by_name(target
->reg_cache
, args
[0], 1);
1649 command_print(cmd_ctx
, "register %s not found in current target", args
[0]);
1654 /* display a register */
1655 if ((argc
== 1) || ((argc
== 2) && !((args
[1][0] >= '0') && (args
[1][0] <= '9'))))
1657 if ((argc
== 2) && (strcmp(args
[1], "force") == 0))
1660 if (reg
->valid
== 0)
1662 reg_arch_type_t
*arch_type
= register_get_arch_type(reg
->arch_type
);
1663 if (arch_type
== NULL
)
1665 LOG_ERROR("BUG: encountered unregistered arch type");
1668 arch_type
->get(reg
);
1670 value
= buf_to_str(reg
->value
, reg
->size
, 16);
1671 command_print(cmd_ctx
, "%s (/%i): 0x%s", reg
->name
, reg
->size
, value
);
1676 /* set register value */
1679 u8
*buf
= malloc(CEIL(reg
->size
, 8));
1680 str_to_buf(args
[1], strlen(args
[1]), buf
, reg
->size
, 0);
1682 reg_arch_type_t
*arch_type
= register_get_arch_type(reg
->arch_type
);
1683 if (arch_type
== NULL
)
1685 LOG_ERROR("BUG: encountered unregistered arch type");
1689 arch_type
->set(reg
, buf
);
1691 value
= buf_to_str(reg
->value
, reg
->size
, 16);
1692 command_print(cmd_ctx
, "%s (/%i): 0x%s", reg
->name
, reg
->size
, value
);
1700 command_print(cmd_ctx
, "usage: reg <#|name> [value]");
1705 static int wait_state(struct command_context_s
*cmd_ctx
, char *cmd
, enum target_state state
, int ms
);
1707 int handle_poll_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1709 target_t
*target
= get_current_target(cmd_ctx
);
1713 target_poll(target
);
1714 target_arch_state(target
);
1718 if (strcmp(args
[0], "on") == 0)
1720 target_continous_poll
= 1;
1722 else if (strcmp(args
[0], "off") == 0)
1724 target_continous_poll
= 0;
1728 command_print(cmd_ctx
, "arg is \"on\" or \"off\"");
1736 int handle_wait_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1744 ms
= strtoul(args
[0], &end
, 0) * 1000;
1747 command_print(cmd_ctx
, "usage: %s [seconds]", cmd
);
1752 return wait_state(cmd_ctx
, cmd
, TARGET_HALTED
, ms
);
1755 static void target_process_events(struct command_context_s
*cmd_ctx
)
1757 target_t
*target
= get_current_target(cmd_ctx
);
1758 target_poll(target
);
1759 target_call_timer_callbacks_now();
1762 static int wait_state(struct command_context_s
*cmd_ctx
, char *cmd
, enum target_state state
, int ms
)
1765 struct timeval timeout
, now
;
1767 gettimeofday(&timeout
, NULL
);
1768 timeval_add_time(&timeout
, 0, ms
* 1000);
1770 target_t
*target
= get_current_target(cmd_ctx
);
1773 if ((retval
=target_poll(target
))!=ERROR_OK
)
1775 target_call_timer_callbacks_now();
1776 if (target
->state
== state
)
1783 command_print(cmd_ctx
, "waiting for target %s...", target_state_strings
[state
]);
1786 gettimeofday(&now
, NULL
);
1787 if ((now
.tv_sec
> timeout
.tv_sec
) || ((now
.tv_sec
== timeout
.tv_sec
) && (now
.tv_usec
>= timeout
.tv_usec
)))
1789 LOG_ERROR("timed out while waiting for target %s", target_state_strings
[state
]);
1797 int handle_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1800 target_t
*target
= get_current_target(cmd_ctx
);
1804 if ((retval
= target_halt(target
)) != ERROR_OK
)
1809 return handle_wait_halt_command(cmd_ctx
, cmd
, args
, argc
);
1813 int handle_soft_reset_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1815 target_t
*target
= get_current_target(cmd_ctx
);
1817 LOG_USER("requesting target halt and executing a soft reset");
1819 target
->type
->soft_reset_halt(target
);
1824 int handle_reset_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1826 target_t
*target
= get_current_target(cmd_ctx
);
1827 enum target_reset_mode reset_mode
= target
->reset_mode
;
1828 enum target_reset_mode save
= target
->reset_mode
;
1834 if (strcmp("run", args
[0]) == 0)
1835 reset_mode
= RESET_RUN
;
1836 else if (strcmp("halt", args
[0]) == 0)
1837 reset_mode
= RESET_HALT
;
1838 else if (strcmp("init", args
[0]) == 0)
1839 reset_mode
= RESET_INIT
;
1840 else if (strcmp("run_and_halt", args
[0]) == 0)
1842 reset_mode
= RESET_RUN_AND_HALT
;
1845 target
->run_and_halt_time
= strtoul(args
[1], NULL
, 0);
1848 else if (strcmp("run_and_init", args
[0]) == 0)
1850 reset_mode
= RESET_RUN_AND_INIT
;
1853 target
->run_and_halt_time
= strtoul(args
[1], NULL
, 0);
1858 command_print(cmd_ctx
, "usage: reset ['run', 'halt', 'init', 'run_and_halt', 'run_and_init]");
1863 /* temporarily modify mode of current reset target */
1864 target
->reset_mode
= reset_mode
;
1866 /* reset *all* targets */
1867 target_process_reset(cmd_ctx
);
1869 /* Restore default reset mode for this target */
1870 target
->reset_mode
= save
;
1875 int handle_resume_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1878 target_t
*target
= get_current_target(cmd_ctx
);
1881 retval
= target_resume(target
, 1, 0, 1, 0); /* current pc, addr = 0, handle breakpoints, not debugging */
1883 retval
= target_resume(target
, 0, strtoul(args
[0], NULL
, 0), 1, 0); /* addr = args[0], handle breakpoints, not debugging */
1886 return ERROR_COMMAND_SYNTAX_ERROR
;
1889 target_process_events(cmd_ctx
);
1894 int handle_step_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1896 target_t
*target
= get_current_target(cmd_ctx
);
1901 target
->type
->step(target
, 1, 0, 1); /* current pc, addr = 0, handle breakpoints */
1904 target
->type
->step(target
, 0, strtoul(args
[0], NULL
, 0), 1); /* addr = args[0], handle breakpoints */
1909 int handle_md_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1911 const int line_bytecnt
= 32;
1924 target_t
*target
= get_current_target(cmd_ctx
);
1930 count
= strtoul(args
[1], NULL
, 0);
1932 address
= strtoul(args
[0], NULL
, 0);
1938 size
= 4; line_modulo
= line_bytecnt
/ 4;
1941 size
= 2; line_modulo
= line_bytecnt
/ 2;
1944 size
= 1; line_modulo
= line_bytecnt
/ 1;
1950 buffer
= calloc(count
, size
);
1951 retval
= target
->type
->read_memory(target
, address
, size
, count
, buffer
);
1952 if (retval
== ERROR_OK
)
1956 for (i
= 0; i
< count
; i
++)
1958 if (i
%line_modulo
== 0)
1959 output_len
+= snprintf(output
+ output_len
, 128 - output_len
, "0x%8.8x: ", address
+ (i
*size
));
1964 output_len
+= snprintf(output
+ output_len
, 128 - output_len
, "%8.8x ", target_buffer_get_u32(target
, &buffer
[i
*4]));
1967 output_len
+= snprintf(output
+ output_len
, 128 - output_len
, "%4.4x ", target_buffer_get_u16(target
, &buffer
[i
*2]));
1970 output_len
+= snprintf(output
+ output_len
, 128 - output_len
, "%2.2x ", buffer
[i
*1]);
1974 if ((i
%line_modulo
== line_modulo
-1) || (i
== count
- 1))
1976 command_print(cmd_ctx
, output
);
1982 LOG_ERROR("Failure examining memory");
1990 int handle_mw_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1997 target_t
*target
= get_current_target(cmd_ctx
);
2000 if ((argc
< 2) || (argc
> 3))
2001 return ERROR_COMMAND_SYNTAX_ERROR
;
2003 address
= strtoul(args
[0], NULL
, 0);
2004 value
= strtoul(args
[1], NULL
, 0);
2006 count
= strtoul(args
[2], NULL
, 0);
2013 target_buffer_set_u32(target
, value_buf
, value
);
2017 target_buffer_set_u16(target
, value_buf
, value
);
2021 value_buf
[0] = value
;
2024 return ERROR_COMMAND_SYNTAX_ERROR
;
2026 for (i
=0; i
<count
; i
++)
2032 retval
= target
->type
->write_memory(target
, address
+ i
*wordsize
, 4, 1, value_buf
);
2035 retval
= target
->type
->write_memory(target
, address
+ i
*wordsize
, 2, 1, value_buf
);
2038 retval
= target
->type
->write_memory(target
, address
+ i
*wordsize
, 1, 1, value_buf
);
2043 if (retval
!=ERROR_OK
)
2053 int handle_load_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2063 duration_t duration
;
2064 char *duration_text
;
2066 target_t
*target
= get_current_target(cmd_ctx
);
2070 command_print(cmd_ctx
, "usage: load_image <filename> [address] [type]");
2074 /* a base address isn't always necessary, default to 0x0 (i.e. don't relocate) */
2077 image
.base_address_set
= 1;
2078 image
.base_address
= strtoul(args
[1], NULL
, 0);
2082 image
.base_address_set
= 0;
2085 image
.start_address_set
= 0;
2087 duration_start_measure(&duration
);
2089 if (image_open(&image
, args
[0], (argc
>= 3) ? args
[2] : NULL
) != ERROR_OK
)
2096 for (i
= 0; i
< image
.num_sections
; i
++)
2098 buffer
= malloc(image
.sections
[i
].size
);
2101 command_print(cmd_ctx
, "error allocating buffer for section (%d bytes)", image
.sections
[i
].size
);
2105 if ((retval
= image_read_section(&image
, i
, 0x0, image
.sections
[i
].size
, buffer
, &buf_cnt
)) != ERROR_OK
)
2110 if ((retval
= target_write_buffer(target
, image
.sections
[i
].base_address
, buf_cnt
, buffer
)) != ERROR_OK
)
2115 image_size
+= buf_cnt
;
2116 command_print(cmd_ctx
, "%u byte written at address 0x%8.8x", buf_cnt
, image
.sections
[i
].base_address
);
2121 duration_stop_measure(&duration
, &duration_text
);
2122 if (retval
==ERROR_OK
)
2124 command_print(cmd_ctx
, "downloaded %u byte in %s", image_size
, duration_text
);
2126 free(duration_text
);
2128 image_close(&image
);
2134 int handle_dump_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2141 int retval
=ERROR_OK
;
2143 duration_t duration
;
2144 char *duration_text
;
2146 target_t
*target
= get_current_target(cmd_ctx
);
2150 command_print(cmd_ctx
, "usage: dump_image <filename> <address> <size>");
2154 address
= strtoul(args
[1], NULL
, 0);
2155 size
= strtoul(args
[2], NULL
, 0);
2157 if ((address
& 3) || (size
& 3))
2159 command_print(cmd_ctx
, "only 32-bit aligned address and size are supported");
2163 if (fileio_open(&fileio
, args
[0], FILEIO_WRITE
, FILEIO_BINARY
) != ERROR_OK
)
2168 duration_start_measure(&duration
);
2173 u32 this_run_size
= (size
> 560) ? 560 : size
;
2175 retval
= target
->type
->read_memory(target
, address
, 4, this_run_size
/ 4, buffer
);
2176 if (retval
!= ERROR_OK
)
2181 retval
= fileio_write(&fileio
, this_run_size
, buffer
, &size_written
);
2182 if (retval
!= ERROR_OK
)
2187 size
-= this_run_size
;
2188 address
+= this_run_size
;
2191 fileio_close(&fileio
);
2193 duration_stop_measure(&duration
, &duration_text
);
2194 if (retval
==ERROR_OK
)
2196 command_print(cmd_ctx
, "dumped %"PRIi64
" byte in %s", fileio
.size
, duration_text
);
2198 free(duration_text
);
2203 int handle_verify_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2211 u32 mem_checksum
= 0;
2215 duration_t duration
;
2216 char *duration_text
;
2218 target_t
*target
= get_current_target(cmd_ctx
);
2222 return ERROR_COMMAND_SYNTAX_ERROR
;
2227 LOG_ERROR("no target selected");
2231 duration_start_measure(&duration
);
2235 image
.base_address_set
= 1;
2236 image
.base_address
= strtoul(args
[1], NULL
, 0);
2240 image
.base_address_set
= 0;
2241 image
.base_address
= 0x0;
2244 image
.start_address_set
= 0;
2246 if ((retval
=image_open(&image
, args
[0], (argc
== 3) ? args
[2] : NULL
)) != ERROR_OK
)
2253 for (i
= 0; i
< image
.num_sections
; i
++)
2255 buffer
= malloc(image
.sections
[i
].size
);
2258 command_print(cmd_ctx
, "error allocating buffer for section (%d bytes)", image
.sections
[i
].size
);
2261 if ((retval
= image_read_section(&image
, i
, 0x0, image
.sections
[i
].size
, buffer
, &buf_cnt
)) != ERROR_OK
)
2267 /* calculate checksum of image */
2268 image_calculate_checksum( buffer
, buf_cnt
, &checksum
);
2270 retval
= target_checksum_memory(target
, image
.sections
[i
].base_address
, buf_cnt
, &mem_checksum
);
2271 if( retval
!= ERROR_OK
)
2277 if( checksum
!= mem_checksum
)
2279 /* failed crc checksum, fall back to a binary compare */
2282 command_print(cmd_ctx
, "checksum mismatch - attempting binary compare");
2284 data
= (u8
*)malloc(buf_cnt
);
2286 /* Can we use 32bit word accesses? */
2288 int count
= buf_cnt
;
2289 if ((count
% 4) == 0)
2294 retval
= target
->type
->read_memory(target
, image
.sections
[i
].base_address
, size
, count
, data
);
2295 if (retval
== ERROR_OK
)
2298 for (t
= 0; t
< buf_cnt
; t
++)
2300 if (data
[t
] != buffer
[t
])
2302 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
]);
2315 image_size
+= buf_cnt
;
2318 duration_stop_measure(&duration
, &duration_text
);
2319 if (retval
==ERROR_OK
)
2321 command_print(cmd_ctx
, "verified %u bytes in %s", image_size
, duration_text
);
2323 free(duration_text
);
2325 image_close(&image
);
2330 int handle_bp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2333 target_t
*target
= get_current_target(cmd_ctx
);
2337 breakpoint_t
*breakpoint
= target
->breakpoints
;
2341 if (breakpoint
->type
== BKPT_SOFT
)
2343 char* buf
= buf_to_str(breakpoint
->orig_instr
, breakpoint
->length
, 16);
2344 command_print(cmd_ctx
, "0x%8.8x, 0x%x, %i, 0x%s", breakpoint
->address
, breakpoint
->length
, breakpoint
->set
, buf
);
2349 command_print(cmd_ctx
, "0x%8.8x, 0x%x, %i", breakpoint
->address
, breakpoint
->length
, breakpoint
->set
);
2351 breakpoint
= breakpoint
->next
;
2359 length
= strtoul(args
[1], NULL
, 0);
2362 if (strcmp(args
[2], "hw") == 0)
2365 if ((retval
= breakpoint_add(target
, strtoul(args
[0], NULL
, 0), length
, hw
)) != ERROR_OK
)
2367 LOG_ERROR("Failure setting breakpoints");
2371 command_print(cmd_ctx
, "breakpoint added at address 0x%8.8x", strtoul(args
[0], NULL
, 0));
2376 command_print(cmd_ctx
, "usage: bp <address> <length> ['hw']");
2382 int handle_rbp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2384 target_t
*target
= get_current_target(cmd_ctx
);
2387 breakpoint_remove(target
, strtoul(args
[0], NULL
, 0));
2392 int handle_wp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2394 target_t
*target
= get_current_target(cmd_ctx
);
2399 watchpoint_t
*watchpoint
= target
->watchpoints
;
2403 command_print(cmd_ctx
, "address: 0x%8.8x, mask: 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
);
2404 watchpoint
= watchpoint
->next
;
2409 enum watchpoint_rw type
= WPT_ACCESS
;
2410 u32 data_value
= 0x0;
2411 u32 data_mask
= 0xffffffff;
2427 command_print(cmd_ctx
, "usage: wp <address> <length> [r/w/a] [value] [mask]");
2433 data_value
= strtoul(args
[3], NULL
, 0);
2437 data_mask
= strtoul(args
[4], NULL
, 0);
2440 if ((retval
= watchpoint_add(target
, strtoul(args
[0], NULL
, 0),
2441 strtoul(args
[1], NULL
, 0), type
, data_value
, data_mask
)) != ERROR_OK
)
2443 LOG_ERROR("Failure setting breakpoints");
2448 command_print(cmd_ctx
, "usage: wp <address> <length> [r/w/a] [value] [mask]");
2454 int handle_rwp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2456 target_t
*target
= get_current_target(cmd_ctx
);
2459 watchpoint_remove(target
, strtoul(args
[0], NULL
, 0));
2464 int handle_virt2phys_command(command_context_t
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2467 target_t
*target
= get_current_target(cmd_ctx
);
2473 return ERROR_COMMAND_SYNTAX_ERROR
;
2475 va
= strtoul(args
[0], NULL
, 0);
2477 retval
= target
->type
->virt2phys(target
, va
, &pa
);
2478 if (retval
== ERROR_OK
)
2480 command_print(cmd_ctx
, "Physical address 0x%08x", pa
);
2484 /* lower levels will have logged a detailed error which is
2485 * forwarded to telnet/GDB session.
2490 static void writeLong(FILE *f
, int l
)
2495 char c
=(l
>>(i
*8))&0xff;
2496 fwrite(&c
, 1, 1, f
);
2500 static void writeString(FILE *f
, char *s
)
2502 fwrite(s
, 1, strlen(s
), f
);
2507 // Dump a gmon.out histogram file.
2508 static void writeGmon(u32
*samples
, int sampleNum
, char *filename
)
2511 FILE *f
=fopen(filename
, "w");
2514 fwrite("gmon", 1, 4, f
);
2515 writeLong(f
, 0x00000001); // Version
2516 writeLong(f
, 0); // padding
2517 writeLong(f
, 0); // padding
2518 writeLong(f
, 0); // padding
2520 fwrite("", 1, 1, f
); // GMON_TAG_TIME_HIST
2522 // figure out bucket size
2525 for (i
=0; i
<sampleNum
; i
++)
2537 int addressSpace
=(max
-min
+1);
2539 static int const maxBuckets
=256*1024; // maximum buckets.
2540 int length
=addressSpace
;
2541 if (length
> maxBuckets
)
2545 int *buckets
=malloc(sizeof(int)*length
);
2551 memset(buckets
, 0, sizeof(int)*length
);
2552 for (i
=0; i
<sampleNum
;i
++)
2554 u32 address
=samples
[i
];
2555 long long a
=address
-min
;
2556 long long b
=length
-1;
2557 long long c
=addressSpace
-1;
2558 int index
=(a
*b
)/c
; // danger!!!! int32 overflows
2562 // append binary memory gmon.out &profile_hist_hdr ((char*)&profile_hist_hdr + sizeof(struct gmon_hist_hdr))
2563 writeLong(f
, min
); // low_pc
2564 writeLong(f
, max
); // high_pc
2565 writeLong(f
, length
); // # of samples
2566 writeLong(f
, 64000000); // 64MHz
2567 writeString(f
, "seconds");
2568 for (i
=0; i
<(15-strlen("seconds")); i
++)
2570 fwrite("", 1, 1, f
); // padding
2572 writeString(f
, "s");
2574 // append binary memory gmon.out profile_hist_data (profile_hist_data + profile_hist_hdr.hist_size)
2576 char *data
=malloc(2*length
);
2579 for (i
=0; i
<length
;i
++)
2588 data
[i
*2+1]=(val
>>8)&0xff;
2591 fwrite(data
, 1, length
*2, f
);
2601 /* profiling samples the CPU PC as quickly as OpenOCD is able, which will be used as a random sampling of PC */
2602 int handle_profile_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2604 target_t
*target
= get_current_target(cmd_ctx
);
2605 struct timeval timeout
, now
;
2607 gettimeofday(&timeout
, NULL
);
2610 return ERROR_COMMAND_SYNTAX_ERROR
;
2613 timeval_add_time(&timeout
, strtoul(args
[0], &end
, 0), 0);
2619 command_print(cmd_ctx
, "Starting profiling. Halting and resuming the target as often as we can...");
2621 static const int maxSample
=10000;
2622 u32
*samples
=malloc(sizeof(u32
)*maxSample
);
2627 int retval
=ERROR_OK
;
2628 // hopefully it is safe to cache! We want to stop/restart as quickly as possible.
2629 reg_t
*reg
= register_get_by_name(target
->reg_cache
, "pc", 1);
2633 target_poll(target
);
2634 if (target
->state
== TARGET_HALTED
)
2636 u32 t
=*((u32
*)reg
->value
);
2637 samples
[numSamples
++]=t
;
2638 retval
= target_resume(target
, 1, 0, 0, 0); /* current pc, addr = 0, do not handle breakpoints, not debugging */
2639 target_poll(target
);
2640 usleep(10*1000); // sleep 10ms, i.e. <100 samples/second.
2641 } else if (target
->state
== TARGET_RUNNING
)
2643 // We want to quickly sample the PC.
2644 target_halt(target
);
2647 command_print(cmd_ctx
, "Target not halted or running");
2651 if (retval
!=ERROR_OK
)
2656 gettimeofday(&now
, NULL
);
2657 if ((numSamples
>=maxSample
) || ((now
.tv_sec
>= timeout
.tv_sec
) && (now
.tv_usec
>= timeout
.tv_usec
)))
2659 command_print(cmd_ctx
, "Profiling completed. %d samples.", numSamples
);
2660 target_poll(target
);
2661 if (target
->state
== TARGET_HALTED
)
2663 target_resume(target
, 1, 0, 0, 0); /* current pc, addr = 0, do not handle breakpoints, not debugging */
2665 target_poll(target
);
2666 writeGmon(samples
, numSamples
, args
[1]);
2667 command_print(cmd_ctx
, "Wrote %s", args
[1]);
Linking to existing account procedure
If you already have an account and want to add another login method
you
MUST first sign in with your existing account and
then change URL to read
https://review.openocd.org/login/?link
to get to this page again but this time it'll work for linking. Thank you.
SSH host keys fingerprints
1024 SHA256:YKx8b7u5ZWdcbp7/4AeXNaqElP49m6QrwfXaqQGJAOk gerrit-code-review@openocd.zylin.com (DSA)
384 SHA256:jHIbSQa4REvwCFG4cq5LBlBLxmxSqelQPem/EXIrxjk gerrit-code-review@openocd.org (ECDSA)
521 SHA256:UAOPYkU9Fjtcao0Ul/Rrlnj/OsQvt+pgdYSZ4jOYdgs gerrit-code-review@openocd.org (ECDSA)
256 SHA256:A13M5QlnozFOvTllybRZH6vm7iSt0XLxbA48yfc2yfY gerrit-code-review@openocd.org (ECDSA)
256 SHA256:spYMBqEYoAOtK7yZBrcwE8ZpYt6b68Cfh9yEVetvbXg gerrit-code-review@openocd.org (ED25519)
+--[ED25519 256]--+
|=.. |
|+o.. . |
|*.o . . |
|+B . . . |
|Bo. = o S |
|Oo.+ + = |
|oB=.* = . o |
| =+=.+ + E |
|. .=o . o |
+----[SHA256]-----+
2048 SHA256:0Onrb7/PHjpo6iVZ7xQX2riKN83FJ3KGU0TvI0TaFG4 gerrit-code-review@openocd.zylin.com (RSA)