target.c 104 KB
Newer Older
1
2
3
4
/***************************************************************************
 *   Copyright (C) 2005 by Dominic Rath                                    *
 *   Dominic.Rath@gmx.de                                                   *
 *                                                                         *
5
 *   Copyright (C) 2007,2008 yvind Harboe                                 *
6
7
 *   oyvind.harboe@zylin.com                                               *
 *                                                                         *
8
9
10
 *   Copyright (C) 2008, Duane Ellis                                       *
 *   openocd@duaneeellis.com                                               *
 *                                                                         *
11
12
13
 *   Copyright (C) 2008 by Spencer Oliver                                  *
 *   spen@spen-soft.co.uk                                                  *
 *                                                                         *
14
15
16
 *   Copyright (C) 2008 by Rick Altherr                                    *
 *   kc8apf@kc8apf.net>                                                    *
 *                                                                         *
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 ***************************************************************************/
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif

#include "target.h"
#include "target_request.h"
38
39
40
41
#include "time_support.h"
#include "register.h"
#include "trace.h"
#include "image.h"
42
43
44
45
46
#include "jtag.h"

#include <inttypes.h>


47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
static int handle_targets_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);

static int handle_reg_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_poll_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_halt_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_wait_halt_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_reset_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_soft_reset_halt_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_resume_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_step_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_md_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_mw_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_load_image_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_dump_image_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_verify_image_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_test_image_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_bp_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_rbp_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_wp_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_rwp_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_virt2phys_command(command_context_t *cmd_ctx, char *cmd, char **args, int argc);
static int handle_profile_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_fast_load_image_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
static int handle_fast_load_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);
71

72
73
static int jim_array2mem(Jim_Interp *interp, int argc, Jim_Obj *const *argv);
static int jim_mem2array(Jim_Interp *interp, int argc, Jim_Obj *const *argv);
74
static int jim_target( Jim_Interp *interp, int argc, Jim_Obj *const *argv);
75

76
77
78
static int target_array2mem(Jim_Interp *interp, target_t *target, int argc, Jim_Obj *const *argv);
static int target_mem2array(Jim_Interp *interp, target_t *target, int argc, Jim_Obj *const *argv);

79
/* targets */
80
81
82
83
84
85
86
87
88
extern target_type_t arm7tdmi_target;
extern target_type_t arm720t_target;
extern target_type_t arm9tdmi_target;
extern target_type_t arm920t_target;
extern target_type_t arm966e_target;
extern target_type_t arm926ejs_target;
extern target_type_t feroceon_target;
extern target_type_t xscale_target;
extern target_type_t cortexm3_target;
89
extern target_type_t cortexa8_target;
oharboe's avatar
oharboe committed
90
extern target_type_t arm11_target;
ntfreak's avatar
ntfreak committed
91
extern target_type_t mips_m4k_target;
92
extern target_type_t avr_target;
93
94
95
96
97
98
99
100
101
102
103
104

target_type_t *target_types[] =
{
	&arm7tdmi_target,
	&arm9tdmi_target,
	&arm920t_target,
	&arm720t_target,
	&arm966e_target,
	&arm926ejs_target,
	&feroceon_target,
	&xscale_target,
	&cortexm3_target,
105
	&cortexa8_target,
oharboe's avatar
oharboe committed
106
	&arm11_target,
ntfreak's avatar
ntfreak committed
107
	&mips_m4k_target,
108
	&avr_target,
109
110
111
	NULL,
};

112
target_t *all_targets = NULL;
113
114
115
target_event_callback_t *target_event_callbacks = NULL;
target_timer_callback_t *target_timer_callbacks = NULL;

116
117
118
119
120
121
122
123
const Jim_Nvp nvp_assert[] = {
	{ .name = "assert", NVP_ASSERT },
	{ .name = "deassert", NVP_DEASSERT },
	{ .name = "T", NVP_ASSERT },
	{ .name = "F", NVP_DEASSERT },
	{ .name = "t", NVP_ASSERT },
	{ .name = "f", NVP_DEASSERT },
	{ .name = NULL, .value = -1 }
124
125
};

126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
const Jim_Nvp nvp_error_target[] = {
	{ .value = ERROR_TARGET_INVALID, .name = "err-invalid" },
	{ .value = ERROR_TARGET_INIT_FAILED, .name = "err-init-failed" },
	{ .value = ERROR_TARGET_TIMEOUT, .name = "err-timeout" },
	{ .value = ERROR_TARGET_NOT_HALTED, .name = "err-not-halted" },
	{ .value = ERROR_TARGET_FAILURE, .name = "err-failure" },
	{ .value = ERROR_TARGET_UNALIGNED_ACCESS   , .name = "err-unaligned-access" },
	{ .value = ERROR_TARGET_DATA_ABORT , .name = "err-data-abort" },
	{ .value = ERROR_TARGET_RESOURCE_NOT_AVAILABLE , .name = "err-resource-not-available" },
	{ .value = ERROR_TARGET_TRANSLATION_FAULT  , .name = "err-translation-fault" },
	{ .value = ERROR_TARGET_NOT_RUNNING, .name = "err-not-running" },
	{ .value = ERROR_TARGET_NOT_EXAMINED, .name = "err-not-examined" },
	{ .value = -1, .name = NULL }
};

const char *target_strerror_safe( int err )
{
	const Jim_Nvp *n;

	n = Jim_Nvp_value2name_simple( nvp_error_target, err );
	if( n->name == NULL ){
		return "unknown";
	} else {
		return n->name;
	}
}

