ARMv7: help/usage updates
[openocd/ellerodev.git] / src / target / mips32.c
blob0f6f9b09a8befed9fc8edb8c65aaa8b0848cd054
1 /***************************************************************************
2 * Copyright (C) 2008 by Spencer Oliver *
3 * spen@spen-soft.co.uk *
4 * *
5 * Copyright (C) 2008 by David T.L. Wong *
6 * *
7 * Copyright (C) 2007,2008 Øyvind Harboe *
8 * oyvind.harboe@zylin.com *
9 * *
10 * This program is free software; you can redistribute it and/or modify *
11 * it under the terms of the GNU General Public License as published by *
12 * the Free Software Foundation; either version 2 of the License, or *
13 * (at your option) any later version. *
14 * *
15 * This program is distributed in the hope that it will be useful, *
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
18 * GNU General Public License for more details. *
19 * *
20 * You should have received a copy of the GNU General Public License *
21 * along with this program; if not, write to the *
22 * Free Software Foundation, Inc., *
23 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
24 ***************************************************************************/
25 #ifdef HAVE_CONFIG_H
26 #include "config.h"
27 #endif
29 #include "mips32.h"
30 #include "register.h"
32 char* mips32_core_reg_list[] =
34 "zero", "at", "v0", "v1", "a0", "a1", "a2", "a3",
35 "t0", "t1", "t2", "t3", "t4", "t5", "t6", "t7",
36 "s0", "s1", "s2", "s3", "s4", "s5", "s6", "s7",
37 "t8", "t9", "k0", "k1", "gp", "sp", "fp", "ra",
38 "status", "lo", "hi", "badvaddr", "cause", "pc"
41 struct mips32_core_reg mips32_core_reg_list_arch_info[MIPS32NUMCOREREGS] =
43 {0, NULL, NULL},
44 {1, NULL, NULL},
45 {2, NULL, NULL},
46 {3, NULL, NULL},
47 {4, NULL, NULL},
48 {5, NULL, NULL},
49 {6, NULL, NULL},
50 {7, NULL, NULL},
51 {8, NULL, NULL},
52 {9, NULL, NULL},
53 {10, NULL, NULL},
54 {11, NULL, NULL},
55 {12, NULL, NULL},
56 {13, NULL, NULL},
57 {14, NULL, NULL},
58 {15, NULL, NULL},
59 {16, NULL, NULL},
60 {17, NULL, NULL},
61 {18, NULL, NULL},
62 {19, NULL, NULL},
63 {20, NULL, NULL},
64 {21, NULL, NULL},
65 {22, NULL, NULL},
66 {23, NULL, NULL},
67 {24, NULL, NULL},
68 {25, NULL, NULL},
69 {26, NULL, NULL},
70 {27, NULL, NULL},
71 {28, NULL, NULL},
72 {29, NULL, NULL},
73 {30, NULL, NULL},
74 {31, NULL, NULL},
76 {32, NULL, NULL},
77 {33, NULL, NULL},
78 {34, NULL, NULL},
79 {35, NULL, NULL},
80 {36, NULL, NULL},
81 {37, NULL, NULL},
84 /* number of mips dummy fp regs fp0 - fp31 + fsr and fir
85 * we also add 18 unknown registers to handle gdb requests */
87 #define MIPS32NUMFPREGS 34 + 18
89 uint8_t mips32_gdb_dummy_fp_value[] = {0, 0, 0, 0};
91 struct reg mips32_gdb_dummy_fp_reg =
93 .name = "GDB dummy floating-point register",
94 .value = mips32_gdb_dummy_fp_value,
95 .dirty = 0,
96 .valid = 1,
97 .size = 32,
98 .arch_info = NULL,
101 int mips32_get_core_reg(struct reg *reg)
103 int retval;
104 struct mips32_core_reg *mips32_reg = reg->arch_info;
105 struct target *target = mips32_reg->target;
106 struct mips32_common *mips32_target = target->arch_info;
108 if (target->state != TARGET_HALTED)
110 return ERROR_TARGET_NOT_HALTED;
113 retval = mips32_target->read_core_reg(target, mips32_reg->num);
115 return retval;
118 int mips32_set_core_reg(struct reg *reg, uint8_t *buf)
120 struct mips32_core_reg *mips32_reg = reg->arch_info;
121 struct target *target = mips32_reg->target;
122 uint32_t value = buf_get_u32(buf, 0, 32);
124 if (target->state != TARGET_HALTED)
126 return ERROR_TARGET_NOT_HALTED;
129 buf_set_u32(reg->value, 0, 32, value);
130 reg->dirty = 1;
131 reg->valid = 1;
133 return ERROR_OK;
136 int mips32_read_core_reg(struct target *target, int num)
138 uint32_t reg_value;
139 struct mips32_core_reg *mips_core_reg;
141 /* get pointers to arch-specific information */
142 struct mips32_common *mips32 = target->arch_info;
144 if ((num < 0) || (num >= MIPS32NUMCOREREGS))
145 return ERROR_INVALID_ARGUMENTS;
147 mips_core_reg = mips32->core_cache->reg_list[num].arch_info;
148 reg_value = mips32->core_regs[num];
149 buf_set_u32(mips32->core_cache->reg_list[num].value, 0, 32, reg_value);
150 mips32->core_cache->reg_list[num].valid = 1;
151 mips32->core_cache->reg_list[num].dirty = 0;
153 return ERROR_OK;
156 int mips32_write_core_reg(struct target *target, int num)
158 uint32_t reg_value;
159 struct mips32_core_reg *mips_core_reg;
161 /* get pointers to arch-specific information */
162 struct mips32_common *mips32 = target->arch_info;
164 if ((num < 0) || (num >= MIPS32NUMCOREREGS))
165 return ERROR_INVALID_ARGUMENTS;
167 reg_value = buf_get_u32(mips32->core_cache->reg_list[num].value, 0, 32);
168 mips_core_reg = mips32->core_cache->reg_list[num].arch_info;
169 mips32->core_regs[num] = reg_value;
170 LOG_DEBUG("write core reg %i value 0x%" PRIx32 "", num , reg_value);
171 mips32->core_cache->reg_list[num].valid = 1;
172 mips32->core_cache->reg_list[num].dirty = 0;
174 return ERROR_OK;
177 int mips32_get_gdb_reg_list(struct target *target, struct reg **reg_list[], int *reg_list_size)
179 /* get pointers to arch-specific information */
180 struct mips32_common *mips32 = target->arch_info;
181 int i;
183 /* include floating point registers */
184 *reg_list_size = MIPS32NUMCOREREGS + MIPS32NUMFPREGS;
185 *reg_list = malloc(sizeof(struct reg*) * (*reg_list_size));
187 for (i = 0; i < MIPS32NUMCOREREGS; i++)
189 (*reg_list)[i] = &mips32->core_cache->reg_list[i];
192 /* add dummy floating points regs */
193 for (i = MIPS32NUMCOREREGS; i < (MIPS32NUMCOREREGS + MIPS32NUMFPREGS); i++)
195 (*reg_list)[i] = &mips32_gdb_dummy_fp_reg;
198 return ERROR_OK;
201 int mips32_save_context(struct target *target)
203 int i;
205 /* get pointers to arch-specific information */
206 struct mips32_common *mips32 = target->arch_info;
207 struct mips_ejtag *ejtag_info = &mips32->ejtag_info;
209 /* read core registers */
210 mips32_pracc_read_regs(ejtag_info, mips32->core_regs);
212 for (i = 0; i < MIPS32NUMCOREREGS; i++)
214 if (!mips32->core_cache->reg_list[i].valid)
216 mips32->read_core_reg(target, i);
220 return ERROR_OK;
223 int mips32_restore_context(struct target *target)
225 int i;
227 /* get pointers to arch-specific information */
228 struct mips32_common *mips32 = target->arch_info;
229 struct mips_ejtag *ejtag_info = &mips32->ejtag_info;
231 for (i = 0; i < MIPS32NUMCOREREGS; i++)
233 if (mips32->core_cache->reg_list[i].dirty)
235 mips32->write_core_reg(target, i);
239 /* write core regs */
240 mips32_pracc_write_regs(ejtag_info, mips32->core_regs);
242 return ERROR_OK;
245 int mips32_arch_state(struct target *target)
247 struct mips32_common *mips32 = target->arch_info;
249 if (mips32->common_magic != MIPS32_COMMON_MAGIC)
251 LOG_ERROR("BUG: called for a non-MIPS32 target");
252 return ERROR_FAIL;
255 LOG_USER("target halted due to %s, pc: 0x%8.8" PRIx32 "",
256 debug_reason_name(target),
257 buf_get_u32(mips32->core_cache->reg_list[MIPS32_PC].value, 0, 32));
259 return ERROR_OK;
262 static const struct reg_arch_type mips32_reg_type = {
263 .get = mips32_get_core_reg,
264 .set = mips32_set_core_reg,
267 struct reg_cache *mips32_build_reg_cache(struct target *target)
269 /* get pointers to arch-specific information */
270 struct mips32_common *mips32 = target->arch_info;
272 int num_regs = MIPS32NUMCOREREGS;
273 struct reg_cache **cache_p = register_get_last_cache_p(&target->reg_cache);
274 struct reg_cache *cache = malloc(sizeof(struct reg_cache));
275 struct reg *reg_list = malloc(sizeof(struct reg) * num_regs);
276 struct mips32_core_reg *arch_info = malloc(sizeof(struct mips32_core_reg) * num_regs);
277 int i;
279 register_init_dummy(&mips32_gdb_dummy_fp_reg);
281 /* Build the process context cache */
282 cache->name = "mips32 registers";
283 cache->next = NULL;
284 cache->reg_list = reg_list;
285 cache->num_regs = num_regs;
286 (*cache_p) = cache;
287 mips32->core_cache = cache;
289 for (i = 0; i < num_regs; i++)
291 arch_info[i] = mips32_core_reg_list_arch_info[i];
292 arch_info[i].target = target;
293 arch_info[i].mips32_common = mips32;
294 reg_list[i].name = mips32_core_reg_list[i];
295 reg_list[i].size = 32;
296 reg_list[i].value = calloc(1, 4);
297 reg_list[i].dirty = 0;
298 reg_list[i].valid = 0;
299 reg_list[i].type = &mips32_reg_type;
300 reg_list[i].arch_info = &arch_info[i];
303 return cache;
306 int mips32_init_arch_info(struct target *target, struct mips32_common *mips32, struct jtag_tap *tap)
308 target->arch_info = mips32;
309 mips32->common_magic = MIPS32_COMMON_MAGIC;
311 /* has breakpoint/watchpint unit been scanned */
312 mips32->bp_scanned = 0;
313 mips32->data_break_list = NULL;
315 mips32->ejtag_info.tap = tap;
316 mips32->read_core_reg = mips32_read_core_reg;
317 mips32->write_core_reg = mips32_write_core_reg;
319 return ERROR_OK;
322 int mips32_run_algorithm(struct target *target, int num_mem_params, struct mem_param *mem_params, int num_reg_params, struct reg_param *reg_params, uint32_t entry_point, uint32_t exit_point, int timeout_ms, void *arch_info)
324 /*TODO*/
325 return ERROR_OK;
328 int mips32_examine(struct target *target)
330 struct mips32_common *mips32 = target->arch_info;
332 if (!target_was_examined(target))
334 target_set_examined(target);
336 /* we will configure later */
337 mips32->bp_scanned = 0;
338 mips32->num_inst_bpoints = 0;
339 mips32->num_data_bpoints = 0;
340 mips32->num_inst_bpoints_avail = 0;
341 mips32->num_data_bpoints_avail = 0;
344 return ERROR_OK;
347 int mips32_configure_break_unit(struct target *target)
349 /* get pointers to arch-specific information */
350 struct mips32_common *mips32 = target->arch_info;
351 int retval;
352 uint32_t dcr, bpinfo;
353 int i;
355 if (mips32->bp_scanned)
356 return ERROR_OK;
358 /* get info about breakpoint support */
359 if ((retval = target_read_u32(target, EJTAG_DCR, &dcr)) != ERROR_OK)
360 return retval;
362 if (dcr & (1 << 16))
364 /* get number of inst breakpoints */
365 if ((retval = target_read_u32(target, EJTAG_IBS, &bpinfo)) != ERROR_OK)
366 return retval;
368 mips32->num_inst_bpoints = (bpinfo >> 24) & 0x0F;
369 mips32->num_inst_bpoints_avail = mips32->num_inst_bpoints;
370 mips32->inst_break_list = calloc(mips32->num_inst_bpoints, sizeof(struct mips32_comparator));
371 for (i = 0; i < mips32->num_inst_bpoints; i++)
373 mips32->inst_break_list[i].reg_address = EJTAG_IBA1 + (0x100 * i);
376 /* clear IBIS reg */
377 if ((retval = target_write_u32(target, EJTAG_IBS, 0)) != ERROR_OK)
378 return retval;
381 if (dcr & (1 << 17))
383 /* get number of data breakpoints */
384 if ((retval = target_read_u32(target, EJTAG_DBS, &bpinfo)) != ERROR_OK)
385 return retval;
387 mips32->num_data_bpoints = (bpinfo >> 24) & 0x0F;
388 mips32->num_data_bpoints_avail = mips32->num_data_bpoints;
389 mips32->data_break_list = calloc(mips32->num_data_bpoints, sizeof(struct mips32_comparator));
390 for (i = 0; i < mips32->num_data_bpoints; i++)
392 mips32->data_break_list[i].reg_address = EJTAG_DBA1 + (0x100 * i);
395 /* clear DBIS reg */
396 if ((retval = target_write_u32(target, EJTAG_DBS, 0)) != ERROR_OK)
397 return retval;
400 LOG_DEBUG("DCR 0x%" PRIx32 " numinst %i numdata %i", dcr, mips32->num_inst_bpoints, mips32->num_data_bpoints);
402 mips32->bp_scanned = 1;
404 return ERROR_OK;
407 int mips32_enable_interrupts(struct target *target, int enable)
409 int retval;
410 int update = 0;
411 uint32_t dcr;
413 /* read debug control register */
414 if ((retval = target_read_u32(target, EJTAG_DCR, &dcr)) != ERROR_OK)
415 return retval;
417 if (enable)
419 if (!(dcr & (1 << 4)))
421 /* enable interrupts */
422 dcr |= (1 << 4);
423 update = 1;
426 else
428 if (dcr & (1 << 4))
430 /* disable interrupts */
431 dcr &= ~(1 << 4);
432 update = 1;
436 if (update)
438 if ((retval = target_write_u32(target, EJTAG_DCR, dcr)) != ERROR_OK)
439 return retval;
442 return ERROR_OK;