OpenOCD
target.h
Go to the documentation of this file.
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 
3 /***************************************************************************
4  * Copyright (C) 2005 by Dominic Rath *
5  * Dominic.Rath@gmx.de *
6  * *
7  * Copyright (C) 2007-2010 Øyvind Harboe *
8  * oyvind.harboe@zylin.com *
9  * *
10  * Copyright (C) 2008 by Spencer Oliver *
11  * spen@spen-soft.co.uk *
12  * *
13  * Copyright (C) 2011 by Broadcom Corporation *
14  * Evan Hunter - ehunter@broadcom.com *
15  * *
16  * Copyright (C) ST-Ericsson SA 2011 *
17  * michel.jaouen@stericsson.com : smp minimum support *
18  ***************************************************************************/
19 
20 #ifndef OPENOCD_TARGET_TARGET_H
21 #define OPENOCD_TARGET_TARGET_H
22 
23 #include <helper/list.h>
24 #include "helper/replacements.h"
25 #include "helper/system.h"
26 #include <helper/types.h>
27 #include <jim.h>
28 
29 struct reg;
30 struct trace;
31 struct command_context;
32 struct command_invocation;
33 struct breakpoint;
34 struct watchpoint;
35 struct mem_param;
36 struct reg_param;
37 struct target_list;
38 struct gdb_fileio_info;
39 
40 /*
41  * TARGET_UNKNOWN = 0: we don't know anything about the target yet
42  * TARGET_RUNNING = 1: the target is executing or ready to execute user code
43  * TARGET_HALTED = 2: the target is not executing code, and ready to talk to the
44  * debugger. on an xscale it means that the debug handler is executing
45  * TARGET_RESET = 3: the target is being held in reset (only a temporary state,
46  * not sure how this is used with all the recent changes)
47  * TARGET_DEBUG_RUNNING = 4: the target is running, but it is executing code on
48  * behalf of the debugger (e.g. algorithm for flashing)
49  *
50  * also see: target_state_name();
51  */
52 
59 };
60 
63  RESET_RUN = 1, /* reset and let target run */
64  RESET_HALT = 2, /* reset and halt target out of reset */
65  RESET_INIT = 3, /* reset and halt target out of reset, then run init script */
66 };
67 
78 };
79 
83 };
84 
85 struct working_area {
87  uint32_t size;
88  bool free;
89  uint8_t *backup;
90  struct working_area **user;
91  struct working_area *next;
92 };
93 
94 struct gdb_service {
95  struct target *target;
96  /* field for smp display */
97  /* element 0 coreid currently displayed ( 1 till n) */
98  /* element 1 coreid to be displayed at next resume 1 till n 0 means resume
99  * all cores core displayed */
100  int32_t core[2];
101 };
102 
103 /* target back off timer */
105  int times;
106  int count;
107 };
108 
109 /* split target registers into multiple class */
113 };
114 
115 /* target_type.h contains the full definition of struct target_type */
116 struct target {
117  struct target_type *type; /* target type definition (name, access functions) */
118  char *cmd_name; /* tcl Name of target */
119  struct jtag_tap *tap; /* where on the jtag chain is this */
120  int32_t coreid; /* which device on the TAP? */
121 
124 
131  bool examined;
132 
141 
143 
144  bool reset_halt; /* attempt resetting the CPU into the halted mode? */
145  target_addr_t working_area; /* working area (initialised RAM). Evaluated
146  * upon first allocation from virtual/physical address. */
147  bool working_area_virt_spec; /* virtual address specified? */
148  target_addr_t working_area_virt; /* virtual address */
149  bool working_area_phys_spec; /* physical address specified? */
150  target_addr_t working_area_phys; /* physical address */
151  uint32_t working_area_size; /* size in bytes */
152  bool backup_working_area; /* whether the content of the working area has to be preserved */
153  struct working_area *working_areas;/* list of allocated working areas */
154  enum target_debug_reason debug_reason;/* reason why the target entered debug state */
155  enum target_endianness endianness; /* target endianness */
156  /* also see: target_state_name() */
157  enum target_state state; /* the current backend-state (running, halted, ...) */
158  struct reg_cache *reg_cache; /* the first register cache of the target (core regs) */
159  struct breakpoint *breakpoints; /* list of breakpoints */
160  struct watchpoint *watchpoints; /* list of watchpoints */
161  struct trace *trace_info; /* generic trace information */
162  struct debug_msg_receiver *dbgmsg; /* list of debug message receivers */
163  uint32_t dbg_msg_enabled; /* debug message status */
164  void *arch_info; /* architecture specific information */
165  void *private_config; /* pointer to target specific config data (for jim_configure hook) */
166  struct target *next; /* next target in list */
167 
168  bool verbose_halt_msg; /* display async info in telnet session. Do not display
169  * lots of halted/resumed info when stepping in debugger. */
170  bool halt_issued; /* did we transition to halted state? */
171  int64_t halt_issued_time; /* Note time when halt was issued */
172 
173  /* ARM v7/v8 targets with ADIv5 interface */
174  bool dbgbase_set; /* By default the debug base is not set */
175  uint32_t dbgbase; /* Really a Cortex-A specific option, but there is no
176  * system in place to support target specific options
177  * currently. */
178  bool has_dap; /* set to true if target has ADIv5 support */
179  bool dap_configured; /* set to true if ADIv5 DAP is configured */
180  bool tap_configured; /* set to true if JTAG tap has been configured
181  * through -chain-position */
182 
183  struct rtos *rtos; /* Instance of Real Time Operating System support */
184  bool rtos_auto_detect; /* A flag that indicates that the RTOS has been specified as "auto"
185  * and must be detected when symbols are offered */
186  struct backoff_timer backoff;
187  int smp; /* Unique non-zero number for each SMP group */
188  struct list_head *smp_targets; /* list all targets in this smp group/cluster
189  * The head of the list is shared between the
190  * cluster, thus here there is a pointer */
191  bool smp_halt_event_postponed; /* Some SMP implementations (currently Cortex-M) stores
192  * 'halted' events and emits them after all targets of
193  * the SMP group has been polled */
194 
195  /* the gdb service is there in case of smp, we have only one gdb server
196  * for all smp target
197  * the target attached to the gdb is changing dynamically by changing
198  * gdb_service->target pointer */
200 
201  /* file-I/O information for host to do syscall */
203 
204  char *gdb_port_override; /* target-specific override for gdb_port */
205 
206  int gdb_max_connections; /* max number of simultaneous gdb connections */
207 
208  /* The semihosting information, extracted from the target. */
210 };
211 
212 struct target_list {
213  struct list_head lh;
214  struct target *target;
215 };
216 
218  char *identifier;
219  uint64_t param_1;
220  uint64_t param_2;
221  uint64_t param_3;
222  uint64_t param_4;
223 };
224 
226 static inline const char *target_endianness(const struct target *target)
227 {
228  return (target->endianness == TARGET_ENDIAN_UNKNOWN) ? "unknown" :
229  (target->endianness == TARGET_BIG_ENDIAN) ? "big endian" : "little endian";
230 }
231 
233 static inline const char *target_name(const struct target *target)
234 {
235  return target->cmd_name;
236 }
237 
238 const char *debug_reason_name(const struct target *t);
239 
241 
242  /* allow GDB to do stuff before others handle the halted event,
243  * this is in lieu of defining ordering of invocation of events,
244  * which would be more complicated
245  *
246  * Telling GDB to halt does not mean that the target stopped running,
247  * simply that we're dropping out of GDB's waiting for step or continue.
248  *
249  * This can be useful when e.g. detecting power dropout.
250  */
252  TARGET_EVENT_HALTED, /* target entered debug state from normal execution or reset */
253  TARGET_EVENT_RESUMED, /* target resumed to normal execution */
258 
259  TARGET_EVENT_GDB_START, /* debugger started execution (step/run) */
260  TARGET_EVENT_GDB_END, /* debugger stopped execution (step/run) */
261 
264  TARGET_EVENT_RESET_ASSERT, /* C code uses this instead of SRST */
270 
271  TARGET_EVENT_DEBUG_HALTED, /* target entered debug state, but was executing on behalf of the debugger */
272  TARGET_EVENT_DEBUG_RESUMED, /* target resumed to execute on behalf of the debugger */
273 
277 
280 
285 
287 
288  TARGET_EVENT_SEMIHOSTING_USER_CMD_0X100 = 0x100, /* semihosting allows user cmds from 0x100 to 0x1ff */
296 };
297 
299  enum target_event event;
300  Jim_Interp *interp;
301  Jim_Obj *body;
303 };
304 
305 bool target_has_event_action(const struct target *target, enum target_event event);
306 
308  int (*callback)(struct target *target, enum target_event event, void *priv);
309  void *priv;
311 };
312 
314  struct list_head list;
315  void *priv;
316  int (*callback)(struct target *target, enum target_reset_mode reset_mode, void *priv);
317 };
318 
320  struct list_head list;
321  void *priv;
322  int (*callback)(struct target *target, size_t len, uint8_t *data, void *priv);
323 };
324 
328 };
329 
331  int (*callback)(void *priv);
332  unsigned int time_ms;
333  enum target_timer_type type;
334  bool removed;
335  int64_t when; /* output of timeval_ms() */
336  void *priv;
338 };
339 
342  uint32_t size;
343  uint32_t result;
344 };
345 
346 int target_register_commands(struct command_context *cmd_ctx);
347 int target_examine(void);
348 
350  int (*callback)(struct target *target,
351  enum target_event event, void *priv),
352  void *priv);
354  int (*callback)(struct target *target,
355  enum target_event event, void *priv),
356  void *priv);
357 
359  int (*callback)(struct target *target,
360  enum target_reset_mode reset_mode, void *priv),
361  void *priv);
363  int (*callback)(struct target *target,
364  enum target_reset_mode reset_mode, void *priv),
365  void *priv);
366 
368  int (*callback)(struct target *target,
369  size_t len, uint8_t *data, void *priv),
370  void *priv);
372  int (*callback)(struct target *target,
373  size_t len, uint8_t *data, void *priv),
374  void *priv);
375 
376 /* Poll the status of the target, detect any error conditions and report them.
377  *
378  * Also note that this fn will clear such error conditions, so a subsequent
379  * invocation will then succeed.
380  *
381  * These error conditions can be "sticky" error conditions. E.g. writing
382  * to memory could be implemented as an open loop and if memory writes
383  * fails, then a note is made of it, the error is sticky, but the memory
384  * write loop still runs to completion. This improves performance in the
385  * normal case as there is no need to verify that every single write succeed,
386  * yet it is possible to detect error conditions.
387  */
388 int target_poll(struct target *target);
389 int target_resume(struct target *target, int current, target_addr_t address,
390  int handle_breakpoints, int debug_execution);
391 int target_halt(struct target *target);
392 int target_call_event_callbacks(struct target *target, enum target_event event);
393 int target_call_reset_callbacks(struct target *target, enum target_reset_mode reset_mode);
394 int target_call_trace_callbacks(struct target *target, size_t len, uint8_t *data);
395 
400 int target_register_timer_callback(int (*callback)(void *priv),
401  unsigned int time_ms, enum target_timer_type type, void *priv);
402 int target_unregister_timer_callback(int (*callback)(void *priv), void *priv);
413 int64_t target_timer_next_event(void);
414 
415 struct target *get_current_target(struct command_context *cmd_ctx);
416 struct target *get_current_target_or_null(struct command_context *cmd_ctx);
417 struct target *get_target(const char *id);
418 
425 const char *target_type_name(const struct target *target);
426 
433 int target_examine_one(struct target *target);
434 
436 static inline bool target_was_examined(const struct target *target)
437 {
438  return target->examined;
439 }
440 
443 static inline void target_set_examined(struct target *target)
444 {
445  target->examined = true;
446 }
447 
454  struct breakpoint *breakpoint);
461  struct breakpoint *breakpoint);
468  struct breakpoint *breakpoint);
476  struct breakpoint *breakpoint);
483  struct watchpoint *watchpoint);
490  struct watchpoint *watchpoint);
491 
498  struct watchpoint **watchpoint);
499 
505 const char *target_get_gdb_arch(const struct target *target);
506 
513  struct reg **reg_list[], int *reg_list_size,
514  enum target_register_class reg_class);
515 
523  struct reg **reg_list[], int *reg_list_size,
524  enum target_register_class reg_class);
525 
531 bool target_supports_gdb_connection(const struct target *target);
532 
538 int target_step(struct target *target,
539  int current, target_addr_t address, int handle_breakpoints);
546  int num_mem_params, struct mem_param *mem_params,
547  int num_reg_params, struct reg_param *reg_param,
548  target_addr_t entry_point, target_addr_t exit_point,
549  unsigned int timeout_ms, void *arch_info);
550 
557  int num_mem_params, struct mem_param *mem_params,
558  int num_reg_params, struct reg_param *reg_params,
559  target_addr_t entry_point, target_addr_t exit_point,
560  void *arch_info);
561 
568  int num_mem_params, struct mem_param *mem_params,
569  int num_reg_params, struct reg_param *reg_params,
570  target_addr_t exit_point, unsigned int timeout_ms,
571  void *arch_info);
572 
578  const uint8_t *buffer, uint32_t count, int block_size,
579  int num_mem_params, struct mem_param *mem_params,
580  int num_reg_params, struct reg_param *reg_params,
581  uint32_t buffer_start, uint32_t buffer_size,
582  uint32_t entry_point, uint32_t exit_point,
583  void *arch_info);
584 
590  uint8_t *buffer, uint32_t count, int block_size,
591  int num_mem_params, struct mem_param *mem_params,
592  int num_reg_params, struct reg_param *reg_params,
593  uint32_t buffer_start, uint32_t buffer_size,
594  uint32_t entry_point, uint32_t exit_point,
595  void *arch_info);
596 
603 int target_read_memory(struct target *target,
604  target_addr_t address, uint32_t size, uint32_t count, uint8_t *buffer);
606  target_addr_t address, uint32_t size, uint32_t count, uint8_t *buffer);
624 int target_write_memory(struct target *target,
625  target_addr_t address, uint32_t size, uint32_t count, const uint8_t *buffer);
627  target_addr_t address, uint32_t size, uint32_t count, const uint8_t *buffer);
628 
629 /*
630  * Write to target memory using the virtual address.
631  *
632  * Note that this fn is used to implement software breakpoints. Targets
633  * can implement support for software breakpoints to memory marked as read
634  * only by making this fn write to ram even if it is read only(MMU or
635  * MPUs).
636  *
637  * It is sufficient to implement for writing a single word(16 or 32 in
638  * ARM32/16 bit case) to write the breakpoint to ram.
639  *
640  * The target should also take care of "other things" to make sure that
641  * software breakpoints can be written using this function. E.g.
642  * when there is a separate instruction and data cache, this fn must
643  * make sure that the instruction cache is synced up to the potential
644  * code change that can happen as a result of the memory write(typically
645  * by invalidating the cache).
646  *
647  * The high level wrapper fn in target.c will break down this memory write
648  * request to multiple write requests to the target driver to e.g. guarantee
649  * that writing 4 bytes to an aligned address happens with a single 32 bit
650  * write operation, thus making this fn suitable to e.g. write to special
651  * peripheral registers which do not support byte operations.
652  */
653 int target_write_buffer(struct target *target,
654  target_addr_t address, uint32_t size, const uint8_t *buffer);
655 int target_read_buffer(struct target *target,
656  target_addr_t address, uint32_t size, uint8_t *buffer);
658  target_addr_t address, uint32_t size, uint32_t *crc);
660  struct target_memory_check_block *blocks, int num_blocks,
661  uint8_t erased_value);
662 int target_wait_state(struct target *target, enum target_state state, unsigned int ms);
663 
670 
676 int target_gdb_fileio_end(struct target *target, int retcode, int fileio_errno, bool ctrl_c);
677 
682 
688 unsigned target_address_bits(struct target *target);
689 
695 unsigned int target_data_bits(struct target *target);
696 
698 const char *target_state_name(const struct target *target);
699 
701 const char *target_event_name(enum target_event event);
702 
704 const char *target_reset_mode_name(enum target_reset_mode reset_mode);
705 
706 /* DANGER!!!!!
707  *
708  * if "area" passed in to target_alloc_working_area() points to a memory
709  * location that goes out of scope (e.g. a pointer on the stack), then
710  * the caller of target_alloc_working_area() is responsible for invoking
711  * target_free_working_area() before "area" goes out of scope.
712  *
713  * target_free_all_working_areas() will NULL out the "area" pointer
714  * upon resuming or resetting the CPU.
715  *
716  */
718  uint32_t size, struct working_area **area);
719 /* Same as target_alloc_working_area, except that no error is logged
720  * when ERROR_TARGET_RESOURCE_NOT_AVAILABLE is returned.
721  *
722  * This allows the calling code to *try* to allocate target memory
723  * and have a fallback to another behaviour(slower?).
724  */
726  uint32_t size, struct working_area **area);
734 int target_free_working_area(struct target *target, struct working_area *area);
737 
741 void target_quit(void);
742 
743 extern struct target *all_targets;
744 
745 uint64_t target_buffer_get_u64(struct target *target, const uint8_t *buffer);
746 uint32_t target_buffer_get_u32(struct target *target, const uint8_t *buffer);
747 uint32_t target_buffer_get_u24(struct target *target, const uint8_t *buffer);
748 uint16_t target_buffer_get_u16(struct target *target, const uint8_t *buffer);
749 void target_buffer_set_u64(struct target *target, uint8_t *buffer, uint64_t value);
750 void target_buffer_set_u32(struct target *target, uint8_t *buffer, uint32_t value);
751 void target_buffer_set_u24(struct target *target, uint8_t *buffer, uint32_t value);
752 void target_buffer_set_u16(struct target *target, uint8_t *buffer, uint16_t value);
753 
754 void target_buffer_get_u64_array(struct target *target, const uint8_t *buffer, uint32_t count, uint64_t *dstbuf);
755 void target_buffer_get_u32_array(struct target *target, const uint8_t *buffer, uint32_t count, uint32_t *dstbuf);
756 void target_buffer_get_u16_array(struct target *target, const uint8_t *buffer, uint32_t count, uint16_t *dstbuf);
757 void target_buffer_set_u64_array(struct target *target, uint8_t *buffer, uint32_t count, const uint64_t *srcbuf);
758 void target_buffer_set_u32_array(struct target *target, uint8_t *buffer, uint32_t count, const uint32_t *srcbuf);
759 void target_buffer_set_u16_array(struct target *target, uint8_t *buffer, uint32_t count, const uint16_t *srcbuf);
760 
761 int target_read_u64(struct target *target, target_addr_t address, uint64_t *value);
762 int target_read_u32(struct target *target, target_addr_t address, uint32_t *value);
763 int target_read_u16(struct target *target, target_addr_t address, uint16_t *value);
764 int target_read_u8(struct target *target, target_addr_t address, uint8_t *value);
765 int target_write_u64(struct target *target, target_addr_t address, uint64_t value);
766 int target_write_u32(struct target *target, target_addr_t address, uint32_t value);
767 int target_write_u16(struct target *target, target_addr_t address, uint16_t value);
768 int target_write_u8(struct target *target, target_addr_t address, uint8_t value);
769 
770 int target_write_phys_u64(struct target *target, target_addr_t address, uint64_t value);
771 int target_write_phys_u32(struct target *target, target_addr_t address, uint32_t value);
772 int target_write_phys_u16(struct target *target, target_addr_t address, uint16_t value);
773 int target_write_phys_u8(struct target *target, target_addr_t address, uint8_t value);
774 
775 /* Issues USER() statements with target state information */
776 int target_arch_state(struct target *target);
777 
778 void target_handle_event(struct target *t, enum target_event e);
779 
781  struct target *target, target_addr_t address, unsigned size,
782  unsigned count, const uint8_t *buffer);
783 
784 int target_profiling_default(struct target *target, uint32_t *samples, uint32_t
785  max_num_samples, uint32_t *num_samples, uint32_t seconds);
786 
787 #define ERROR_TARGET_INVALID (-300)
788 #define ERROR_TARGET_INIT_FAILED (-301)
789 #define ERROR_TARGET_TIMEOUT (-302)
790 #define ERROR_TARGET_NOT_HALTED (-304)
791 #define ERROR_TARGET_FAILURE (-305)
792 #define ERROR_TARGET_UNALIGNED_ACCESS (-306)
793 #define ERROR_TARGET_DATA_ABORT (-307)
794 #define ERROR_TARGET_RESOURCE_NOT_AVAILABLE (-308)
795 #define ERROR_TARGET_TRANSLATION_FAULT (-309)
796 #define ERROR_TARGET_NOT_RUNNING (-310)
797 #define ERROR_TARGET_NOT_EXAMINED (-311)
798 #define ERROR_TARGET_DUPLICATE_BREAKPOINT (-312)
799 #define ERROR_TARGET_ALGO_EXIT (-313)
800 #define ERROR_TARGET_SIZE_NOT_SUPPORTED (-314)
801 #define ERROR_TARGET_PACKING_NOT_SUPPORTED (-315)
802 
803 extern bool get_target_reset_nag(void);
804 
805 #define TARGET_DEFAULT_POLLING_INTERVAL 100
806 
807 const char *target_debug_reason_str(enum target_debug_reason reason);
808 
809 #endif /* OPENOCD_TARGET_TARGET_H */
uint8_t type
Definition: esp_usb_jtag.c:0
static struct esp_usb_jtag * priv
Definition: esp_usb_jtag.c:219
struct target * target
Definition: rtt/rtt.c:26
size_t size
Size of the control block search area.
Definition: rtt/rtt.c:30
When run_command is called, a new instance will be created on the stack, filled with the proper value...
Definition: command.h:76
uint64_t param_1
Definition: target.h:219
uint64_t param_4
Definition: target.h:222
uint64_t param_3
Definition: target.h:221
char * identifier
Definition: target.h:218
uint64_t param_2
Definition: target.h:220
int32_t core[2]
Definition: target.h:100
struct target * target
Definition: target.h:95
Definition: jtag.h:101
Definition: list.h:40
Definition: register.h:111
Definition: rtos.h:36
Jim_Interp * interp
Definition: target.h:300
Jim_Obj * body
Definition: target.h:301
struct target_event_action * next
Definition: target.h:302
enum target_event event
Definition: target.h:299
int(* callback)(struct target *target, enum target_event event, void *priv)
Definition: target.h:308
struct target_event_callback * next
Definition: target.h:310
struct list_head lh
Definition: target.h:213
struct target * target
Definition: target.h:214
target_addr_t address
Definition: target.h:341
int(* callback)(struct target *target, enum target_reset_mode reset_mode, void *priv)
Definition: target.h:316
struct list_head list
Definition: target.h:314
int(* callback)(void *priv)
Definition: target.h:331
struct target_timer_callback * next
Definition: target.h:337
unsigned int time_ms
Definition: target.h:332
enum target_timer_type type
Definition: target.h:333
int(* callback)(struct target *target, size_t len, uint8_t *data, void *priv)
Definition: target.h:322
struct list_head list
Definition: target.h:320
This holds methods shared between all instances of a given target type.
Definition: target_type.h:26
Definition: target.h:116
int32_t coreid
Definition: target.h:120
struct semihosting * semihosting
Definition: target.h:209
int smp
Definition: target.h:187
target_addr_t working_area
Definition: target.h:145
target_addr_t working_area_virt
Definition: target.h:148
struct gdb_service * gdb_service
Definition: target.h:199
uint32_t working_area_size
Definition: target.h:151
struct jtag_tap * tap
Definition: target.h:119
bool dbgbase_set
Definition: target.h:174
struct trace * trace_info
Definition: target.h:161
enum target_debug_reason debug_reason
Definition: target.h:154
enum target_state state
Definition: target.h:157
uint32_t dbgbase
Definition: target.h:175
void * private_config
Definition: target.h:165
char * gdb_port_override
Definition: target.h:204
enum target_endianness endianness
Definition: target.h:155
struct reg_cache * reg_cache
Definition: target.h:158
bool backup_working_area
Definition: target.h:152
bool halt_issued
Definition: target.h:170
struct list_head * smp_targets
Definition: target.h:188
struct target_event_action * event_action
Definition: target.h:142
struct breakpoint * breakpoints
Definition: target.h:159
struct working_area * working_areas
Definition: target.h:153
bool verbose_halt_msg
Definition: target.h:168
bool dap_configured
Definition: target.h:179
struct rtos * rtos
Definition: target.h:183
struct gdb_fileio_info * fileio_info
Definition: target.h:202
struct debug_msg_receiver * dbgmsg
Definition: target.h:162
bool rtos_auto_detect
Definition: target.h:184
int64_t halt_issued_time
Definition: target.h:171
struct target_type * type
Definition: target.h:117
struct backoff_timer backoff
Definition: target.h:186
target_addr_t working_area_phys
Definition: target.h:150
bool has_dap
Definition: target.h:178
bool tap_configured
Definition: target.h:180
struct watchpoint * watchpoints
Definition: target.h:160
bool working_area_phys_spec
Definition: target.h:149
bool running_alg
true if the target is currently running a downloaded "algorithm" instead of arbitrary user code.
Definition: target.h:140
void * arch_info
Definition: target.h:164
uint32_t dbg_msg_enabled
Definition: target.h:163
int gdb_max_connections
Definition: target.h:206
bool working_area_virt_spec
Definition: target.h:147
bool smp_halt_event_postponed
Definition: target.h:191
bool reset_halt
Definition: target.h:144
bool examined
Indicates whether this target has been examined.
Definition: target.h:131
char * cmd_name
Definition: target.h:118
bool defer_examine
Should we defer examine to later.
Definition: target.h:123
struct target * next
Definition: target.h:166
Definition: trace.h:21
uint32_t size
Definition: target.h:87
bool free
Definition: target.h:88
struct working_area * next
Definition: target.h:91
target_addr_t address
Definition: target.h:86
struct working_area ** user
Definition: target.h:90
uint8_t * backup
Definition: target.h:89
void target_buffer_get_u16_array(struct target *target, const uint8_t *buffer, uint32_t count, uint16_t *dstbuf)
Definition: target.c:401
void target_buffer_set_u24(struct target *target, uint8_t *buffer, uint32_t value)
Definition: target.c:361
int target_get_gdb_fileio_info(struct target *target, struct gdb_fileio_info *fileio_info)
Obtain file-I/O information from target for GDB to do syscall.
Definition: target.c:1426
int target_add_watchpoint(struct target *target, struct watchpoint *watchpoint)
Add the watchpoint for target.
Definition: target.c:1329
target_debug_reason
Definition: target.h:68
@ DBG_REASON_WPTANDBKPT
Definition: target.h:72
@ DBG_REASON_UNDEFINED
Definition: target.h:77
@ DBG_REASON_EXIT
Definition: target.h:75
@ DBG_REASON_NOTHALTED
Definition: target.h:74
@ DBG_REASON_DBGRQ
Definition: target.h:69
@ DBG_REASON_SINGLESTEP
Definition: target.h:73
@ DBG_REASON_WATCHPOINT
Definition: target.h:71
@ DBG_REASON_EXC_CATCH
Definition: target.h:76
@ DBG_REASON_BREAKPOINT
Definition: target.h:70
struct target * all_targets
Definition: target.c:107
int target_run_read_async_algorithm(struct target *target, uint8_t *buffer, uint32_t count, int block_size, int num_mem_params, struct mem_param *mem_params, int num_reg_params, struct reg_param *reg_params, uint32_t buffer_start, uint32_t buffer_size, uint32_t entry_point, uint32_t exit_point, void *arch_info)
This routine is a wrapper for asynchronous algorithms.
Definition: target.c:1083
int target_write_phys_u32(struct target *target, target_addr_t address, uint32_t value)
Definition: target.c:2722
uint64_t target_buffer_get_u64(struct target *target, const uint8_t *buffer)
Definition: target.c:307
int target_call_event_callbacks(struct target *target, enum target_event event)
Definition: target.c:1764
struct target * get_target(const char *id)
Definition: target.c:433
void target_free_all_working_areas(struct target *target)
Definition: target.c:2150
int target_unregister_reset_callback(int(*callback)(struct target *target, enum target_reset_mode reset_mode, void *priv), void *priv)
Definition: target.c:1710
target_reset_mode
Definition: target.h:61
@ RESET_RUN
Definition: target.h:63
@ RESET_HALT
Definition: target.h:64
@ RESET_UNKNOWN
Definition: target.h:62
@ RESET_INIT
Definition: target.h:65
target_register_class
Definition: target.h:110
@ REG_CLASS_GENERAL
Definition: target.h:112
@ REG_CLASS_ALL
Definition: target.h:111
int target_write_phys_u64(struct target *target, target_addr_t address, uint64_t value)
Definition: target.c:2701
int target_unregister_event_callback(int(*callback)(struct target *target, enum target_event event, void *priv), void *priv)
Definition: target.c:1687
int target_hit_watchpoint(struct target *target, struct watchpoint **watchpoint)
Find out the just hit watchpoint for target.
Definition: target.c:1343
int target_read_phys_memory(struct target *target, target_addr_t address, uint32_t size, uint32_t count, uint8_t *buffer)
Definition: target.c:1251
int target_register_event_callback(int(*callback)(struct target *target, enum target_event event, void *priv), void *priv)
Definition: target.c:1592
int target_write_phys_memory(struct target *target, target_addr_t address, uint32_t size, uint32_t count, const uint8_t *buffer)
Definition: target.c:1279
int target_halt(struct target *target)
Definition: target.c:507
int target_get_gdb_reg_list_noread(struct target *target, struct reg **reg_list[], int *reg_list_size, enum target_register_class reg_class)
Obtain the registers for GDB, but don't read register values from the target.
Definition: target.c:1390
static bool target_was_examined(const struct target *target)
Definition: target.h:436
bool target_supports_gdb_connection(const struct target *target)
Check if target allows GDB connections.
Definition: target.c:1401
int target_arch_state(struct target *target)
Definition: target.c:2259
void target_buffer_set_u16(struct target *target, uint8_t *buffer, uint16_t value)
Definition: target.c:370
int target_call_timer_callbacks_now(void)
Invoke this to ensure that e.g.
Definition: target.c:1884
int target_remove_breakpoint(struct target *target, struct breakpoint *breakpoint)
Remove the breakpoint for target.
Definition: target.c:1323
void target_buffer_set_u32(struct target *target, uint8_t *buffer, uint32_t value)
Definition: target.c:352
int target_register_commands(struct command_context *cmd_ctx)
Definition: target.c:6273
int target_checksum_memory(struct target *target, target_addr_t address, uint32_t size, uint32_t *crc)
Definition: target.c:2467
int target_write_buffer(struct target *target, target_addr_t address, uint32_t size, const uint8_t *buffer)
Definition: target.c:2342
int target_add_hybrid_breakpoint(struct target *target, struct breakpoint *breakpoint)
Add the ContextID & IVA breakpoint for target.
Definition: target.c:1313
int target_write_u8(struct target *target, target_addr_t address, uint8_t value)
Definition: target.c:2683
int target_add_breakpoint(struct target *target, struct breakpoint *breakpoint)
Add the breakpoint for target.
Definition: target.c:1293
target_addr_t target_address_max(struct target *target)
Return the highest accessible address for this target.
Definition: target.c:1444
int target_write_u16(struct target *target, target_addr_t address, uint16_t value)
Definition: target.c:2662
int target_unregister_timer_callback(int(*callback)(void *priv), void *priv)
Definition: target.c:1748
int target_gdb_fileio_end(struct target *target, int retcode, int fileio_errno, bool ctrl_c)
Pass GDB file-I/O response to target after finishing host syscall.
Definition: target.c:1435
int target_read_buffer(struct target *target, target_addr_t address, uint32_t size, uint8_t *buffer)
Definition: target.c:2407
int target_unregister_trace_callback(int(*callback)(struct target *target, size_t len, uint8_t *data, void *priv), void *priv)
Definition: target.c:1729
int target_read_u8(struct target *target, target_addr_t address, uint8_t *value)
Definition: target.c:2598
int target_blank_check_memory(struct target *target, struct target_memory_check_block *blocks, int num_blocks, uint8_t erased_value)
Definition: target.c:2511
int target_run_algorithm(struct target *target, int num_mem_params, struct mem_param *mem_params, int num_reg_params, struct reg_param *reg_param, target_addr_t entry_point, target_addr_t exit_point, unsigned int timeout_ms, void *arch_info)
Run an algorithm on the target given.
Definition: target.c:773
target_timer_type
Definition: target.h:325
@ TARGET_TIMER_TYPE_PERIODIC
Definition: target.h:327
@ TARGET_TIMER_TYPE_ONESHOT
Definition: target.h:326
target_event
Definition: target.h:240
@ TARGET_EVENT_DEBUG_RESUMED
Definition: target.h:272
@ TARGET_EVENT_EXAMINE_START
Definition: target.h:274
@ TARGET_EVENT_RESET_START
Definition: target.h:262
@ TARGET_EVENT_SEMIHOSTING_USER_CMD_0X106
Definition: target.h:294
@ TARGET_EVENT_GDB_FLASH_WRITE_END
Definition: target.h:284
@ TARGET_EVENT_RESET_END
Definition: target.h:269
@ TARGET_EVENT_RESET_ASSERT_POST
Definition: target.h:265
@ TARGET_EVENT_RESET_DEASSERT_POST
Definition: target.h:267
@ TARGET_EVENT_HALTED
Definition: target.h:252
@ TARGET_EVENT_RESUMED
Definition: target.h:253
@ TARGET_EVENT_SEMIHOSTING_USER_CMD_0X102
Definition: target.h:290
@ TARGET_EVENT_SEMIHOSTING_USER_CMD_0X107
Definition: target.h:295
@ TARGET_EVENT_SEMIHOSTING_USER_CMD_0X105
Definition: target.h:293
@ TARGET_EVENT_EXAMINE_FAIL
Definition: target.h:275
@ TARGET_EVENT_GDB_START
Definition: target.h:259
@ TARGET_EVENT_EXAMINE_END
Definition: target.h:276
@ TARGET_EVENT_SEMIHOSTING_USER_CMD_0X104
Definition: target.h:292
@ TARGET_EVENT_RESET_INIT
Definition: target.h:268
@ TARGET_EVENT_GDB_END
Definition: target.h:260
@ TARGET_EVENT_RESET_DEASSERT_PRE
Definition: target.h:266
@ TARGET_EVENT_GDB_FLASH_ERASE_START
Definition: target.h:281
@ TARGET_EVENT_SEMIHOSTING_USER_CMD_0X103
Definition: target.h:291
@ TARGET_EVENT_DEBUG_HALTED
Definition: target.h:271
@ TARGET_EVENT_RESET_ASSERT_PRE
Definition: target.h:263
@ TARGET_EVENT_RESET_ASSERT
Definition: target.h:264
@ TARGET_EVENT_GDB_FLASH_WRITE_START
Definition: target.h:283
@ TARGET_EVENT_RESUME_START
Definition: target.h:254
@ TARGET_EVENT_STEP_END
Definition: target.h:257
@ TARGET_EVENT_STEP_START
Definition: target.h:256
@ TARGET_EVENT_GDB_ATTACH
Definition: target.h:278
@ TARGET_EVENT_SEMIHOSTING_USER_CMD_0X100
Definition: target.h:288
@ TARGET_EVENT_SEMIHOSTING_USER_CMD_0X101
Definition: target.h:289
@ TARGET_EVENT_RESUME_END
Definition: target.h:255
@ TARGET_EVENT_GDB_FLASH_ERASE_END
Definition: target.h:282
@ TARGET_EVENT_GDB_DETACH
Definition: target.h:279
@ TARGET_EVENT_TRACE_CONFIG
Definition: target.h:286
@ TARGET_EVENT_GDB_HALT
Definition: target.h:251
static const char * target_name(const struct target *target)
Returns the instance-specific name of the specified target.
Definition: target.h:233
int target_profiling_default(struct target *target, uint32_t *samples, uint32_t max_num_samples, uint32_t *num_samples, uint32_t seconds)
Definition: target.c:2290
int target_write_memory(struct target *target, target_addr_t address, uint32_t size, uint32_t count, const uint8_t *buffer)
Write count items of size bytes to the memory of target at the address given.
Definition: target.c:1265
unsigned target_address_bits(struct target *target)
Return the number of address bits this target supports.
Definition: target.c:1453
void target_handle_md_output(struct command_invocation *cmd, struct target *target, target_addr_t address, unsigned size, unsigned count, const uint8_t *buffer)
Definition: target.c:3339
int target_get_gdb_reg_list(struct target *target, struct reg **reg_list[], int *reg_list_size, enum target_register_class reg_class)
Obtain the registers for GDB.
Definition: target.c:1368
int target_call_timer_callbacks(void)
Definition: target.c:1878
int target_write_u64(struct target *target, target_addr_t address, uint64_t value)
Definition: target.c:2620
target_state
Definition: target.h:53
@ TARGET_RESET
Definition: target.h:57
@ TARGET_DEBUG_RUNNING
Definition: target.h:58
@ TARGET_UNKNOWN
Definition: target.h:54
@ TARGET_HALTED
Definition: target.h:56
@ TARGET_RUNNING
Definition: target.h:55
struct target * get_current_target_or_null(struct command_context *cmd_ctx)
Definition: target.c:470
target_endianness
Definition: target.h:80
@ TARGET_BIG_ENDIAN
Definition: target.h:82
@ TARGET_ENDIAN_UNKNOWN
Definition: target.h:81
@ TARGET_LITTLE_ENDIAN
Definition: target.h:82
const char * target_debug_reason_str(enum target_debug_reason reason)
Definition: target.c:6779
int target_call_reset_callbacks(struct target *target, enum target_reset_mode reset_mode)
Definition: target.c:1789
uint32_t target_get_working_area_avail(struct target *target)
Definition: target.c:2164
int target_alloc_working_area(struct target *target, uint32_t size, struct working_area **area)
Definition: target.c:2060
bool get_target_reset_nag(void)
Definition: target.c:6280
int target_step(struct target *target, int current, target_addr_t address, int handle_breakpoints)
Step the target.
Definition: target.c:1410
unsigned int target_data_bits(struct target *target)
Return the number of data bits this target supports.
Definition: target.c:1460
int target_remove_watchpoint(struct target *target, struct watchpoint *watchpoint)
Remove the watchpoint for target.
Definition: target.c:1338
const char * target_event_name(enum target_event event)
Return the name of a target event enumeration value.
Definition: target.c:275
int target_write_u32(struct target *target, target_addr_t address, uint32_t value)
Definition: target.c:2641
int target_examine_one(struct target *target)
Examine the specified target, letting it perform any Initialisation that requires JTAG access.
Definition: target.c:672
int target_poll(struct target *target)
Definition: target.c:477
int target_free_working_area(struct target *target, struct working_area *area)
Free a working area.
Definition: target.c:2118
int target_alloc_working_area_try(struct target *target, uint32_t size, struct working_area **area)
Definition: target.c:1966
int target_register_timer_callback(int(*callback)(void *priv), unsigned int time_ms, enum target_timer_type type, void *priv)
The period is very approximate, the callback can happen much more often or much more rarely than spec...
Definition: target.c:1658
static void target_set_examined(struct target *target)
Sets the examined flag for the given target.
Definition: target.h:443
int target_read_u16(struct target *target, target_addr_t address, uint16_t *value)
Definition: target.c:2574
int target_run_flash_async_algorithm(struct target *target, const uint8_t *buffer, uint32_t count, int block_size, int num_mem_params, struct mem_param *mem_params, int num_reg_params, struct reg_param *reg_params, uint32_t buffer_start, uint32_t buffer_size, uint32_t entry_point, uint32_t exit_point, void *arch_info)
This routine is a wrapper for asynchronous algorithms.
Definition: target.c:930
void target_buffer_set_u64(struct target *target, uint8_t *buffer, uint64_t value)
Definition: target.c:343
void target_buffer_set_u64_array(struct target *target, uint8_t *buffer, uint32_t count, const uint64_t *srcbuf)
Definition: target.c:409
int target_add_context_breakpoint(struct target *target, struct breakpoint *breakpoint)
Add the ContextID breakpoint for target.
Definition: target.c:1303
int target_read_u32(struct target *target, target_addr_t address, uint32_t *value)
Definition: target.c:2550
uint16_t target_buffer_get_u16(struct target *target, const uint8_t *buffer)
Definition: target.c:334
int target_read_memory(struct target *target, target_addr_t address, uint32_t size, uint32_t count, uint8_t *buffer)
Read count items of size bytes from the memory of target at the address given.
Definition: target.c:1237
bool target_has_event_action(const struct target *target, enum target_event event)
Returns true only if the target has a handler for the specified event.
Definition: target.c:4854
void target_buffer_get_u64_array(struct target *target, const uint8_t *buffer, uint32_t count, uint64_t *dstbuf)
Definition: target.c:385
const char * debug_reason_name(const struct target *t)
Definition: target.c:247
void target_buffer_set_u16_array(struct target *target, uint8_t *buffer, uint32_t count, const uint16_t *srcbuf)
Definition: target.c:425
int target_register_reset_callback(int(*callback)(struct target *target, enum target_reset_mode reset_mode, void *priv), void *priv)
Definition: target.c:1614
uint32_t target_buffer_get_u24(struct target *target, const uint8_t *buffer)
Definition: target.c:325
void target_buffer_get_u32_array(struct target *target, const uint8_t *buffer, uint32_t count, uint32_t *dstbuf)
Definition: target.c:393
int64_t target_timer_next_event(void)
Returns when the next registered event will take place.
Definition: target.c:1889
int target_write_phys_u16(struct target *target, target_addr_t address, uint16_t value)
Definition: target.c:2743
void target_handle_event(struct target *t, enum target_event e)
Definition: target.c:4660
const char * target_get_gdb_arch(const struct target *target)
Obtain the architecture for GDB.
Definition: target.c:1361
int target_wait_algorithm(struct target *target, int num_mem_params, struct mem_param *mem_params, int num_reg_params, struct reg_param *reg_params, target_addr_t exit_point, unsigned int timeout_ms, void *arch_info)
Wait for an algorithm on the target given.
Definition: target.c:858
int target_wait_state(struct target *target, enum target_state state, unsigned int ms)
Definition: target.c:3207
const char * target_state_name(const struct target *target)
Return the name of this targets current state.
Definition: target.c:260
int target_examine(void)
Definition: target.c:711
int target_register_trace_callback(int(*callback)(struct target *target, size_t len, uint8_t *data, void *priv), void *priv)
Definition: target.c:1636
struct target * get_current_target(struct command_context *cmd_ctx)
Definition: target.c:458
void target_buffer_set_u32_array(struct target *target, uint8_t *buffer, uint32_t count, const uint32_t *srcbuf)
Definition: target.c:417
uint32_t target_buffer_get_u32(struct target *target, const uint8_t *buffer)
Definition: target.c:316
const char * target_type_name(const struct target *target)
Get the target type name.
Definition: target.c:736
int target_call_trace_callbacks(struct target *target, size_t len, uint8_t *data)
Definition: target.c:1802
int target_start_algorithm(struct target *target, int num_mem_params, struct mem_param *mem_params, int num_reg_params, struct reg_param *reg_params, target_addr_t entry_point, target_addr_t exit_point, void *arch_info)
Starts an algorithm in the background on the target given.
Definition: target.c:814
void target_quit(void)
Free all the resources allocated by targets and the target layer.
Definition: target.c:2230
int target_write_phys_u8(struct target *target, target_addr_t address, uint8_t value)
Definition: target.c:2764
int target_read_u64(struct target *target, target_addr_t address, uint64_t *value)
Definition: target.c:2526
const char * target_reset_mode_name(enum target_reset_mode reset_mode)
Return the name of a target reset reason enumeration value.
Definition: target.c:286
int target_resume(struct target *target, int current, target_addr_t address, int handle_breakpoints, int debug_execution)
Make the target (re)start executing using its saved execution context (possibly with some modificatio...
Definition: target.c:556
uint64_t target_addr_t
Definition: types.h:335
uint8_t cmd
Definition: vdebug.c:1
uint8_t state[4]
Definition: vdebug.c:21
uint8_t count[4]
Definition: vdebug.c:22