153
const Jim_Nvp nvp_target_event[] = {
154
155
	{ .value = TARGET_EVENT_OLD_gdb_program_config , .name = "old-gdb_program_config" },
	{ .value = TARGET_EVENT_OLD_pre_resume         , .name = "old-pre_resume" },
156

157
	{ .value = TARGET_EVENT_EARLY_HALTED, .name = "early-halted" },
158
159
160
161
162
	{ .value = TARGET_EVENT_HALTED, .name = "halted" },
	{ .value = TARGET_EVENT_RESUMED, .name = "resumed" },
	{ .value = TARGET_EVENT_RESUME_START, .name = "resume-start" },
	{ .value = TARGET_EVENT_RESUME_END, .name = "resume-end" },

163
164
165
	{ .name = "gdb-start", .value = TARGET_EVENT_GDB_START },
	{ .name = "gdb-end", .value = TARGET_EVENT_GDB_END },

166
	/* historical name */
167

168
	{ .value = TARGET_EVENT_RESET_START, .name = "reset-start" },
169
170
171
172
173
174
175
176
177

	{ .value = TARGET_EVENT_RESET_ASSERT_PRE,    .name = "reset-assert-pre" },
	{ .value = TARGET_EVENT_RESET_ASSERT_POST,   .name = "reset-assert-post" },
	{ .value = TARGET_EVENT_RESET_DEASSERT_PRE,  .name = "reset-deassert-pre" },
	{ .value = TARGET_EVENT_RESET_DEASSERT_POST, .name = "reset-deassert-post" },
	{ .value = TARGET_EVENT_RESET_HALT_PRE,      .name = "reset-halt-pre" },
	{ .value = TARGET_EVENT_RESET_HALT_POST,     .name = "reset-halt-post" },
	{ .value = TARGET_EVENT_RESET_WAIT_PRE,      .name = "reset-wait-pre" },
	{ .value = TARGET_EVENT_RESET_WAIT_POST,     .name = "reset-wait-post" },
178
179
180
	{ .value = TARGET_EVENT_RESET_INIT , .name = "reset-init" },
	{ .value = TARGET_EVENT_RESET_END, .name = "reset-end" },

181
	{ .value = TARGET_EVENT_EXAMINE_START, .name = "examine-start" },
182
	{ .value = TARGET_EVENT_EXAMINE_END, .name = "examine-end" },
183

184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
	{ .value = TARGET_EVENT_DEBUG_HALTED, .name = "debug-halted" },
	{ .value = TARGET_EVENT_DEBUG_RESUMED, .name = "debug-resumed" },

	{ .value = TARGET_EVENT_GDB_ATTACH, .name = "gdb-attach" },
	{ .value = TARGET_EVENT_GDB_DETACH, .name = "gdb-detach" },

	{ .value = TARGET_EVENT_GDB_FLASH_WRITE_START, .name = "gdb-flash-write-start" },
	{ .value = TARGET_EVENT_GDB_FLASH_WRITE_END  , .name = "gdb-flash-write-end"   },

	{ .value = TARGET_EVENT_GDB_FLASH_ERASE_START, .name = "gdb-flash-erase-start" },
	{ .value = TARGET_EVENT_GDB_FLASH_ERASE_END  , .name = "gdb-flash-erase-end" },

	{ .value = TARGET_EVENT_RESUME_START, .name = "resume-start" },
	{ .value = TARGET_EVENT_RESUMED     , .name = "resume-ok" },
	{ .value = TARGET_EVENT_RESUME_END  , .name = "resume-end" },

	{ .name = NULL, .value = -1 }
201
202
};

203
204
205
206
207
208
209
const Jim_Nvp nvp_target_state[] = {
	{ .name = "unknown", .value = TARGET_UNKNOWN },
	{ .name = "running", .value = TARGET_RUNNING },
	{ .name = "halted",  .value = TARGET_HALTED },
	{ .name = "reset",   .value = TARGET_RESET },
	{ .name = "debug-running", .value = TARGET_DEBUG_RUNNING },
	{ .name = NULL, .value = -1 },
210
211
};

212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
const Jim_Nvp nvp_target_debug_reason [] = {
	{ .name = "debug-request"            , .value = DBG_REASON_DBGRQ },
	{ .name = "breakpoint"               , .value = DBG_REASON_BREAKPOINT },
	{ .name = "watchpoint"               , .value = DBG_REASON_WATCHPOINT },
	{ .name = "watchpoint-and-breakpoint", .value = DBG_REASON_WPTANDBKPT },
	{ .name = "single-step"              , .value = DBG_REASON_SINGLESTEP },
	{ .name = "target-not-halted"        , .value = DBG_REASON_NOTHALTED  },
	{ .name = "undefined"                , .value = DBG_REASON_UNDEFINED },
	{ .name = NULL, .value = -1 },
};

const Jim_Nvp nvp_target_endian[] = {
	{ .name = "big",    .value = TARGET_BIG_ENDIAN },
	{ .name = "little", .value = TARGET_LITTLE_ENDIAN },
	{ .name = "be",     .value = TARGET_BIG_ENDIAN },
227
	{ .name = "le",     .value = TARGET_LITTLE_ENDIAN },
228
229
230
	{ .name = NULL,     .value = -1 },
};

231
232
233
234
235
236
237
238
const Jim_Nvp nvp_reset_modes[] = {
	{ .name = "unknown", .value = RESET_UNKNOWN },
	{ .name = "run"    , .value = RESET_RUN },
	{ .name = "halt"   , .value = RESET_HALT },
	{ .name = "init"   , .value = RESET_INIT },
	{ .name = NULL     , .value = -1 },
};

