65dc24f07ede8dfaabdfcdd48b37ff5a8578497c
[openocd.git] / src / target / register.c
1 /***************************************************************************
2 * Copyright (C) 2005 by Dominic Rath *
3 * Dominic.Rath@gmx.de *
4 * *
5 * Copyright (C) 2007,2008 √ėyvind Harboe *
6 * oyvind.harboe@zylin.com *
7 * *
8 * This program is free software; you can redistribute it and/or modify *
9 * it under the terms of the GNU General Public License as published by *
10 * the Free Software Foundation; either version 2 of the License, or *
11 * (at your option) any later version. *
12 * *
13 * This program is distributed in the hope that it will be useful, *
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
16 * GNU General Public License for more details. *
17 * *
18 * You should have received a copy of the GNU General Public License *
19 * along with this program; if not, write to the *
20 * Free Software Foundation, Inc., *
21 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
22 ***************************************************************************/
23
24 #ifdef HAVE_CONFIG_H
25 #include "config.h"
26 #endif
27
28 #include <helper/types.h>
29 #include "register.h"
30 #include <helper/log.h>
31
32 /**
33 * @file
34 * Holds utilities to work with register caches.
35 *
36 * OpenOCD uses machine registers internally, and exposes them by name
37 * to Tcl scripts. Sets of related registers are grouped into caches.
38 * For example, a CPU core will expose a set of registers, and there
39 * may be separate registers associated with debug or trace modules.
40 */
41
42 struct reg *register_get_by_name(struct reg_cache *first,
43 const char *name, bool search_all)
44 {
45 unsigned i;
46 struct reg_cache *cache = first;
47
48 while (cache) {
49 for (i = 0; i < cache->num_regs; i++) {
50 if (strcmp(cache->reg_list[i].name, name) == 0)
51 return &(cache->reg_list[i]);
52 }
53
54 if (search_all)
55 cache = cache->next;
56 else
57 break;
58 }
59
60 return NULL;
61 }
62
63 struct reg_cache **register_get_last_cache_p(struct reg_cache **first)
64 {
65 struct reg_cache **cache_p = first;
66
67 if (*cache_p)
68 while (*cache_p)
69 cache_p = &((*cache_p)->next);
70 else
71 return first;
72
73 return cache_p;
74 }
75
76 /** Marks the contents of the register cache as invalid (and clean). */
77 void register_cache_invalidate(struct reg_cache *cache)
78 {
79 struct reg *reg = cache->reg_list;
80
81 for (unsigned n = cache->num_regs; n != 0; n--, reg++) {
82 reg->valid = 0;
83 reg->dirty = 0;
84 }
85 }
86
87 static int register_get_dummy_core_reg(struct reg *reg)
88 {
89 return ERROR_OK;
90 }
91
92 static int register_set_dummy_core_reg(struct reg *reg, uint8_t *buf)
93 {
94 reg->dirty = 1;
95 reg->valid = 1;
96
97 return ERROR_OK;
98 }
99
100 static const struct reg_arch_type dummy_type = {
101 .get = register_get_dummy_core_reg,
102 .set = register_set_dummy_core_reg,
103 };
104
105 void register_init_dummy(struct reg *reg)
106 {
107 reg->type = &dummy_type;
108 }