?  search:
summary | log | graphiclog1 | graphiclog2 | commit | commitdiff | tree | refs | edit | fork
blame | history | raw | HEAD
jtag: remove jtag_get_end_state()'s that should be unecessary
[openocd/cortex.git] / src / target / arm7_9_common.c
blob4c8d83d66461f37b0f741fefca9fb61c8306c903
1 /***************************************************************************
2 * Copyright (C) 2005 by Dominic Rath *
3 * Dominic.Rath@gmx.de *
4 * *
5 * Copyright (C) 2007-2009 Øyvind Harboe *
6 * oyvind.harboe@zylin.com *
7 * *
8 * Copyright (C) 2008 by Spencer Oliver *
9 * spen@spen-soft.co.uk *
10 * *
11 * Copyright (C) 2008 by Hongtao Zheng *
12 * hontor@126.com *
13 * *
14 * Copyright (C) 2009 by David Brownell *
15 * *
16 * This program is free software; you can redistribute it and/or modify *
17 * it under the terms of the GNU General Public License as published by *
18 * the Free Software Foundation; either version 2 of the License, or *
19 * (at your option) any later version. *
20 * *
21 * This program is distributed in the hope that it will be useful, *
22 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
24 * GNU General Public License for more details. *
25 * *
26 * You should have received a copy of the GNU General Public License *
27 * along with this program; if not, write to the *
28 * Free Software Foundation, Inc., *
29 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
30 ***************************************************************************/
31 #ifdef HAVE_CONFIG_H
32 #include "config.h"
33 #endif
34
35 #include "breakpoints.h"
36 #include "embeddedice.h"
37 #include "target_request.h"
38 #include "etm.h"
39 #include <helper/time_support.h>
40 #include "arm_simulator.h"
41 #include "arm_semihosting.h"
42 #include "algorithm.h"
43 #include "register.h"
44 #include "armv4_5.h"
45
46
47 /**
48 * @file
49 * Hold common code supporting the ARM7 and ARM9 core generations.
50 *
51 * While the ARM core implementations evolved substantially during these
52 * two generations, they look quite similar from the JTAG perspective.
53 * Both have similar debug facilities, based on the same two scan chains
54 * providing access to the core and to an EmbeddedICE module. Both can
55 * support similar ETM and ETB modules, for tracing. And both expose
56 * what could be viewed as "ARM Classic", with multiple processor modes,
57 * shadowed registers, and support for the Thumb instruction set.
58 *
59 * Processor differences include things like presence or absence of MMU
60 * and cache, pipeline sizes, use of a modified Harvard Architecure
61 * (with separate instruction and data busses from the CPU), support
62 * for cpu clock gating during idle, and more.
63 */
64
65 static int arm7_9_debug_entry(struct target *target);
66
67 /**
68 * Clear watchpoints for an ARM7/9 target.
69 *
70 * @param arm7_9 Pointer to the common struct for an ARM7/9 target
71 * @return JTAG error status after executing queue
72 */
73 static int arm7_9_clear_watchpoints(struct arm7_9_common *arm7_9)
74 {
75 LOG_DEBUG("-");
76 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_VALUE], 0x0);
77 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_VALUE], 0x0);
78 arm7_9->sw_breakpoint_count = 0;
79 arm7_9->sw_breakpoints_added = 0;
80 arm7_9->wp0_used = 0;
81 arm7_9->wp1_used = arm7_9->wp1_used_default;
82 arm7_9->wp_available = arm7_9->wp_available_max;
83
84 return jtag_execute_queue();
85 }
86
87 /**
88 * Assign a watchpoint to one of the two available hardware comparators in an
89 * ARM7 or ARM9 target.
90 *
91 * @param arm7_9 Pointer to the common struct for an ARM7/9 target
92 * @param breakpoint Pointer to the breakpoint to be used as a watchpoint
93 */
94 static void arm7_9_assign_wp(struct arm7_9_common *arm7_9, struct breakpoint *breakpoint)
95 {
96 if (!arm7_9->wp0_used)
97 {
98 arm7_9->wp0_used = 1;
99 breakpoint->set = 1;
100 arm7_9->wp_available--;
101 }
102 else if (!arm7_9->wp1_used)
103 {
104 arm7_9->wp1_used = 1;
105 breakpoint->set = 2;
106 arm7_9->wp_available--;
107 }
108 else
109 {
110 LOG_ERROR("BUG: no hardware comparator available");
111 }
112 LOG_DEBUG("BPID: %d (0x%08" PRIx32 ") using hw wp: %d",
113 breakpoint->unique_id,
114 breakpoint->address,
115 breakpoint->set );
116 }
117
118 /**
119 * Setup an ARM7/9 target's embedded ICE registers for software breakpoints.
120 *
121 * @param arm7_9 Pointer to common struct for ARM7/9 targets
122 * @return Error codes if there is a problem finding a watchpoint or the result
123 * of executing the JTAG queue
124 */
125 static int arm7_9_set_software_breakpoints(struct arm7_9_common *arm7_9)
126 {
127 if (arm7_9->sw_breakpoints_added)
128 {
129 return ERROR_OK;
130 }
131 if (arm7_9->wp_available < 1)
132 {
133 LOG_WARNING("can't enable sw breakpoints with no watchpoint unit available");
134 return ERROR_TARGET_RESOURCE_NOT_AVAILABLE;
135 }
136 arm7_9->wp_available--;
137
138 /* pick a breakpoint unit */
139 if (!arm7_9->wp0_used)
140 {
141 arm7_9->sw_breakpoints_added = 1;
142 arm7_9->wp0_used = 3;
143 } else if (!arm7_9->wp1_used)
144 {
145 arm7_9->sw_breakpoints_added = 2;
146 arm7_9->wp1_used = 3;
147 }
148 else
149 {
150 LOG_ERROR("BUG: both watchpoints used, but wp_available >= 1");
151 return ERROR_FAIL;
152 }
153
154 if (arm7_9->sw_breakpoints_added == 1)
155 {
156 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_DATA_VALUE], arm7_9->arm_bkpt);
157 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_DATA_MASK], 0x0);
158 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_ADDR_MASK], 0xffffffffu);
159 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_MASK], ~EICE_W_CTRL_nOPC & 0xff);
160 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_VALUE], EICE_W_CTRL_ENABLE);
161 }
162 else if (arm7_9->sw_breakpoints_added == 2)
163 {
164 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_DATA_VALUE], arm7_9->arm_bkpt);
165 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_DATA_MASK], 0x0);
166 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_ADDR_MASK], 0xffffffffu);
167 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_MASK], ~EICE_W_CTRL_nOPC & 0xff);
168 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_VALUE], EICE_W_CTRL_ENABLE);
169 }
170 else
171 {
172 LOG_ERROR("BUG: both watchpoints used, but wp_available >= 1");
173 return ERROR_FAIL;
174 }
175 LOG_DEBUG("SW BP using hw wp: %d",
176 arm7_9->sw_breakpoints_added );
177
178 return jtag_execute_queue();
179 }
180
181 /**
182 * Setup the common pieces for an ARM7/9 target after reset or on startup.
183 *
184 * @param target Pointer to an ARM7/9 target to setup
185 * @return Result of clearing the watchpoints on the target
186 */
187 int arm7_9_setup(struct target *target)
188 {
189 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
190
191 return arm7_9_clear_watchpoints(arm7_9);
192 }
193
194 /**
195 * Set either a hardware or software breakpoint on an ARM7/9 target. The
196 * breakpoint is set up even if it is already set. Some actions, e.g. reset,
197 * might have erased the values in Embedded ICE.
198 *
199 * @param target Pointer to the target device to set the breakpoints on
200 * @param breakpoint Pointer to the breakpoint to be set
201 * @return For hardware breakpoints, this is the result of executing the JTAG
202 * queue. For software breakpoints, this will be the status of the
203 * required memory reads and writes
204 */
205 int arm7_9_set_breakpoint(struct target *target, struct breakpoint *breakpoint)
206 {
207 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
208 int retval = ERROR_OK;
209
210 LOG_DEBUG("BPID: %d, Address: 0x%08" PRIx32 ", Type: %d" ,
211 breakpoint->unique_id,
212 breakpoint->address,
213 breakpoint->type);
214
215 if (target->state != TARGET_HALTED)
216 {
217 LOG_WARNING("target not halted");
218 return ERROR_TARGET_NOT_HALTED;
219 }
220
221 if (breakpoint->type == BKPT_HARD)
222 {
223 /* either an ARM (4 byte) or Thumb (2 byte) breakpoint */
224 uint32_t mask = (breakpoint->length == 4) ? 0x3u : 0x1u;
225
226 /* reassign a hw breakpoint */
227 if (breakpoint->set == 0)
228 {
229 arm7_9_assign_wp(arm7_9, breakpoint);
230 }
231
232 if (breakpoint->set == 1)
233 {
234 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_ADDR_VALUE], breakpoint->address);
235 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_ADDR_MASK], mask);
236 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_DATA_MASK], 0xffffffffu);
237 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_MASK], ~EICE_W_CTRL_nOPC & 0xff);
238 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_VALUE], EICE_W_CTRL_ENABLE);
239 }
240 else if (breakpoint->set == 2)
241 {
242 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_ADDR_VALUE], breakpoint->address);
243 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_ADDR_MASK], mask);
244 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_DATA_MASK], 0xffffffffu);
245 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_MASK], ~EICE_W_CTRL_nOPC & 0xff);
246 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_VALUE], EICE_W_CTRL_ENABLE);
247 }
248 else
249 {
250 LOG_ERROR("BUG: no hardware comparator available");
251 return ERROR_OK;
252 }
253
254 retval = jtag_execute_queue();
255 }
256 else if (breakpoint->type == BKPT_SOFT)
257 {
258 /* did we already set this breakpoint? */
259 if (breakpoint->set)
260 return ERROR_OK;
261
262 if (breakpoint->length == 4)
263 {
264 uint32_t verify = 0xffffffff;
265 /* keep the original instruction in target endianness */
266 if ((retval = target_read_memory(target, breakpoint->address, 4, 1, breakpoint->orig_instr)) != ERROR_OK)
267 {
268 return retval;
269 }
270 /* write the breakpoint instruction in target endianness (arm7_9->arm_bkpt is host endian) */
271 if ((retval = target_write_u32(target, breakpoint->address, arm7_9->arm_bkpt)) != ERROR_OK)
272 {
273 return retval;
274 }
275
276 if ((retval = target_read_u32(target, breakpoint->address, &verify)) != ERROR_OK)
277 {
278 return retval;
279 }
280 if (verify != arm7_9->arm_bkpt)
281 {
282 LOG_ERROR("Unable to set 32 bit software breakpoint at address %08" PRIx32 " - check that memory is read/writable", breakpoint->address);
283 return ERROR_OK;
284 }
285 }
286 else
287 {
288 uint16_t verify = 0xffff;
289 /* keep the original instruction in target endianness */
290 if ((retval = target_read_memory(target, breakpoint->address, 2, 1, breakpoint->orig_instr)) != ERROR_OK)
291 {
292 return retval;
293 }
294 /* write the breakpoint instruction in target endianness (arm7_9->thumb_bkpt is host endian) */
295 if ((retval = target_write_u16(target, breakpoint->address, arm7_9->thumb_bkpt)) != ERROR_OK)
296 {
297 return retval;
298 }
299
300 if ((retval = target_read_u16(target, breakpoint->address, &verify)) != ERROR_OK)
301 {
302 return retval;
303 }
304 if (verify != arm7_9->thumb_bkpt)
305 {
306 LOG_ERROR("Unable to set thumb software breakpoint at address %08" PRIx32 " - check that memory is read/writable", breakpoint->address);
307 return ERROR_OK;
308 }
309 }
310
311 if ((retval = arm7_9_set_software_breakpoints(arm7_9)) != ERROR_OK)
312 return retval;
313
314 arm7_9->sw_breakpoint_count++;
315
316 breakpoint->set = 1;
317 }
318
319 return retval;
320 }
321
322 /**
323 * Unsets an existing breakpoint on an ARM7/9 target. If it is a hardware
324 * breakpoint, the watchpoint used will be freed and the Embedded ICE registers
325 * will be updated. Otherwise, the software breakpoint will be restored to its
326 * original instruction if it hasn't already been modified.
327 *
328 * @param target Pointer to ARM7/9 target to unset the breakpoint from
329 * @param breakpoint Pointer to breakpoint to be unset
330 * @return For hardware breakpoints, this is the result of executing the JTAG
331 * queue. For software breakpoints, this will be the status of the
332 * required memory reads and writes
333 */
334 int arm7_9_unset_breakpoint(struct target *target, struct breakpoint *breakpoint)
335 {
336 int retval = ERROR_OK;
337 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
338
339 LOG_DEBUG("BPID: %d, Address: 0x%08" PRIx32,
340 breakpoint->unique_id,
341 breakpoint->address );
342
343 if (!breakpoint->set)
344 {
345 LOG_WARNING("breakpoint not set");
346 return ERROR_OK;
347 }
348
349 if (breakpoint->type == BKPT_HARD)
350 {
351 LOG_DEBUG("BPID: %d Releasing hw wp: %d",
352 breakpoint->unique_id,
353 breakpoint->set );
354 if (breakpoint->set == 1)
355 {
356 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_VALUE], 0x0);
357 arm7_9->wp0_used = 0;
358 arm7_9->wp_available++;
359 }
360 else if (breakpoint->set == 2)
361 {
362 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_VALUE], 0x0);
363 arm7_9->wp1_used = 0;
364 arm7_9->wp_available++;
365 }
366 retval = jtag_execute_queue();
367 breakpoint->set = 0;
368 }
369 else
370 {
371 /* restore original instruction (kept in target endianness) */
372 if (breakpoint->length == 4)
373 {
374 uint32_t current_instr;
375 /* check that user program as not modified breakpoint instruction */
376 if ((retval = target_read_memory(target, breakpoint->address, 4, 1, (uint8_t*)&current_instr)) != ERROR_OK)
377 {
378 return retval;
379 }
380 if (current_instr == arm7_9->arm_bkpt)
381 if ((retval = target_write_memory(target, breakpoint->address, 4, 1, breakpoint->orig_instr)) != ERROR_OK)
382 {
383 return retval;
384 }
385 }
386 else
387 {
388 uint16_t current_instr;
389 /* check that user program as not modified breakpoint instruction */
390 if ((retval = target_read_memory(target, breakpoint->address, 2, 1, (uint8_t*)&current_instr)) != ERROR_OK)
391 {
392 return retval;
393 }
394 if (current_instr == arm7_9->thumb_bkpt)
395 if ((retval = target_write_memory(target, breakpoint->address, 2, 1, breakpoint->orig_instr)) != ERROR_OK)
396 {
397 return retval;
398 }
399 }
400
401 if (--arm7_9->sw_breakpoint_count==0)
402 {
403 /* We have removed the last sw breakpoint, clear the hw breakpoint we used to implement it */
404 if (arm7_9->sw_breakpoints_added == 1)
405 {
406 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_VALUE], 0);
407 }
408 else if (arm7_9->sw_breakpoints_added == 2)
409 {
410 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_VALUE], 0);
411 }
412 }
413
414 breakpoint->set = 0;
415 }
416
417 return retval;
418 }
419
420 /**
421 * Add a breakpoint to an ARM7/9 target. This makes sure that there are no
422 * dangling breakpoints and that the desired breakpoint can be added.
423 *
424 * @param target Pointer to the target ARM7/9 device to add a breakpoint to
425 * @param breakpoint Pointer to the breakpoint to be added
426 * @return An error status if there is a problem adding the breakpoint or the
427 * result of setting the breakpoint
428 */
429 int arm7_9_add_breakpoint(struct target *target, struct breakpoint *breakpoint)
430 {
431 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
432
433 if (arm7_9->breakpoint_count == 0)
434 {
435 /* make sure we don't have any dangling breakpoints. This is vital upon
436 * GDB connect/disconnect
437 */
438 arm7_9_clear_watchpoints(arm7_9);
439 }
440
441 if ((breakpoint->type == BKPT_HARD) && (arm7_9->wp_available < 1))
442 {
443 LOG_INFO("no watchpoint unit available for hardware breakpoint");
444 return ERROR_TARGET_RESOURCE_NOT_AVAILABLE;
445 }
446
447 if ((breakpoint->length != 2) && (breakpoint->length != 4))
448 {
449 LOG_INFO("only breakpoints of two (Thumb) or four (ARM) bytes length supported");
450 return ERROR_TARGET_RESOURCE_NOT_AVAILABLE;
451 }
452
453 if (breakpoint->type == BKPT_HARD)
454 {
455 arm7_9_assign_wp(arm7_9, breakpoint);
456 }
457
458 arm7_9->breakpoint_count++;
459
460 return arm7_9_set_breakpoint(target, breakpoint);
461 }
462
463 /**
464 * Removes a breakpoint from an ARM7/9 target. This will make sure there are no
465 * dangling breakpoints and updates available watchpoints if it is a hardware
466 * breakpoint.
467 *
468 * @param target Pointer to the target to have a breakpoint removed
469 * @param breakpoint Pointer to the breakpoint to be removed
470 * @return Error status if there was a problem unsetting the breakpoint or the
471 * watchpoints could not be cleared
472 */
473 int arm7_9_remove_breakpoint(struct target *target, struct breakpoint *breakpoint)
474 {
475 int retval = ERROR_OK;
476 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
477
478 if ((retval = arm7_9_unset_breakpoint(target, breakpoint)) != ERROR_OK)
479 {
480 return retval;
481 }
482
483 if (breakpoint->type == BKPT_HARD)
484 arm7_9->wp_available++;
485
486 arm7_9->breakpoint_count--;
487 if (arm7_9->breakpoint_count == 0)
488 {
489 /* make sure we don't have any dangling breakpoints */
490 if ((retval = arm7_9_clear_watchpoints(arm7_9)) != ERROR_OK)
491 {
492 return retval;
493 }
494 }
495
496 return ERROR_OK;
497 }
498
499 /**
500 * Sets a watchpoint for an ARM7/9 target in one of the watchpoint units. It is
501 * considered a bug to call this function when there are no available watchpoint
502 * units.
503 *
504 * @param target Pointer to an ARM7/9 target to set a watchpoint on
505 * @param watchpoint Pointer to the watchpoint to be set
506 * @return Error status if watchpoint set fails or the result of executing the
507 * JTAG queue
508 */
509 int arm7_9_set_watchpoint(struct target *target, struct watchpoint *watchpoint)
510 {
511 int retval = ERROR_OK;
512 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
513 int rw_mask = 1;
514 uint32_t mask;
515
516 mask = watchpoint->length - 1;
517
518 if (target->state != TARGET_HALTED)
519 {
520 LOG_WARNING("target not halted");
521 return ERROR_TARGET_NOT_HALTED;
522 }
523
524 if (watchpoint->rw == WPT_ACCESS)
525 rw_mask = 0;
526 else
527 rw_mask = 1;
528
529 if (!arm7_9->wp0_used)
530 {
531 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_ADDR_VALUE], watchpoint->address);
532 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_ADDR_MASK], mask);
533 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_DATA_MASK], watchpoint->mask);
534 if (watchpoint->mask != 0xffffffffu)
535 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_DATA_VALUE], watchpoint->value);
536 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_MASK], 0xff & ~EICE_W_CTRL_nOPC & ~rw_mask);
537 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_VALUE], EICE_W_CTRL_ENABLE | EICE_W_CTRL_nOPC | (watchpoint->rw & 1));
538
539 if ((retval = jtag_execute_queue()) != ERROR_OK)
540 {
541 return retval;
542 }
543 watchpoint->set = 1;
544 arm7_9->wp0_used = 2;
545 }
546 else if (!arm7_9->wp1_used)
547 {
548 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_ADDR_VALUE], watchpoint->address);
549 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_ADDR_MASK], mask);
550 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_DATA_MASK], watchpoint->mask);
551 if (watchpoint->mask != 0xffffffffu)
552 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_DATA_VALUE], watchpoint->value);
553 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_MASK], 0xff & ~EICE_W_CTRL_nOPC & ~rw_mask);
554 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_VALUE], EICE_W_CTRL_ENABLE | EICE_W_CTRL_nOPC | (watchpoint->rw & 1));
555
556 if ((retval = jtag_execute_queue()) != ERROR_OK)
557 {
558 return retval;
559 }
560 watchpoint->set = 2;
561 arm7_9->wp1_used = 2;
562 }
563 else
564 {
565 LOG_ERROR("BUG: no hardware comparator available");
566 return ERROR_OK;
567 }
568
569 return ERROR_OK;
570 }
571
572 /**
573 * Unset an existing watchpoint and clear the used watchpoint unit.
574 *
575 * @param target Pointer to the target to have the watchpoint removed
576 * @param watchpoint Pointer to the watchpoint to be removed
577 * @return Error status while trying to unset the watchpoint or the result of
578 * executing the JTAG queue
579 */
580 int arm7_9_unset_watchpoint(struct target *target, struct watchpoint *watchpoint)
581 {
582 int retval = ERROR_OK;
583 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
584
585 if (target->state != TARGET_HALTED)
586 {
587 LOG_WARNING("target not halted");
588 return ERROR_TARGET_NOT_HALTED;
589 }
590
591 if (!watchpoint->set)
592 {
593 LOG_WARNING("breakpoint not set");
594 return ERROR_OK;
595 }
596
597 if (watchpoint->set == 1)
598 {
599 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_VALUE], 0x0);
600 if ((retval = jtag_execute_queue()) != ERROR_OK)
601 {
602 return retval;
603 }
604 arm7_9->wp0_used = 0;
605 }
606 else if (watchpoint->set == 2)
607 {
608 embeddedice_set_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_VALUE], 0x0);
609 if ((retval = jtag_execute_queue()) != ERROR_OK)
610 {
611 return retval;
612 }
613 arm7_9->wp1_used = 0;
614 }
615 watchpoint->set = 0;
616
617 return ERROR_OK;
618 }
619
620 /**
621 * Add a watchpoint to an ARM7/9 target. If there are no watchpoint units
622 * available, an error response is returned.
623 *
624 * @param target Pointer to the ARM7/9 target to add a watchpoint to
625 * @param watchpoint Pointer to the watchpoint to be added
626 * @return Error status while trying to add the watchpoint
627 */
628 int arm7_9_add_watchpoint(struct target *target, struct watchpoint *watchpoint)
629 {
630 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
631
632 if (arm7_9->wp_available < 1)
633 {
634 return ERROR_TARGET_RESOURCE_NOT_AVAILABLE;
635 }
636
637 if ((watchpoint->length != 1) && (watchpoint->length != 2) && (watchpoint->length != 4))
638 {
639 return ERROR_TARGET_RESOURCE_NOT_AVAILABLE;
640 }
641
642 arm7_9->wp_available--;
643
644 return ERROR_OK;
645 }
646
647 /**
648 * Remove a watchpoint from an ARM7/9 target. The watchpoint will be unset and
649 * the used watchpoint unit will be reopened.
650 *
651 * @param target Pointer to the target to remove a watchpoint from
652 * @param watchpoint Pointer to the watchpoint to be removed
653 * @return Result of trying to unset the watchpoint
654 */
655 int arm7_9_remove_watchpoint(struct target *target, struct watchpoint *watchpoint)
656 {
657 int retval = ERROR_OK;
658 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
659
660 if (watchpoint->set)
661 {
662 if ((retval = arm7_9_unset_watchpoint(target, watchpoint)) != ERROR_OK)
663 {
664 return retval;
665 }
666 }
667
668 arm7_9->wp_available++;
669
670 return ERROR_OK;
671 }
672
673 /**
674 * Restarts the target by sending a RESTART instruction and moving the JTAG
675 * state to IDLE. This includes a timeout waiting for DBGACK and SYSCOMP to be
676 * asserted by the processor.
677 *
678 * @param target Pointer to target to issue commands to
679 * @return Error status if there is a timeout or a problem while executing the
680 * JTAG queue
681 */
682 int arm7_9_execute_sys_speed(struct target *target)
683 {
684 int retval;
685 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
686 struct arm_jtag *jtag_info = &arm7_9->jtag_info;
687 struct reg *dbg_stat = &arm7_9->eice_cache->reg_list[EICE_DBG_STAT];
688
689 /* set RESTART instruction */
690 jtag_set_end_state(TAP_IDLE);
691 if (arm7_9->need_bypass_before_restart) {
692 arm7_9->need_bypass_before_restart = 0;
693 arm_jtag_set_instr(jtag_info, 0xf, NULL, TAP_IDLE);
694 }
695 arm_jtag_set_instr(jtag_info, 0x4, NULL, TAP_IDLE);
696
697 long long then = timeval_ms();
698 int timeout;
699 while (!(timeout = ((timeval_ms()-then) > 1000)))
700 {
701 /* read debug status register */
702 embeddedice_read_reg(dbg_stat);
703 if ((retval = jtag_execute_queue()) != ERROR_OK)
704 return retval;
705 if ((buf_get_u32(dbg_stat->value, EICE_DBG_STATUS_DBGACK, 1))
706 && (buf_get_u32(dbg_stat->value, EICE_DBG_STATUS_SYSCOMP, 1)))
707 break;
708 if (debug_level >= 3)
709 {
710 alive_sleep(100);
711 } else
712 {
713 keep_alive();
714 }
715 }
716 if (timeout)
717 {
718 LOG_ERROR("timeout waiting for SYSCOMP & DBGACK, last DBG_STATUS: %" PRIx32 "", buf_get_u32(dbg_stat->value, 0, dbg_stat->size));
719 return ERROR_TARGET_TIMEOUT;
720 }
721
722 return ERROR_OK;
723 }
724
725 /**
726 * Restarts the target by sending a RESTART instruction and moving the JTAG
727 * state to IDLE. This validates that DBGACK and SYSCOMP are set without
728 * waiting until they are.
729 *
730 * @param target Pointer to the target to issue commands to
731 * @return Always ERROR_OK
732 */
733 int arm7_9_execute_fast_sys_speed(struct target *target)
734 {
735 static int set = 0;
736 static uint8_t check_value[4], check_mask[4];
737
738 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
739 struct arm_jtag *jtag_info = &arm7_9->jtag_info;
740 struct reg *dbg_stat = &arm7_9->eice_cache->reg_list[EICE_DBG_STAT];
741
742 /* set RESTART instruction */
743 jtag_set_end_state(TAP_IDLE);
744 if (arm7_9->need_bypass_before_restart) {
745 arm7_9->need_bypass_before_restart = 0;
746 arm_jtag_set_instr(jtag_info, 0xf, NULL, TAP_IDLE);
747 }
748 arm_jtag_set_instr(jtag_info, 0x4, NULL, TAP_IDLE);
749
750 if (!set)
751 {
752 /* check for DBGACK and SYSCOMP set (others don't care) */
753
754 /* NB! These are constants that must be available until after next jtag_execute() and
755 * we evaluate the values upon first execution in lieu of setting up these constants
756 * during early setup.
757 * */
758 buf_set_u32(check_value, 0, 32, 0x9);
759 buf_set_u32(check_mask, 0, 32, 0x9);
760 set = 1;
761 }
762
763 /* read debug status register */
764 embeddedice_read_reg_w_check(dbg_stat, check_value, check_mask);
765
766 return ERROR_OK;
767 }
768
769 /**
770 * Get some data from the ARM7/9 target.
771 *
772 * @param target Pointer to the ARM7/9 target to read data from
773 * @param size The number of 32bit words to be read
774 * @param buffer Pointer to the buffer that will hold the data
775 * @return The result of receiving data from the Embedded ICE unit
776 */
777 int arm7_9_target_request_data(struct target *target, uint32_t size, uint8_t *buffer)
778 {
779 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
780 struct arm_jtag *jtag_info = &arm7_9->jtag_info;
781 uint32_t *data;
782 int retval = ERROR_OK;
783 uint32_t i;
784
785 data = malloc(size * (sizeof(uint32_t)));
786
787 retval = embeddedice_receive(jtag_info, data, size);
788
789 /* return the 32-bit ints in the 8-bit array */
790 for (i = 0; i < size; i++)
791 {
792 h_u32_to_le(buffer + (i * 4), data[i]);
793 }
794
795 free(data);
796
797 return retval;
798 }
799
800 /**
801 * Handles requests to an ARM7/9 target. If debug messaging is enabled, the
802 * target is running and the DCC control register has the W bit high, this will
803 * execute the request on the target.
804 *
805 * @param priv Void pointer expected to be a struct target pointer
806 * @return ERROR_OK unless there are issues with the JTAG queue or when reading
807 * from the Embedded ICE unit
808 */
809 int arm7_9_handle_target_request(void *priv)
810 {
811 int retval = ERROR_OK;
812 struct target *target = priv;
813 if (!target_was_examined(target))
814 return ERROR_OK;
815 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
816 struct arm_jtag *jtag_info = &arm7_9->jtag_info;
817 struct reg *dcc_control = &arm7_9->eice_cache->reg_list[EICE_COMMS_CTRL];
818
819 if (!target->dbg_msg_enabled)
820 return ERROR_OK;
821
822 if (target->state == TARGET_RUNNING)
823 {
824 /* read DCC control register */
825 embeddedice_read_reg(dcc_control);
826 if ((retval = jtag_execute_queue()) != ERROR_OK)
827 {
828 return retval;
829 }
830
831 /* check W bit */
832 if (buf_get_u32(dcc_control->value, 1, 1) == 1)
833 {
834 uint32_t request;
835
836 if ((retval = embeddedice_receive(jtag_info, &request, 1)) != ERROR_OK)
837 {
838 return retval;
839 }
840 if ((retval = target_request(target, request)) != ERROR_OK)
841 {
842 return retval;
843 }
844 }
845 }
846
847 return ERROR_OK;
848 }
849
850 /**
851 * Polls an ARM7/9 target for its current status. If DBGACK is set, the target
852 * is manipulated to the right halted state based on its current state. This is
853 * what happens:
854 *
855 * <table>
856 * <tr><th > State</th><th > Action</th></tr>
857 * <tr><td > TARGET_RUNNING | TARGET_RESET</td><td > Enters debug mode. If TARGET_RESET, pc may be checked</td></tr>
858 * <tr><td > TARGET_UNKNOWN</td><td > Warning is logged</td></tr>
859 * <tr><td > TARGET_DEBUG_RUNNING</td><td > Enters debug mode</td></tr>
860 * <tr><td > TARGET_HALTED</td><td > Nothing</td></tr>
861 * </table>
862 *
863 * If the target does not end up in the halted state, a warning is produced. If
864 * DBGACK is cleared, then the target is expected to either be running or
865 * running in debug.
866 *
867 * @param target Pointer to the ARM7/9 target to poll
868 * @return ERROR_OK or an error status if a command fails
869 */
870 int arm7_9_poll(struct target *target)
871 {
872 int retval;
873 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
874 struct reg *dbg_stat = &arm7_9->eice_cache->reg_list[EICE_DBG_STAT];
875
876 /* read debug status register */
877 embeddedice_read_reg(dbg_stat);
878 if ((retval = jtag_execute_queue()) != ERROR_OK)
879 {
880 return retval;
881 }
882
883 if (buf_get_u32(dbg_stat->value, EICE_DBG_STATUS_DBGACK, 1))
884 {
885 /* LOG_DEBUG("DBGACK set, dbg_state->value: 0x%x", buf_get_u32(dbg_stat->value, 0, 32));*/
886 if (target->state == TARGET_UNKNOWN)
887 {
888 /* Starting OpenOCD with target in debug-halt */
889 target->state = TARGET_RUNNING;
890 LOG_DEBUG("DBGACK already set during server startup.");
891 }
892 if ((target->state == TARGET_RUNNING) || (target->state == TARGET_RESET))
893 {
894 target->state = TARGET_HALTED;
895
896 if ((retval = arm7_9_debug_entry(target)) != ERROR_OK)
897 return retval;
898
899 if (arm_semihosting(target, &retval) != 0)
900 return retval;
901
902 if ((retval = target_call_event_callbacks(target, TARGET_EVENT_HALTED)) != ERROR_OK)
903 {
904 return retval;
905 }
906 }
907 if (target->state == TARGET_DEBUG_RUNNING)
908 {
909 target->state = TARGET_HALTED;
910 if ((retval = arm7_9_debug_entry(target)) != ERROR_OK)
911 return retval;
912
913 if ((retval = target_call_event_callbacks(target, TARGET_EVENT_DEBUG_HALTED)) != ERROR_OK)
914 {
915 return retval;
916 }
917 }
918 if (target->state != TARGET_HALTED)
919 {
920 LOG_WARNING("DBGACK set, but the target did not end up in the halted state %d", target->state);
921 }
922 }
923 else
924 {
925 if (target->state != TARGET_DEBUG_RUNNING)
926 target->state = TARGET_RUNNING;
927 }
928
929 return ERROR_OK;
930 }
931
932 /**
933 * Asserts the reset (SRST) on an ARM7/9 target. Some -S targets (ARM966E-S in
934 * the STR912 isn't affected, ARM926EJ-S in the LPC3180 and AT91SAM9260 is
935 * affected) completely stop the JTAG clock while the core is held in reset
936 * (SRST). It isn't possible to program the halt condition once reset is
937 * asserted, hence a hook that allows the target to set up its reset-halt
938 * condition is setup prior to asserting reset.
939 *
940 * @param target Pointer to an ARM7/9 target to assert reset on
941 * @return ERROR_FAIL if the JTAG device does not have SRST, otherwise ERROR_OK
942 */
943 int arm7_9_assert_reset(struct target *target)
944 {
945 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
946 enum reset_types jtag_reset_config = jtag_get_reset_config();
947 bool use_event = false;
948
949 LOG_DEBUG("target->state: %s",
950 target_state_name(target));
951
952 if (target_has_event_action(target, TARGET_EVENT_RESET_ASSERT))
953 use_event = true;
954 else if (!(jtag_reset_config & RESET_HAS_SRST)) {
955 LOG_ERROR("%s: how to reset?", target_name(target));
956 return ERROR_FAIL;
957 }
958
959 /* At this point trst has been asserted/deasserted once. We would
960 * like to program EmbeddedICE while SRST is asserted, instead of
961 * depending on SRST to leave that module alone. However, many CPUs
962 * gate the JTAG clock while SRST is asserted; or JTAG may need
963 * clock stability guarantees (adaptive clocking might help).
964 *
965 * So we assume JTAG access during SRST is off the menu unless it's
966 * been specifically enabled.
967 */
968 bool srst_asserted = false;
969
970 if (!use_event
971 && !(jtag_reset_config & RESET_SRST_PULLS_TRST)
972 && (jtag_reset_config & RESET_SRST_NO_GATING))
973 {
974 jtag_add_reset(0, 1);
975 srst_asserted = true;
976 }
977
978 if (target->reset_halt)
979 {
980 /*
981 * For targets that don't support communication while SRST is
982 * asserted, we need to set up the reset vector catch first.
983 *
984 * When we use TRST+SRST and that's equivalent to a power-up
985 * reset, these settings may well be reset anyway; so setting
986 * them here won't matter.
987 */
988 if (arm7_9->has_vector_catch)
989 {
990 /* program vector catch register to catch reset */
991 embeddedice_write_reg(&arm7_9->eice_cache
992 ->reg_list[EICE_VEC_CATCH], 0x1);
993
994 /* extra runtest added as issues were found with
995 * certain ARM9 cores (maybe more) - AT91SAM9260
996 * and STR9
997 */
998 jtag_add_runtest(1, TAP_IDLE);
999 }
1000 else
1001 {
1002 /* program watchpoint unit to match on reset vector
1003 * address
1004 */
1005 embeddedice_write_reg(&arm7_9->eice_cache
1006 ->reg_list[EICE_W0_ADDR_VALUE], 0x0);
1007 embeddedice_write_reg(&arm7_9->eice_cache
1008 ->reg_list[EICE_W0_ADDR_MASK], 0x3);
1009 embeddedice_write_reg(&arm7_9->eice_cache
1010 ->reg_list[EICE_W0_DATA_MASK],
1011 0xffffffff);
1012 embeddedice_write_reg(&arm7_9->eice_cache
1013 ->reg_list[EICE_W0_CONTROL_VALUE],
1014 EICE_W_CTRL_ENABLE);
1015 embeddedice_write_reg(&arm7_9->eice_cache
1016 ->reg_list[EICE_W0_CONTROL_MASK],
1017 ~EICE_W_CTRL_nOPC & 0xff);
1018 }
1019 }
1020
1021 if (use_event) {
1022 target_handle_event(target, TARGET_EVENT_RESET_ASSERT);
1023 } else {
1024 /* If we use SRST ... we'd like to issue just SRST, but the
1025 * board or chip may be set up so we have to assert TRST as
1026 * well. On some chips that combination is equivalent to a
1027 * power-up reset, and generally clobbers EICE state.
1028 */
1029 if (jtag_reset_config & RESET_SRST_PULLS_TRST)
1030 jtag_add_reset(1, 1);
1031 else if (!srst_asserted)
1032 jtag_add_reset(0, 1);
1033 jtag_add_sleep(50000);
1034 }
1035
1036 target->state = TARGET_RESET;
1037 register_cache_invalidate(arm7_9->armv4_5_common.core_cache);
1038
1039 /* REVISIT why isn't standard debug entry logic sufficient?? */
1040 if (target->reset_halt
1041 && (!(jtag_reset_config & RESET_SRST_PULLS_TRST)
1042 || use_event))
1043 {
1044 /* debug entry was prepared above */
1045 target->debug_reason = DBG_REASON_DBGRQ;
1046 }
1047
1048 return ERROR_OK;
1049 }
1050
1051 /**
1052 * Deassert the reset (SRST) signal on an ARM7/9 target. If SRST pulls TRST
1053 * and the target is being reset into a halt, a warning will be triggered
1054 * because it is not possible to reset into a halted mode in this case. The
1055 * target is halted using the target's functions.
1056 *
1057 * @param target Pointer to the target to have the reset deasserted
1058 * @return ERROR_OK or an error from polling or halting the target
1059 */
1060 int arm7_9_deassert_reset(struct target *target)
1061 {
1062 int retval = ERROR_OK;
1063 LOG_DEBUG("target->state: %s",
1064 target_state_name(target));
1065
1066 /* deassert reset lines */
1067 jtag_add_reset(0, 0);
1068
1069 enum reset_types jtag_reset_config = jtag_get_reset_config();
1070 if (target->reset_halt && (jtag_reset_config & RESET_SRST_PULLS_TRST) != 0)
1071 {
1072 LOG_WARNING("srst pulls trst - can not reset into halted mode. Issuing halt after reset.");
1073 /* set up embedded ice registers again */
1074 if ((retval = target_examine_one(target)) != ERROR_OK)
1075 return retval;
1076
1077 if ((retval = target_poll(target)) != ERROR_OK)
1078 {
1079 return retval;
1080 }
1081
1082 if ((retval = target_halt(target)) != ERROR_OK)
1083 {
1084 return retval;
1085 }
1086
1087 }
1088 return retval;
1089 }
1090
1091 /**
1092 * Clears the halt condition for an ARM7/9 target. If it isn't coming out of
1093 * reset and if DBGRQ is used, it is progammed to be deasserted. If the reset
1094 * vector catch was used, it is restored. Otherwise, the control value is
1095 * restored and the watchpoint unit is restored if it was in use.
1096 *
1097 * @param target Pointer to the ARM7/9 target to have halt cleared
1098 * @return Always ERROR_OK
1099 */
1100 int arm7_9_clear_halt(struct target *target)
1101 {
1102 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
1103 struct reg *dbg_ctrl = &arm7_9->eice_cache->reg_list[EICE_DBG_CTRL];
1104
1105 /* we used DBGRQ only if we didn't come out of reset */
1106 if (!arm7_9->debug_entry_from_reset && arm7_9->use_dbgrq)
1107 {
1108 /* program EmbeddedICE Debug Control Register to deassert DBGRQ
1109 */
1110 buf_set_u32(dbg_ctrl->value, EICE_DBG_CONTROL_DBGRQ, 1, 0);
1111 embeddedice_store_reg(dbg_ctrl);
1112 }
1113 else
1114 {
1115 if (arm7_9->debug_entry_from_reset && arm7_9->has_vector_catch)
1116 {
1117 /* if we came out of reset, and vector catch is supported, we used
1118 * vector catch to enter debug state
1119 * restore the register in that case
1120 */
1121 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_VEC_CATCH]);
1122 }
1123 else
1124 {
1125 /* restore registers if watchpoint unit 0 was in use
1126 */
1127 if (arm7_9->wp0_used)
1128 {
1129 if (arm7_9->debug_entry_from_reset)
1130 {
1131 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_W0_ADDR_VALUE]);
1132 }
1133 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_W0_ADDR_MASK]);
1134 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_W0_DATA_MASK]);
1135 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_MASK]);
1136 }
1137 /* control value always has to be restored, as it was either disabled,
1138 * or enabled with possibly different bits
1139 */
1140 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_VALUE]);
1141 }
1142 }
1143
1144 return ERROR_OK;
1145 }
1146
1147 /**
1148 * Issue a software reset and halt to an ARM7/9 target. The target is halted
1149 * and then there is a wait until the processor shows the halt. This wait can
1150 * timeout and results in an error being returned. The software reset involves
1151 * clearing the halt, updating the debug control register, changing to ARM mode,
1152 * reset of the program counter, and reset of all of the registers.
1153 *
1154 * @param target Pointer to the ARM7/9 target to be reset and halted by software
1155 * @return Error status if any of the commands fail, otherwise ERROR_OK
1156 */
1157 int arm7_9_soft_reset_halt(struct target *target)
1158 {
1159 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
1160 struct arm *armv4_5 = &arm7_9->armv4_5_common;
1161 struct reg *dbg_stat = &arm7_9->eice_cache->reg_list[EICE_DBG_STAT];
1162 struct reg *dbg_ctrl = &arm7_9->eice_cache->reg_list[EICE_DBG_CTRL];
1163 int i;
1164 int retval;
1165
1166 /* FIX!!! replace some of this code with tcl commands
1167 *
1168 * halt # the halt command is synchronous
1169 * armv4_5 core_state arm
1170 *
1171 */
1172
1173 if ((retval = target_halt(target)) != ERROR_OK)
1174 return retval;
1175
1176 long long then = timeval_ms();
1177 int timeout;
1178 while (!(timeout = ((timeval_ms()-then) > 1000)))
1179 {
1180 if (buf_get_u32(dbg_stat->value, EICE_DBG_STATUS_DBGACK, 1) != 0)
1181 break;
1182 embeddedice_read_reg(dbg_stat);
1183 if ((retval = jtag_execute_queue()) != ERROR_OK)
1184 return retval;
1185 if (debug_level >= 3)
1186 {
1187 alive_sleep(100);
1188 } else
1189 {
1190 keep_alive();
1191 }
1192 }
1193 if (timeout)
1194 {
1195 LOG_ERROR("Failed to halt CPU after 1 sec");
1196 return ERROR_TARGET_TIMEOUT;
1197 }
1198 target->state = TARGET_HALTED;
1199
1200 /* program EmbeddedICE Debug Control Register to assert DBGACK and INTDIS
1201 * ensure that DBGRQ is cleared
1202 */
1203 buf_set_u32(dbg_ctrl->value, EICE_DBG_CONTROL_DBGACK, 1, 1);
1204 buf_set_u32(dbg_ctrl->value, EICE_DBG_CONTROL_DBGRQ, 1, 0);
1205 buf_set_u32(dbg_ctrl->value, EICE_DBG_CONTROL_INTDIS, 1, 1);
1206 embeddedice_store_reg(dbg_ctrl);
1207
1208 if ((retval = arm7_9_clear_halt(target)) != ERROR_OK)
1209 {
1210 return retval;
1211 }
1212
1213 /* if the target is in Thumb state, change to ARM state */
1214 if (buf_get_u32(dbg_stat->value, EICE_DBG_STATUS_ITBIT, 1))
1215 {
1216 uint32_t r0_thumb, pc_thumb;
1217 LOG_DEBUG("target entered debug from Thumb state, changing to ARM");
1218 /* Entered debug from Thumb mode */
1219 armv4_5->core_state = ARM_STATE_THUMB;
1220 arm7_9->change_to_arm(target, &r0_thumb, &pc_thumb);
1221 }
1222
1223 /* REVISIT likewise for bit 5 -- switch Jazelle-to-ARM */
1224
1225 /* all register content is now invalid */
1226 register_cache_invalidate(armv4_5->core_cache);
1227
1228 /* SVC, ARM state, IRQ and FIQ disabled */
1229 uint32_t cpsr;
1230
1231 cpsr = buf_get_u32(armv4_5->cpsr->value, 0, 32);
1232 cpsr &= ~0xff;
1233 cpsr |= 0xd3;
1234 arm_set_cpsr(armv4_5, cpsr);
1235 armv4_5->cpsr->dirty = 1;
1236
1237 /* start fetching from 0x0 */
1238 buf_set_u32(armv4_5->pc->value, 0, 32, 0x0);
1239 armv4_5->pc->dirty = 1;
1240 armv4_5->pc->valid = 1;
1241
1242 /* reset registers */
1243 for (i = 0; i <= 14; i++)
1244 {
1245 struct reg *r = arm_reg_current(armv4_5, i);
1246
1247 buf_set_u32(r->value, 0, 32, 0xffffffff);
1248 r->dirty = 1;
1249 r->valid = 1;
1250 }
1251
1252 if ((retval = target_call_event_callbacks(target, TARGET_EVENT_HALTED)) != ERROR_OK)
1253 {
1254 return retval;
1255 }
1256
1257 return ERROR_OK;
1258 }
1259
1260 /**
1261 * Halt an ARM7/9 target. This is accomplished by either asserting the DBGRQ
1262 * line or by programming a watchpoint to trigger on any address. It is
1263 * considered a bug to call this function while the target is in the
1264 * TARGET_RESET state.
1265 *
1266 * @param target Pointer to the ARM7/9 target to be halted
1267 * @return Always ERROR_OK
1268 */
1269 int arm7_9_halt(struct target *target)
1270 {
1271 if (target->state == TARGET_RESET)
1272 {
1273 LOG_ERROR("BUG: arm7/9 does not support halt during reset. This is handled in arm7_9_assert_reset()");
1274 return ERROR_OK;
1275 }
1276
1277 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
1278 struct reg *dbg_ctrl = &arm7_9->eice_cache->reg_list[EICE_DBG_CTRL];
1279
1280 LOG_DEBUG("target->state: %s",
1281 target_state_name(target));
1282
1283 if (target->state == TARGET_HALTED)
1284 {
1285 LOG_DEBUG("target was already halted");
1286 return ERROR_OK;
1287 }
1288
1289 if (target->state == TARGET_UNKNOWN)
1290 {
1291 LOG_WARNING("target was in unknown state when halt was requested");
1292 }
1293
1294 if (arm7_9->use_dbgrq)
1295 {
1296 /* program EmbeddedICE Debug Control Register to assert DBGRQ
1297 */
1298 if (arm7_9->set_special_dbgrq) {
1299 arm7_9->set_special_dbgrq(target);
1300 } else {
1301 buf_set_u32(dbg_ctrl->value, EICE_DBG_CONTROL_DBGRQ, 1, 1);
1302 embeddedice_store_reg(dbg_ctrl);
1303 }
1304 }
1305 else
1306 {
1307 /* program watchpoint unit to match on any address
1308 */
1309 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W0_ADDR_MASK], 0xffffffff);
1310 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W0_DATA_MASK], 0xffffffff);
1311 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_VALUE], EICE_W_CTRL_ENABLE);
1312 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_MASK], ~EICE_W_CTRL_nOPC & 0xff);
1313 }
1314
1315 target->debug_reason = DBG_REASON_DBGRQ;
1316
1317 return ERROR_OK;
1318 }
1319
1320 /**
1321 * Handle an ARM7/9 target's entry into debug mode. The halt is cleared on the
1322 * ARM. The JTAG queue is then executed and the reason for debug entry is
1323 * examined. Once done, the target is verified to be halted and the processor
1324 * is forced into ARM mode. The core registers are saved for the current core
1325 * mode and the program counter (register 15) is updated as needed. The core
1326 * registers and CPSR and SPSR are saved for restoration later.
1327 *
1328 * @param target Pointer to target that is entering debug mode
1329 * @return Error code if anything fails, otherwise ERROR_OK
1330 */
1331 static int arm7_9_debug_entry(struct target *target)
1332 {
1333 int i;
1334 uint32_t context[16];
1335 uint32_t* context_p[16];
1336 uint32_t r0_thumb, pc_thumb;
1337 uint32_t cpsr, cpsr_mask = 0;
1338 int retval;
1339 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
1340 struct arm *armv4_5 = &arm7_9->armv4_5_common;
1341 struct reg *dbg_stat = &arm7_9->eice_cache->reg_list[EICE_DBG_STAT];
1342 struct reg *dbg_ctrl = &arm7_9->eice_cache->reg_list[EICE_DBG_CTRL];
1343
1344 #ifdef _DEBUG_ARM7_9_
1345 LOG_DEBUG("-");
1346 #endif
1347
1348 /* program EmbeddedICE Debug Control Register to assert DBGACK and INTDIS
1349 * ensure that DBGRQ is cleared
1350 */
1351 buf_set_u32(dbg_ctrl->value, EICE_DBG_CONTROL_DBGACK, 1, 1);
1352 buf_set_u32(dbg_ctrl->value, EICE_DBG_CONTROL_DBGRQ, 1, 0);
1353 buf_set_u32(dbg_ctrl->value, EICE_DBG_CONTROL_INTDIS, 1, 1);
1354 embeddedice_store_reg(dbg_ctrl);
1355
1356 if ((retval = arm7_9_clear_halt(target)) != ERROR_OK)
1357 {
1358 return retval;
1359 }
1360
1361 if ((retval = jtag_execute_queue()) != ERROR_OK)
1362 {
1363 return retval;
1364 }
1365
1366 if ((retval = arm7_9->examine_debug_reason(target)) != ERROR_OK)
1367 return retval;
1368
1369
1370 if (target->state != TARGET_HALTED)
1371 {
1372 LOG_WARNING("target not halted");
1373 return ERROR_TARGET_NOT_HALTED;
1374 }
1375
1376 /* if the target is in Thumb state, change to ARM state */
1377 if (buf_get_u32(dbg_stat->value, EICE_DBG_STATUS_ITBIT, 1))
1378 {
1379 LOG_DEBUG("target entered debug from Thumb state");
1380 /* Entered debug from Thumb mode */
1381 armv4_5->core_state = ARM_STATE_THUMB;
1382 cpsr_mask = 1 << 5;
1383 arm7_9->change_to_arm(target, &r0_thumb, &pc_thumb);
1384 LOG_DEBUG("r0_thumb: 0x%8.8" PRIx32
1385 ", pc_thumb: 0x%8.8" PRIx32, r0_thumb, pc_thumb);
1386 } else if (buf_get_u32(dbg_stat->value, 5, 1)) {
1387 /* \todo Get some vaguely correct handling of Jazelle, if
1388 * anyone ever uses it and full info becomes available.
1389 * See ARM9EJS TRM B.7.1 for how to switch J->ARM; and
1390 * B.7.3 for the reverse. That'd be the bare minimum...
1391 */
1392 LOG_DEBUG("target entered debug from Jazelle state");
1393 armv4_5->core_state = ARM_STATE_JAZELLE;
1394 cpsr_mask = 1 << 24;
1395 LOG_ERROR("Jazelle debug entry -- BROKEN!");
1396 } else {
1397 LOG_DEBUG("target entered debug from ARM state");
1398 /* Entered debug from ARM mode */
1399 armv4_5->core_state = ARM_STATE_ARM;
1400 }
1401
1402 for (i = 0; i < 16; i++)
1403 context_p[i] = &context[i];
1404 /* save core registers (r0 - r15 of current core mode) */
1405 arm7_9->read_core_regs(target, 0xffff, context_p);
1406
1407 arm7_9->read_xpsr(target, &cpsr, 0);
1408
1409 if ((retval = jtag_execute_queue()) != ERROR_OK)
1410 return retval;
1411
1412 /* Sync our CPSR copy with J or T bits EICE reported, but
1413 * which we then erased by putting the core into ARM mode.
1414 */
1415 arm_set_cpsr(armv4_5, cpsr | cpsr_mask);
1416
1417 if (!is_arm_mode(armv4_5->core_mode))
1418 {
1419 target->state = TARGET_UNKNOWN;
1420 LOG_ERROR("cpsr contains invalid mode value - communication failure");
1421 return ERROR_TARGET_FAILURE;
1422 }
1423
1424 LOG_DEBUG("target entered debug state in %s mode",
1425 arm_mode_name(armv4_5->core_mode));
1426
1427 if (armv4_5->core_state == ARM_STATE_THUMB)
1428 {
1429 LOG_DEBUG("thumb state, applying fixups");
1430 context[0] = r0_thumb;
1431 context[15] = pc_thumb;
1432 } else if (armv4_5->core_state == ARM_STATE_ARM)
1433 {
1434 /* adjust value stored by STM */
1435 context[15] -= 3 * 4;
1436 }
1437
1438 if ((target->debug_reason != DBG_REASON_DBGRQ) || (!arm7_9->use_dbgrq))
1439 context[15] -= 3 * ((armv4_5->core_state == ARM_STATE_ARM) ? 4 : 2);
1440 else
1441 context[15] -= arm7_9->dbgreq_adjust_pc * ((armv4_5->core_state == ARM_STATE_ARM) ? 4 : 2);
1442
1443 for (i = 0; i <= 15; i++)
1444 {
1445 struct reg *r = arm_reg_current(armv4_5, i);
1446
1447 LOG_DEBUG("r%i: 0x%8.8" PRIx32 "", i, context[i]);
1448
1449 buf_set_u32(r->value, 0, 32, context[i]);
1450 /* r0 and r15 (pc) have to be restored later */
1451 r->dirty = (i == 0) || (i == 15);
1452 r->valid = 1;
1453 }
1454
1455 LOG_DEBUG("entered debug state at PC 0x%" PRIx32 "", context[15]);
1456
1457 /* exceptions other than USR & SYS have a saved program status register */
1458 if (armv4_5->spsr) {
1459 uint32_t spsr;
1460 arm7_9->read_xpsr(target, &spsr, 1);
1461 if ((retval = jtag_execute_queue()) != ERROR_OK)
1462 {
1463 return retval;
1464 }
1465 buf_set_u32(armv4_5->spsr->value, 0, 32, spsr);
1466 armv4_5->spsr->dirty = 0;
1467 armv4_5->spsr->valid = 1;
1468 }
1469
1470 if ((retval = jtag_execute_queue()) != ERROR_OK)
1471 return retval;
1472
1473 if (arm7_9->post_debug_entry)
1474 arm7_9->post_debug_entry(target);
1475
1476 return ERROR_OK;
1477 }
1478
1479 /**
1480 * Validate the full context for an ARM7/9 target in all processor modes. If
1481 * there are any invalid registers for the target, they will all be read. This
1482 * includes the PSR.
1483 *
1484 * @param target Pointer to the ARM7/9 target to capture the full context from
1485 * @return Error if the target is not halted, has an invalid core mode, or if
1486 * the JTAG queue fails to execute
1487 */
1488 int arm7_9_full_context(struct target *target)
1489 {
1490 int i;
1491 int retval;
1492 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
1493 struct arm *armv4_5 = &arm7_9->armv4_5_common;
1494
1495 LOG_DEBUG("-");
1496
1497 if (target->state != TARGET_HALTED)
1498 {
1499 LOG_WARNING("target not halted");
1500 return ERROR_TARGET_NOT_HALTED;
1501 }
1502
1503 if (!is_arm_mode(armv4_5->core_mode))
1504 return ERROR_FAIL;
1505
1506 /* iterate through processor modes (User, FIQ, IRQ, SVC, ABT, UND)
1507 * SYS shares registers with User, so we don't touch SYS
1508 */
1509 for (i = 0; i < 6; i++)
1510 {
1511 uint32_t mask = 0;
1512 uint32_t* reg_p[16];
1513 int j;
1514 int valid = 1;
1515
1516 /* check if there are invalid registers in the current mode
1517 */
1518 for (j = 0; j <= 16; j++)
1519 {
1520 if (ARMV4_5_CORE_REG_MODE(armv4_5->core_cache, armv4_5_number_to_mode(i), j).valid == 0)
1521 valid = 0;
1522 }
1523
1524 if (!valid)
1525 {
1526 uint32_t tmp_cpsr;
1527
1528 /* change processor mode (and mask T bit) */
1529 tmp_cpsr = buf_get_u32(armv4_5->cpsr->value, 0, 8)
1530 & 0xe0;
1531 tmp_cpsr |= armv4_5_number_to_mode(i);
1532 tmp_cpsr &= ~0x20;
1533 arm7_9->write_xpsr_im8(target, tmp_cpsr & 0xff, 0, 0);
1534
1535 for (j = 0; j < 15; j++)
1536 {
1537 if (ARMV4_5_CORE_REG_MODE(armv4_5->core_cache, armv4_5_number_to_mode(i), j).valid == 0)
1538 {
1539 reg_p[j] = (uint32_t*)ARMV4_5_CORE_REG_MODE(armv4_5->core_cache, armv4_5_number_to_mode(i), j).value;
1540 mask |= 1 << j;
1541 ARMV4_5_CORE_REG_MODE(armv4_5->core_cache, armv4_5_number_to_mode(i), j).valid = 1;
1542 ARMV4_5_CORE_REG_MODE(armv4_5->core_cache, armv4_5_number_to_mode(i), j).dirty = 0;
1543 }
1544 }
1545
1546 /* if only the PSR is invalid, mask is all zeroes */
1547 if (mask)
1548 arm7_9->read_core_regs(target, mask, reg_p);
1549
1550 /* check if the PSR has to be read */
1551 if (ARMV4_5_CORE_REG_MODE(armv4_5->core_cache, armv4_5_number_to_mode(i), 16).valid == 0)
1552 {
1553 arm7_9->read_xpsr(target, (uint32_t*)ARMV4_5_CORE_REG_MODE(armv4_5->core_cache, armv4_5_number_to_mode(i), 16).value, 1);
1554 ARMV4_5_CORE_REG_MODE(armv4_5->core_cache, armv4_5_number_to_mode(i), 16).valid = 1;
1555 ARMV4_5_CORE_REG_MODE(armv4_5->core_cache, armv4_5_number_to_mode(i), 16).dirty = 0;
1556 }
1557 }
1558 }
1559
1560 /* restore processor mode (mask T bit) */
1561 arm7_9->write_xpsr_im8(target,
1562 buf_get_u32(armv4_5->cpsr->value, 0, 8) & ~0x20,
1563 0, 0);
1564
1565 if ((retval = jtag_execute_queue()) != ERROR_OK)
1566 {
1567 return retval;
1568 }
1569 return ERROR_OK;
1570 }
1571
1572 /**
1573 * Restore the processor context on an ARM7/9 target. The full processor
1574 * context is analyzed to see if any of the registers are dirty on this end, but
1575 * have a valid new value. If this is the case, the processor is changed to the
1576 * appropriate mode and the new register values are written out to the
1577 * processor. If there happens to be a dirty register with an invalid value, an
1578 * error will be logged.
1579 *
1580 * @param target Pointer to the ARM7/9 target to have its context restored
1581 * @return Error status if the target is not halted or the core mode in the
1582 * armv4_5 struct is invalid.
1583 */
1584 int arm7_9_restore_context(struct target *target)
1585 {
1586 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
1587 struct arm *armv4_5 = &arm7_9->armv4_5_common;
1588 struct reg *reg;
1589 struct arm_reg *reg_arch_info;
1590 enum arm_mode current_mode = armv4_5->core_mode;
1591 int i, j;
1592 int dirty;
1593 int mode_change;
1594
1595 LOG_DEBUG("-");
1596
1597 if (target->state != TARGET_HALTED)
1598 {
1599 LOG_WARNING("target not halted");
1600 return ERROR_TARGET_NOT_HALTED;
1601 }
1602
1603 if (arm7_9->pre_restore_context)
1604 arm7_9->pre_restore_context(target);
1605
1606 if (!is_arm_mode(armv4_5->core_mode))
1607 return ERROR_FAIL;
1608
1609 /* iterate through processor modes (User, FIQ, IRQ, SVC, ABT, UND)
1610 * SYS shares registers with User, so we don't touch SYS
1611 */
1612 for (i = 0; i < 6; i++)
1613 {
1614 LOG_DEBUG("examining %s mode",
1615 arm_mode_name(armv4_5->core_mode));
1616 dirty = 0;
1617 mode_change = 0;
1618 /* check if there are dirty registers in the current mode
1619 */
1620 for (j = 0; j <= 16; j++)
1621 {
1622 reg = &ARMV4_5_CORE_REG_MODE(armv4_5->core_cache, armv4_5_number_to_mode(i), j);
1623 reg_arch_info = reg->arch_info;
1624 if (reg->dirty == 1)
1625 {
1626 if (reg->valid == 1)
1627 {
1628 dirty = 1;
1629 LOG_DEBUG("examining dirty reg: %s", reg->name);
1630 if ((reg_arch_info->mode != ARM_MODE_ANY)
1631 && (reg_arch_info->mode != current_mode)
1632 && !((reg_arch_info->mode == ARM_MODE_USR) && (armv4_5->core_mode == ARM_MODE_SYS))
1633 && !((reg_arch_info->mode == ARM_MODE_SYS) && (armv4_5->core_mode == ARM_MODE_USR)))
1634 {
1635 mode_change = 1;
1636 LOG_DEBUG("require mode change");
1637 }
1638 }
1639 else
1640 {
1641 LOG_ERROR("BUG: dirty register '%s', but no valid data", reg->name);
1642 }
1643 }
1644 }
1645
1646 if (dirty)
1647 {
1648 uint32_t mask = 0x0;
1649 int num_regs = 0;
1650 uint32_t regs[16];
1651
1652 if (mode_change)
1653 {
1654 uint32_t tmp_cpsr;
1655
1656 /* change processor mode (mask T bit) */
1657 tmp_cpsr = buf_get_u32(armv4_5->cpsr->value,
1658 0, 8) & 0xe0;
1659 tmp_cpsr |= armv4_5_number_to_mode(i);
1660 tmp_cpsr &= ~0x20;
1661 arm7_9->write_xpsr_im8(target, tmp_cpsr & 0xff, 0, 0);
1662 current_mode = armv4_5_number_to_mode(i);
1663 }
1664
1665 for (j = 0; j <= 14; j++)
1666 {
1667 reg = &ARMV4_5_CORE_REG_MODE(armv4_5->core_cache, armv4_5_number_to_mode(i), j);
1668 reg_arch_info = reg->arch_info;
1669
1670
1671 if (reg->dirty == 1)
1672 {
1673 regs[j] = buf_get_u32(reg->value, 0, 32);
1674 mask |= 1 << j;
1675 num_regs++;
1676 reg->dirty = 0;
1677 reg->valid = 1;
1678 LOG_DEBUG("writing register %i mode %s "
1679 "with value 0x%8.8" PRIx32, j,
1680 arm_mode_name(armv4_5->core_mode),
1681 regs[j]);
1682 }
1683 }
1684
1685 if (mask)
1686 {
1687 arm7_9->write_core_regs(target, mask, regs);
1688 }
1689
1690 reg = &ARMV4_5_CORE_REG_MODE(armv4_5->core_cache, armv4_5_number_to_mode(i), 16);
1691 reg_arch_info = reg->arch_info;
1692 if ((reg->dirty) && (reg_arch_info->mode != ARM_MODE_ANY))
1693 {
1694 LOG_DEBUG("writing SPSR of mode %i with value 0x%8.8" PRIx32 "", i, buf_get_u32(reg->value, 0, 32));
1695 arm7_9->write_xpsr(target, buf_get_u32(reg->value, 0, 32), 1);
1696 }
1697 }
1698 }
1699
1700 if (!armv4_5->cpsr->dirty && (armv4_5->core_mode != current_mode))
1701 {
1702 /* restore processor mode (mask T bit) */
1703 uint32_t tmp_cpsr;
1704
1705 tmp_cpsr = buf_get_u32(armv4_5->cpsr->value, 0, 8) & 0xE0;
1706 tmp_cpsr |= armv4_5_number_to_mode(i);
1707 tmp_cpsr &= ~0x20;
1708 LOG_DEBUG("writing lower 8 bit of cpsr with value 0x%2.2x", (unsigned)(tmp_cpsr));
1709 arm7_9->write_xpsr_im8(target, tmp_cpsr & 0xff, 0, 0);
1710 }
1711 else if (armv4_5->cpsr->dirty)
1712 {
1713 /* CPSR has been changed, full restore necessary (mask T bit) */
1714 LOG_DEBUG("writing cpsr with value 0x%8.8" PRIx32,
1715 buf_get_u32(armv4_5->cpsr->value, 0, 32));
1716 arm7_9->write_xpsr(target,
1717 buf_get_u32(armv4_5->cpsr->value, 0, 32)
1718 & ~0x20, 0);
1719 armv4_5->cpsr->dirty = 0;
1720 armv4_5->cpsr->valid = 1;
1721 }
1722
1723 /* restore PC */
1724 LOG_DEBUG("writing PC with value 0x%8.8" PRIx32,
1725 buf_get_u32(armv4_5->pc->value, 0, 32));
1726 arm7_9->write_pc(target, buf_get_u32(armv4_5->pc->value, 0, 32));
1727 armv4_5->pc->dirty = 0;
1728
1729 return ERROR_OK;
1730 }
1731
1732 /**
1733 * Restart the core of an ARM7/9 target. A RESTART command is sent to the
1734 * instruction register and the JTAG state is set to TAP_IDLE causing a core
1735 * restart.
1736 *
1737 * @param target Pointer to the ARM7/9 target to be restarted
1738 * @return Result of executing the JTAG queue
1739 */
1740 int arm7_9_restart_core(struct target *target)
1741 {
1742 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
1743 struct arm_jtag *jtag_info = &arm7_9->jtag_info;
1744
1745 /* set RESTART instruction */
1746 jtag_set_end_state(TAP_IDLE);
1747 if (arm7_9->need_bypass_before_restart) {
1748 arm7_9->need_bypass_before_restart = 0;
1749 arm_jtag_set_instr(jtag_info, 0xf, NULL, TAP_IDLE);
1750 }
1751 arm_jtag_set_instr(jtag_info, 0x4, NULL, TAP_IDLE);
1752
1753 jtag_add_runtest(1, TAP_IDLE);
1754 return jtag_execute_queue();
1755 }
1756
1757 /**
1758 * Enable the watchpoints on an ARM7/9 target. The target's watchpoints are
1759 * iterated through and are set on the target if they aren't already set.
1760 *
1761 * @param target Pointer to the ARM7/9 target to enable watchpoints on
1762 */
1763 void arm7_9_enable_watchpoints(struct target *target)
1764 {
1765 struct watchpoint *watchpoint = target->watchpoints;
1766
1767 while (watchpoint)
1768 {
1769 if (watchpoint->set == 0)
1770 arm7_9_set_watchpoint(target, watchpoint);
1771 watchpoint = watchpoint->next;
1772 }
1773 }
1774
1775 /**
1776 * Enable the breakpoints on an ARM7/9 target. The target's breakpoints are
1777 * iterated through and are set on the target.
1778 *
1779 * @param target Pointer to the ARM7/9 target to enable breakpoints on
1780 */
1781 void arm7_9_enable_breakpoints(struct target *target)
1782 {
1783 struct breakpoint *breakpoint = target->breakpoints;
1784
1785 /* set any pending breakpoints */
1786 while (breakpoint)
1787 {
1788 arm7_9_set_breakpoint(target, breakpoint);
1789 breakpoint = breakpoint->next;
1790 }
1791 }
1792
1793 int arm7_9_resume(struct target *target, int current, uint32_t address, int handle_breakpoints, int debug_execution)
1794 {
1795 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
1796 struct arm *armv4_5 = &arm7_9->armv4_5_common;
1797 struct breakpoint *breakpoint = target->breakpoints;
1798 struct reg *dbg_ctrl = &arm7_9->eice_cache->reg_list[EICE_DBG_CTRL];
1799 int err, retval = ERROR_OK;
1800
1801 LOG_DEBUG("-");
1802
1803 if (target->state != TARGET_HALTED)
1804 {
1805 LOG_WARNING("target not halted");
1806 return ERROR_TARGET_NOT_HALTED;
1807 }
1808
1809 if (!debug_execution)
1810 {
1811 target_free_all_working_areas(target);
1812 }
1813
1814 /* current = 1: continue on current pc, otherwise continue at <address> */
1815 if (!current)
1816 buf_set_u32(armv4_5->pc->value, 0, 32, address);
1817
1818 uint32_t current_pc;
1819 current_pc = buf_get_u32(armv4_5->pc->value, 0, 32);
1820
1821 /* the front-end may request us not to handle breakpoints */
1822 if (handle_breakpoints)
1823 {
1824 breakpoint = breakpoint_find(target,
1825 buf_get_u32(armv4_5->pc->value, 0, 32));
1826 if (breakpoint != NULL)
1827 {
1828 LOG_DEBUG("unset breakpoint at 0x%8.8" PRIx32 " (id: %d)", breakpoint->address, breakpoint->unique_id );
1829 if ((retval = arm7_9_unset_breakpoint(target, breakpoint)) != ERROR_OK)
1830 {
1831 return retval;
1832 }
1833
1834 /* calculate PC of next instruction */
1835 uint32_t next_pc;
1836 if ((retval = arm_simulate_step(target, &next_pc)) != ERROR_OK)
1837 {
1838 uint32_t current_opcode;
1839 target_read_u32(target, current_pc, &current_opcode);
1840 LOG_ERROR("Couldn't calculate PC of next instruction, current opcode was 0x%8.8" PRIx32 "", current_opcode);
1841 return retval;
1842 }
1843
1844 LOG_DEBUG("enable single-step");
1845 arm7_9->enable_single_step(target, next_pc);
1846
1847 target->debug_reason = DBG_REASON_SINGLESTEP;
1848
1849 if ((retval = arm7_9_restore_context(target)) != ERROR_OK)
1850 {
1851 return retval;
1852 }
1853
1854 if (armv4_5->core_state == ARM_STATE_ARM)
1855 arm7_9->branch_resume(target);
1856 else if (armv4_5->core_state == ARM_STATE_THUMB)
1857 {
1858 arm7_9->branch_resume_thumb(target);
1859 }
1860 else
1861 {
1862 LOG_ERROR("unhandled core state");
1863 return ERROR_FAIL;
1864 }
1865
1866 buf_set_u32(dbg_ctrl->value, EICE_DBG_CONTROL_DBGACK, 1, 0);
1867 embeddedice_write_reg(dbg_ctrl, buf_get_u32(dbg_ctrl->value, 0, dbg_ctrl->size));
1868 err = arm7_9_execute_sys_speed(target);
1869
1870 LOG_DEBUG("disable single-step");
1871 arm7_9->disable_single_step(target);
1872
1873 if (err != ERROR_OK)
1874 {
1875 if ((retval = arm7_9_set_breakpoint(target, breakpoint)) != ERROR_OK)
1876 {
1877 return retval;
1878 }
1879 target->state = TARGET_UNKNOWN;
1880 return err;
1881 }
1882
1883 arm7_9_debug_entry(target);
1884 LOG_DEBUG("new PC after step: 0x%8.8" PRIx32,
1885 buf_get_u32(armv4_5->pc->value, 0, 32));
1886
1887 LOG_DEBUG("set breakpoint at 0x%8.8" PRIx32 "", breakpoint->address);
1888 if ((retval = arm7_9_set_breakpoint(target, breakpoint)) != ERROR_OK)
1889 {
1890 return retval;
1891 }
1892 }
1893 }
1894
1895 /* enable any pending breakpoints and watchpoints */
1896 arm7_9_enable_breakpoints(target);
1897 arm7_9_enable_watchpoints(target);
1898
1899 if ((retval = arm7_9_restore_context(target)) != ERROR_OK)
1900 {
1901 return retval;
1902 }
1903
1904 if (armv4_5->core_state == ARM_STATE_ARM)
1905 {
1906 arm7_9->branch_resume(target);
1907 }
1908 else if (armv4_5->core_state == ARM_STATE_THUMB)
1909 {
1910 arm7_9->branch_resume_thumb(target);
1911 }
1912 else
1913 {
1914 LOG_ERROR("unhandled core state");
1915 return ERROR_FAIL;
1916 }
1917
1918 /* deassert DBGACK and INTDIS */
1919 buf_set_u32(dbg_ctrl->value, EICE_DBG_CONTROL_DBGACK, 1, 0);
1920 /* INTDIS only when we really resume, not during debug execution */
1921 if (!debug_execution)
1922 buf_set_u32(dbg_ctrl->value, EICE_DBG_CONTROL_INTDIS, 1, 0);
1923 embeddedice_write_reg(dbg_ctrl, buf_get_u32(dbg_ctrl->value, 0, dbg_ctrl->size));
1924
1925 if ((retval = arm7_9_restart_core(target)) != ERROR_OK)
1926 {
1927 return retval;
1928 }
1929
1930 target->debug_reason = DBG_REASON_NOTHALTED;
1931
1932 if (!debug_execution)
1933 {
1934 /* registers are now invalid */
1935 register_cache_invalidate(armv4_5->core_cache);
1936 target->state = TARGET_RUNNING;
1937 if ((retval = target_call_event_callbacks(target, TARGET_EVENT_RESUMED)) != ERROR_OK)
1938 {
1939 return retval;
1940 }
1941 }
1942 else
1943 {
1944 target->state = TARGET_DEBUG_RUNNING;
1945 if ((retval = target_call_event_callbacks(target, TARGET_EVENT_DEBUG_RESUMED)) != ERROR_OK)
1946 {
1947 return retval;
1948 }
1949 }
1950
1951 LOG_DEBUG("target resumed");
1952
1953 return ERROR_OK;
1954 }
1955
1956 void arm7_9_enable_eice_step(struct target *target, uint32_t next_pc)
1957 {
1958 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
1959 struct arm *armv4_5 = &arm7_9->armv4_5_common;
1960 uint32_t current_pc;
1961 current_pc = buf_get_u32(armv4_5->pc->value, 0, 32);
1962
1963 if (next_pc != current_pc)
1964 {
1965 /* setup an inverse breakpoint on the current PC
1966 * - comparator 1 matches the current address
1967 * - rangeout from comparator 1 is connected to comparator 0 rangein
1968 * - comparator 0 matches any address, as long as rangein is low */
1969 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W0_ADDR_MASK], 0xffffffff);
1970 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W0_DATA_MASK], 0xffffffff);
1971 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_VALUE], EICE_W_CTRL_ENABLE);
1972 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_MASK], ~(EICE_W_CTRL_RANGE | EICE_W_CTRL_nOPC) & 0xff);
1973 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W1_ADDR_VALUE], current_pc);
1974 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W1_ADDR_MASK], 0);
1975 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W1_DATA_MASK], 0xffffffff);
1976 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_VALUE], 0x0);
1977 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_MASK], ~EICE_W_CTRL_nOPC & 0xff);
1978 }
1979 else
1980 {
1981 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W0_ADDR_MASK], 0xffffffff);
1982 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W0_DATA_MASK], 0xffffffff);
1983 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_VALUE], 0x0);
1984 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_MASK], 0xff);
1985 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W1_ADDR_VALUE], next_pc);
1986 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W1_ADDR_MASK], 0);
1987 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W1_DATA_MASK], 0xffffffff);
1988 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_VALUE], EICE_W_CTRL_ENABLE);
1989 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_MASK], ~EICE_W_CTRL_nOPC & 0xff);
1990 }
1991 }
1992
1993 void arm7_9_disable_eice_step(struct target *target)
1994 {
1995 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
1996
1997 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_W0_ADDR_MASK]);
1998 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_W0_DATA_MASK]);
1999 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_VALUE]);
2000 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_W0_CONTROL_MASK]);
2001 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_W1_ADDR_VALUE]);
2002 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_W1_ADDR_MASK]);
2003 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_W1_DATA_MASK]);
2004 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_MASK]);
2005 embeddedice_store_reg(&arm7_9->eice_cache->reg_list[EICE_W1_CONTROL_VALUE]);
2006 }
2007
2008 int arm7_9_step(struct target *target, int current, uint32_t address, int handle_breakpoints)
2009 {
2010 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
2011 struct arm *armv4_5 = &arm7_9->armv4_5_common;
2012 struct breakpoint *breakpoint = NULL;
2013 int err, retval;
2014
2015 if (target->state != TARGET_HALTED)
2016 {
2017 LOG_WARNING("target not halted");
2018 return ERROR_TARGET_NOT_HALTED;
2019 }
2020
2021 /* current = 1: continue on current pc, otherwise continue at <address> */
2022 if (!current)
2023 buf_set_u32(armv4_5->pc->value, 0, 32, address);
2024
2025 uint32_t current_pc = buf_get_u32(armv4_5->pc->value, 0, 32);
2026
2027 /* the front-end may request us not to handle breakpoints */
2028 if (handle_breakpoints)
2029 breakpoint = breakpoint_find(target, current_pc);
2030 if (breakpoint != NULL) {
2031 retval = arm7_9_unset_breakpoint(target, breakpoint);
2032 if (retval != ERROR_OK)
2033 return retval;
2034 }
2035
2036 target->debug_reason = DBG_REASON_SINGLESTEP;
2037
2038 /* calculate PC of next instruction */
2039 uint32_t next_pc;
2040 if ((retval = arm_simulate_step(target, &next_pc)) != ERROR_OK)
2041 {
2042 uint32_t current_opcode;
2043 target_read_u32(target, current_pc, &current_opcode);
2044 LOG_ERROR("Couldn't calculate PC of next instruction, current opcode was 0x%8.8" PRIx32 "", current_opcode);
2045 return retval;
2046 }
2047
2048 if ((retval = arm7_9_restore_context(target)) != ERROR_OK)
2049 {
2050 return retval;
2051 }
2052
2053 arm7_9->enable_single_step(target, next_pc);
2054
2055 if (armv4_5->core_state == ARM_STATE_ARM)
2056 {
2057 arm7_9->branch_resume(target);
2058 }
2059 else if (armv4_5->core_state == ARM_STATE_THUMB)
2060 {
2061 arm7_9->branch_resume_thumb(target);
2062 }
2063 else
2064 {
2065 LOG_ERROR("unhandled core state");
2066 return ERROR_FAIL;
2067 }
2068
2069 if ((retval = target_call_event_callbacks(target, TARGET_EVENT_RESUMED)) != ERROR_OK)
2070 {
2071 return retval;
2072 }
2073
2074 err = arm7_9_execute_sys_speed(target);
2075 arm7_9->disable_single_step(target);
2076
2077 /* registers are now invalid */
2078 register_cache_invalidate(armv4_5->core_cache);
2079
2080 if (err != ERROR_OK)
2081 {
2082 target->state = TARGET_UNKNOWN;
2083 } else {
2084 arm7_9_debug_entry(target);
2085 if ((retval = target_call_event_callbacks(target, TARGET_EVENT_HALTED)) != ERROR_OK)
2086 {
2087 return retval;
2088 }
2089 LOG_DEBUG("target stepped");
2090 }
2091
2092 if (breakpoint)
2093 if ((retval = arm7_9_set_breakpoint(target, breakpoint)) != ERROR_OK)
2094 {
2095 return retval;
2096 }
2097
2098 return err;
2099 }
2100
2101 static int arm7_9_read_core_reg(struct target *target, struct reg *r,
2102 int num, enum arm_mode mode)
2103 {
2104 uint32_t* reg_p[16];
2105 uint32_t value;
2106 int retval;
2107 struct arm_reg *areg = r->arch_info;
2108 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
2109 struct arm *armv4_5 = &arm7_9->armv4_5_common;
2110
2111 if (!is_arm_mode(armv4_5->core_mode))
2112 return ERROR_FAIL;
2113 if ((num < 0) || (num > 16))
2114 return ERROR_INVALID_ARGUMENTS;
2115
2116 if ((mode != ARM_MODE_ANY)
2117 && (mode != armv4_5->core_mode)
2118 && (areg->mode != ARM_MODE_ANY))
2119 {
2120 uint32_t tmp_cpsr;
2121
2122 /* change processor mode (mask T bit) */
2123 tmp_cpsr = buf_get_u32(armv4_5->cpsr->value, 0, 8) & 0xE0;
2124 tmp_cpsr |= mode;
2125 tmp_cpsr &= ~0x20;
2126 arm7_9->write_xpsr_im8(target, tmp_cpsr & 0xff, 0, 0);
2127 }
2128
2129 if ((num >= 0) && (num <= 15))
2130 {
2131 /* read a normal core register */
2132 reg_p[num] = &value;
2133
2134 arm7_9->read_core_regs(target, 1 << num, reg_p);
2135 }
2136 else
2137 {
2138 /* read a program status register
2139 * if the register mode is MODE_ANY, we read the cpsr, otherwise a spsr
2140 */
2141 arm7_9->read_xpsr(target, &value, areg->mode != ARM_MODE_ANY);
2142 }
2143
2144 if ((retval = jtag_execute_queue()) != ERROR_OK)
2145 {
2146 return retval;
2147 }
2148
2149 r->valid = 1;
2150 r->dirty = 0;
2151 buf_set_u32(r->value, 0, 32, value);
2152
2153 if ((mode != ARM_MODE_ANY)
2154 && (mode != armv4_5->core_mode)
2155 && (areg->mode != ARM_MODE_ANY)) {
2156 /* restore processor mode (mask T bit) */
2157 arm7_9->write_xpsr_im8(target,
2158 buf_get_u32(armv4_5->cpsr->value, 0, 8)
2159 & ~0x20, 0, 0);
2160 }
2161
2162 return ERROR_OK;
2163 }
2164
2165 static int arm7_9_write_core_reg(struct target *target, struct reg *r,
2166 int num, enum arm_mode mode, uint32_t value)
2167 {
2168 uint32_t reg[16];
2169 struct arm_reg *areg = r->arch_info;
2170 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
2171 struct arm *armv4_5 = &arm7_9->armv4_5_common;
2172
2173 if (!is_arm_mode(armv4_5->core_mode))
2174 return ERROR_FAIL;
2175 if ((num < 0) || (num > 16))
2176 return ERROR_INVALID_ARGUMENTS;
2177
2178 if ((mode != ARM_MODE_ANY)
2179 && (mode != armv4_5->core_mode)
2180 && (areg->mode != ARM_MODE_ANY)) {
2181 uint32_t tmp_cpsr;
2182
2183 /* change processor mode (mask T bit) */
2184 tmp_cpsr = buf_get_u32(armv4_5->cpsr->value, 0, 8) & 0xE0;
2185 tmp_cpsr |= mode;
2186 tmp_cpsr &= ~0x20;
2187 arm7_9->write_xpsr_im8(target, tmp_cpsr & 0xff, 0, 0);
2188 }
2189
2190 if ((num >= 0) && (num <= 15))
2191 {
2192 /* write a normal core register */
2193 reg[num] = value;
2194
2195 arm7_9->write_core_regs(target, 1 << num, reg);
2196 }
2197 else
2198 {
2199 /* write a program status register
2200 * if the register mode is MODE_ANY, we write the cpsr, otherwise a spsr
2201 */
2202 int spsr = (areg->mode != ARM_MODE_ANY);
2203
2204 /* if we're writing the CPSR, mask the T bit */
2205 if (!spsr)
2206 value &= ~0x20;
2207
2208 arm7_9->write_xpsr(target, value, spsr);
2209 }
2210
2211 r->valid = 1;
2212 r->dirty = 0;
2213
2214 if ((mode != ARM_MODE_ANY)
2215 && (mode != armv4_5->core_mode)
2216 && (areg->mode != ARM_MODE_ANY)) {
2217 /* restore processor mode (mask T bit) */
2218 arm7_9->write_xpsr_im8(target,
2219 buf_get_u32(armv4_5->cpsr->value, 0, 8)
2220 & ~0x20, 0, 0);
2221 }
2222
2223 return jtag_execute_queue();
2224 }
2225
2226 int arm7_9_read_memory(struct target *target, uint32_t address, uint32_t size, uint32_t count, uint8_t *buffer)
2227 {
2228 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
2229 struct arm *armv4_5 = &arm7_9->armv4_5_common;
2230 uint32_t reg[16];
2231 uint32_t num_accesses = 0;
2232 int thisrun_accesses;
2233 int i;
2234 uint32_t cpsr;
2235 int retval;
2236 int last_reg = 0;
2237
2238 LOG_DEBUG("address: 0x%8.8" PRIx32 ", size: 0x%8.8" PRIx32 ", count: 0x%8.8" PRIx32 "", address, size, count);
2239
2240 if (target->state != TARGET_HALTED)
2241 {
2242 LOG_WARNING("target not halted");
2243 return ERROR_TARGET_NOT_HALTED;
2244 }
2245
2246 /* sanitize arguments */
2247 if (((size != 4) && (size != 2) && (size != 1)) || (count == 0) || !(buffer))
2248 return ERROR_INVALID_ARGUMENTS;
2249
2250 if (((size == 4) && (address & 0x3u)) || ((size == 2) && (address & 0x1u)))
2251 return ERROR_TARGET_UNALIGNED_ACCESS;
2252
2253 /* load the base register with the address of the first word */
2254 reg[0] = address;
2255 arm7_9->write_core_regs(target, 0x1, reg);
2256
2257 int j = 0;
2258
2259 switch (size)
2260 {
2261 case 4:
2262 while (num_accesses < count)
2263 {
2264 uint32_t reg_list;
2265 thisrun_accesses = ((count - num_accesses) >= 14) ? 14 : (count - num_accesses);
2266 reg_list = (0xffff >> (15 - thisrun_accesses)) & 0xfffe;
2267
2268 if (last_reg <= thisrun_accesses)
2269 last_reg = thisrun_accesses;
2270
2271 arm7_9->load_word_regs(target, reg_list);
2272
2273 /* fast memory reads are only safe when the target is running
2274 * from a sufficiently high clock (32 kHz is usually too slow)
2275 */
2276 if (arm7_9->fast_memory_access)
2277 retval = arm7_9_execute_fast_sys_speed(target);
2278 else
2279 retval = arm7_9_execute_sys_speed(target);
2280 if (retval != ERROR_OK)
2281 return retval;
2282
2283 arm7_9->read_core_regs_target_buffer(target, reg_list, buffer, 4);
2284
2285 /* advance buffer, count number of accesses */
2286 buffer += thisrun_accesses * 4;
2287 num_accesses += thisrun_accesses;
2288
2289 if ((j++%1024) == 0)
2290 {
2291 keep_alive();
2292 }
2293 }
2294 break;
2295 case 2:
2296 while (num_accesses < count)
2297 {
2298 uint32_t reg_list;
2299 thisrun_accesses = ((count - num_accesses) >= 14) ? 14 : (count - num_accesses);
2300 reg_list = (0xffff >> (15 - thisrun_accesses)) & 0xfffe;
2301
2302 for (i = 1; i <= thisrun_accesses; i++)
2303 {
2304 if (i > last_reg)
2305 last_reg = i;
2306 arm7_9->load_hword_reg(target, i);
2307 /* fast memory reads are only safe when the target is running
2308 * from a sufficiently high clock (32 kHz is usually too slow)
2309 */
2310 if (arm7_9->fast_memory_access)
2311 retval = arm7_9_execute_fast_sys_speed(target);
2312 else
2313 retval = arm7_9_execute_sys_speed(target);
2314 if (retval != ERROR_OK)
2315 {
2316 return retval;
2317 }
2318
2319 }
2320
2321 arm7_9->read_core_regs_target_buffer(target, reg_list, buffer, 2);
2322
2323 /* advance buffer, count number of accesses */
2324 buffer += thisrun_accesses * 2;
2325 num_accesses += thisrun_accesses;
2326
2327 if ((j++%1024) == 0)
2328 {
2329 keep_alive();
2330 }
2331 }
2332 break;
2333 case 1:
2334 while (num_accesses < count)
2335 {
2336 uint32_t reg_list;
2337 thisrun_accesses = ((count - num_accesses) >= 14) ? 14 : (count - num_accesses);
2338 reg_list = (0xffff >> (15 - thisrun_accesses)) & 0xfffe;
2339
2340 for (i = 1; i <= thisrun_accesses; i++)
2341 {
2342 if (i > last_reg)
2343 last_reg = i;
2344 arm7_9->load_byte_reg(target, i);
2345 /* fast memory reads are only safe when the target is running
2346 * from a sufficiently high clock (32 kHz is usually too slow)
2347 */
2348 if (arm7_9->fast_memory_access)
2349 retval = arm7_9_execute_fast_sys_speed(target);
2350 else
2351 retval = arm7_9_execute_sys_speed(target);
2352 if (retval != ERROR_OK)
2353 {
2354 return retval;
2355 }
2356 }
2357
2358 arm7_9->read_core_regs_target_buffer(target, reg_list, buffer, 1);
2359
2360 /* advance buffer, count number of accesses */
2361 buffer += thisrun_accesses * 1;
2362 num_accesses += thisrun_accesses;
2363
2364 if ((j++%1024) == 0)
2365 {
2366 keep_alive();
2367 }
2368 }
2369 break;
2370 }
2371
2372 if (!is_arm_mode(armv4_5->core_mode))
2373 return ERROR_FAIL;
2374
2375 for (i = 0; i <= last_reg; i++) {
2376 struct reg *r = arm_reg_current(armv4_5, i);
2377
2378 r->dirty = r->valid;
2379 }
2380
2381 arm7_9->read_xpsr(target, &cpsr, 0);
2382 if ((retval = jtag_execute_queue()) != ERROR_OK)
2383 {
2384 LOG_ERROR("JTAG error while reading cpsr");
2385 return ERROR_TARGET_DATA_ABORT;
2386 }
2387
2388 if (((cpsr & 0x1f) == ARM_MODE_ABT) && (armv4_5->core_mode != ARM_MODE_ABT))
2389 {
2390 LOG_WARNING("memory read caused data abort (address: 0x%8.8" PRIx32 ", size: 0x%" PRIx32 ", count: 0x%" PRIx32 ")", address, size, count);
2391
2392 arm7_9->write_xpsr_im8(target,
2393 buf_get_u32(armv4_5->cpsr->value, 0, 8)
2394 & ~0x20, 0, 0);
2395
2396 return ERROR_TARGET_DATA_ABORT;
2397 }
2398
2399 return ERROR_OK;
2400 }
2401
2402 int arm7_9_write_memory(struct target *target, uint32_t address, uint32_t size, uint32_t count, uint8_t *buffer)
2403 {
2404 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
2405 struct arm *armv4_5 = &arm7_9->armv4_5_common;
2406 struct reg *dbg_ctrl = &arm7_9->eice_cache->reg_list[EICE_DBG_CTRL];
2407
2408 uint32_t reg[16];
2409 uint32_t num_accesses = 0;
2410 int thisrun_accesses;
2411 int i;
2412 uint32_t cpsr;
2413 int retval;
2414 int last_reg = 0;
2415
2416 #ifdef _DEBUG_ARM7_9_
2417 LOG_DEBUG("address: 0x%8.8x, size: 0x%8.8x, count: 0x%8.8x", address, size, count);
2418 #endif
2419
2420 if (target->state != TARGET_HALTED)
2421 {
2422 LOG_WARNING("target not halted");
2423 return ERROR_TARGET_NOT_HALTED;
2424 }
2425
2426 /* sanitize arguments */
2427 if (((size != 4) && (size != 2) && (size != 1)) || (count == 0) || !(buffer))
2428 return ERROR_INVALID_ARGUMENTS;
2429
2430 if (((size == 4) && (address & 0x3u)) || ((size == 2) && (address & 0x1u)))
2431 return ERROR_TARGET_UNALIGNED_ACCESS;
2432
2433 /* load the base register with the address of the first word */
2434 reg[0] = address;
2435 arm7_9->write_core_regs(target, 0x1, reg);
2436
2437 /* Clear DBGACK, to make sure memory fetches work as expected */
2438 buf_set_u32(dbg_ctrl->value, EICE_DBG_CONTROL_DBGACK, 1, 0);
2439 embeddedice_store_reg(dbg_ctrl);
2440
2441 switch (size)
2442 {
2443 case 4:
2444 while (num_accesses < count)
2445 {
2446 uint32_t reg_list;
2447 thisrun_accesses = ((count - num_accesses) >= 14) ? 14 : (count - num_accesses);
2448 reg_list = (0xffff >> (15 - thisrun_accesses)) & 0xfffe;
2449
2450 for (i = 1; i <= thisrun_accesses; i++)
2451 {
2452 if (i > last_reg)
2453 last_reg = i;
2454 reg[i] = target_buffer_get_u32(target, buffer);
2455 buffer += 4;
2456 }
2457
2458 arm7_9->write_core_regs(target, reg_list, reg);
2459
2460 arm7_9->store_word_regs(target, reg_list);
2461
2462 /* fast memory writes are only safe when the target is running
2463 * from a sufficiently high clock (32 kHz is usually too slow)
2464 */
2465 if (arm7_9->fast_memory_access)
2466 retval = arm7_9_execute_fast_sys_speed(target);
2467 else
2468 retval = arm7_9_execute_sys_speed(target);
2469 if (retval != ERROR_OK)
2470 {
2471 return retval;
2472 }
2473
2474 num_accesses += thisrun_accesses;
2475 }
2476 break;
2477 case 2:
2478 while (num_accesses < count)
2479 {
2480 uint32_t reg_list;
2481 thisrun_accesses = ((count - num_accesses) >= 14) ? 14 : (count - num_accesses);
2482 reg_list = (0xffff >> (15 - thisrun_accesses)) & 0xfffe;
2483
2484 for (i = 1; i <= thisrun_accesses; i++)
2485 {
2486 if (i > last_reg)
2487 last_reg = i;
2488 reg[i] = target_buffer_get_u16(target, buffer) & 0xffff;
2489 buffer += 2;
2490 }
2491
2492 arm7_9->write_core_regs(target, reg_list, reg);
2493
2494 for (i = 1; i <= thisrun_accesses; i++)
2495 {
2496 arm7_9->store_hword_reg(target, i);
2497
2498 /* fast memory writes are only safe when the target is running
2499 * from a sufficiently high clock (32 kHz is usually too slow)
2500 */
2501 if (arm7_9->fast_memory_access)
2502 retval = arm7_9_execute_fast_sys_speed(target);
2503 else
2504 retval = arm7_9_execute_sys_speed(target);
2505 if (retval != ERROR_OK)
2506 {
2507 return retval;
2508 }
2509 }
2510
2511 num_accesses += thisrun_accesses;
2512 }
2513 break;
2514 case 1:
2515 while (num_accesses < count)
2516 {
2517 uint32_t reg_list;
2518 thisrun_accesses = ((count - num_accesses) >= 14) ? 14 : (count - num_accesses);
2519 reg_list = (0xffff >> (15 - thisrun_accesses)) & 0xfffe;
2520
2521 for (i = 1; i <= thisrun_accesses; i++)
2522 {
2523 if (i > last_reg)
2524 last_reg = i;
2525 reg[i] = *buffer++ & 0xff;
2526 }
2527
2528 arm7_9->write_core_regs(target, reg_list, reg);
2529
2530 for (i = 1; i <= thisrun_accesses; i++)
2531 {
2532 arm7_9->store_byte_reg(target, i);
2533 /* fast memory writes are only safe when the target is running
2534 * from a sufficiently high clock (32 kHz is usually too slow)
2535 */
2536 if (arm7_9->fast_memory_access)
2537 retval = arm7_9_execute_fast_sys_speed(target);
2538 else
2539 retval = arm7_9_execute_sys_speed(target);
2540 if (retval != ERROR_OK)
2541 {
2542 return retval;
2543 }
2544
2545 }
2546
2547 num_accesses += thisrun_accesses;
2548 }
2549 break;
2550 }
2551
2552 /* Re-Set DBGACK */
2553 buf_set_u32(dbg_ctrl->value, EICE_DBG_CONTROL_DBGACK, 1, 1);
2554 embeddedice_store_reg(dbg_ctrl);
2555
2556 if (!is_arm_mode(armv4_5->core_mode))
2557 return ERROR_FAIL;
2558
2559 for (i = 0; i <= last_reg; i++) {
2560 struct reg *r = arm_reg_current(armv4_5, i);
2561
2562 r->dirty = r->valid;
2563 }
2564
2565 arm7_9->read_xpsr(target, &cpsr, 0);
2566 if ((retval = jtag_execute_queue()) != ERROR_OK)
2567 {
2568 LOG_ERROR("JTAG error while reading cpsr");
2569 return ERROR_TARGET_DATA_ABORT;
2570 }
2571
2572 if (((cpsr & 0x1f) == ARM_MODE_ABT) && (armv4_5->core_mode != ARM_MODE_ABT))
2573 {
2574 LOG_WARNING("memory write caused data abort (address: 0x%8.8" PRIx32 ", size: 0x%" PRIx32 ", count: 0x%" PRIx32 ")", address, size, count);
2575
2576 arm7_9->write_xpsr_im8(target,
2577 buf_get_u32(armv4_5->cpsr->value, 0, 8)
2578 & ~0x20, 0, 0);
2579
2580 return ERROR_TARGET_DATA_ABORT;
2581 }
2582
2583 return ERROR_OK;
2584 }
2585
2586 static int dcc_count;
2587 static uint8_t *dcc_buffer;
2588
2589 static int arm7_9_dcc_completion(struct target *target, uint32_t exit_point, int timeout_ms, void *arch_info)
2590 {
2591 int retval = ERROR_OK;
2592 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
2593
2594 if ((retval = target_wait_state(target, TARGET_DEBUG_RUNNING, 500)) != ERROR_OK)
2595 return retval;
2596
2597 int little = target->endianness == TARGET_LITTLE_ENDIAN;
2598 int count = dcc_count;
2599 uint8_t *buffer = dcc_buffer;
2600 if (count > 2)
2601 {
2602 /* Handle first & last using standard embeddedice_write_reg and the middle ones w/the
2603 * core function repeated. */
2604 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_COMMS_DATA], fast_target_buffer_get_u32(buffer, little));
2605 buffer += 4;
2606
2607 struct embeddedice_reg *ice_reg = arm7_9->eice_cache->reg_list[EICE_COMMS_DATA].arch_info;
2608 uint8_t reg_addr = ice_reg->addr & 0x1f;
2609 struct jtag_tap *tap;
2610 tap = ice_reg->jtag_info->tap;
2611
2612 embeddedice_write_dcc(tap, reg_addr, buffer, little, count-2);
2613 buffer += (count-2)*4;
2614
2615 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_COMMS_DATA], fast_target_buffer_get_u32(buffer, little));
2616 } else
2617 {
2618 int i;
2619 for (i = 0; i < count; i++)
2620 {
2621 embeddedice_write_reg(&arm7_9->eice_cache->reg_list[EICE_COMMS_DATA], fast_target_buffer_get_u32(buffer, little));
2622 buffer += 4;
2623 }
2624 }
2625
2626 if ((retval = target_halt(target))!= ERROR_OK)
2627 {
2628 return retval;
2629 }
2630 return target_wait_state(target, TARGET_HALTED, 500);
2631 }
2632
2633 static const uint32_t dcc_code[] =
2634 {
2635 /* r0 == input, points to memory buffer
2636 * r1 == scratch
2637 */
2638
2639 /* spin until DCC control (c0) reports data arrived */
2640 0xee101e10, /* w: mrc p14, #0, r1, c0, c0 */
2641 0xe3110001, /* tst r1, #1 */
2642 0x0afffffc, /* bne w */
2643
2644 /* read word from DCC (c1), write to memory */
2645 0xee111e10, /* mrc p14, #0, r1, c1, c0 */
2646 0xe4801004, /* str r1, [r0], #4 */
2647
2648 /* repeat */
2649 0xeafffff9 /* b w */
2650 };
2651
2652 int arm7_9_bulk_write_memory(struct target *target, uint32_t address, uint32_t count, uint8_t *buffer)
2653 {
2654 int retval;
2655 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
2656 int i;
2657
2658 if (!arm7_9->dcc_downloads)
2659 return target_write_memory(target, address, 4, count, buffer);
2660
2661 /* regrab previously allocated working_area, or allocate a new one */
2662 if (!arm7_9->dcc_working_area)
2663 {
2664 uint8_t dcc_code_buf[6 * 4];
2665
2666 /* make sure we have a working area */
2667 if (target_alloc_working_area(target, 24, &arm7_9->dcc_working_area) != ERROR_OK)
2668 {
2669 LOG_INFO("no working area available, falling back to memory writes");
2670 return target_write_memory(target, address, 4, count, buffer);
2671 }
2672
2673 /* copy target instructions to target endianness */
2674 for (i = 0; i < 6; i++)
2675 {
2676 target_buffer_set_u32(target, dcc_code_buf + i*4, dcc_code[i]);
2677 }
2678
2679 /* write DCC code to working area */
2680 if ((retval = target_write_memory(target, arm7_9->dcc_working_area->address, 4, 6, dcc_code_buf)) != ERROR_OK)
2681 {
2682 return retval;
2683 }
2684 }
2685
2686 struct arm_algorithm armv4_5_info;
2687 struct reg_param reg_params[1];
2688
2689 armv4_5_info.common_magic = ARM_COMMON_MAGIC;
2690 armv4_5_info.core_mode = ARM_MODE_SVC;
2691 armv4_5_info.core_state = ARM_STATE_ARM;
2692
2693 init_reg_param(&reg_params[0], "r0", 32, PARAM_IN_OUT);
2694
2695 buf_set_u32(reg_params[0].value, 0, 32, address);
2696
2697 dcc_count = count;
2698 dcc_buffer = buffer;
2699 retval = armv4_5_run_algorithm_inner(target, 0, NULL, 1, reg_params,
2700 arm7_9->dcc_working_area->address,
2701 arm7_9->dcc_working_area->address + 6*4,
2702 20*1000, &armv4_5_info, arm7_9_dcc_completion);
2703
2704 if (retval == ERROR_OK)
2705 {
2706 uint32_t endaddress = buf_get_u32(reg_params[0].value, 0, 32);
2707 if (endaddress != (address + count*4))
2708 {
2709 LOG_ERROR("DCC write failed, expected end address 0x%08" PRIx32 " got 0x%0" PRIx32 "", (address + count*4), endaddress);
2710 retval = ERROR_FAIL;
2711 }
2712 }
2713
2714 destroy_reg_param(&reg_params[0]);
2715
2716 return retval;
2717 }
2718
2719 /**
2720 * Perform per-target setup that requires JTAG access.
2721 */
2722 int arm7_9_examine(struct target *target)
2723 {
2724 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
2725 int retval;
2726
2727 if (!target_was_examined(target)) {
2728 struct reg_cache *t, **cache_p;
2729
2730 t = embeddedice_build_reg_cache(target, arm7_9);
2731 if (t == NULL)
2732 return ERROR_FAIL;
2733
2734 cache_p = register_get_last_cache_p(&target->reg_cache);
2735 (*cache_p) = t;
2736 arm7_9->eice_cache = (*cache_p);
2737
2738 if (arm7_9->armv4_5_common.etm)
2739 (*cache_p)->next = etm_build_reg_cache(target,
2740 &arm7_9->jtag_info,
2741 arm7_9->armv4_5_common.etm);
2742
2743 target_set_examined(target);
2744 }
2745
2746 retval = embeddedice_setup(target);
2747 if (retval == ERROR_OK)
2748 retval = arm7_9_setup(target);
2749 if (retval == ERROR_OK && arm7_9->armv4_5_common.etm)
2750 retval = etm_setup(target);
2751 return retval;
2752 }
2753
2754
2755 int arm7_9_check_reset(struct target *target)
2756 {
2757 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
2758
2759 if (get_target_reset_nag() && !arm7_9->dcc_downloads)
2760 {
2761 LOG_WARNING("NOTE! DCC downloads have not been enabled, defaulting to slow memory writes. Type 'help dcc'.");
2762 }
2763
2764 if (get_target_reset_nag() && (target->working_area_size == 0))
2765 {
2766 LOG_WARNING("NOTE! Severe performance degradation without working memory enabled.");
2767 }
2768
2769 if (get_target_reset_nag() && !arm7_9->fast_memory_access)
2770 {
2771 LOG_WARNING("NOTE! Severe performance degradation without fast memory access enabled. Type 'help fast'.");
2772 }
2773
2774 return ERROR_OK;
2775 }
2776
2777 COMMAND_HANDLER(handle_arm7_9_dbgrq_command)
2778 {
2779 struct target *target = get_current_target(CMD_CTX);
2780 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
2781
2782 if (!is_arm7_9(arm7_9))
2783 {
2784 command_print(CMD_CTX, "current target isn't an ARM7/ARM9 target");
2785 return ERROR_TARGET_INVALID;
2786 }
2787
2788 if (CMD_ARGC > 0)
2789 COMMAND_PARSE_ENABLE(CMD_ARGV[0],arm7_9->use_dbgrq);
2790
2791 command_print(CMD_CTX, "use of EmbeddedICE dbgrq instead of breakpoint for target halt %s", (arm7_9->use_dbgrq) ? "enabled" : "disabled");
2792
2793 return ERROR_OK;
2794 }
2795
2796 COMMAND_HANDLER(handle_arm7_9_fast_memory_access_command)
2797 {
2798 struct target *target = get_current_target(CMD_CTX);
2799 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
2800
2801 if (!is_arm7_9(arm7_9))
2802 {
2803 command_print(CMD_CTX, "current target isn't an ARM7/ARM9 target");
2804 return ERROR_TARGET_INVALID;
2805 }
2806
2807 if (CMD_ARGC > 0)
2808 COMMAND_PARSE_ENABLE(CMD_ARGV[0], arm7_9->fast_memory_access);
2809
2810 command_print(CMD_CTX, "fast memory access is %s", (arm7_9->fast_memory_access) ? "enabled" : "disabled");
2811
2812 return ERROR_OK;
2813 }
2814
2815 COMMAND_HANDLER(handle_arm7_9_dcc_downloads_command)
2816 {
2817 struct target *target = get_current_target(CMD_CTX);
2818 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
2819
2820 if (!is_arm7_9(arm7_9))
2821 {
2822 command_print(CMD_CTX, "current target isn't an ARM7/ARM9 target");
2823 return ERROR_TARGET_INVALID;
2824 }
2825
2826 if (CMD_ARGC > 0)
2827 COMMAND_PARSE_ENABLE(CMD_ARGV[0], arm7_9->dcc_downloads);
2828
2829 command_print(CMD_CTX, "dcc downloads are %s", (arm7_9->dcc_downloads) ? "enabled" : "disabled");
2830
2831 return ERROR_OK;
2832 }
2833
2834 int arm7_9_setup_semihosting(struct target *target, int enable)
2835 {
2836 struct arm7_9_common *arm7_9 = target_to_arm7_9(target);
2837
2838 if (!is_arm7_9(arm7_9))
2839 {
2840 LOG_USER("current target isn't an ARM7/ARM9 target");
2841 return ERROR_TARGET_INVALID;
2842 }
2843
2844 if (arm7_9->has_vector_catch) {
2845 struct reg *vector_catch = &arm7_9->eice_cache
2846 ->reg_list[EICE_VEC_CATCH];
2847
2848 if (!vector_catch->valid)
2849 embeddedice_read_reg(vector_catch);
2850 buf_set_u32(vector_catch->value, 2, 1, enable);
2851 embeddedice_store_reg(vector_catch);
2852 } else {
2853 /* TODO: allow optional high vectors and/or BKPT_HARD */
2854 if (enable)
2855 breakpoint_add(target, 8, 4, BKPT_SOFT);
2856 else
2857 breakpoint_remove(target, 8);
2858 }
2859
2860 return ERROR_OK;
2861 }
2862
2863 int arm7_9_init_arch_info(struct target *target, struct arm7_9_common *arm7_9)
2864 {
2865 int retval = ERROR_OK;
2866 struct arm *armv4_5 = &arm7_9->armv4_5_common;
2867
2868 arm7_9->common_magic = ARM7_9_COMMON_MAGIC;
2869
2870 if ((retval = arm_jtag_setup_connection(&arm7_9->jtag_info)) != ERROR_OK)
2871 return retval;
2872
2873 /* caller must have allocated via calloc(), so everything's zeroed */
2874
2875 arm7_9->wp_available_max = 2;
2876
2877 arm7_9->fast_memory_access = false;
2878 arm7_9->dcc_downloads = false;
2879
2880 armv4_5->arch_info = arm7_9;
2881 armv4_5->read_core_reg = arm7_9_read_core_reg;
2882 armv4_5->write_core_reg = arm7_9_write_core_reg;
2883 armv4_5->full_context = arm7_9_full_context;
2884 armv4_5->setup_semihosting = arm7_9_setup_semihosting;
2885
2886 retval = arm_init_arch_info(target, armv4_5);
2887 if (retval != ERROR_OK)
2888 return retval;
2889
2890 return target_register_timer_callback(arm7_9_handle_target_request,
2891 1, 1, target);
2892 }
2893
2894 static const struct command_registration arm7_9_any_command_handlers[] = {
2895 {
2896 "dbgrq",
2897 .handler = handle_arm7_9_dbgrq_command,
2898 .mode = COMMAND_ANY,
2899 .usage = "['enable'|'disable']",
2900 .help = "use EmbeddedICE dbgrq instead of breakpoint "
2901 "for target halt requests",
2902 },
2903 {
2904 "fast_memory_access",
2905 .handler = handle_arm7_9_fast_memory_access_command,
2906 .mode = COMMAND_ANY,
2907 .usage = "['enable'|'disable']",
2908 .help = "use fast memory accesses instead of slower "
2909 "but potentially safer accesses",
2910 },
2911 {
2912 "dcc_downloads",
2913 .handler = handle_arm7_9_dcc_downloads_command,
2914 .mode = COMMAND_ANY,
2915 .usage = "['enable'|'disable']",
2916 .help = "use DCC downloads for larger memory writes",
2917 },
2918 COMMAND_REGISTRATION_DONE
2919 };
2920 const struct command_registration arm7_9_command_handlers[] = {
2921 {
2922 .chain = arm_command_handlers,
2923 },
2924 {
2925 .chain = etm_command_handlers,
2926 },
2927 {
2928 .name = "arm7_9",
2929 .mode = COMMAND_ANY,
2930 .help = "arm7/9 specific commands",
2931 .chain = arm7_9_any_command_handlers,
2932 },
2933 COMMAND_REGISTRATION_DONE
2934 };
Marex's Cortex A8 development branch