239
static int max_target_number(void)
240
241
242
243
244
245
246
247
248
249
250
251
252
253
{
	target_t *t;
	int x;

	x = -1;
	t = all_targets;
	while( t ){
		if( x < t->target_number ){
			x = (t->target_number)+1;
		}
		t = t->next;
	}
	return x;
}
254
255

/* determine the number of the new target */
256
static int new_target_number(void)
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
{
	target_t *t;
	int x;

	/* number is 0 based */
	x = -1;
	t = all_targets;
	while(t){
		if( x < t->target_number ){
			x = t->target_number;
		}
		t = t->next;
	}
	return x+1;
}

273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
static int target_continous_poll = 1;

/* read a u32 from a buffer in target memory endianness */
u32 target_buffer_get_u32(target_t *target, u8 *buffer)
{
	if (target->endianness == TARGET_LITTLE_ENDIAN)
		return le_to_h_u32(buffer);
	else
		return be_to_h_u32(buffer);
}

/* read a u16 from a buffer in target memory endianness */
u16 target_buffer_get_u16(target_t *target, u8 *buffer)
{
	if (target->endianness == TARGET_LITTLE_ENDIAN)
		return le_to_h_u16(buffer);
	else
		return be_to_h_u16(buffer);
}

293
294
295
296
297
298
/* read a u8 from a buffer in target memory endianness */
u8 target_buffer_get_u8(target_t *target, u8 *buffer)
{
	return *buffer & 0x0ff;
}

299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
/* write a u32 to a buffer in target memory endianness */
void target_buffer_set_u32(target_t *target, u8 *buffer, u32 value)
{
	if (target->endianness == TARGET_LITTLE_ENDIAN)
		h_u32_to_le(buffer, value);
	else
		h_u32_to_be(buffer, value);
}

/* write a u16 to a buffer in target memory endianness */
void target_buffer_set_u16(target_t *target, u8 *buffer, u16 value)
{
	if (target->endianness == TARGET_LITTLE_ENDIAN)
		h_u16_to_le(buffer, value);
	else
		h_u16_to_be(buffer, value);
}

317
318
319
320
321
322
/* write a u8 to a buffer in target memory endianness */
void target_buffer_set_u8(target_t *target, u8 *buffer, u8 value)
{
	*buffer = value;
}

323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
/* return a pointer to a configured target; id is name or number */
target_t *get_target(const char *id)
{
	target_t *target;
	char *endptr;
	int num;

	/* try as tcltarget name */
	for (target = all_targets; target; target = target->next) {
		if (target->cmd_name == NULL)
			continue;
		if (strcmp(id, target->cmd_name) == 0)
			return target;
	}

	/* no match, try as number */
	num = strtoul(id, &endptr, 0);
	if (*endptr != 0)
		return NULL;

	for (target = all_targets; target; target = target->next) {
		if (target->target_number == num)
			return target;
	}

	return NULL;
}

351
/* returns a pointer to the n-th configured target */
352
static target_t *get_target_by_num(int num)
353
{
354
	target_t *target = all_targets;
355

356
357
	while (target){
		if( target->target_number == num ){
358
			return target;
359
		}
360
361
362
363
364
365
366
367
		target = target->next;
	}

	return NULL;
}

int get_num_by_target(target_t *query_target)
{
368
	return query_target->target_number;
369
370
371
372
373
}

target_t* get_current_target(command_context_t *cmd_ctx)
{
	target_t *target = get_target_by_num(cmd_ctx->current_target);
oharboe's avatar
oharboe committed
374

375
376
	if (target == NULL)
	{
377
		LOG_ERROR("BUG: current_target out of bounds");
378
379
380
		exit(-1);
	}

oharboe's avatar
oharboe committed
381
	return target;
382
383
}

384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
int target_poll(struct target_s *target)
{
	/* We can't poll until after examine */
	if (!target->type->examined)
	{
		/* Fail silently lest we pollute the log */
		return ERROR_FAIL;
	}
	return target->type->poll(target);
}

int target_halt(struct target_s *target)
{
	/* We can't poll until after examine */
	if (!target->type->examined)
	{
		LOG_ERROR("Target not examined yet");
		return ERROR_FAIL;
	}
	return target->type->halt(target);
}

int target_resume(struct target_s *target, int current, u32 address, int handle_breakpoints, int debug_execution)
{
408
	int retval;
oharboe's avatar
oharboe committed
409

410
411
412
413
414
415
	/* We can't poll until after examine */
	if (!target->type->examined)
	{
		LOG_ERROR("Target not examined yet");
		return ERROR_FAIL;
	}
oharboe's avatar
oharboe committed
416

oharboe's avatar
oharboe committed
417
418
419
420
	/* note that resume *must* be asynchronous. The CPU can halt before we poll. The CPU can
	 * even halt at the current PC as a result of a software breakpoint being inserted by (a bug?)
	 * the application.
	 */
421
422
	if ((retval = target->type->resume(target, current, address, handle_breakpoints, debug_execution)) != ERROR_OK)
		return retval;
oharboe's avatar
oharboe committed
423

424
	return retval;
425
426
}

