X-Git-Url: https://review.openocd.org/gitweb?p=openocd.git;a=blobdiff_plain;f=src%2Ftarget%2Fregister.h;h=1e4f2e088988dd9e0e25d06f686a5e912ad14057;hp=c21edf64982815ee03009dd8b6d5798ef4a63224;hb=HEAD;hpb=04b514707f221ba00ae789e69f6f8047af96125d diff --git a/src/target/register.h b/src/target/register.h index c21edf6498..1e4f2e0889 100644 --- a/src/target/register.h +++ b/src/target/register.h @@ -1,67 +1,166 @@ +/* SPDX-License-Identifier: GPL-2.0-or-later */ + /*************************************************************************** * Copyright (C) 2005 by Dominic Rath * * Dominic.Rath@gmx.de * * * * Copyright (C) 2007,2008 Øyvind Harboe * * oyvind.harboe@zylin.com * - * * - * This program is free software; you can redistribute it and/or modify * - * it under the terms of the GNU General Public License as published by * - * the Free Software Foundation; either version 2 of the License, or * - * (at your option) any later version. * - * * - * This program is distributed in the hope that it will be useful, * - * but WITHOUT ANY WARRANTY; without even the implied warranty of * - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * - * GNU General Public License for more details. * - * * - * You should have received a copy of the GNU General Public License * - * along with this program; if not, write to the * - * Free Software Foundation, Inc., * - * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * ***************************************************************************/ -#ifndef REGISTER_H -#define REGISTER_H -#include "types.h" +#ifndef OPENOCD_TARGET_REGISTER_H +#define OPENOCD_TARGET_REGISTER_H + +#include "helper/replacements.h" +#include "helper/types.h" struct target; -struct reg -{ - char *name; - void *value; - int dirty; - int valid; +enum reg_type { + REG_TYPE_BOOL, + REG_TYPE_INT, + REG_TYPE_INT8, + REG_TYPE_INT16, + REG_TYPE_INT32, + REG_TYPE_INT64, + REG_TYPE_INT128, + REG_TYPE_UINT, + REG_TYPE_UINT8, + REG_TYPE_UINT16, + REG_TYPE_UINT32, + REG_TYPE_UINT64, + REG_TYPE_UINT128, + REG_TYPE_CODE_PTR, + REG_TYPE_DATA_PTR, + REG_TYPE_FLOAT, + REG_TYPE_IEEE_SINGLE, + REG_TYPE_IEEE_DOUBLE, + REG_TYPE_ARCH_DEFINED, +}; + +struct reg_feature { + const char *name; +}; + +struct reg_data_type_vector { + struct reg_data_type *type; + uint32_t count; +}; + +struct reg_data_type_union_field { + const char *name; + struct reg_data_type *type; + struct reg_data_type_union_field *next; +}; + +struct reg_data_type_union { + struct reg_data_type_union_field *fields; +}; + +struct reg_data_type_bitfield { + uint32_t start; + uint32_t end; + enum reg_type type; +}; + +struct reg_data_type_struct_field { + const char *name; + bool use_bitfields; + union { + struct reg_data_type_bitfield *bitfield; + struct reg_data_type *type; + }; + struct reg_data_type_struct_field *next; +}; + +struct reg_data_type_struct { + uint32_t size; + struct reg_data_type_struct_field *fields; +}; + +struct reg_data_type_flags_field { + const char *name; + struct reg_data_type_bitfield *bitfield; + struct reg_data_type_flags_field *next; +}; + +struct reg_data_type_flags { uint32_t size; + struct reg_data_type_flags_field *fields; +}; + +enum reg_data_type_class { + REG_TYPE_CLASS_VECTOR, + REG_TYPE_CLASS_UNION, + REG_TYPE_CLASS_STRUCT, + REG_TYPE_CLASS_FLAGS, +}; + +struct reg_data_type { + enum reg_type type; + const char *id; + enum reg_data_type_class type_class; + union { + struct reg_data_type_vector *reg_type_vector; + struct reg_data_type_union *reg_type_union; + struct reg_data_type_struct *reg_type_struct; + struct reg_data_type_flags *reg_type_flags; + }; +}; + +struct reg { + /* Canonical name of the register. */ + const char *name; + /* Number that gdb uses to access this register. */ + uint32_t number; + /* TODO. This should probably be const. */ + struct reg_feature *feature; + /* TODO: When true, the caller will save this register before running any algorithm. */ + bool caller_save; + /* Pointer to place where the value is stored, in the format understood by + * the binarybuffer.h functions. */ + uint8_t *value; + /* The stored value needs to be written to the target. */ + bool dirty; + /* When true, value is valid. */ + bool valid; + /* When false, the register doesn't actually exist in the target. */ + bool exist; + /* Hide the register from gdb and omit it in 'reg' cmd output */ + bool hidden; + /* Size of the register in bits. */ + uint32_t size; + /* Used for generating XML description of registers. Can be set to NULL for + * targets that don't use that. */ + struct reg_data_type *reg_data_type; + /* Used for generating XML description of registers. Can be set to NULL for + * targets that don't use that. */ + const char *group; + /* Pointer to architecture-specific info for this register. */ void *arch_info; - int arch_type; + const struct reg_arch_type *type; }; -struct reg_cache -{ - char *name; +struct reg_cache { + const char *name; struct reg_cache *next; struct reg *reg_list; - int num_regs; + unsigned num_regs; }; -struct reg_arch_type -{ - int id; +struct reg_arch_type { int (*get)(struct reg *reg); int (*set)(struct reg *reg, uint8_t *buf); - struct reg_arch_type *next; }; -struct reg* register_get_by_name(struct reg_cache *first, +struct reg *register_get_by_number(struct reg_cache *first, + uint32_t reg_num, bool search_all); +struct reg *register_get_by_name(struct reg_cache *first, const char *name, bool search_all); -struct reg_cache** register_get_last_cache_p(struct reg_cache **first); - -int register_reg_arch_type(int (*get)(struct reg *reg), - int (*set)(struct reg *reg, uint8_t *buf)); -struct reg_arch_type* register_get_arch_type(int id); +struct reg_cache **register_get_last_cache_p(struct reg_cache **first); +void register_unlink_cache(struct reg_cache **cache_p, const struct reg_cache *cache); +void register_cache_invalidate(struct reg_cache *cache); void register_init_dummy(struct reg *reg); -#endif /* REGISTER_H */ +#endif /* OPENOCD_TARGET_REGISTER_H */