git.gag.com Git - fw/openocd/blob - 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 }