oharboe's avatar
oharboe committed
427
int target_process_reset(struct command_context_s *cmd_ctx, enum target_reset_mode reset_mode)
428
429
{
	char buf[100];
430
	int retval;
431
432
433
434
435
436
437
438
	Jim_Nvp *n;
	n = Jim_Nvp_value2name_simple( nvp_reset_modes, reset_mode );
	if( n->name == NULL ){
		LOG_ERROR("invalid reset mode");
		return ERROR_FAIL;
	}

	sprintf( buf, "ocd_process_reset %s", n->name );
439
440
	retval = Jim_Eval( interp, buf );

441
442
	if(retval != JIM_OK) {
		Jim_PrintErrorMessage(interp);
443
444
		return ERROR_FAIL;
	}
445
446

	/* We want any events to be processed before the prompt */
447
	retval = target_call_timer_callbacks_now();
448

449
	return retval;
450
451
}

452
453
454
455
456
457
458
459
460
461
462
463
static int default_virt2phys(struct target_s *target, u32 virtual, u32 *physical)
{
	*physical = virtual;
	return ERROR_OK;
}

static int default_mmu(struct target_s *target, int *enabled)
{
	*enabled = 0;
	return ERROR_OK;
}

464
static int default_examine(struct target_s *target)
465
{
466
	target->type->examined = 1;
467
468
469
	return ERROR_OK;
}

470
471
/* Targets that correctly implement init+examine, i.e.
 * no communication with target during init:
oharboe's avatar
oharboe committed
472
473
 *
 * XScale
474
 */
ntfreak's avatar
ntfreak committed
475
int target_examine(void)
476
477
{
	int retval = ERROR_OK;
478
	target_t *target = all_targets;
479
480
	while (target)
	{
481
		if ((retval = target->type->examine(target))!=ERROR_OK)
482
483
484
485
486
			return retval;
		target = target->next;
	}
	return retval;
}
487

488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
static int target_write_memory_imp(struct target_s *target, u32 address, u32 size, u32 count, u8 *buffer)
{
	if (!target->type->examined)
	{
		LOG_ERROR("Target not examined yet");
		return ERROR_FAIL;
	}
	return target->type->write_memory_imp(target, address, size, count, buffer);
}

static int target_read_memory_imp(struct target_s *target, u32 address, u32 size, u32 count, u8 *buffer)
{
	if (!target->type->examined)
	{
		LOG_ERROR("Target not examined yet");
		return ERROR_FAIL;
	}
	return target->type->read_memory_imp(target, address, size, count, buffer);
}

static int target_soft_reset_halt_imp(struct target_s *target)
{
	if (!target->type->examined)
	{
		LOG_ERROR("Target not examined yet");
		return ERROR_FAIL;
	}
	return target->type->soft_reset_halt_imp(target);
}

static int target_run_algorithm_imp(struct target_s *target, int num_mem_params, mem_param_t *mem_params, int num_reg_params, reg_param_t *reg_param, u32 entry_point, u32 exit_point, int timeout_ms, void *arch_info)
{
	if (!target->type->examined)
	{
		LOG_ERROR("Target not examined yet");
		return ERROR_FAIL;
	}
	return target->type->run_algorithm_imp(target, num_mem_params, mem_params, num_reg_params, reg_param, entry_point, exit_point, timeout_ms, arch_info);
}
527

528
529
int target_init(struct command_context_s *cmd_ctx)
{
530
	target_t *target = all_targets;
531
	int retval;
oharboe's avatar
oharboe committed
532

533
534
	while (target)
	{
535
536
537
538
539
		target->type->examined = 0;
		if (target->type->examine == NULL)
		{
			target->type->examine = default_examine;
		}
oharboe's avatar
oharboe committed
540

541
		if ((retval = target->type->init_target(cmd_ctx, target)) != ERROR_OK)
542
		{
543
			LOG_ERROR("target '%s' init failed", target->type->name);
544
			return retval;
545
		}
oharboe's avatar
oharboe committed
546

547
548
549
550
551
		/* Set up default functions if none are provided by target */
		if (target->type->virt2phys == NULL)
		{
			target->type->virt2phys = default_virt2phys;
		}
552
553
554
555
556
557
558
559
560
561
562
563
564
		target->type->virt2phys = default_virt2phys;
		/* a non-invasive way(in terms of patches) to add some code that
		 * runs before the type->write/read_memory implementation
		 */
		target->type->write_memory_imp = target->type->write_memory;
		target->type->write_memory = target_write_memory_imp;
		target->type->read_memory_imp = target->type->read_memory;
		target->type->read_memory = target_read_memory_imp;
		target->type->soft_reset_halt_imp = target->type->soft_reset_halt;
		target->type->soft_reset_halt = target_soft_reset_halt_imp;
		target->type->run_algorithm_imp = target->type->run_algorithm;
		target->type->run_algorithm = target_run_algorithm_imp;

565
566
567
568
569
570
		if (target->type->mmu == NULL)
		{
			target->type->mmu = default_mmu;
		}
		target = target->next;
	}
oharboe's avatar
oharboe committed
571

572
	if (all_targets)
573
	{
574
575
576
577
		if((retval = target_register_user_commands(cmd_ctx)) != ERROR_OK)
			return retval;
		if((retval = target_register_timer_callback(handle_target, 100, 1, NULL)) != ERROR_OK)
			return retval;
578
	}
oharboe's avatar
oharboe committed
579

580
581
582
583
584
585
	return ERROR_OK;
}

