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
;
251 target
->type
->halt(target
);
256 int target_process_reset(struct command_context_s
*cmd_ctx
)
258 int retval
= ERROR_OK
;
260 struct timeval timeout
, now
;
262 jtag
->speed(jtag_speed
);
264 if ((retval
= jtag_init_reset(cmd_ctx
)) != ERROR_OK
)
268 /* prepare reset_halt where necessary */
272 if (jtag_reset_config
& RESET_SRST_PULLS_TRST
)
274 switch (target
->reset_mode
)
277 command_print(cmd_ctx
, "nSRST pulls nTRST, falling back to \"reset run_and_halt\"");
278 target
->reset_mode
= RESET_RUN_AND_HALT
;
281 command_print(cmd_ctx
, "nSRST pulls nTRST, falling back to \"reset run_and_init\"");
282 target
->reset_mode
= RESET_RUN_AND_INIT
;
288 target
= target
->next
;
294 /* we have no idea what state the target is in, so we
295 * have to drop working areas
297 target_free_all_working_areas_restore(target
, 0);
298 target
->type
->assert_reset(target
);
299 target
= target
->next
;
301 if ((retval
= jtag_execute_queue()) != ERROR_OK
)
303 LOG_WARNING("JTAG communication failed asserting reset.");
307 /* request target halt if necessary, and schedule further action */
311 switch (target
->reset_mode
)
314 /* nothing to do if target just wants to be run */
316 case RESET_RUN_AND_HALT
:
318 target_register_timer_callback(target_run_and_halt_handler
, target
->run_and_halt_time
, 0, target
);
320 case RESET_RUN_AND_INIT
:
322 target_register_timer_callback(target_run_and_halt_handler
, target
->run_and_halt_time
, 0, target
);
323 target_register_event_callback(target_init_handler
, cmd_ctx
);
326 target
->type
->halt(target
);
329 target
->type
->halt(target
);
330 target_register_event_callback(target_init_handler
, cmd_ctx
);
333 LOG_ERROR("BUG: unknown target->reset_mode");
335 target
= target
->next
;
338 if ((retval
= jtag_execute_queue()) != ERROR_OK
)
340 LOG_WARNING("JTAG communication failed while reset was asserted. Consider using srst_only for reset_config.");
347 target
->type
->deassert_reset(target
);
348 target
= target
->next
;
351 if ((retval
= jtag_execute_queue()) != ERROR_OK
)
353 LOG_WARNING("JTAG communication failed while deasserting reset.");
357 LOG_DEBUG("Waiting for halted stated as approperiate");
359 /* Wait for reset to complete, maximum 5 seconds. */
360 gettimeofday(&timeout
, NULL
);
361 timeval_add_time(&timeout
, 5, 0);
364 gettimeofday(&now
, NULL
);
366 target_call_timer_callbacks_now();
371 LOG_DEBUG("Polling target");
372 target
->type
->poll(target
);
373 if ((target
->reset_mode
== RESET_RUN_AND_INIT
) ||
374 (target
->reset_mode
== RESET_RUN_AND_HALT
) ||
375 (target
->reset_mode
== RESET_HALT
) ||
376 (target
->reset_mode
== RESET_INIT
))
378 if (target
->state
!= TARGET_HALTED
)
380 if ((now
.tv_sec
> timeout
.tv_sec
) || ((now
.tv_sec
== timeout
.tv_sec
) && (now
.tv_usec
>= timeout
.tv_usec
)))
382 LOG_USER("Timed out waiting for halt after reset");
385 /* this will send alive messages on e.g. GDB remote protocol. */
387 LOG_USER_N("%s", ""); /* avoid warning about zero length formatting message*/
391 target
= target
->next
;
393 /* All targets we're waiting for are halted */
401 /* We want any events to be processed before the prompt */
402 target_call_timer_callbacks_now();
404 /* if we timed out we need to unregister these handlers */
408 target_unregister_timer_callback(target_run_and_halt_handler
, target
);
409 target
= target
->next
;
411 target_unregister_event_callback(target_init_handler
, cmd_ctx
);
414 jtag
->speed(jtag_speed_post_reset
);
419 static int default_virt2phys(struct target_s
*target
, u32
virtual, u32
*physical
)
425 static int default_mmu(struct target_s
*target
, int *enabled
)
431 int target_init(struct command_context_s
*cmd_ctx
)
433 target_t
*target
= targets
;
437 if (target
->type
->init_target(cmd_ctx
, target
) != ERROR_OK
)
439 LOG_ERROR("target '%s' init failed", target
->type
->name
);
443 /* Set up default functions if none are provided by target */
444 if (target
->type
->virt2phys
== NULL
)
446 target
->type
->virt2phys
= default_virt2phys
;
448 if (target
->type
->mmu
== NULL
)
450 target
->type
->mmu
= default_mmu
;
452 target
= target
->next
;
457 target_register_user_commands(cmd_ctx
);
458 target_register_timer_callback(handle_target
, 100, 1, NULL
);
464 int target_register_event_callback(int (*callback
)(struct target_s
*target
, enum target_event event
, void *priv
), void *priv
)
466 target_event_callback_t
**callbacks_p
= &target_event_callbacks
;
468 if (callback
== NULL
)
470 return ERROR_INVALID_ARGUMENTS
;
475 while ((*callbacks_p
)->next
)
476 callbacks_p
= &((*callbacks_p
)->next
);
477 callbacks_p
= &((*callbacks_p
)->next
);
480 (*callbacks_p
) = malloc(sizeof(target_event_callback_t
));
481 (*callbacks_p
)->callback
= callback
;
482 (*callbacks_p
)->priv
= priv
;
483 (*callbacks_p
)->next
= NULL
;
488 int target_register_timer_callback(int (*callback
)(void *priv
), int time_ms
, int periodic
, void *priv
)
490 target_timer_callback_t
**callbacks_p
= &target_timer_callbacks
;
493 if (callback
== NULL
)
495 return ERROR_INVALID_ARGUMENTS
;
500 while ((*callbacks_p
)->next
)
501 callbacks_p
= &((*callbacks_p
)->next
);
502 callbacks_p
= &((*callbacks_p
)->next
);
505 (*callbacks_p
) = malloc(sizeof(target_timer_callback_t
));
506 (*callbacks_p
)->callback
= callback
;
507 (*callbacks_p
)->periodic
= periodic
;
508 (*callbacks_p
)->time_ms
= time_ms
;
510 gettimeofday(&now
, NULL
);
511 (*callbacks_p
)->when
.tv_usec
= now
.tv_usec
+ (time_ms
% 1000) * 1000;
512 time_ms
-= (time_ms
% 1000);
513 (*callbacks_p
)->when
.tv_sec
= now
.tv_sec
+ (time_ms
/ 1000);
514 if ((*callbacks_p
)->when
.tv_usec
> 1000000)
516 (*callbacks_p
)->when
.tv_usec
= (*callbacks_p
)->when
.tv_usec
- 1000000;
517 (*callbacks_p
)->when
.tv_sec
+= 1;
520 (*callbacks_p
)->priv
= priv
;
521 (*callbacks_p
)->next
= NULL
;
526 int target_unregister_event_callback(int (*callback
)(struct target_s
*target
, enum target_event event
, void *priv
), void *priv
)
528 target_event_callback_t
**p
= &target_event_callbacks
;
529 target_event_callback_t
*c
= target_event_callbacks
;
531 if (callback
== NULL
)
533 return ERROR_INVALID_ARGUMENTS
;
538 target_event_callback_t
*next
= c
->next
;
539 if ((c
->callback
== callback
) && (c
->priv
== priv
))
553 int target_unregister_timer_callback(int (*callback
)(void *priv
), void *priv
)
555 target_timer_callback_t
**p
= &target_timer_callbacks
;
556 target_timer_callback_t
*c
= target_timer_callbacks
;
558 if (callback
== NULL
)
560 return ERROR_INVALID_ARGUMENTS
;
565 target_timer_callback_t
*next
= c
->next
;
566 if ((c
->callback
== callback
) && (c
->priv
== priv
))
580 int target_call_event_callbacks(target_t
*target
, enum target_event event
)
582 target_event_callback_t
*callback
= target_event_callbacks
;
583 target_event_callback_t
*next_callback
;
585 LOG_DEBUG("target event %i", event
);
589 next_callback
= callback
->next
;
590 callback
->callback(target
, event
, callback
->priv
);
591 callback
= next_callback
;
597 static int target_call_timer_callbacks_check_time(int checktime
)
599 target_timer_callback_t
*callback
= target_timer_callbacks
;
600 target_timer_callback_t
*next_callback
;
603 gettimeofday(&now
, NULL
);
607 next_callback
= callback
->next
;
609 if ((!checktime
&&callback
->periodic
)||
610 (((now
.tv_sec
>= callback
->when
.tv_sec
) && (now
.tv_usec
>= callback
->when
.tv_usec
))
611 || (now
.tv_sec
> callback
->when
.tv_sec
)))
613 callback
->callback(callback
->priv
);
614 if (callback
->periodic
)
616 int time_ms
= callback
->time_ms
;
617 callback
->when
.tv_usec
= now
.tv_usec
+ (time_ms
% 1000) * 1000;
618 time_ms
-= (time_ms
% 1000);
619 callback
->when
.tv_sec
= now
.tv_sec
+ time_ms
/ 1000;
620 if (callback
->when
.tv_usec
> 1000000)
622 callback
->when
.tv_usec
= callback
->when
.tv_usec
- 1000000;
623 callback
->when
.tv_sec
+= 1;
627 target_unregister_timer_callback(callback
->callback
, callback
->priv
);
630 callback
= next_callback
;
636 int target_call_timer_callbacks()
638 return target_call_timer_callbacks_check_time(1);
641 /* invoke periodic callbacks immediately */
642 int target_call_timer_callbacks_now()
644 return target_call_timer_callbacks(0);
648 int target_alloc_working_area(struct target_s
*target
, u32 size
, working_area_t
**area
)
650 working_area_t
*c
= target
->working_areas
;
651 working_area_t
*new_wa
= NULL
;
653 /* Reevaluate working area address based on MMU state*/
654 if (target
->working_areas
== NULL
)
658 retval
= target
->type
->mmu(target
, &enabled
);
659 if (retval
!= ERROR_OK
)
665 target
->working_area
= target
->working_area_virt
;
669 target
->working_area
= target
->working_area_phys
;
673 /* only allocate multiples of 4 byte */
676 LOG_ERROR("BUG: code tried to allocate unaligned number of bytes, padding");
677 size
= CEIL(size
, 4);
680 /* see if there's already a matching working area */
683 if ((c
->free
) && (c
->size
== size
))
691 /* if not, allocate a new one */
694 working_area_t
**p
= &target
->working_areas
;
695 u32 first_free
= target
->working_area
;
696 u32 free_size
= target
->working_area_size
;
698 LOG_DEBUG("allocating new working area");
700 c
= target
->working_areas
;
703 first_free
+= c
->size
;
704 free_size
-= c
->size
;
709 if (free_size
< size
)
711 LOG_WARNING("not enough working area available(requested %d, free %d)", size
, free_size
);
712 return ERROR_TARGET_RESOURCE_NOT_AVAILABLE
;
715 new_wa
= malloc(sizeof(working_area_t
));
718 new_wa
->address
= first_free
;
720 if (target
->backup_working_area
)
722 new_wa
->backup
= malloc(new_wa
->size
);
723 target
->type
->read_memory(target
, new_wa
->address
, 4, new_wa
->size
/ 4, new_wa
->backup
);
727 new_wa
->backup
= NULL
;
730 /* put new entry in list */
734 /* mark as used, and return the new (reused) area */
744 int target_free_working_area_restore(struct target_s
*target
, working_area_t
*area
, int restore
)
749 if (restore
&&target
->backup_working_area
)
750 target
->type
->write_memory(target
, area
->address
, 4, area
->size
/ 4, area
->backup
);
754 /* mark user pointer invalid */
761 int target_free_working_area(struct target_s
*target
, working_area_t
*area
)
763 return target_free_working_area_restore(target
, area
, 1);
766 int target_free_all_working_areas_restore(struct target_s
*target
, int restore
)
768 working_area_t
*c
= target
->working_areas
;
772 working_area_t
*next
= c
->next
;
773 target_free_working_area_restore(target
, c
, restore
);
783 target
->working_areas
= NULL
;
788 int target_free_all_working_areas(struct target_s
*target
)
790 return target_free_all_working_areas_restore(target
, 1);
793 int target_register_commands(struct command_context_s
*cmd_ctx
)
795 register_command(cmd_ctx
, NULL
, "target", handle_target_command
, COMMAND_CONFIG
, "target <cpu> [reset_init default - DEPRECATED] <chainpos> <endianness> <variant> [cpu type specifc args]");
796 register_command(cmd_ctx
, NULL
, "targets", handle_targets_command
, COMMAND_EXEC
, NULL
);
797 register_command(cmd_ctx
, NULL
, "target_script", handle_target_script_command
, COMMAND_CONFIG
, NULL
);
798 register_command(cmd_ctx
, NULL
, "run_and_halt_time", handle_run_and_halt_time_command
, COMMAND_CONFIG
, "<target> <run time ms>");
799 register_command(cmd_ctx
, NULL
, "working_area", handle_working_area_command
, COMMAND_ANY
, "working_area <target#> <address> <size> <'backup'|'nobackup'> [virtual address]");
800 register_command(cmd_ctx
, NULL
, "virt2phys", handle_virt2phys_command
, COMMAND_ANY
, "virt2phys <virtual address>");
801 register_command(cmd_ctx
, NULL
, "profile", handle_profile_command
, COMMAND_EXEC
, "PRELIMINARY! - profile <seconds> <gmon.out>");
806 int target_arch_state(struct target_s
*target
)
811 LOG_USER("No target has been configured");
815 LOG_USER("target state: %s", target_state_strings
[target
->state
]);
817 if (target
->state
!=TARGET_HALTED
)
820 retval
=target
->type
->arch_state(target
);
824 /* Single aligned words are guaranteed to use 16 or 32 bit access
825 * mode respectively, otherwise data is handled as quickly as
828 int target_write_buffer(struct target_s
*target
, u32 address
, u32 size
, u8
*buffer
)
832 LOG_DEBUG("writing buffer of %i byte at 0x%8.8x", size
, address
);
834 if (((address
% 2) == 0) && (size
== 2))
836 return target
->type
->write_memory(target
, address
, 2, 1, buffer
);
839 /* handle unaligned head bytes */
842 int unaligned
= 4 - (address
% 4);
844 if (unaligned
> size
)
847 if ((retval
= target
->type
->write_memory(target
, address
, 1, unaligned
, buffer
)) != ERROR_OK
)
851 address
+= unaligned
;
855 /* handle aligned words */
858 int aligned
= size
- (size
% 4);
860 /* use bulk writes above a certain limit. This may have to be changed */
863 if ((retval
= target
->type
->bulk_write_memory(target
, address
, aligned
/ 4, buffer
)) != ERROR_OK
)
868 if ((retval
= target
->type
->write_memory(target
, address
, 4, aligned
/ 4, buffer
)) != ERROR_OK
)
877 /* handle tail writes of less than 4 bytes */
880 if ((retval
= target
->type
->write_memory(target
, address
, 1, size
, buffer
)) != ERROR_OK
)
888 /* Single aligned words are guaranteed to use 16 or 32 bit access
889 * mode respectively, otherwise data is handled as quickly as
892 int target_read_buffer(struct target_s
*target
, u32 address
, u32 size
, u8
*buffer
)
896 LOG_DEBUG("reading buffer of %i byte at 0x%8.8x", size
, address
);
898 if (((address
% 2) == 0) && (size
== 2))
900 return target
->type
->read_memory(target
, address
, 2, 1, buffer
);
903 /* handle unaligned head bytes */
906 int unaligned
= 4 - (address
% 4);
908 if (unaligned
> size
)
911 if ((retval
= target
->type
->read_memory(target
, address
, 1, unaligned
, buffer
)) != ERROR_OK
)
915 address
+= unaligned
;
919 /* handle aligned words */
922 int aligned
= size
- (size
% 4);
924 if ((retval
= target
->type
->read_memory(target
, address
, 4, aligned
/ 4, buffer
)) != ERROR_OK
)
932 /* handle tail writes of less than 4 bytes */
935 if ((retval
= target
->type
->read_memory(target
, address
, 1, size
, buffer
)) != ERROR_OK
)
942 int target_checksum_memory(struct target_s
*target
, u32 address
, u32 size
, u32
* crc
)
949 if ((retval
= target
->type
->checksum_memory(target
, address
,
950 size
, &checksum
)) == ERROR_TARGET_RESOURCE_NOT_AVAILABLE
)
952 buffer
= malloc(size
);
955 LOG_ERROR("error allocating buffer for section (%d bytes)", size
);
956 return ERROR_INVALID_ARGUMENTS
;
958 retval
= target_read_buffer(target
, address
, size
, buffer
);
959 if (retval
!= ERROR_OK
)
965 /* convert to target endianess */
966 for (i
= 0; i
< (size
/sizeof(u32
)); i
++)
969 target_data
= target_buffer_get_u32(target
, &buffer
[i
*sizeof(u32
)]);
970 target_buffer_set_u32(target
, &buffer
[i
*sizeof(u32
)], target_data
);
973 retval
= image_calculate_checksum( buffer
, size
, &checksum
);
982 int target_read_u32(struct target_s
*target
, u32 address
, u32
*value
)
986 int retval
= target
->type
->read_memory(target
, address
, 4, 1, value_buf
);
988 if (retval
== ERROR_OK
)
990 *value
= target_buffer_get_u32(target
, value_buf
);
991 LOG_DEBUG("address: 0x%8.8x, value: 0x%8.8x", address
, *value
);
996 LOG_DEBUG("address: 0x%8.8x failed", address
);
1002 int target_read_u16(struct target_s
*target
, u32 address
, u16
*value
)
1006 int retval
= target
->type
->read_memory(target
, address
, 2, 1, value_buf
);
1008 if (retval
== ERROR_OK
)
1010 *value
= target_buffer_get_u16(target
, value_buf
);
1011 LOG_DEBUG("address: 0x%8.8x, value: 0x%4.4x", address
, *value
);
1016 LOG_DEBUG("address: 0x%8.8x failed", address
);
1022 int target_read_u8(struct target_s
*target
, u32 address
, u8
*value
)
1024 int retval
= target
->type
->read_memory(target
, address
, 1, 1, value
);
1026 if (retval
== ERROR_OK
)
1028 LOG_DEBUG("address: 0x%8.8x, value: 0x%2.2x", address
, *value
);
1033 LOG_DEBUG("address: 0x%8.8x failed", address
);
1039 int target_write_u32(struct target_s
*target
, u32 address
, u32 value
)
1044 LOG_DEBUG("address: 0x%8.8x, value: 0x%8.8x", address
, value
);
1046 target_buffer_set_u32(target
, value_buf
, value
);
1047 if ((retval
= target
->type
->write_memory(target
, address
, 4, 1, value_buf
)) != ERROR_OK
)
1049 LOG_DEBUG("failed: %i", retval
);
1055 int target_write_u16(struct target_s
*target
, u32 address
, u16 value
)
1060 LOG_DEBUG("address: 0x%8.8x, value: 0x%8.8x", address
, value
);
1062 target_buffer_set_u16(target
, value_buf
, value
);
1063 if ((retval
= target
->type
->write_memory(target
, address
, 2, 1, value_buf
)) != ERROR_OK
)
1065 LOG_DEBUG("failed: %i", retval
);
1071 int target_write_u8(struct target_s
*target
, u32 address
, u8 value
)
1075 LOG_DEBUG("address: 0x%8.8x, value: 0x%2.2x", address
, value
);
1077 if ((retval
= target
->type
->read_memory(target
, address
, 1, 1, &value
)) != ERROR_OK
)
1079 LOG_DEBUG("failed: %i", retval
);
1085 int target_register_user_commands(struct command_context_s
*cmd_ctx
)
1087 register_command(cmd_ctx
, NULL
, "reg", handle_reg_command
, COMMAND_EXEC
, NULL
);
1088 register_command(cmd_ctx
, NULL
, "poll", handle_poll_command
, COMMAND_EXEC
, "poll target state");
1089 register_command(cmd_ctx
, NULL
, "wait_halt", handle_wait_halt_command
, COMMAND_EXEC
, "wait for target halt [time (s)]");
1090 register_command(cmd_ctx
, NULL
, "halt", handle_halt_command
, COMMAND_EXEC
, "halt target");
1091 register_command(cmd_ctx
, NULL
, "resume", handle_resume_command
, COMMAND_EXEC
, "resume target [addr]");
1092 register_command(cmd_ctx
, NULL
, "step", handle_step_command
, COMMAND_EXEC
, "step one instruction from current PC or [addr]");
1093 register_command(cmd_ctx
, NULL
, "reset", handle_reset_command
, COMMAND_EXEC
, "reset target [run|halt|init|run_and_halt|run_and_init]");
1094 register_command(cmd_ctx
, NULL
, "soft_reset_halt", handle_soft_reset_halt_command
, COMMAND_EXEC
, "halt the target and do a soft reset");
1096 register_command(cmd_ctx
, NULL
, "mdw", handle_md_command
, COMMAND_EXEC
, "display memory words <addr> [count]");
1097 register_command(cmd_ctx
, NULL
, "mdh", handle_md_command
, COMMAND_EXEC
, "display memory half-words <addr> [count]");
1098 register_command(cmd_ctx
, NULL
, "mdb", handle_md_command
, COMMAND_EXEC
, "display memory bytes <addr> [count]");
1100 register_command(cmd_ctx
, NULL
, "mww", handle_mw_command
, COMMAND_EXEC
, "write memory word <addr> <value> [count]");
1101 register_command(cmd_ctx
, NULL
, "mwh", handle_mw_command
, COMMAND_EXEC
, "write memory half-word <addr> <value> [count]");
1102 register_command(cmd_ctx
, NULL
, "mwb", handle_mw_command
, COMMAND_EXEC
, "write memory byte <addr> <value> [count]");
1104 register_command(cmd_ctx
, NULL
, "bp", handle_bp_command
, COMMAND_EXEC
, "set breakpoint <address> <length> [hw]");
1105 register_command(cmd_ctx
, NULL
, "rbp", handle_rbp_command
, COMMAND_EXEC
, "remove breakpoint <adress>");
1106 register_command(cmd_ctx
, NULL
, "wp", handle_wp_command
, COMMAND_EXEC
, "set watchpoint <address> <length> <r/w/a> [value] [mask]");
1107 register_command(cmd_ctx
, NULL
, "rwp", handle_rwp_command
, COMMAND_EXEC
, "remove watchpoint <adress>");
1109 register_command(cmd_ctx
, NULL
, "load_image", handle_load_image_command
, COMMAND_EXEC
, "load_image <file> <address> ['bin'|'ihex'|'elf'|'s19']");
1110 register_command(cmd_ctx
, NULL
, "dump_image", handle_dump_image_command
, COMMAND_EXEC
, "dump_image <file> <address> <size>");
1111 register_command(cmd_ctx
, NULL
, "verify_image", handle_verify_image_command
, COMMAND_EXEC
, "verify_image <file> [offset] [type]");
1112 register_command(cmd_ctx
, NULL
, "load_binary", handle_load_image_command
, COMMAND_EXEC
, "[DEPRECATED] load_binary <file> <address>");
1113 register_command(cmd_ctx
, NULL
, "dump_binary", handle_dump_image_command
, COMMAND_EXEC
, "[DEPRECATED] dump_binary <file> <address> <size>");
1115 target_request_register_commands(cmd_ctx
);
1116 trace_register_commands(cmd_ctx
);
1121 int handle_targets_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1123 target_t
*target
= targets
;
1128 int num
= strtoul(args
[0], NULL
, 0);
1133 target
= target
->next
;
1137 cmd_ctx
->current_target
= num
;
1139 command_print(cmd_ctx
, "%i is out of bounds, only %i targets are configured", num
, count
);
1146 command_print(cmd_ctx
, "%i: %s (%s), state: %s", count
++, target
->type
->name
, target_endianess_strings
[target
->endianness
], target_state_strings
[target
->state
]);
1147 target
= target
->next
;
1153 int handle_target_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1160 return ERROR_COMMAND_SYNTAX_ERROR
;
1163 /* search for the specified target */
1164 if (args
[0] && (args
[0][0] != 0))
1166 for (i
= 0; target_types
[i
]; i
++)
1168 if (strcmp(args
[0], target_types
[i
]->name
) == 0)
1170 target_t
**last_target_p
= &targets
;
1172 /* register target specific commands */
1173 if (target_types
[i
]->register_commands(cmd_ctx
) != ERROR_OK
)
1175 LOG_ERROR("couldn't register '%s' commands", args
[0]);
1181 while ((*last_target_p
)->next
)
1182 last_target_p
= &((*last_target_p
)->next
);
1183 last_target_p
= &((*last_target_p
)->next
);
1186 *last_target_p
= malloc(sizeof(target_t
));
1188 (*last_target_p
)->type
= target_types
[i
];
1190 if (strcmp(args
[1], "big") == 0)
1191 (*last_target_p
)->endianness
= TARGET_BIG_ENDIAN
;
1192 else if (strcmp(args
[1], "little") == 0)
1193 (*last_target_p
)->endianness
= TARGET_LITTLE_ENDIAN
;
1196 LOG_ERROR("endianness must be either 'little' or 'big', not '%s'", args
[1]);
1197 return ERROR_COMMAND_SYNTAX_ERROR
;
1200 /* what to do on a target reset */
1201 (*last_target_p
)->reset_mode
= RESET_INIT
; /* default */
1202 if (strcmp(args
[2], "reset_halt") == 0)
1203 (*last_target_p
)->reset_mode
= RESET_HALT
;
1204 else if (strcmp(args
[2], "reset_run") == 0)
1205 (*last_target_p
)->reset_mode
= RESET_RUN
;
1206 else if (strcmp(args
[2], "reset_init") == 0)
1207 (*last_target_p
)->reset_mode
= RESET_INIT
;
1208 else if (strcmp(args
[2], "run_and_halt") == 0)
1209 (*last_target_p
)->reset_mode
= RESET_RUN_AND_HALT
;
1210 else if (strcmp(args
[2], "run_and_init") == 0)
1211 (*last_target_p
)->reset_mode
= RESET_RUN_AND_INIT
;
1214 /* Kludge! we want to make this reset arg optional while remaining compatible! */
1218 (*last_target_p
)->run_and_halt_time
= 1000; /* default 1s */
1220 (*last_target_p
)->reset_script
= NULL
;
1221 (*last_target_p
)->post_halt_script
= NULL
;
1222 (*last_target_p
)->pre_resume_script
= NULL
;
1223 (*last_target_p
)->gdb_program_script
= NULL
;
1225 (*last_target_p
)->working_area
= 0x0;
1226 (*last_target_p
)->working_area_size
= 0x0;
1227 (*last_target_p
)->working_areas
= NULL
;
1228 (*last_target_p
)->backup_working_area
= 0;
1230 (*last_target_p
)->state
= TARGET_UNKNOWN
;
1231 (*last_target_p
)->debug_reason
= DBG_REASON_UNDEFINED
;
1232 (*last_target_p
)->reg_cache
= NULL
;
1233 (*last_target_p
)->breakpoints
= NULL
;
1234 (*last_target_p
)->watchpoints
= NULL
;
1235 (*last_target_p
)->next
= NULL
;
1236 (*last_target_p
)->arch_info
= NULL
;
1238 /* initialize trace information */
1239 (*last_target_p
)->trace_info
= malloc(sizeof(trace_t
));
1240 (*last_target_p
)->trace_info
->num_trace_points
= 0;
1241 (*last_target_p
)->trace_info
->trace_points_size
= 0;
1242 (*last_target_p
)->trace_info
->trace_points
= NULL
;
1243 (*last_target_p
)->trace_info
->trace_history_size
= 0;
1244 (*last_target_p
)->trace_info
->trace_history
= NULL
;
1245 (*last_target_p
)->trace_info
->trace_history_pos
= 0;
1246 (*last_target_p
)->trace_info
->trace_history_overflowed
= 0;
1248 (*last_target_p
)->dbgmsg
= NULL
;
1249 (*last_target_p
)->dbg_msg_enabled
= 0;
1251 (*last_target_p
)->type
->target_command(cmd_ctx
, cmd
, args
, argc
, *last_target_p
);
1259 /* no matching target found */
1262 LOG_ERROR("target '%s' not found", args
[0]);
1263 return ERROR_COMMAND_SYNTAX_ERROR
;
1269 /* usage: target_script <target#> <event> <script_file> */
1270 int handle_target_script_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1272 target_t
*target
= NULL
;
1276 LOG_ERROR("incomplete target_script command");
1277 return ERROR_COMMAND_SYNTAX_ERROR
;
1280 target
= get_target_by_num(strtoul(args
[0], NULL
, 0));
1284 return ERROR_COMMAND_SYNTAX_ERROR
;
1287 if (strcmp(args
[1], "reset") == 0)
1289 if (target
->reset_script
)
1290 free(target
->reset_script
);
1291 target
->reset_script
= strdup(args
[2]);
1293 else if (strcmp(args
[1], "post_halt") == 0)
1295 if (target
->post_halt_script
)
1296 free(target
->post_halt_script
);
1297 target
->post_halt_script
= strdup(args
[2]);
1299 else if (strcmp(args
[1], "pre_resume") == 0)
1301 if (target
->pre_resume_script
)
1302 free(target
->pre_resume_script
);
1303 target
->pre_resume_script
= strdup(args
[2]);
1305 else if (strcmp(args
[1], "gdb_program_config") == 0)
1307 if (target
->gdb_program_script
)
1308 free(target
->gdb_program_script
);
1309 target
->gdb_program_script
= strdup(args
[2]);
1313 LOG_ERROR("unknown event type: '%s", args
[1]);
1314 return ERROR_COMMAND_SYNTAX_ERROR
;
1320 int handle_run_and_halt_time_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1322 target_t
*target
= NULL
;
1326 return ERROR_COMMAND_SYNTAX_ERROR
;
1329 target
= get_target_by_num(strtoul(args
[0], NULL
, 0));
1332 return ERROR_COMMAND_SYNTAX_ERROR
;
1335 target
->run_and_halt_time
= strtoul(args
[1], NULL
, 0);
1340 int handle_working_area_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1342 target_t
*target
= NULL
;
1344 if ((argc
< 4) || (argc
> 5))
1346 return ERROR_COMMAND_SYNTAX_ERROR
;
1349 target
= get_target_by_num(strtoul(args
[0], NULL
, 0));
1352 return ERROR_COMMAND_SYNTAX_ERROR
;
1354 target_free_all_working_areas(target
);
1356 target
->working_area_phys
= target
->working_area_virt
= strtoul(args
[1], NULL
, 0);
1359 target
->working_area_virt
= strtoul(args
[4], NULL
, 0);
1361 target
->working_area_size
= strtoul(args
[2], NULL
, 0);
1363 if (strcmp(args
[3], "backup") == 0)
1365 target
->backup_working_area
= 1;
1367 else if (strcmp(args
[3], "nobackup") == 0)
1369 target
->backup_working_area
= 0;
1373 LOG_ERROR("unrecognized <backup|nobackup> argument (%s)", args
[3]);
1374 return ERROR_COMMAND_SYNTAX_ERROR
;
1381 /* process target state changes */
1382 int handle_target(void *priv
)
1385 target_t
*target
= targets
;
1389 /* only poll if target isn't already halted */
1390 if (target
->state
!= TARGET_HALTED
)
1392 if (target_continous_poll
)
1393 if ((retval
= target
->type
->poll(target
)) != ERROR_OK
)
1395 LOG_ERROR("couldn't poll target(%d). It's due for a reset.", retval
);
1399 target
= target
->next
;
1405 int handle_reg_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1414 target
= get_current_target(cmd_ctx
);
1416 /* list all available registers for the current target */
1419 reg_cache_t
*cache
= target
->reg_cache
;
1425 for (i
= 0; i
< cache
->num_regs
; i
++)
1427 value
= buf_to_str(cache
->reg_list
[i
].value
, cache
->reg_list
[i
].size
, 16);
1428 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
);
1431 cache
= cache
->next
;
1437 /* access a single register by its ordinal number */
1438 if ((args
[0][0] >= '0') && (args
[0][0] <= '9'))
1440 int num
= strtoul(args
[0], NULL
, 0);
1441 reg_cache_t
*cache
= target
->reg_cache
;
1447 for (i
= 0; i
< cache
->num_regs
; i
++)
1451 reg
= &cache
->reg_list
[i
];
1457 cache
= cache
->next
;
1462 command_print(cmd_ctx
, "%i is out of bounds, the current target has only %i registers (0 - %i)", num
, count
, count
- 1);
1465 } else /* access a single register by its name */
1467 reg
= register_get_by_name(target
->reg_cache
, args
[0], 1);
1471 command_print(cmd_ctx
, "register %s not found in current target", args
[0]);
1476 /* display a register */
1477 if ((argc
== 1) || ((argc
== 2) && !((args
[1][0] >= '0') && (args
[1][0] <= '9'))))
1479 if ((argc
== 2) && (strcmp(args
[1], "force") == 0))
1482 if (reg
->valid
== 0)
1484 reg_arch_type_t
*arch_type
= register_get_arch_type(reg
->arch_type
);
1485 if (arch_type
== NULL
)
1487 LOG_ERROR("BUG: encountered unregistered arch type");
1490 arch_type
->get(reg
);
1492 value
= buf_to_str(reg
->value
, reg
->size
, 16);
1493 command_print(cmd_ctx
, "%s (/%i): 0x%s", reg
->name
, reg
->size
, value
);
1498 /* set register value */
1501 u8
*buf
= malloc(CEIL(reg
->size
, 8));
1502 str_to_buf(args
[1], strlen(args
[1]), buf
, reg
->size
, 0);
1504 reg_arch_type_t
*arch_type
= register_get_arch_type(reg
->arch_type
);
1505 if (arch_type
== NULL
)
1507 LOG_ERROR("BUG: encountered unregistered arch type");
1511 arch_type
->set(reg
, buf
);
1513 value
= buf_to_str(reg
->value
, reg
->size
, 16);
1514 command_print(cmd_ctx
, "%s (/%i): 0x%s", reg
->name
, reg
->size
, value
);
1522 command_print(cmd_ctx
, "usage: reg <#|name> [value]");
1527 static int wait_state(struct command_context_s
*cmd_ctx
, char *cmd
, enum target_state state
, int ms
);
1529 int handle_poll_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1531 target_t
*target
= get_current_target(cmd_ctx
);
1535 target
->type
->poll(target
);
1536 target_arch_state(target
);
1540 if (strcmp(args
[0], "on") == 0)
1542 target_continous_poll
= 1;
1544 else if (strcmp(args
[0], "off") == 0)
1546 target_continous_poll
= 0;
1550 command_print(cmd_ctx
, "arg is \"on\" or \"off\"");
1558 int handle_wait_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1566 ms
= strtoul(args
[0], &end
, 0) * 1000;
1569 command_print(cmd_ctx
, "usage: %s [seconds]", cmd
);
1574 return wait_state(cmd_ctx
, cmd
, TARGET_HALTED
, ms
);
1577 static void target_process_events(struct command_context_s
*cmd_ctx
)
1579 target_t
*target
= get_current_target(cmd_ctx
);
1580 target
->type
->poll(target
);
1581 target_call_timer_callbacks_now();
1584 static int wait_state(struct command_context_s
*cmd_ctx
, char *cmd
, enum target_state state
, int ms
)
1587 struct timeval timeout
, now
;
1589 gettimeofday(&timeout
, NULL
);
1590 timeval_add_time(&timeout
, 0, ms
* 1000);
1592 target_t
*target
= get_current_target(cmd_ctx
);
1595 if ((retval
=target
->type
->poll(target
))!=ERROR_OK
)
1597 target_call_timer_callbacks_now();
1598 if (target
->state
== state
)
1605 command_print(cmd_ctx
, "waiting for target %s...", target_state_strings
[state
]);
1608 gettimeofday(&now
, NULL
);
1609 if ((now
.tv_sec
> timeout
.tv_sec
) || ((now
.tv_sec
== timeout
.tv_sec
) && (now
.tv_usec
>= timeout
.tv_usec
)))
1611 LOG_ERROR("timed out while waiting for target %s", target_state_strings
[state
]);
1619 int handle_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1622 target_t
*target
= get_current_target(cmd_ctx
);
1626 if ((retval
= target
->type
->halt(target
)) != ERROR_OK
)
1631 return handle_wait_halt_command(cmd_ctx
, cmd
, args
, argc
);
1635 int handle_soft_reset_halt_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1637 target_t
*target
= get_current_target(cmd_ctx
);
1639 LOG_USER("requesting target halt and executing a soft reset");
1641 target
->type
->soft_reset_halt(target
);
1646 int handle_reset_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1648 target_t
*target
= get_current_target(cmd_ctx
);
1649 enum target_reset_mode reset_mode
= target
->reset_mode
;
1650 enum target_reset_mode save
= target
->reset_mode
;
1656 if (strcmp("run", args
[0]) == 0)
1657 reset_mode
= RESET_RUN
;
1658 else if (strcmp("halt", args
[0]) == 0)
1659 reset_mode
= RESET_HALT
;
1660 else if (strcmp("init", args
[0]) == 0)
1661 reset_mode
= RESET_INIT
;
1662 else if (strcmp("run_and_halt", args
[0]) == 0)
1664 reset_mode
= RESET_RUN_AND_HALT
;
1667 target
->run_and_halt_time
= strtoul(args
[1], NULL
, 0);
1670 else if (strcmp("run_and_init", args
[0]) == 0)
1672 reset_mode
= RESET_RUN_AND_INIT
;
1675 target
->run_and_halt_time
= strtoul(args
[1], NULL
, 0);
1680 command_print(cmd_ctx
, "usage: reset ['run', 'halt', 'init', 'run_and_halt', 'run_and_init]");
1685 /* temporarily modify mode of current reset target */
1686 target
->reset_mode
= reset_mode
;
1688 /* reset *all* targets */
1689 target_process_reset(cmd_ctx
);
1691 /* Restore default reset mode for this target */
1692 target
->reset_mode
= save
;
1697 int handle_resume_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1700 target_t
*target
= get_current_target(cmd_ctx
);
1703 retval
= target
->type
->resume(target
, 1, 0, 1, 0); /* current pc, addr = 0, handle breakpoints, not debugging */
1705 retval
= target
->type
->resume(target
, 0, strtoul(args
[0], NULL
, 0), 1, 0); /* addr = args[0], handle breakpoints, not debugging */
1708 return ERROR_COMMAND_SYNTAX_ERROR
;
1711 target_process_events(cmd_ctx
);
1716 int handle_step_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1718 target_t
*target
= get_current_target(cmd_ctx
);
1723 target
->type
->step(target
, 1, 0, 1); /* current pc, addr = 0, handle breakpoints */
1726 target
->type
->step(target
, 0, strtoul(args
[0], NULL
, 0), 1); /* addr = args[0], handle breakpoints */
1731 int handle_md_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1733 const int line_bytecnt
= 32;
1746 target_t
*target
= get_current_target(cmd_ctx
);
1752 count
= strtoul(args
[1], NULL
, 0);
1754 address
= strtoul(args
[0], NULL
, 0);
1760 size
= 4; line_modulo
= line_bytecnt
/ 4;
1763 size
= 2; line_modulo
= line_bytecnt
/ 2;
1766 size
= 1; line_modulo
= line_bytecnt
/ 1;
1772 buffer
= calloc(count
, size
);
1773 retval
= target
->type
->read_memory(target
, address
, size
, count
, buffer
);
1774 if (retval
== ERROR_OK
)
1778 for (i
= 0; i
< count
; i
++)
1780 if (i
%line_modulo
== 0)
1781 output_len
+= snprintf(output
+ output_len
, 128 - output_len
, "0x%8.8x: ", address
+ (i
*size
));
1786 output_len
+= snprintf(output
+ output_len
, 128 - output_len
, "%8.8x ", target_buffer_get_u32(target
, &buffer
[i
*4]));
1789 output_len
+= snprintf(output
+ output_len
, 128 - output_len
, "%4.4x ", target_buffer_get_u16(target
, &buffer
[i
*2]));
1792 output_len
+= snprintf(output
+ output_len
, 128 - output_len
, "%2.2x ", buffer
[i
*1]);
1796 if ((i
%line_modulo
== line_modulo
-1) || (i
== count
- 1))
1798 command_print(cmd_ctx
, output
);
1804 LOG_ERROR("Failure examining memory");
1812 int handle_mw_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1819 target_t
*target
= get_current_target(cmd_ctx
);
1822 if ((argc
< 2) || (argc
> 3))
1823 return ERROR_COMMAND_SYNTAX_ERROR
;
1825 address
= strtoul(args
[0], NULL
, 0);
1826 value
= strtoul(args
[1], NULL
, 0);
1828 count
= strtoul(args
[2], NULL
, 0);
1835 target_buffer_set_u32(target
, value_buf
, value
);
1839 target_buffer_set_u16(target
, value_buf
, value
);
1843 value_buf
[0] = value
;
1846 return ERROR_COMMAND_SYNTAX_ERROR
;
1848 for (i
=0; i
<count
; i
++)
1854 retval
= target
->type
->write_memory(target
, address
+ i
*wordsize
, 4, 1, value_buf
);
1857 retval
= target
->type
->write_memory(target
, address
+ i
*wordsize
, 2, 1, value_buf
);
1860 retval
= target
->type
->write_memory(target
, address
+ i
*wordsize
, 1, 1, value_buf
);
1865 if (retval
!=ERROR_OK
)
1875 int handle_load_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1885 duration_t duration
;
1886 char *duration_text
;
1888 target_t
*target
= get_current_target(cmd_ctx
);
1892 command_print(cmd_ctx
, "usage: load_image <filename> [address] [type]");
1896 /* a base address isn't always necessary, default to 0x0 (i.e. don't relocate) */
1899 image
.base_address_set
= 1;
1900 image
.base_address
= strtoul(args
[1], NULL
, 0);
1904 image
.base_address_set
= 0;
1907 image
.start_address_set
= 0;
1909 duration_start_measure(&duration
);
1911 if (image_open(&image
, args
[0], (argc
>= 3) ? args
[2] : NULL
) != ERROR_OK
)
1918 for (i
= 0; i
< image
.num_sections
; i
++)
1920 buffer
= malloc(image
.sections
[i
].size
);
1923 command_print(cmd_ctx
, "error allocating buffer for section (%d bytes)", image
.sections
[i
].size
);
1927 if ((retval
= image_read_section(&image
, i
, 0x0, image
.sections
[i
].size
, buffer
, &buf_cnt
)) != ERROR_OK
)
1932 if ((retval
= target_write_buffer(target
, image
.sections
[i
].base_address
, buf_cnt
, buffer
)) != ERROR_OK
)
1937 image_size
+= buf_cnt
;
1938 command_print(cmd_ctx
, "%u byte written at address 0x%8.8x", buf_cnt
, image
.sections
[i
].base_address
);
1943 duration_stop_measure(&duration
, &duration_text
);
1944 if (retval
==ERROR_OK
)
1946 command_print(cmd_ctx
, "downloaded %u byte in %s", image_size
, duration_text
);
1948 free(duration_text
);
1950 image_close(&image
);
1956 int handle_dump_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
1963 int retval
=ERROR_OK
;
1965 duration_t duration
;
1966 char *duration_text
;
1968 target_t
*target
= get_current_target(cmd_ctx
);
1972 command_print(cmd_ctx
, "usage: dump_image <filename> <address> <size>");
1976 address
= strtoul(args
[1], NULL
, 0);
1977 size
= strtoul(args
[2], NULL
, 0);
1979 if ((address
& 3) || (size
& 3))
1981 command_print(cmd_ctx
, "only 32-bit aligned address and size are supported");
1985 if (fileio_open(&fileio
, args
[0], FILEIO_WRITE
, FILEIO_BINARY
) != ERROR_OK
)
1990 duration_start_measure(&duration
);
1995 u32 this_run_size
= (size
> 560) ? 560 : size
;
1997 retval
= target
->type
->read_memory(target
, address
, 4, this_run_size
/ 4, buffer
);
1998 if (retval
!= ERROR_OK
)
2003 retval
= fileio_write(&fileio
, this_run_size
, buffer
, &size_written
);
2004 if (retval
!= ERROR_OK
)
2009 size
-= this_run_size
;
2010 address
+= this_run_size
;
2013 fileio_close(&fileio
);
2015 duration_stop_measure(&duration
, &duration_text
);
2016 if (retval
==ERROR_OK
)
2018 command_print(cmd_ctx
, "dumped %"PRIi64
" byte in %s", fileio
.size
, duration_text
);
2020 free(duration_text
);
2025 int handle_verify_image_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2033 u32 mem_checksum
= 0;
2037 duration_t duration
;
2038 char *duration_text
;
2040 target_t
*target
= get_current_target(cmd_ctx
);
2044 return ERROR_COMMAND_SYNTAX_ERROR
;
2049 LOG_ERROR("no target selected");
2053 duration_start_measure(&duration
);
2057 image
.base_address_set
= 1;
2058 image
.base_address
= strtoul(args
[1], NULL
, 0);
2062 image
.base_address_set
= 0;
2063 image
.base_address
= 0x0;
2066 image
.start_address_set
= 0;
2068 if ((retval
=image_open(&image
, args
[0], (argc
== 3) ? args
[2] : NULL
)) != ERROR_OK
)
2075 for (i
= 0; i
< image
.num_sections
; i
++)
2077 buffer
= malloc(image
.sections
[i
].size
);
2080 command_print(cmd_ctx
, "error allocating buffer for section (%d bytes)", image
.sections
[i
].size
);
2083 if ((retval
= image_read_section(&image
, i
, 0x0, image
.sections
[i
].size
, buffer
, &buf_cnt
)) != ERROR_OK
)
2089 /* calculate checksum of image */
2090 image_calculate_checksum( buffer
, buf_cnt
, &checksum
);
2092 retval
= target_checksum_memory(target
, image
.sections
[i
].base_address
, buf_cnt
, &mem_checksum
);
2093 if( retval
!= ERROR_OK
)
2099 if( checksum
!= mem_checksum
)
2101 /* failed crc checksum, fall back to a binary compare */
2104 command_print(cmd_ctx
, "checksum mismatch - attempting binary compare");
2106 data
= (u8
*)malloc(buf_cnt
);
2108 /* Can we use 32bit word accesses? */
2110 int count
= buf_cnt
;
2111 if ((count
% 4) == 0)
2116 retval
= target
->type
->read_memory(target
, image
.sections
[i
].base_address
, size
, count
, data
);
2117 if (retval
== ERROR_OK
)
2120 for (t
= 0; t
< buf_cnt
; t
++)
2122 if (data
[t
] != buffer
[t
])
2124 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
]);
2137 image_size
+= buf_cnt
;
2140 duration_stop_measure(&duration
, &duration_text
);
2141 if (retval
==ERROR_OK
)
2143 command_print(cmd_ctx
, "verified %u bytes in %s", image_size
, duration_text
);
2145 free(duration_text
);
2147 image_close(&image
);
2152 int handle_bp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2155 target_t
*target
= get_current_target(cmd_ctx
);
2159 breakpoint_t
*breakpoint
= target
->breakpoints
;
2163 if (breakpoint
->type
== BKPT_SOFT
)
2165 char* buf
= buf_to_str(breakpoint
->orig_instr
, breakpoint
->length
, 16);
2166 command_print(cmd_ctx
, "0x%8.8x, 0x%x, %i, 0x%s", breakpoint
->address
, breakpoint
->length
, breakpoint
->set
, buf
);
2171 command_print(cmd_ctx
, "0x%8.8x, 0x%x, %i", breakpoint
->address
, breakpoint
->length
, breakpoint
->set
);
2173 breakpoint
= breakpoint
->next
;
2181 length
= strtoul(args
[1], NULL
, 0);
2184 if (strcmp(args
[2], "hw") == 0)
2187 if ((retval
= breakpoint_add(target
, strtoul(args
[0], NULL
, 0), length
, hw
)) != ERROR_OK
)
2189 LOG_ERROR("Failure setting breakpoints");
2193 command_print(cmd_ctx
, "breakpoint added at address 0x%8.8x", strtoul(args
[0], NULL
, 0));
2198 command_print(cmd_ctx
, "usage: bp <address> <length> ['hw']");
2204 int handle_rbp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2206 target_t
*target
= get_current_target(cmd_ctx
);
2209 breakpoint_remove(target
, strtoul(args
[0], NULL
, 0));
2214 int handle_wp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2216 target_t
*target
= get_current_target(cmd_ctx
);
2221 watchpoint_t
*watchpoint
= target
->watchpoints
;
2225 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
);
2226 watchpoint
= watchpoint
->next
;
2231 enum watchpoint_rw type
= WPT_ACCESS
;
2232 u32 data_value
= 0x0;
2233 u32 data_mask
= 0xffffffff;
2249 command_print(cmd_ctx
, "usage: wp <address> <length> [r/w/a] [value] [mask]");
2255 data_value
= strtoul(args
[3], NULL
, 0);
2259 data_mask
= strtoul(args
[4], NULL
, 0);
2262 if ((retval
= watchpoint_add(target
, strtoul(args
[0], NULL
, 0),
2263 strtoul(args
[1], NULL
, 0), type
, data_value
, data_mask
)) != ERROR_OK
)
2265 LOG_ERROR("Failure setting breakpoints");
2270 command_print(cmd_ctx
, "usage: wp <address> <length> [r/w/a] [value] [mask]");
2276 int handle_rwp_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2278 target_t
*target
= get_current_target(cmd_ctx
);
2281 watchpoint_remove(target
, strtoul(args
[0], NULL
, 0));
2286 int handle_virt2phys_command(command_context_t
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2289 target_t
*target
= get_current_target(cmd_ctx
);
2295 return ERROR_COMMAND_SYNTAX_ERROR
;
2297 va
= strtoul(args
[0], NULL
, 0);
2299 retval
= target
->type
->virt2phys(target
, va
, &pa
);
2300 if (retval
== ERROR_OK
)
2302 command_print(cmd_ctx
, "Physical address 0x%08x", pa
);
2306 /* lower levels will have logged a detailed error which is
2307 * forwarded to telnet/GDB session.
2312 static void writeLong(FILE *f
, int l
)
2317 char c
=(l
>>(i
*8))&0xff;
2318 fwrite(&c
, 1, 1, f
);
2322 static void writeString(FILE *f
, char *s
)
2324 fwrite(s
, 1, strlen(s
), f
);
2329 // Dump a gmon.out histogram file.
2330 static void writeGmon(u32
*samples
, int sampleNum
, char *filename
)
2333 FILE *f
=fopen(filename
, "w");
2336 fwrite("gmon", 1, 4, f
);
2337 writeLong(f
, 0x00000001); // Version
2338 writeLong(f
, 0); // padding
2339 writeLong(f
, 0); // padding
2340 writeLong(f
, 0); // padding
2342 fwrite("", 1, 1, f
); // GMON_TAG_TIME_HIST
2344 // figure out bucket size
2347 for (i
=0; i
<sampleNum
; i
++)
2359 int addressSpace
=(max
-min
+1);
2361 static int const maxBuckets
=256*1024; // maximum buckets.
2362 int length
=addressSpace
;
2363 if (length
> maxBuckets
)
2367 int *buckets
=malloc(sizeof(int)*length
);
2373 memset(buckets
, 0, sizeof(int)*length
);
2374 for (i
=0; i
<sampleNum
;i
++)
2376 u32 address
=samples
[i
];
2377 long long a
=address
-min
;
2378 long long b
=length
-1;
2379 long long c
=addressSpace
-1;
2380 int index
=(a
*b
)/c
; // danger!!!! int32 overflows
2384 // append binary memory gmon.out &profile_hist_hdr ((char*)&profile_hist_hdr + sizeof(struct gmon_hist_hdr))
2385 writeLong(f
, min
); // low_pc
2386 writeLong(f
, max
); // high_pc
2387 writeLong(f
, length
); // # of samples
2388 writeLong(f
, 64000000); // 64MHz
2389 writeString(f
, "seconds");
2390 for (i
=0; i
<(15-strlen("seconds")); i
++)
2392 fwrite("", 1, 1, f
); // padding
2394 writeString(f
, "s");
2396 // append binary memory gmon.out profile_hist_data (profile_hist_data + profile_hist_hdr.hist_size)
2398 char *data
=malloc(2*length
);
2401 for (i
=0; i
<length
;i
++)
2410 data
[i
*2+1]=(val
>>8)&0xff;
2413 fwrite(data
, 1, length
*2, f
);
2423 /* profiling samples the CPU PC as quickly as OpenOCD is able, which will be used as a random sampling of PC */
2424 int handle_profile_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
2426 target_t
*target
= get_current_target(cmd_ctx
);
2427 struct timeval timeout
, now
;
2429 gettimeofday(&timeout
, NULL
);
2432 return ERROR_COMMAND_SYNTAX_ERROR
;
2435 timeval_add_time(&timeout
, strtoul(args
[0], &end
, 0), 0);
2441 command_print(cmd_ctx
, "Starting profiling. Halting and resuming the target as often as we can...");
2443 static const int maxSample
=10000;
2444 u32
*samples
=malloc(sizeof(u32
)*maxSample
);
2449 int retval
=ERROR_OK
;
2450 // hopefully it is safe to cache! We want to stop/restart as quickly as possible.
2451 reg_t
*reg
= register_get_by_name(target
->reg_cache
, "pc", 1);
2455 target
->type
->poll(target
);
2456 if (target
->state
== TARGET_HALTED
)
2458 u32 t
=*((u32
*)reg
->value
);
2459 samples
[numSamples
++]=t
;
2460 retval
= target
->type
->resume(target
, 1, 0, 0, 0); /* current pc, addr = 0, do not handle breakpoints, not debugging */
2461 target
->type
->poll(target
);
2462 usleep(10*1000); // sleep 10ms, i.e. <100 samples/second.
2463 } else if (target
->state
== TARGET_RUNNING
)
2465 // We want to quickly sample the PC.
2466 target
->type
->halt(target
);
2469 command_print(cmd_ctx
, "Target not halted or running");
2473 if (retval
!=ERROR_OK
)
2478 gettimeofday(&now
, NULL
);
2479 if ((numSamples
>=maxSample
) || ((now
.tv_sec
>= timeout
.tv_sec
) && (now
.tv_usec
>= timeout
.tv_usec
)))
2481 command_print(cmd_ctx
, "Profiling completed. %d samples.", numSamples
);
2482 target
->type
->poll(target
);
2483 if (target
->state
== TARGET_HALTED
)
2485 target
->type
->resume(target
, 1, 0, 0, 0); /* current pc, addr = 0, do not handle breakpoints, not debugging */
2487 target
->type
->poll(target
);
2488 writeGmon(samples
, numSamples
, args
[1]);
2489 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)