int target_register_event_callback(int (*callback)(struct target_s *target, enum target_event event, void *priv), void *priv)
{
	target_event_callback_t **callbacks_p = &target_event_callbacks;
oharboe's avatar
oharboe committed
586

587
588
589
590
	if (callback == NULL)
	{
		return ERROR_INVALID_ARGUMENTS;
	}
oharboe's avatar
oharboe committed
591

592
593
594
595
596
597
	if (*callbacks_p)
	{
		while ((*callbacks_p)->next)
			callbacks_p = &((*callbacks_p)->next);
		callbacks_p = &((*callbacks_p)->next);
	}
oharboe's avatar
oharboe committed
598

599
600
601
602
	(*callbacks_p) = malloc(sizeof(target_event_callback_t));
	(*callbacks_p)->callback = callback;
	(*callbacks_p)->priv = priv;
	(*callbacks_p)->next = NULL;
oharboe's avatar
oharboe committed
603

604
605
606
607
608
609
610
	return ERROR_OK;
}

int target_register_timer_callback(int (*callback)(void *priv), int time_ms, int periodic, void *priv)
{
	target_timer_callback_t **callbacks_p = &target_timer_callbacks;
	struct timeval now;
oharboe's avatar
oharboe committed
611

612
613
614
615
	if (callback == NULL)
	{
		return ERROR_INVALID_ARGUMENTS;
	}
oharboe's avatar
oharboe committed
616

617
618
619
620
621
622
	if (*callbacks_p)
	{
		while ((*callbacks_p)->next)
			callbacks_p = &((*callbacks_p)->next);
		callbacks_p = &((*callbacks_p)->next);
	}
oharboe's avatar
oharboe committed
623

624
625
626
627
	(*callbacks_p) = malloc(sizeof(target_timer_callback_t));
	(*callbacks_p)->callback = callback;
	(*callbacks_p)->periodic = periodic;
	(*callbacks_p)->time_ms = time_ms;
oharboe's avatar
oharboe committed
628

629
630
631
632
633
634
635
636
637
	gettimeofday(&now, NULL);
	(*callbacks_p)->when.tv_usec = now.tv_usec + (time_ms % 1000) * 1000;
	time_ms -= (time_ms % 1000);
	(*callbacks_p)->when.tv_sec = now.tv_sec + (time_ms / 1000);
	if ((*callbacks_p)->when.tv_usec > 1000000)
	{
		(*callbacks_p)->when.tv_usec = (*callbacks_p)->when.tv_usec - 1000000;
		(*callbacks_p)->when.tv_sec += 1;
	}
oharboe's avatar
oharboe committed
638

639
640
	(*callbacks_p)->priv = priv;
	(*callbacks_p)->next = NULL;
oharboe's avatar
oharboe committed
641

642
643
644
645
646
647
648
	return ERROR_OK;
}

int target_unregister_event_callback(int (*callback)(struct target_s *target, enum target_event event, void *priv), void *priv)
{
	target_event_callback_t **p = &target_event_callbacks;
	target_event_callback_t *c = target_event_callbacks;
oharboe's avatar
oharboe committed
649

650
651
652
653
	if (callback == NULL)
	{
		return ERROR_INVALID_ARGUMENTS;
	}
oharboe's avatar
oharboe committed
654

655
656
657
658
659
660
661
662
663
664
665
666
667
	while (c)
	{
		target_event_callback_t *next = c->next;
		if ((c->callback == callback) && (c->priv == priv))
		{
			*p = next;
			free(c);
			return ERROR_OK;
		}
		else
			p = &(c->next);
		c = next;
	}
oharboe's avatar
oharboe committed
668

669
670
671
672
673
674
675
	return ERROR_OK;
}

int target_unregister_timer_callback(int (*callback)(void *priv), void *priv)
{
	target_timer_callback_t **p = &target_timer_callbacks;
	target_timer_callback_t *c = target_timer_callbacks;
oharboe's avatar
oharboe committed
676

677
678
679
680
	if (callback == NULL)
	{
		return ERROR_INVALID_ARGUMENTS;
	}
oharboe's avatar
oharboe committed
681

682
683
684
685
686
687
688
689
690
691
692
693
694
	while (c)
	{
		target_timer_callback_t *next = c->next;
		if ((c->callback == callback) && (c->priv == priv))
		{
			*p = next;
			free(c);
			return ERROR_OK;
		}
		else
			p = &(c->next);
		c = next;
	}
oharboe's avatar
oharboe committed
695

696
697
698
699
700
701
702
	return ERROR_OK;
}

int target_call_event_callbacks(target_t *target, enum target_event event)
{
	target_event_callback_t *callback = target_event_callbacks;
	target_event_callback_t *next_callback;
oharboe's avatar
oharboe committed
703

704
705
706
707
708
709
	if (event == TARGET_EVENT_HALTED)
	{
		/* execute early halted first */
		target_call_event_callbacks(target, TARGET_EVENT_EARLY_HALTED);
	}

710
711
	LOG_DEBUG("target event %i (%s)",
			  event,
712
			  Jim_Nvp_value2name_simple( nvp_target_event, event )->name );
oharboe's avatar
oharboe committed
713

714
	target_handle_event( target, event );
715

716
717
718
719
720
721
	while (callback)
	{
		next_callback = callback->next;
		callback->callback(target, event, callback->priv);
		callback = next_callback;
	}
oharboe's avatar
oharboe committed
722

723
724
725
	return ERROR_OK;
}

726
static int target_call_timer_callbacks_check_time(int checktime)
727
728
729
730
731
{
	target_timer_callback_t *callback = target_timer_callbacks;
	target_timer_callback_t *next_callback;
	struct timeval now;

oharboe's avatar
   
oharboe committed
732
733
	keep_alive();

734
	gettimeofday(&now, NULL);
oharboe's avatar
oharboe committed
735

736
737
738
	while (callback)
	{
		next_callback = callback->next;
oharboe's avatar
oharboe committed
739

740
741
742
		if ((!checktime&&callback->periodic)||
				(((now.tv_sec >= callback->when.tv_sec) && (now.tv_usec >= callback->when.tv_usec))
						|| (now.tv_sec > callback->when.tv_sec)))
743
		{
744
			if(callback->callback != NULL)
745
			{
746
747
				callback->callback(callback->priv);
				if (callback->periodic)
748
				{
749
750
751
752
753
754
755
756
757
					int time_ms = callback->time_ms;
					callback->when.tv_usec = now.tv_usec + (time_ms % 1000) * 1000;
					time_ms -= (time_ms % 1000);
					callback->when.tv_sec = now.tv_sec + time_ms / 1000;
					if (callback->when.tv_usec > 1000000)
					{
						callback->when.tv_usec = callback->when.tv_usec - 1000000;
						callback->when.tv_sec += 1;
					}
758
				}
759
				else
760
761
762
763
764
				{
					int retval;
					if((retval = target_unregister_timer_callback(callback->callback, callback->priv)) != ERROR_OK)
						return retval;
				}
765
766
			}
		}
oharboe's avatar
oharboe committed
767

768
769
		callback = next_callback;
	}
oharboe's avatar
oharboe committed
770

771
772
773
	return ERROR_OK;
}

oharboe's avatar
oharboe committed
774
int target_call_timer_callbacks(void)
775
776
777
778
779
{
	return target_call_timer_callbacks_check_time(1);
}

/* invoke periodic callbacks immediately */
oharboe's avatar
oharboe committed
780
int target_call_timer_callbacks_now(void)
781
{
oharboe's avatar
   
oharboe committed
782
	return target_call_timer_callbacks_check_time(0);
783
784
}

785
786
787
788
int target_alloc_working_area(struct target_s *target, u32 size, working_area_t **area)
{
	working_area_t *c = target->working_areas;
	working_area_t *new_wa = NULL;
oharboe's avatar
oharboe committed
789

790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
	/* Reevaluate working area address based on MMU state*/
	if (target->working_areas == NULL)
	{
		int retval;
		int enabled;
		retval = target->type->mmu(target, &enabled);
		if (retval != ERROR_OK)
		{
			return retval;
		}
		if (enabled)
		{
			target->working_area = target->working_area_virt;
		}
		else
		{
			target->working_area = target->working_area_phys;
		}
	}
oharboe's avatar
oharboe committed
809

810
811
812
	/* only allocate multiples of 4 byte */
	if (size % 4)
	{
813
		LOG_ERROR("BUG: code tried to allocate unaligned number of bytes, padding");
814
815
		size = CEIL(size, 4);
	}
oharboe's avatar
oharboe committed
816

817
818
819
820
821
822
823
824
825
826
	/* see if there's already a matching working area */
	while (c)
	{
		if ((c->free) && (c->size == size))
		{
			new_wa = c;
			break;
		}
		c = c->next;
	}
oharboe's avatar
oharboe committed
827

828
829
830
831
832
833
	/* if not, allocate a new one */
	if (!new_wa)
	{
		working_area_t **p = &target->working_areas;
		u32 first_free = target->working_area;
		u32 free_size = target->working_area_size;
oharboe's avatar
oharboe committed
834

835
		LOG_DEBUG("allocating new working area");
oharboe's avatar
oharboe committed
836

837
838
839
840
841
842
843
844
		c = target->working_areas;
		while (c)
		{
			first_free += c->size;
			free_size -= c->size;
			p = &c->next;
			c = c->next;
		}
oharboe's avatar
oharboe committed
845

846
847
		if (free_size < size)
		{
848
			LOG_WARNING("not enough working area available(requested %d, free %d)", size, free_size);
849
850
			return ERROR_TARGET_RESOURCE_NOT_AVAILABLE;
		}
oharboe's avatar
oharboe committed
851

852
853
854
855
		new_wa = malloc(sizeof(working_area_t));
		new_wa->next = NULL;
		new_wa->size = size;
		new_wa->address = first_free;
oharboe's avatar
oharboe committed
856

857
858
		if (target->backup_working_area)
		{
859
			int retval;
860
			new_wa->backup = malloc(new_wa->size);
861
862
863
864
865
866
			if((retval = target->type->read_memory(target, new_wa->address, 4, new_wa->size / 4, new_wa->backup)) != ERROR_OK)
			{
				free(new_wa->backup);
				free(new_wa);
				return retval;
			}
867
868
869
870
871
		}
		else
		{
			new_wa->backup = NULL;
		}
oharboe's avatar
oharboe committed
872

873
874
875
		/* put new entry in list */
		*p = new_wa;
	}
oharboe's avatar
oharboe committed
876

877
878
879
	/* mark as used, and return the new (reused) area */
	new_wa->free = 0;
	*area = new_wa;
oharboe's avatar
oharboe committed
880

881
882
	/* user pointer */
	new_wa->user = area;
oharboe's avatar
oharboe committed
883

884
885
886
	return ERROR_OK;
}

oharboe's avatar
   
oharboe committed
887
int target_free_working_area_restore(struct target_s *target, working_area_t *area, int restore)
888
889
890
{
	if (area->free)
		return ERROR_OK;
oharboe's avatar
oharboe committed
891

oharboe's avatar
   
oharboe committed
892
	if (restore&&target->backup_working_area)
893
894
895
896
897
	{
		int retval;
		if((retval = target->type->write_memory(target, area->address, 4, area->size / 4, area->backup)) != ERROR_OK)
			return retval;
	}
oharboe's avatar
oharboe committed
898

899
	area->free = 1;
oharboe's avatar
oharboe committed
900

901
902
903
	/* mark user pointer invalid */
	*area->user = NULL;
	area->user = NULL;
oharboe's avatar
oharboe committed
904

905
906
907
	return ERROR_OK;
}

oharboe's avatar
   
oharboe committed
908
909
910
911
912
int target_free_working_area(struct target_s *target, working_area_t *area)
{
	return target_free_working_area_restore(target, area, 1);
}

913
914
915
916
/* free resources and restore memory, if restoring memory fails,
 * free up resources anyway
 */
void target_free_all_working_areas_restore(struct target_s *target, int restore)
917
918
919
920
921
922
{
	working_area_t *c = target->working_areas;

	while (c)
	{
		working_area_t *next = c->next;
oharboe's avatar
   
oharboe committed
923
		target_free_working_area_restore(target, c, restore);
oharboe's avatar
oharboe committed
924

925
926
		if (c->backup)
			free(c->backup);
oharboe's avatar
oharboe committed
927

928
		free(c);
oharboe's avatar
oharboe committed
929

930
931
		c = next;
	}
oharboe's avatar
oharboe committed
932

933
934
935
	target->working_areas = NULL;
}

936
void target_free_all_working_areas(struct target_s *target)
oharboe's avatar
   
oharboe committed
937
{
938
	target_free_all_working_areas_restore(target, 1);
oharboe's avatar
   
oharboe committed
939
940
}

941
942
int target_register_commands(struct command_context_s *cmd_ctx)
{
943

oharboe's avatar
oharboe committed
944
	register_command(cmd_ctx, NULL, "targets", handle_targets_command, COMMAND_EXEC, "change the current command line target (one parameter) or lists targets (with no parameter)");
945

946
947
948



949
	register_jim(cmd_ctx, "target", jim_target, "configure target" );
950

951
952
953
954
955
956
957
958
	return ERROR_OK;
}

int target_arch_state(struct target_s *target)
{
	int retval;
	if (target==NULL)
	{
959
		LOG_USER("No target has been configured");
960
961
		return ERROR_OK;
	}
oharboe's avatar
oharboe committed
962

963
	LOG_USER("target state: %s",
964
		 Jim_Nvp_value2name_simple(nvp_target_state,target->state)->name);
oharboe's avatar
oharboe committed
965

966
967
	if (target->state!=TARGET_HALTED)
		return ERROR_OK;
oharboe's avatar
oharboe committed
968

969
970
971
972
	retval=target->type->arch_state(target);
	return retval;
}

oharboe's avatar
oharboe committed
973
974
/* Single aligned words are guaranteed to use 16 or 32 bit access
 * mode respectively, otherwise data is handled as quickly as
975
976
977
978
979
 * possible
 */
int target_write_buffer(struct target_s *target, u32 address, u32 size, u8 *buffer)
{
	int retval;
980
981
	LOG_DEBUG("writing buffer of %i byte at 0x%8.8x", size, address);

982
983
984
985
986
	if (!target->type->examined)
	{
		LOG_ERROR("Target not examined yet");
		return ERROR_FAIL;
	}
oharboe's avatar
oharboe committed
987

988
989
990
991
	if (size == 0) {
		return ERROR_OK;
	}

992
	if ((address + size - 1) < address)
993
994
995
996
997
	{
		/* GDB can request this when e.g. PC is 0xfffffffc*/
		LOG_ERROR("address+size wrapped(0x%08x, 0x%08x)", address, size);
		return ERROR_FAIL;
	}
oharboe's avatar
oharboe committed
998

999
1000
1001
1002
	if (((address % 2) == 0) && (size == 2))
	{
		return target->type->write_memory(target, address, 2, 1, buffer);
	}
oharboe's avatar
oharboe committed
1003

1004
1005
1006
	/* handle unaligned head bytes */
	if (address % 4)
	{
1007
		u32 unaligned = 4 - (address % 4);
oharboe's avatar
oharboe committed
1008

1009
1010
1011
1012
1013
		if (unaligned > size)
			unaligned = size;

		if ((retval = target->type->write_memory(target, address, 1, unaligned, buffer)) != ERROR_OK)
			return retval;
oharboe's avatar
oharboe committed
1014

1015
1016
1017
1018
		buffer += unaligned;
		address += unaligned;
		size -= unaligned;
	}
oharboe's avatar
oharboe committed
1019

1020
1021
1022
1023
	/* handle aligned words */
	if (size >= 4)
	{
		int aligned = size - (size % 4);
oharboe's avatar
oharboe committed
1024

1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
		/* use bulk writes above a certain limit. This may have to be changed */
		if (aligned > 128)
		{
			if ((retval = target->type->bulk_write_memory(target, address, aligned / 4, buffer)) != ERROR_OK)
				return retval;
		}
		else
		{
			if ((retval = target->type->write_memory(target, address, 4, aligned / 4, buffer)) != ERROR_OK)
				return retval;
		}
oharboe's avatar
oharboe committed
1036

1037
1038
1039
1040
		buffer += aligned;
		address += aligned;
		size -= aligned;
	}
oharboe's avatar
oharboe committed
1041

1042
1043
1044
1045
1046
1047
	/* handle tail writes of less than 4 bytes */
	if (size > 0)
	{
		if ((retval = target->type->write_memory(target, address, 1, size, buffer)) != ERROR_OK)
			return retval;
	}
oharboe's avatar
oharboe committed
1048

1049
1050
1051
	return ERROR_OK;
}

oharboe's avatar
oharboe committed
1052
1053
/* Single aligned words are guaranteed to use 16 or 32 bit access
 * mode respectively, otherwise data is handled as quickly as
1054
1055
1056
1057
1058
 * possible
 */
int target_read_buffer(struct target_s *target, u32 address, u32 size, u8 *buffer)
{
	int retval;
1059
1060
	LOG_DEBUG("reading buffer of %i byte at 0x%8.8x", size, address);

1061
1062
1063
1064
1065
	if (!target->type->examined)
	{
		LOG_ERROR("Target not examined yet");
		return ERROR_FAIL;
	}
oharboe's avatar
oharboe committed
1066

1067
1068
1069
1070
	if (size == 0) {
		return ERROR_OK;
	}

1071
	if ((address + size - 1) < address)
1072
1073
1074
1075
1076
	{
		/* GDB can request this when e.g. PC is 0xfffffffc*/
		LOG_ERROR("address+size wrapped(0x%08x, 0x%08x)", address, size);
		return ERROR_FAIL;
	}
oharboe's avatar
oharboe committed
1077

1078
1079
1080
1081
	if (((address % 2) == 0) && (size == 2))
	{
		return target->type->read_memory(target, address, 2, 1, buffer);
	}
oharboe's avatar
oharboe committed
1082

1083
1084
1085
	/* handle unaligned head bytes */
	if (address % 4)
	{
1086
		u32 unaligned = 4 - (address % 4);
oharboe's avatar
oharboe committed
1087

1088
1089
1090
1091
1092
		if (unaligned > size)
			unaligned = size;

		if ((retval = target->type->read_memory(target, address, 1, unaligned, buffer)) != ERROR_OK)
			return retval;
oharboe's avatar
oharboe committed
1093

1094
1095
1096
1097
		buffer += unaligned;
		address += unaligned;
		size -= unaligned;
	}
oharboe's avatar
oharboe committed
1098

1099
1100
1101
1102
	/* handle aligned words */
	if (size >= 4)
	{
		int aligned = size - (size % 4);
oharboe's avatar
oharboe committed
1103

1104
1105
		if ((retval = target->type->read_memory(target, address, 4, aligned / 4, buffer)) != ERROR_OK)
			return retval;
oharboe's avatar
oharboe committed
1106

1107
1108
1109
1110
		buffer += aligned;
		address += aligned;
		size -= aligned;
	}
oharboe's avatar
oharboe committed
1111

1112
1113
1114
1115
1116
1117
	/* handle tail writes of less than 4 bytes */
	if (size > 0)
	{
		if ((retval = target->type->read_memory(target, address, 1, size, buffer)) != ERROR_OK)
			return retval;
	}
oharboe's avatar
oharboe committed
1118

1119
1120
1121
1122
1123
1124
1125
	return ERROR_OK;
}

int target_checksum_memory(struct target_s *target, u32 address, u32 size, u32* crc)
{
	u8 *buffer;
	int retval;
1126
	u32 i;
1127
	u32 checksum = 0;
1128
1129
1130
1131
1132
	if (!target->type->examined)
	{
		LOG_ERROR("Target not examined yet");
		return ERROR_FAIL;
	}
oharboe's avatar
oharboe committed
1133

1134
	if ((retval = target->type->checksum_memory(target, address,
1135
		size, &checksum)) != ERROR_OK)
1136
1137
1138
1139
	{
		buffer = malloc(size);
		if (buffer == NULL)
		{
1140
			LOG_ERROR("error allocating buffer for section (%d bytes)", size);
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
			return ERROR_INVALID_ARGUMENTS;
		}
		retval = target_read_buffer(target, address, size, buffer);
		if (retval != ERROR_OK)
		{
			free(buffer);
			return retval;
		}

		/* convert to target endianess */
		for (i = 0; i < (size/sizeof(u32)); i++)
		{
			u32 target_data;
			target_data = target_buffer_get_u32(target, &buffer[i*sizeof(u32)]);
			target_buffer_set_u32(target, &buffer[i*sizeof(u32)], target_data);
		}

		retval = image_calculate_checksum( buffer, size, &checksum );
		free(buffer);
	}
oharboe's avatar
oharboe committed
1161

1162
	*crc = checksum;
oharboe's avatar
oharboe committed
1163

1164
1165
	return retval;
}
1166
1167
1168
1169
1170
1171
1172
1173
1174

int target_blank_check_memory(struct target_s *target, u32 address, u32 size, u32* blank)
{
	int retval;
	if (!target->type->examined)
	{
		LOG_ERROR("Target not examined yet");
		return ERROR_FAIL;
	}
oharboe's avatar
oharboe committed
1175

1176
1177
	if (target->type->blank_check_memory == 0)
		return ERROR_TARGET_RESOURCE_NOT_AVAILABLE;
oharboe's avatar
oharboe committed
1178

1179
	retval = target->type->blank_check_memory(target, address, size, blank);
oharboe's avatar
oharboe committed
1180

1181
1182
	return retval;
}
1183
1184
1185
1186

int target_read_u32(struct target_s *target, u32 address, u32 *value)
{
	u8 value_buf[4];
1187
1188
1189
1190
1191
	if (!target->type->examined)
	{
		LOG_ERROR("Target not examined yet");
		return ERROR_FAIL;
	}
1192
1193

	int retval = target->type->read_memory(target, address, 4, 1, value_buf);
oharboe's avatar
oharboe committed
1194

1195
1196
1197
	if (retval == ERROR_OK)
	{
		*value = target_buffer_get_u32(target, value_buf);
1198
		LOG_DEBUG("address: 0x%8.8x, value: 0x%8.8x", address, *value);